Priprava izdaje aplikacije z WKL Office SDK

Izdajo aplikacije Access sestavite iz njenih izvornih datotek, da jo uporabniki prejmejo prek WKL Bootstrapper. Izdaja vsebuje podatkovno zbirko za vsak profil izdaje z njenim manifestom, knjižnice WKL, ki jih aplikacija potrebuje, in zaganjalnik (Starter).

Zahteve: WKL Office SDK 0.3.0 ali novejši, na računalniku za gradnjo pa paketi izdaj WKL Forms Object Library (in WKL Office JSON, če se projekt sklicuje nanj) ter WKL Bootstrapper 2.2 ali novejši. Priporočamo različico 2.2.4 ali novejšo, ki zavrne starejše podpisane izdaje, ponovno postavljene v skupno mapo (s starejšim zaganjalnikom deliver izda opozorilo, izdajo pa vseeno pripravi). WKL Office JSON 2.0 ali novejši potrebuje zaganjalnik 2.3.1 ali novejši, WKL Forms Object Library 2.0 ali novejši pa zaganjalnik 3.1 ali novejši; s starejšim se deliver prekine. Za MSI potrebujete še ukazno vrstico WiX Toolset (wix), za urejanje zaganjalnika pa program WKL Bootstrapper Manager, ki ga skupaj z SDK namesti wkl-office addin install.

Aplikacija, zgrajena z SDK, pride do uporabnikov prek zaganjalnika. Ta prebere app-manifest.json ob podatkovni zbirki in registrira knjižnice WKL, ki jih ta potrebuje. Če izdajo sestavljate ročno, se hitro zmotite pri kontrolnih vsotah, različicah ali pri tem, katero 32- ali 64-bitno različico paketa potrebuje kateri uporabnik.

• Profil izdaje določa, kaj izdaja vsebuje: konfiguracijo gradnje, v kateri se zgradi (njen način je način izdaje), mapo izdaje in zaganjalnik. Vsak profil je datoteka delivery\<name>.profile.json. Kar je skupno vsem profilom, torej različica in paketi izdaj, je v delivery\delivery-settings.json (referenčni priročnik).
• V dodatku oboje nastavite v oknu Lastnosti projekta (gumb Lastnosti v skupini Projekt).
• wkl-office deliver (ali Pripravi izdajo v skupini Izdaja dodatka; meni prikaže profile konfiguracije gradnje, izbrane v dodatku) zgradi vsak profil in zapiše build\Delivery\<name>: zaganjalnik z njegovo projektno datoteko, v podmapi deploy pa podatkovno zbirko, app-manifest.json in knjižnice WKL.
• Projektna datoteka zaganjalnika za posamezen profil je izvorna datoteka projekta (delivery\<name>.bootstrapper.json), ki jo urejate s programom Bootstrapper Manager (Zaganjalnik › Nastavi v programu Bootstrapper Manager).
• wkl-office msi za službo IT zgradi namestitveni paket Windows Installer za profil.

1. Nastavite izdajo. V dodatku odprite Lastnosti, v drevesu izberite Profili izdaje in kliknite Nastavi izdajo. Okno doda profil Production, ki se gradi v konfiguraciji gradnje Release, in vpiše najnovejše pakete izdaj pod WKL_PACKAGES. Preverite jih pod Izdaja in shranite z V redu.

   Ročno napišete isti datoteki, delivery\delivery-settings.json:

   {
     "format": 2,
     "version": "1.0.0",
     "packages": {
       "components": "%WKL_PACKAGES%\\Wkl.Forms.ObjectLibrary\\2.0.0",
       "bootstrapper": "%WKL_PACKAGES%\\Wkl.Bootstrapper\\3.1.0"
     }
   }

   in delivery\Production.profile.json:

   {
     "format": 1,
     "configuration": "Release"
   }

   Konfiguracija gradnje, v kateri se profil gradi, mora določati način: v projektni datoteki <AppMode>Production</AppMode> in <Accde>true</Accde> v skupini lastnosti konfiguracije Release (projektna datoteka), v oknu pa pod Konfiguracije gradnje › Release. Nastavi izdajo nastavi način Production, če ga Release še nima. Za različico, ki jo dobijo samo skrbniki, dodajte še eno konfiguracijo z načinom Administration in profil, ki se gradi v njej.

2. Preverite, kaj bo izdaja vsebovala:

   wkl-office deliver Stranke.acproj --dependencies

3. Pripravite izdajo:

   wkl-office deliver Stranke.acproj

   Prva izdaja profila zapiše delivery\<name>.bootstrapper.json iz predlog zaganjalnika in to sporoči kot opozorilo. Datoteko odprite z ukazom Zaganjalnik › Nastavi v programu Bootstrapper Manager: za source nastavite omrežno mapo v skupni rabi, iz katere berejo uporabniki, ter prikazno ime in bližnjice, nato shranite. Izdajo pripravite znova.

