Vadnica: aplikacija Access od izvorne mape do preverjene namestitve

V tej vadnici za dokončano aplikacijo Access pripravite namestitveni paket in ga preverite s preizkusno namestitvijo. Predznanje o sistemu WKL Bootstrapper ni potrebno: vse, kar morate vedeti, je pojasnjeno pri koraku, v katerem to potrebujete. Za celotno vadnico načrtujte približno pol ure.

Primer je blagajniška aplikacija izmišljenega podjetja Zgled d.o.o. Na začetku imate:

• Blagajna.accde – aplikacijo, različica 3.2.0;
• mapo bin z dvema pomožnima knjižnicama (Blagajna.Tiskalnik.dll, Blagajna.Tehtnica.dll);
• mapo Poročila s predlogo poročila (DnevniZakljucek.pdf).

Na koncu boste imeli paket Blagajna-1.0.0.msi in preverili boste, da na računalniku naredi, kar mora: aplikacija se namesti v uporabnikov profil, predloge poročil v njegovo mapo Dokumenti, na namizju se prikaže bližnjica, Access pa odpre blagajno.

Slike prikazujejo Bootstrapper Manager z nemškim uporabniškim vmesnikom; v slovenskem so strani, ukazi in polja na istih mestih in imajo oznake, ki jih navaja vadnica.

Paket MSI ne vsebuje aplikacije same. Preden začnete, si zato oglejte, kateri del opravi katero nalogo:

Paket MSI torej na računalnik prenese projektno datoteko, aplikacijo pa zaganjalnik ob zagonu prekopira iz izvorne mape. Kako nova različica blagajne pride do uporabnikov, je zato odvisno od tega, kje je zapisana številka različice; več o tem v razdelku Kako naprej.

• Bootstrapper Manager je nastavljen in se zažene; glejte Nastavitev in zagon programa Bootstrapper Manager.
• Paket različice WKL Bootstrapper z datotekama Wkl.Bootstrapper.exe in tools\New-StarterMsi.ps1.
• Orodje ukazne vrstice WiX, različica 6 ali novejša, ki ga namestite na primer z ukazom dotnet tool install --global wix.
• Za preizkusno namestitev preizkusni ali navidezni računalnik z Microsoft Accessom (ali izvajalnim okoljem Access Runtime) in račun s skrbniškimi pravicami. Paket namešča za vse uporabnike računalnika, zato ga za preizkus ne nameščajte na svoj delovni računalnik.

Cilj: vse, kar sodi v namestitev, je zbrano na enem mestu.

Postopek:

1. Ustvarite mapo C:\Izdaje\Blagajna in v njej podmapo deploy.
2. V C:\Izdaje\Blagajna\deploy prekopirajte Blagajna.accde ter mapi bin in Poročila.
3. V C:\Izdaje\Blagajna prekopirajte Wkl.Bootstrapper.exe, mapo tools iz paketa različice (z datoteko New-StarterMsi.ps1) pa v C:\Izdaje\Blagajna\tools.

Rezultat:

C:\Izdaje\Blagajna\
+- Wkl.Bootstrapper.exe
+- tools\New-StarterMsi.ps1
+- deploy\                      < izvorna mapa
   +- Blagajna.accde
   +- bin\Blagajna.Tiskalnik.dll
   +- bin\Blagajna.Tehtnica.dll
   +- Poročila\DnevniZakljucek.pdf

Pojasnilo: Bootstrapper Manager išče zaganjalnik v isti mapi kot projektno datoteko, ki jo boste ustvarili v 1. koraku, skript za paket MSI pa v mapi tools ob zaganjalniku. V praksi je izvorna mapa v skupni rabi, na primer \\server\Blagajna\deploy; za vadnico zadošča lokalna mapa.

Cilj: projektna datoteka C:\Izdaje\Blagajna\bootstrapper.json obstaja in je odprta v programu Bootstrapper Manager.

Postopek:

1. Na strani Projekti kliknite puščico ob ukazu Nov in izberite Prazen projekt.
2. V pogovornem oknu za novo projektno datoteko izberite mapo C:\Izdaje\Blagajna in obdržite predlagano ime bootstrapper.json.
3. Sporočilo z naslovom Nov navede, kaj morate še urediti (zaganjalnik ga izpiše v angleščini): preveriti izvorno mapo ter vnesti različico in cilj zagona. Zaprite ga z OK.

Rezultat: projekt Blagajna je na seznamu in je izbran. Oznako izdelka „Blagajna“ je Bootstrapper Manager prevzel iz imena mape.

