Razdeljevanje aplikacije uporabnikom z zaganjalnikom

Aplikacijo Access, zgrajeno s komponentami knjižnice WKL Forms Object Library, razdelite uporabnikom tako, da jo zaženejo z enim klikom, vedno v trenutni različici, brez namestitvenega programa in brez skrbniških pravic. Izdajo zgradi orodje za gradnjo, zaganjalnik pa jo iz skupne rabe prenese k vsakemu uporabniku in jo zažene.

Zahteve: WKL Forms Object Library 1.51 ali novejša (deploy orodja za gradnjo), WKL Bootstrapper 1.0 ali novejši.

Na tej strani je projektna datoteka v formatu 1, ki ga zaganjalnik še vedno bere. Nov projekt začnite v formatu 2, najlažje iz predlog.

• Orodje za gradnjo WKL Forms Object Library zapiše izdajo: podatkovno zbirko in njen app-manifest.json.
• Izdajo shranite v skupno rabo, poleg nje pa komponente WKL ustrezne različice.
• Zaganjalnik (Wkl.Bootstrapper.exe in bootstrapper.json) kaže na skupno rabo; uporabniki zaženejo datoteko EXE.

1. Zgradite izdajo. V projektni datoteki orodja za gradnjo navedite model aplikacije in izdajo:

   {
     "name": "Stranke",
     "appModel": "src/app/app-model.json",
     "deploy": { "version": "1.4.0", "targets": [ "Production" ] }
   }

   Build-AccessApp.ps1 zapiše deploy\production z datotekama Stranke.accde in app-manifest.json (izdelek, različica, datoteka, velikost, SHA-256, 32- ali 64-bitna izvedba, izvajalno okolje, zahtevana različica WKL).

2. Izdajo shranite v skupno rabo, na primer v \\server\apps\Stranke\production. Najprej kopirajte podatkovno zbirko, app-manifest.json pa na koncu. Uporabniki potrebujejo samo pravico branja.
3. Dodajte komponente WKL, če na računalnikih uporabnikov niso registrirane: mapi x86 in x64 iz paketa različice WKL kopirajte v \\server\apps\Stranke\production\components\x86 in ...\x64.

4. Pripravite zaganjalnik: mapo z datotekama Wkl.Bootstrapper.exe in bootstrapper.json, ki je v skupni rabi ali kopirana v vsak računalnik:

   {
     "format": 1,
     "product": "Stranke",
     "displayName": "Upravljanje strank",
     "source": "\\\\server\\apps\\Stranke\\production",
     "components": "components",
     "odbcDrivers": [ "ODBC Driver 18 for SQL Server" ],
     "keepVersions": 2
   }

   Vsak vnos je opisan v referenčnem priročniku projektne datoteke. Lasten logotip shranite poleg datoteke EXE in ga navedite v branding.logo; brez njega okna prikazujejo logotip znamke The White Knight Labs.

5. Uporabnikom dajte bližnjico do Wkl.Bootstrapper.exe. Nastavitev enkrat preverite z ukazom Wkl.Bootstrapper.exe /diagnose v uporabnikovem računalniku: prva vrstica 0 Ok pomeni, da bo zagon uspel.
6. Posodobitev izdate tako, da zgradite novo različico in jo kopirate v isto mapo (najprej podatkovno zbirko, app-manifest.json na koncu). Ob naslednjem zagonu uporabniki dobijo novo različico v njeni lastni mapi; kopija, ki je še odprta v programu Access, ostane nespremenjena.

Ob prvem zagonu zaganjalnik različico kopira v %LOCALAPPDATA%\WKL\Stranke\Frontends\1.4.0, po potrebi za uporabnika registrira komponente WKL (začetno okno je kot pozdravno okno prikazano vsaj splash.duration, privzeto 3 sekunde, in se zapre, ko je Access viden), mapo nastavi kot zaupanja vredno mesto in aplikacijo odpre v programu Access – brez varnostnega opozorila. Ob poznejših zagonih se kopija odpre takoj. Če kaj manjka, okno z napako to navede s kodo (glejte Kode napak zaganjalnika).

• Vrnitev na prejšnjo različico. Dokler nova različica ne deluje, uporabnik (ali podpora) zažene Wkl.Bootstrapper.exe /settings, na strani Aplikacija izbere različico z oznako „nazadnje zagnana“ in klikne Zaženi to različico.
• Kopija pripada uporabniku. Access piše v podatkovno zbirko, ki jo odpre, zato zaganjalnik kopijo primerja z izdajo samo takrat, ko jo ustvari. Ukaz Znova kopiraj v nastavitvah jo znova ustvari iz izdaje.
• Gesla ne sodijo v zaganjalnik. Vrednosti INI, ki so videti kot gesla ali ključi, zaganjalnik zavrne; za povezave poskrbi aplikacija sama (Linked Tables Manager, model aplikacije).
• Gonilniki ODBC samo za uporabnika. Gonilnik, nameščen samo za uporabnika (knjižnica DLL v profilu, uporabniški DSN, ki ga navaja s potjo, brez vnosa pod ODBCINST.INI), zaganjalnik preveri prek njegovega vira podatkov: "odbcDataSources": [ "MyDsn" ] namesto odbcDrivers (od 1.0.1).
• 32- in 64-bitni Office. Izdaja v obliki ACCDE deluje samo v eni od obeh različic programa Access; glejte Razdeljevanje aplikacije Access uporabnikom z 32- in 64-bitnim Officeom.
• Podprto: 32- in 64-bitni Office. Pri počasni povezavi prvo kopiranje traja ustrezno dlje, medtem pa je prikazano okno napredka.

Če ima model aplikacije oba načina, orodje za gradnjo poleg deploy\production zapiše še deploy\administration. Zaganjalnik uporablja mapo, ki jo navaja njegov source, zato skrbniška različica dobi svoj zaganjalnik:

1. deploy\administration kopirajte v lastno mapo v skupni rabi, na primer \\server\apps\Stranke\administration, s komponentami v podmapi, tako kot pri produkcijski različici.

2. Pripravite drugo mapo zaganjalnika z datoteko Wkl.Bootstrapper.exe in datoteko bootstrapper.json, katere source navaja to mapo in katere product je drugačen, na primer StrankeAdmin:

   {
     "format": 1,
     "product": "StrankeAdmin",
     "displayName": "Upravljanje strank (skrbništvo)",
     "source": "\\\\server\\apps\\Stranke\\administration",
     "components": "components"
   }

3. Bližnjico dajte samo skrbnikom.

Kopije so shranjene po vrednosti product v %LOCALAPPDATA%\WKL\<product>\Frontends\<version>. Z istim product in isto različico bi si izdaji ob vsakem zagonu druga drugi zamenjali kopijo. Skrbniška različica v svojem app-manifest.json zahteva polno različico programa Access (runtime: false): zaganjalnik jo odpre brez /runtime, v računalniku, kjer je nameščen samo Access Runtime, pa se ustavi s kodo 22 (glejte Aplikacija potrebuje polni Microsoft Access).

• WKL Bootstrapper
• Kode napak zaganjalnika
• app-manifest.json in orodje za gradnjo: dokumentacija izdelka WKL Forms Object Library (app-manifest.json, Gradnja aplikacije Access iz besedilnih izvornih datotek)