Projektna datoteka (format 2)

Projektna datoteka je objekt JSON z "format": 2 v kodiranju UTF-8, v katerem so dovoljeni komentarji in vejice na koncu, in leži v mapi zaganjalnika. Zaganjalnik izbere datoteko v tem vrstnem redu:

1. datoteko .json, ki jo navaja /RUNCFG <file> (samo ime datoteke v mapi zaganjalnika);
2. (od različice 2.3.0) <name>.bootstrapper.json, poimenovano po datoteki EXE zaganjalnika, če obstaja – demo.bootstrapper.json za demo.exe, tako kot v .NET datoteka demo.exe.config pripada datoteki demo.exe;
3. bootstrapper.json.

Zaganjalnik lahko preimenujete (demo.exe): ne glede na ime bere svojo mapo, bližnjice ([Starter]) in vnos v Aplikacijah pa navajajo preimenovano datoteko. Namestitev, posodobitev, zagon brez vira, /list in /uninstall delujejo enako. Od različice 2.3.0 si lahko več preimenovanih zaganjalnikov deli eno mapo, po en zaganjalnik za vsak profil, vsak s svojo projektno datoteko in brez /RUNCFG v bližnjici:

Vsak profil potrebuje svoj product; projektni datoteki z istim ključem izdelka bi druga drugi zamenjevali namestitev v uporabnikovem računalniku. Vnos v Aplikacijah izdelek odstrani prek zaganjalnika na poti, s katere je bil zagnan. Zaganjalnik v skupni rabi, ki ni več dosegljiva, izdelka od tam ne more odstraniti; v tem primeru /uninstall zaženite iz dosegljive kopije zaganjalnika.

Format 1 in format 2 sta formata samo te datoteke. Projektna datoteka orodja za gradnjo WKL Forms Object Library (access-app.json) je druga datoteka z lastnim formatom in je zaganjalnik nikoli ne bere. Od gradnje zaganjalnik bere samo app-manifest.json, ki ga orodje za gradnjo zapiše v vsako mapo izdaje (version.from); polje format v njem je različica sheme manifesta, ne eden od formatov te datoteke. Ali aplikacija teče po formatu 1 ali formatu 2, ne odloča aplikacija, temveč datoteka bootstrapper.json, ki jo njen skrbnik postavi poleg zaganjalnika.

{
  "format": 2,
  "product": "Blagajna",
  "display": { "name": "Blagajna Pro", "publisher": "Contoso", "copyright": [ "(c) 2026 Contoso" ], "logo": "logo.png" },
  "version": { "value": "3.2.1" },
  "source": "\\\\server\\share\\blagajna",
  "deliveryKey": "MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE...",
  "files": [
    { "id": "bin", "source": "bin", "target": "[VersionDir]" },
    { "source": "com\\x86", "target": "[AppDir]\\com", "action": "registerCom", "bitness": "x86" }
  ],
  "registry": [ { "key": "Software\\Contoso\\Blagajna", "values": [ { "name": "Home", "data": "[Dir:bin]" } ] } ],
  "shortcuts": [ { "folder": "[Programs]\\Contoso", "name": "Blagajna", "target": "[Starter]", "arguments": "[RunConfig]" } ],
  "fileTypes": [ { "extension": ".blagajna", "progId": "Contoso.Blagajna", "description": "Blagajniški račun", "command": "\"[Starter]\" [RunConfig] \"%1\"" } ],
  "actions": [ { "when": "beforeInstall", "program": "setup\\vc_redist.x86.exe", "arguments": "/install /quiet /norestart", "successCodes": [ 0, 3010 ] } ],
  "conditions": [ { "kind": "dotnet", "value": "Microsoft.WindowsDesktop.App 10.0", "message": ".NET 10 is missing.", "link": "https://dot.net" } ],
  "start": { "file": "[VersionDir]\\Blagajna.exe", "arguments": "/mode kiosk" },
  "keepVersions": 2
}

Projektna datoteka določa, kaj zaganjalnik namesti za uporabnika sistema Windows, kaj registrira, katere pogoje preveri, katere programe izvede in kaj zažene. Zažene lahko kateri koli program ali datoteko; aplikacija Access je le eden od primerov. Zaganjalnik vse to opravi brez skrbniških pravic, kot eno transakcijo s povrnitvijo ob napaki, s štetjem uporab in z možnostjo odstranitve v Nastavitvah › Aplikacije.