Preverjanje: izberite Preveri. Odpre se stran Težave s sporočilom version needs either value or from. To je pričakovano, saj različico vnesete v naslednjem koraku.

Pojasnilo: predloga Aplikacija Access, ki jo ukaz Nov uporabi, če ne izberete druge, predpostavlja, da je v izvorni mapi datoteka app-manifest.json. To datoteko zapišeta WKL Office SDK in orodje za gradnjo WKL Forms Object Library. Za aplikacijo, ki ni nastala s tema orodjema, kot je blagajna v tem primeru, začnete s praznim projektom.

Cilj: v projektu so vneseni različica, izvorna mapa in ime aplikacije.

Postopek:

1. V navigaciji izberite Projekt > Splošno in vnesite:

   

   Polje	Vrednost	Zakaj
   (1) Različica	3.2.0	Različica blagajne. Zaganjalnik vsako različico namesti v lastno mapo in po številki prepozna novo različico
   (2) Izvorna mapa	C:\Izdaje\Blagajna\deploy	Mapa z datotekami aplikacije; v praksi mapa v skupni rabi, na primer \\server\Blagajna\deploy

   Polje Oznaka izdelka ostane Blagajna. Ostala polja pustite prazna; zanje veljajo privzete vrednosti zaganjalnika, med drugim namestitveno mesto %LOCALAPPDATA%\WKL\Blagajna v uporabnikovem profilu.

2. Izberite stran Videz in vnesite: Ime Blagajniški sistem, Založnik Zgled d.o.o., Besedilo med namestitvijo Še trenutek, blagajniški sistem se nastavlja in Jezik sl.

Rezultat: desno zgoraj se prikaže Ni shranjeno: spremembe so shranjene v programu Bootstrapper Manager, v projektno datoteko pa še niso zapisane.

Preverjanje: na strani Projekti izberite Predogled. Bootstrapper Manager shrani projekt in prikaže sliko okna, ki ga uporabnik vidi med namestitvijo, z imenom „Blagajniški sistem“ in založnikom „Zgled d.o.o.“.

Logotip je na sliki zato, ker je v primeru na drugih straneh priročnika vnesena še datoteka logo.png (polje Logotip); brez logotipa je to mesto prazno. Vrstica pod besedilom in vrstica napredka sta nadomestni prikaz zaganjalnika, ne podatek iz vašega projekta.

Pojasnilo – zakaj polna pot do izvorne mape: relativna pot, kot je deploy, se računa od mape zaganjalnika. Dokler je zaganjalnik v C:\Izdaje\Blagajna, takšna pot deluje. Po namestitvi s paketom MSI pa je zaganjalnik v C:\Program Files (x86)\WKL\Blagajna, kjer mape deploy ni. Pri projektu, ki ga razdeljujete s paketom MSI, zato vedno vnesite polno pot ali mapo v skupni rabi.

Pojasnilo – oznaka izdelka: po vrednosti polja Oznaka izdelka zaganjalnik poimenuje mapo aplikacije v uporabnikovem profilu in njen vnos med nameščenimi aplikacijami v sistemu Windows. Po prvi namestitvi je ne spreminjajte več, saj Windows aplikacijo z novo oznako obravnava kot novo aplikacijo. Uporabnik vidi ime iz polja Ime na strani Videz.

Cilj: projekt navaja vse, kar naj zaganjalnik namesti.

Postopek:

1. Izberite Namestitev > Datoteke.
2. Izberite Dodaj datoteke. Pogovorno okno se odpre v izvorni mapi; izberite Blagajna.accde.
3. Izberite Dodaj mapo in nato mapo bin.
4. Še enkrat izberite Dodaj mapo in nato mapo Poročila.

Datoteke in mape lahko na seznam povlečete tudi iz Raziskovalca.

Rezultat: seznam ima tri vrstice. Bootstrapper Manager je pri vsaki vnesel vir glede na izvorno mapo, za cilj pa isto podmapo pod [VersionDir]:

Preverjanje: drevo ciljev na levi prikazuje pod [VersionDir] podmapi bin in Poročila.

Pojasnilo: uporabnik dobi samo to, kar je na tem seznamu, tudi če je v izvorni mapi še kaj drugega. Pri mapi se namesti vsa njena vsebina. [VersionDir] je ograda: na uporabnikovem računalniku jo zaganjalnik nadomesti z mapo različice, %LOCALAPPDATA%\WKL\Blagajna\Frontends\3.2.0.

Cilj: predloge poročil so nameščene tam, kjer jih uporabnik najde, zaganjalnik pa namešča samo na računalnike z nameščenim Accessom.

