Nastavitev in zagon programa Bootstrapper Manager

Bootstrapper Manager je ena sama datoteka Access, Wkl.Bootstrapper.Manager.accdb. Je del WKL Office SDK in ga namesti namestitveni program SDK. Deluje v 32- in 64-bitnem Accessu iz paketa Microsoft 365. Pred prvo uporabo dodate njegovo mapo med zaupanja vredna mesta in poskrbite, da Bootstrapper Manager najde zaganjalnik; nato datoteko odprete. Za urejanje in shranjevanje zaganjalnik ni potreben, za vse druge ukaze pa.

• Microsoft Access iz paketa Microsoft 365, 32- ali 64-bitna različica.
• WKL Office SDK (do različice 0.4.1 se je imenoval WKL Access SDK), nameščen, kot opisuje Namestitev WKL Office SDK (dokumentacija WKL Office SDK).
• WKL Forms Object Library 2.0 ali novejša in WKL Office JSON 2.0 ali novejša, registrirani za 32- ali 64-bitno različico, ki ustreza nameščenemu Accessu.
• Zaganjalnik Wkl.Bootstrapper.exe iz paketa različice WKL Bootstrapper.

Postopek:

1. Poiščite datoteko. Namestitveni program SDK shrani Wkl.Bootstrapper.Manager.accdb v mapo %LOCALAPPDATA%\Programs\WKL\Bootstrapper Manager\<različica>. Na tem mestu ga išče tudi SDK (glejte Zagon iz WKL Office SDK).
2. Dodajte zaupanja vredno mesto. Strani programa Bootstrapper Manager delujejo s kodo VBA. Če Access mapi ne zaupa, kodo blokira in strani ostanejo prazne. V Accessu izberite Datoteka > Možnosti > Center zaupanja > Nastavitve centra zaupanja > Zaupanja vredna mesta > Dodaj novo mesto. Dodajte mapo %LOCALAPPDATA%\Programs\WKL\Bootstrapper Manager in označite potrditveno polje, s katerim zaupate tudi njenim podmapam. Vnos tako velja tudi za vsako novo različico, ki jo namestitveni program SDK namesti v lastno podmapo. Do različice 1.x se je mapa imenovala Starter Configurator; vnos za to prejšnjo mapo ne velja za različico 2.0, zato dodajte še novo mapo.

3. Poskrbite, da Bootstrapper Manager najde zaganjalnik. Bootstrapper Manager uporabi zaganjalnik s prvega mesta v spodnji tabeli, ki je nastavljeno:

   Vrstni red	Mesto	Kdaj se uporablja
   1	Zaganjalnik, podan ob zagonu (starter=, glejte spodaj)	Ko Bootstrapper Manager zažene drug program
   2	Nastavitev StarterPath v tabeli ConfiguratorSetting	En zaganjalnik na stalnem mestu za vse projekte
   3	Wkl.Bootstrapper.exe v mapi projektne datoteke, sicer tam Wkl.Access.Bootstrapper.exe (ime do WKL Bootstrapper 2.4.1)	Običajni primer: projektna datoteka in zaganjalnik sta v isti mapi, tako kot po namestitvi
   4	Samo pri ukazu Nov: mapa izbranega projekta; samo pri ukazu Prevzemi: mapa datoteke StarterPro.config.xml	Nova projektna datoteka nastane v mapi, v kateri zaganjalnika še ni

   Če na nastavljenem mestu datoteke ni (na primer ker StarterPath kaže na staro pot), Bootstrapper Manager ne išče naprej, ukazi pa javijo, da zaganjalnika ni mogoče najti. Običajno vam ni treba nastaviti ničesar. Če želite nastaviti StarterPath, s tipko F11 odprite podokno za krmarjenje, odprite tabelo ConfiguratorSetting in dodajte vrstico, v kateri je Key StarterPath, Value pa celotna pot do zaganjalnika.

   Zaganjalnik iz 3. ali 4. vrstice je v mapi projektne datoteke, projektna datoteka pa lahko izvira od kjer koli. Ko ukaz, kot so Preveri, Predogled, Poskusni zagon, Ustvari MSI, Nov, Prevzemi ali Uvozi, prvič potrebuje takšen zaganjalnik, Bootstrapper Manager prikaže njegovo celotno pot in vpraša, ali mapi zaupate. Če kliknete Da, se zaganjalnik zažene, mapa pa na tem računalniku velja za potrjeno, zato se zaganjalniki iz nje pozneje zaženejo brez vprašanja. Če kliknete Ne (privzeti gumb), se ne zažene nič: ukaz javi, da zaganjalnik ni bil potrjen, naslednji ukaz pa vpraša znova. Zaganjalnik iz

   1. ali 2. vrstice se zažene brez vprašanja. Če želite potrditev preklicati, v tabeli ConfiguratorSetting izbrišite vrstico, v kateri se Key začne s ConfirmedStarter, Value pa je ta mapa. Shranjevanje nikoli ne vpraša: projekt prek zaganjalnika preveri le, če je zaganjalnik naveden ali je njegova mapa potrjena, sicer shrani brez tega preverjanja.