Vsak cilj, v katerega piše zaganjalnik (appDir, versionDir, cilj vnosa files, mapa bližnjice, datoteka INI), je pot z ogradami pod eno od uporabnikovih map. Cilj zunaj njih, .. v poti, ključ registra, ki navaja drug panj, in neznano ogrado zaganjalnik zavrne, preden karkoli izvede (koda 11).

Mape uporabnika – s temi ogradami se cilj lahko začne. Pred različico 2.3.0 so obstajale samo [LocalAppData], [AppData], [Documents], [Desktop], [Programs] in [Startup].

Knjižnice ter [Downloads], [LocalAppDataLow] in [UserPrograms] zaganjalnik prebere iz sistema Windows kot znane mape. Mapa, ki je Windows v tem računalniku ne more določiti, ostane brez vrednosti, cilj pod njo pa zaganjalnik zavrne enako kot neznano ogrado.

Mape računalnika – razrešijo se povsod, kjer lahko stoji ograda, ki ni cilj: start (datoteka, argumenti, mapa, okolje), actions, conditions in podatki registra. Cilj se z njimi nikoli ne začne, ker pisanje vanje zahteva skrbniške pravice.

Ograde projekta:

Datoteke pod [VersionDir] pripadajo svoji različici: zapišejo se enkrat, nikoli se ne zamenjajo (program, ki piše v svojo mapo, obdrži svoje podatke) in se odstranijo skupaj z različico. Datoteke kjer koli drugje so skupne, njihova uporaba pa se šteje: mapa, ki jo uporabljata dva izdelka, ostane, dokler je ne preneha uporabljati zadnji; datoteka, spremenjena v poznejši izdaji, se zamenja.

Ob vsakem zagonu zaganjalnik prebere projekt, preveri pogoje in namesti izdano različico, če je nova ali nepopolna: datoteke, vrednosti v registru, vrste datotek, bližnjice, datoteko INI, zaupanja vredno mesto (samo če je start.file podatkovna zbirka Access) in vnos v Aplikacijah, nato izvede dejanja afterInstall – vse v eni transakciji. Nato odstrani različice nad keepVersions (nikoli tiste, ki teče, ali nazadnje delujoče) in zažene start.file. Napaka na tej poti vse povrne; kode so enake kot na strani Kode napak zaganjalnika.

Če vir ni dosegljiv (koda 12) ali njegova izdaja ni zaupanja vredna (koda 51), se zažene nameščena različica – nazadnje delujoča, sicer najnovejša – posodobitev pa počaka na naslednji zagon. Diagnostika (/diagnose) sporoči vir takšen, kakršen je.

delivery.json v viru navaja vsako datoteko izdane različice z velikostjo in vrednostjo SHA-256; delivery.json.sig poleg nje je njen podpis z založnikovim ključem za izdaje (ECDSA P-256). Obe datoteki zapiše /publish.

Vsaka kopija se po kopiranju še enkrat preveri glede na manifest, zato se ne namesti niti datoteka, ki se je spremenila med preverjanjem in kopiranjem.

Vrnitev na prejšnjo različico. Z deliveryKey zaganjalnik izdano različico primerja z najvišjo, ki jo je uporabnik kdaj koli namestil (tudi po čiščenju ali odstranitvi izdelka), po vrstnem redu iz razdelka Različice. Nižja različica se namesti samo, če withdrawn v delivery.json navaja to najvišjo različico; polje zapiše /publish /withdraw (glejte Objava podpisane izdaje). Brez deliveryKey se nižja različica namesti kot doslej.

Česa podpis ne zajema. Podpis zajema datoteke iz files. Programi iz actions tečejo neposredno iz vira in jih zaganjalnik glede na delivery.json ne preveri: kdor lahko piše v vir, jih lahko spremeni, tečejo pa s pravicami vsakega uporabnika, ki zažene aplikacijo. Prej podpisana izdaja ostane veljavna; zaganjalnik, ki je že namestil višjo različico, jo zavrne (koda 52), uporabnik brez višje različice pa jo namesti. Pravico pisanja v vir zato zaščitite. Sidro zaupanja je mapa zaganjalnika s projektno datoteko: ključ za izdaje izdajo ščiti samo, dokler uporabniki ne morejo spremeniti datoteke bootstrapper.json, na primer ko oddelek IT zaganjalnik s paketom MSI namesti v Program Files. Zaganjalnik in projektno datoteko v skupni rabi ali v uporabnikovem profilu je mogoče spremeniti skupaj s ključem.