4. Profil preizkusite, ne da bi kar koli namestili:

   wkl-office deliver Stranke.acproj -p Production --whatif

5. Vsebino mape build\Delivery\production\deploy kopirajte v skupno mapo, navedeno kot source: najprej podatkovno zbirko, app-manifest.json pa na koncu. Uporabnikom nato dajte zaganjalnik (Wkl.Bootstrapper.exe z bootstrapper.json) ali pa za službo IT zgradite njegov namestitveni paket:

   wkl-office msi Stranke.acproj -p Production --version 1.0.0 --sign <thumbprint>

• Izdaja se gradi v lastnem skritem programu Access, profil za profilom; podatkovna zbirka, odprta v razvijalčevem programu Access, ostane nespremenjena. Če priprava enega profila ne uspe, se ukaz ustavi in naslednjih profilov ne zgradi niti ne pripravi.
• Več profilov lahko izda isti način, na primer po en profil za vsako stranko, vsak s svojo konfiguracijo gradnje (profilom povezave) in svojo mapo izdaje.
• requires je odvisen od računalnika za gradnjo. Access v podatkovno zbirko zapiše najvišjo registrirano različico knjižnice, na katero se sklicuje. Izdaja, zgrajena na računalniku z registriranimi Components 1.59, zato tudi na računalnikih uporabnikov zahteva 1.59. Izdaje gradite na računalniku, na katerem je registrirana tista različica, ki jo dobijo uporabniki.
• Bootstrapper Manager je del SDK: wkl-office addin install ga namesti kot %LOCALAPPDATA%\Programs\WKL\Bootstrapper Manager\<version>\Wkl.Bootstrapper.Manager.accdb (glejte Namestitev WKL Office SDK). SDK ga odpre s projektno datoteko in zaganjalnikom. Uporabi datoteko, na katero kaže WKL_BOOTSTRAPPER_MANAGER (prej WKL_STARTER_CONFIGURATOR), če obstaja, sicer najvišjo različico pod %LOCALAPPDATA%\Programs\WKL\Bootstrapper Manager in pod prejšnjo mapo %LOCALAPPDATA%\Programs\WKL\Starter Configurator. Argumenti so opisani na strani „Command line of WKL Bootstrapper Manager“ (v angleščini) v dokumentaciji programa WKL Bootstrapper Manager.
• 32- in 64-bitni Office. Profil se izda za isto 32- ali 64-bitno različico, kot jo ima Access, ki gradi. Z vrednostjo "bitness": "any" v profilu (v lastnostih projekta: Za 32- in 64-bitni Office) ena gradnja na 32-bitnem računalniku zadošča za 32- in 64-bitni Office: izda se ACCDB, ki jo Access prevede ob prvem zagonu (glejte delivery-settings.json).
• any ali ACCDE za vsako različico? Odločilno je, ali smejo uporabniki na svojih računalnikih brati in spreminjati kodo VBA. Pri vrednosti any to lahko, saj se izda ACCDB.
  • Administration: any običajno zadošča, ker to različico dobijo samo skrbniki.
  • Production: any, če je odprta koda za vašo aplikacijo sprejemljiva, sicer po ena ACCDE za 32- in 64-bitni Office.
  • ACCDE ima vedno 32- ali 64-bitno različico programa Access, ki jo je zgradil. 64-bitno ACCDE je mogoče zgraditi samo na računalniku s 64-bitnim programom Access (polna različica; Access Runtime ACCDE ne ustvari). Zanjo dodajte lasten profil z lastno mapo izdaje, na primer Production x64, in ga na tem računalniku izdajte z -p "Production x64". Obe izdaji razdelite ločeno. Podatkovno zbirko, zgrajeno za drugo različico, zaganjalnik zavrne s sporočilom, namesto da bi jo odprl.
• Oblika 1 še vedno velja: delivery-settings.json s seznamom targets vsak cilj izda kot profil z imenom njegovega načina. Lastnosti projekta jo zapišejo v obliki 2, ko izdajo tam spremenite (delivery-settings.json).

• Projektna mapa – katera datoteka je kje in kaj je pod nadzorom različic
• Konfiguracije gradnje in profili izdaje – kaj določa konfiguracija in kaj profil
• delivery-settings.json
• Referenčni priročnik ukazne vrstice: deliver, msi
• Selitev projekta orodja za gradnjo WKL Forms Object Library
• „Uporabniški priročnik za WKL Bootstrapper Manager“ v dokumentaciji programa WKL Bootstrapper Manager: urejanje projektne datoteke zaganjalnika