4. Odprite Bootstrapper Manager. Dvokliknite Wkl.Bootstrapper.Manager.accdb.

Rezultat: Bootstrapper Manager prikaže seznam projektov (Projekti). Ob prvem zagonu je seznam prazen, podnaslov pa se glasi „Projekta še ni – Nov ustvari projektno datoteko, Odpri prebere obstoječo.“ Če projekti že obstajajo, je izbran tisti, ki ste ga nazadnje prebrali ali shranili, strani v skupinah Projekt in Namestitev pa so na voljo.

Preverjanje: navigacija na levi prikazuje Projekti, Težave ter skupini Projekt in Namestitev. Če strani ostanejo prazne ali Access sporoči, da je vsebina onemogočena, manjka zaupanja vredno mesto iz 2. koraka; glejte Odpravljanje težav.

Bližnjica ali drug program, na primer orodje za gradnjo, lahko projektno datoteko odpre neposredno in pri tem določi, kateri zaganjalnik naj Bootstrapper Manager uporabi:

msaccess.exe "<mapa>\Wkl.Bootstrapper.Manager.accdb" /cmd "project=<projektna datoteka>|starter=<mapa>\Wkl.Bootstrapper.exe"

Bootstrapper Manager se odpre na strani Splošno navedenega projekta; neshranjene spremembe projekta se pri tem ohranijo. Vse argumente in njihovo delovanje določa „Command line of WKL Bootstrapper Manager“ (tehnična specifikacija v angleščini).

Ko WKL Office SDK pripravi izdajo aplikacije (wkl-office deliver), za vsak cilj zapiše projektno datoteko zaganjalnika, delivery\<način>.bootstrapper.json. Ukaz dodatka SDK Izdaja > Zaganjalnik > Nastavi v programu WKL Bootstrapper Manager odpre to datoteko v programu Bootstrapper Manager, skupaj z zaganjalnikom izdaje, na zgoraj opisani način. V programu Bootstrapper Manager nastavite izvorno mapo, prikazno ime in bližnjice ter shranite; SDK jih uporabi pri naslednji izdaji.

SDK uporabi Bootstrapper Manager s prvega od teh mest, na katerem obstaja:

Če WKL_BOOTSTRAPPER_MANAGER navaja datoteko v drugi mapi, dodajte med zaupanja vredna mesta tudi to mapo (2. korak). Celoten postopek opisuje Priprava izdaje aplikacije z WKL Office SDK (dokumentacija WKL Office SDK).

• Brez traku: Bootstrapper Manager skrije Accessov trak. Delate prek navigacije na levi in ukazov na vrhu vsake strani, Bootstrapper Manager pa zaprete z gumbom Zapri (X) v oknu. Če med odpiranjem datoteke držite tipko Shift, Access preskoči nastavitve zagona ter prikaže trak in podokno za krmarjenje. Ta način je namenjen razvijalcem.
• ACCDB namesto ACCDE: datoteka Wkl.Bootstrapper.Manager.accdb vsebuje kodo VBA brez shranjenega prevoda. Access jo ob odpiranju prevede za svojo 32- ali 64-bitno različico, zato ista datoteka deluje v obeh. Datoteka ACCDE bi delovala samo v različici, v kateri je bila izdelana.
• Več računalnikov: seznam projektov in neshranjene spremembe so shranjeni v sami datoteki Wkl.Bootstrapper.Manager.accdb. Kopija na drugem računalniku se zato začne s praznim seznamom; projektne datoteke ostanejo nespremenjene.
• Nova različica programa Bootstrapper Manager: iz istega razloga se tudi nova datoteka Wkl.Bootstrapper.Manager.accdb začne s praznim seznamom; namestitveni program SDK jo namesti v lastno podmapo. Preden preidete na novo različico, shranite vse projekte (Bootstrapper Manager vas ob zapiranju opozori na neshranjene spremembe), nato pa projektne datoteke znova odprite v novi različici.
• StarterPath velja samo za vaš računalnik: datoteke Wkl.Bootstrapper.Manager.accdb z nastavljenim StarterPath ne posredujte drugim.

• Navigacija, ukazi in tipkovnica
• Odpravljanje težav
• Razdeljevanje aplikacije uporabnikom z zaganjalnikom (dokumentacija WKL Bootstrapper) – od izdaje v skupni rabi do zagona pri uporabniku