Ključ za izdaje je založnikov lastni ključ; zanj ne porabite nobenega podpisa za podpisovanje kode. Nadzor aplikacij v sistemu Windows preverja samo podpise Authenticode programov in knjižnic, ki jih založnik kot doslej podpiše s certifikatom podjetja.

Zaganjalnik v uporabnikovem računalniku nikoli ne zažene strežnikove lastne registracije (DllRegisterServer, regsvr32): registracijo zapiše iz registration.json, ki ga tools\Export-ComRegistration.ps1 zajame na založnikovem računalniku. Če dva izdelka prineseta isti strežnik v različnih različicah, ostane registrirana novejša; ko se ta odstrani, se znova registrira preostala. Glejte Objava podpisane izdaje.

Program teče z uporabnikovimi pravicami; namestitveni program, ki potrebuje skrbniške pravice, ne uspe s svojo izhodno kodo (koda 43). Takšni predpogoji sodijo v začetno namestitev, ki jo izvede oddelek IT.

Dejanja beforeUninstall se ob vsaki odstranitvi izvedejo enkrat, ne glede na once, preden se karkoli odstrani. Njihove ograde se razrešijo za različico, ki bi jo zaganjalnik zagnal nazadnje ([VersionDir] je ta nameščena različica). Relativni program se vzame iz vira, ki ga takrat morda ni več (skupna raba ni dosegljiva, izdaja je odstranjena): programa ni mogoče zagnati, odstranitev se ustavi s kodo 43 in nič se ne odstrani. Takšne programe zato usmerite na nameščeno kopijo ([VersionDir]\...).

message in link pogoja se prikažeta v podrobnostih diagnostike.

Datoteka z "format": 1 (aplikacija Access, zaganjalnik 1.0) se prebere kot projekt: podatkovna zbirka iz app-manifest.json v [VersionDir] (mapa, ki jo je uporabljala različica 1.0), komponente WKL in gonilniki ODBC po različicah, ločeno za 32- in 64-bitni Office, pod [WklRoot], vir podatkov vsakega gonilnika, preverjanja nastavitev kot pogoji in podatkovna zbirka kot cilj zagona. Datoteke formata 1 še naprej delujejo nespremenjene; po potrebi jih nadomesti projekt formata 2, ki ga zapiše Bootstrapper Manager. Ali izdajo formata 1 prevzame namestitveni program 2.0 ali teče po načinu 1.0, je odvisno od njene mape s komponentami: če je poleg knjižnice DLL registration.json (ali če komponent ni), jo prevzame namestitveni program, sicer teče po načinu 1.0 – glejte Kdaj namešča 2.0 in kdaj teče 1.0.

Datoteka formata 1:

{
  "format": 1,
  "product": "INSTRA",
  "displayName": "INSTRA Verwaltung",
  "source": "\\\\server\\apps\\INSTRA\\production",
  "components": "components",
  "ini": { "file": "TECCUsr.ini", "values": [ { "section": "Properties", "key": "SRV", "value": "sql01" } ] },
  "branding": { "logo": "logo.png", "company": "Contoso", "preparing": "Die neue Version wird eingerichtet ..." },
  "command": "mandant=2",
  "odbcDrivers": [ "ODBC Driver 18 for SQL Server" ],
  "language": "",
  "colorScheme": "automatic",
  "keepVersions": 2
}

Program, ki ni aplikacija Access, v lastni mapi za vsako različico, zagnan z argumenti:

{
  "format": 2,
  "product": "Skladisce",
  "display": { "name": "Upravljanje skladišča", "publisher": "Contoso" },
  "version": { "from": "bin\\Skladisce.exe" },
  "source": "\\\\server\\share\\lager",
  "files": [ { "source": "bin", "target": "[VersionDir]" } ],
  "shortcuts": [ { "folder": "[Desktop]", "name": "Skladišče", "target": "[Starter]", "arguments": "[RunConfig]" } ],
  "start": { "file": "[VersionDir]\\Skladisce.exe", "arguments": "/user \"[Product]\"" }
}

• Namestitveni program zaganjalnika 2.0 – transakcija, štetje, ukazi
• Objava podpisane izdaje
• Ustvarjanje projekta iz predlog
• Zagon poljubnega programa z zaganjalnikom
• Zasebno izvajalno okolje .NET v izdaji
• Kode napak zaganjalnika