Postopek:

1. Na strani Datoteke v vrstici Poročila spremenite stolpec Cilj v [Documents]\Blagajniški sistem\Poročila.
2. Izberite Namestitev > Pogoji in v zadnjo vrstico v stolpec Vrsta vnesite access. Stolpca Vrednost in Pričakovano pustite prazna.

Rezultat: drevo ciljev prikazuje Poročila pod [Documents], seznam pogojev pa ima vrstico z vrsto access:

Preverjanje: v 6. koraku s poskusnim zagonom, ki za vsak vnos prikaže dejansko pot.

Pojasnilo: mapa različice je namenjena aplikaciji. Ko izide različica 3.3.0, zaganjalnik ustvari novo mapo, stare različice pa postopoma odstrani. Datoteke, ki jih uporabnik odpira sam, zato sodijo v stalno mapo, kot je [Documents] (uporabnikova mapa Dokumenti). Pogoje zaganjalnik preveri pred vsako namestitvijo. Pogoj access brez vrednosti zahteva katero koli različico Accessa, z vrednostjo full pa polno različico Accessa namesto izvajalnega okolja. Če pogoj ni izpolnjen, zaganjalnik ničesar ne namesti in sporoči, kaj manjka.

Cilj: na uporabnikovem namizju je bližnjica, zaganjalnik pa na koncu odpre Blagajna.accde.

Postopek:

1. Izberite Namestitev > Bližnjice in v zadnjo vrstico vnesite: Mapa [Desktop], Ime Blagajniški sistem, Cilj [Starter].
2. Izberite Projekt > Cilj zagona in vnesite: Datoteka ali program [VersionDir]\Blagajna.accde, Access: /runtime auto.

Rezultat: seznam bližnjic ima eno vrstico, stran Cilj zagona pa navaja blagajno.

Pojasnilo: cilj bližnjice je [Starter] in ne Blagajna.accde. Samo pri zagonu prek zaganjalnika se preveri, ali je na voljo nova različica, in se ta namesti; bližnjica neposredno na datoteko bi uporabnika trajno pustila pri različici, ki jo je prejel ob prvi namestitvi. /runtime auto odpre datoteko ACCDE v izvajalnem okolju, torej brez pogleda načrta in brez Accessovega traku. Vnos v meniju Start ustvari paket MSI, bližnjico na namizju pa zaganjalnik ob prvem zagonu za vsakega uporabnika posebej.

Cilj: zaganjalnik projektno datoteko sprejme kot veljavno, zagon pa bi na tem računalniku uspel.

Postopek:

1. Pritisnite Ctrl+S. Spodaj desno se prikaže obvestilo „Shranjeno v bootstrapper.json“, oznaka Ni shranjeno pa izgine.
2. Na strani Projekti izberite Preveri.
3. Izberite Poskusni zagon.

Rezultat: ukaz Preveri spodaj desno prikaže obvestilo, da zaganjalnik ni našel nobene težave:

Sporočilo Poskusni zagon se začne z 0 Ok in navede načrt namestitve s potmi vašega uporabniškega računa:

0 Ok
version 3.2.0 (x86) into C:\Users\<račun>\AppData\Local\WKL\Blagajna\Frontends\3.2.0
1 file(s) into C:\Users\<račun>\AppData\Local\WKL\Blagajna\Frontends\3.2.0
  C:\Izdaje\Blagajna\deploy\Blagajna.accde -> C:\Users\<račun>\AppData\Local\WKL\Blagajna\Frontends\3.2.0\Blagajna.accde
2 file(s) into C:\Users\<račun>\AppData\Local\WKL\Blagajna\Frontends\3.2.0\bin
  ...
1 file(s) into C:\Users\<račun>\Documents\Blagajniški sistem\Poročila
  ...
shortcut C:\Users\<račun>\Desktop\Blagajniški sistem.lnk
start C:\Users\<račun>\AppData\Local\WKL\Blagajna\Frontends\3.2.0\Blagajna.accde

Preverjanje: načrt primerjajte s koraki od 3 do 5: trije vnosi, poročila v mapi Documents, bližnjica na namizju in zagon datoteke Blagajna.accde. Poskusni zagon na računalniku ničesar ne spremeni.

Če zaganjalnik javi težavo: ukaz Preveri odpre stran Težave z eno vrstico za vsako težavo, v besedilu zaganjalnika (v angleščini). Dvoklik na vrstico odpre ustrezno stran in označi polje ali vrstico, ki jo morate popraviti. Popravite vrednost, shranite in znova izberite Preveri. Če se sporočilo poskusnega zagona ne začne z 0, navaja kodo in vzrok, na primer nedosegljivo izvorno mapo; kode so opisane v dokumentu Kode napak zaganjalnika (dokumentacija WKL Bootstrapper). Podrobnosti: Preverjanje projekta in odpravljanje težav.

Cilj: paket Blagajna-1.0.0.msi obstaja, namestitev na preizkusnem računalniku pa da pričakovani rezultat.

Izdelava paketa:

1. Na strani Projekti izberite Ustvari MSI.

2. V pogovornem oknu potrdite predlagano različico paketa 1.0.0 z OK.

   Različica paketa ni različica blagajne: označuje zaporedne pakete, ki jih namesti oddelek IT, in se začne z 1.0.0.

Rezultat: po nekaj sekundah sporočilo navede izdelani paket:

Preverjanje vsebine (brez namestitve in brez skrbniških pravic):

msiexec /a C:\Izdaje\Blagajna\Blagajna-1.0.0.msi /qn TARGETDIR=C:\Izdaje\msi-vsebina

V mapi C:\Izdaje\msi-vsebina\PFiles\WKL\Blagajna sta natanko Wkl.Bootstrapper.exe in bootstrapper.json. Aplikacije v paketu ni; zaganjalnik jo ob zagonu prekopira iz izvorne mape.

Preizkusna namestitev:

1. Poskrbite, da je izvorna mapa dosegljiva s preizkusnega računalnika. Za vadnico prekopirajte C:\Izdaje\Blagajna\deploy na isto mesto na preizkusnem računalniku; v praksi je to mapa v skupni rabi.

2. Paket namestite kot skrbnik:

   msiexec /i Blagajna-1.0.0.msi

3. Prijavite se kot običajen uporabnik in v meniju Start zaženite Blagajniški sistem.

Rezultat: za hip se prikaže okno zaganjalnika z besedilom „Še trenutek, blagajniški sistem se nastavlja“, nato Access odpre blagajno.

Preverjanje:

Med nameščenimi aplikacijami sta nato dva vnosa z imenom „Blagajniški sistem“: paket MSI (zaganjalnik za vse uporabnike, različica 1.0.0) in aplikacija v profilu tega uporabnika (različica 3.2.0). Kaj odstrani posamezni vnos, opisuje Uvajanje zaganjalnika s paketom MSI (dokumentacija WKL Bootstrapper).

Odstranitev preizkusne namestitve: kot uporabnik najprej odstranite vnos z različico 3.2.0; zaganjalnik pri tem odstrani aplikacijo, predloge poročil, bližnjico in vnos. Dnevnik v mapi Logs ostane. Nato kot skrbnik odstranite še paket MSI (msiexec /x Blagajna-1.0.0.msi).

• Nova različica blagajne: v tej vadnici je različica zapisana v projektni datoteki (polje Različica). Za različico 3.3.0 postavite novo datoteko Blagajna.accde v izvorno mapo, vnesete 3.3.0 in izdelate nov paket MSI z višjo različico paketa, na primer 1.1.0, saj računalniki projektno datoteko prejmejo s paketom. Brez novega paketa pride nova različica do uporabnikov, če zaganjalnik številko različice prebere iz izvorne mape: WKL Office SDK in orodje za gradnjo WKL Forms Object Library ob aplikaciji zapišeta datoteko app-manifest.json, projekt pa jo navaja v polju Različica iz datoteke. Tako projekt nastavi predloga Aplikacija Access. V tem primeru zadošča, da zamenjate vsebino izvorne mape; glejte Nastavitev izdelka, različice, videza in cilja zagona.
• Aplikacija iz WKL Office SDK: če aplikacijo gradite z SDK, ukaz wkl-office deliver pripravi izvorno mapo z manifestom in projektno datoteko zaganjalnika, SDK pa nato s to datoteko odpre Bootstrapper Manager. Glejte Priprava izdaje aplikacije z WKL Office SDK (dokumentacija WKL Office SDK).
• Paket za oddelek IT: kako paket podpišete in razdelite, opisuje Uvajanje zaganjalnika s paketom MSI (dokumentacija WKL Bootstrapper).
• Drugi vnosi, na primer vrednosti registra ali vrste datotek: Nastavitev bližnjic, vrednosti registra in drugih vnosov.

• Katere datoteke se namestijo in kam
• Preizkus projekta in izdelava paketa MSI
• Projektna datoteka (format 2) (dokumentacija WKL Bootstrapper) – vsa polja projektne datoteke