Namestitev WKL Office SDK

WKL Office SDK namestite na razvijalski računalnik ali na računalnik za gradnjo, da lahko na njem uporabljate wkl-office in dotnet build za datoteke .acproj.

Zahteve: Windows 11, 32- ali 64-bitni Access iz paketa Microsoft 365, nameščen za uporabnika, ki gradi, git na poti PATH in izvajalno okolje .NET 10 (dotnet --list-runtimes navede Microsoft.NETCore.App 10.x). Za dotnet build potrebujete .NET 10 SDK. Dodatek za Access teče znotraj programa Access, zato potrebuje izvajalno okolje .NET 10 Desktop Runtime v isti 32- ali 64-bitni različici kot Office (Microsoft.WindowsDesktop.App 10.x). Za 32-bitni Office je to različica x86, ki jo navede C:\Program Files (x86)\dotnet\dotnet.exe --list-runtimes.

Podprta konfiguracija te izdaje: Windows 11 z 32- ali 64-bitnim programom Access iz paketa Microsoft 365. Access 2016, 2019 in 2021, Windows 10 in računalnik za gradnjo samo z izvajalnim okoljem Access Runtime niso podprti.

SDK je ena mapa. V podmapi bin je wkl-office.exe, v msbuild so opravila MSBuild in njihovi cilji, v addin razvijalski dodatek za Access v 32- in 64-bitni različici, v bootstrapper-manager program WKL Bootstrapper Manager, s katerim nastavite zaganjalnik za izdajo, v docs/public pa ta dokumentacija. Datoteki SECURITY.sl.md in MANUFACTURER.sl.md (tudi v angleščini in nemščini) pojasnjujeta, kako prijavite ranljivost, kdo je proizvajalec in do kdaj je izdaja podprta; sbom.cdx.json je kosovnica programske opreme paketa (CycloneDX 1.6). Kopiranje mape ničesar ne registrira in ne zahteva pravic skrbnika. Dodatek se registrira le, kadar to zahtevate, in samo za trenutnega uporabnika. Orodje upravlja nameščeni Access od zunaj, kot ločen proces, zato ista mapa deluje z 32- in 64-bitnim sistemom Office.

1. Mapo paketa kopirajte na poljubno mesto, na primer v C:\Tools\WklOfficeSdk.

2. Njeno podmapo bin dodajte na pot PATH svojega uporabnika:

   $bin = 'C:\Tools\WklOfficeSdk\bin'
   [Environment]::SetEnvironmentVariable('Path', [Environment]::GetEnvironmentVariable('Path', 'User') + ';' + $bin, 'User')

3. Odprite nov terminal in preverite, ali računalnik ustreza projektu:

   wkl-office check C:\Work\Stranke\Stranke.acproj

   check navede najdeni Access in njegovo 32- ali 64-bitno različico ter vsak manjkajoči sklic ali gonilnik ODBC.

4. Za dotnet build na koncu projektne datoteke uvozite cilje SDK:

     <Import Project="C:\Tools\WklOfficeSdk\msbuild\Wkl.Office.Sdk.targets" />
   </Project>

5. Za zavihek traku in delovno območje v programu Access registrirajte dodatek, ko je Access zaprt (glejte Uporaba dodatka za Access):

   wkl-office addin install

   Ob naslednjem zagonu programa Access je na traku zavihek WKL SDK:

   

   *Zavihek WKL SDK s skupinami od 1 do 6; kaj vsebujejo, opisuje stran Uporaba dodatka za Access.*

   Isti ukaz za vašega uporabnika namesti tudi program Bootstrapper Manager v %LOCALAPPDATA%\Programs\WKL\Bootstrapper Manager\<version> in sporoči, ali ga je kopiral ali pa je bila ta različica že nameščena. Bootstrapper Manager potrebuje WKL Forms Object Library 2.0 ali novejšo različico in WKL Office JSON 2.0 ali novejšo različico, registrirani za vašega uporabnika; s starejšimi komponentami namesto besedil prikaže [key].

   Poleg tega projektne datoteke poveže z SDK: dvoklik na datoteko .acproj v Raziskovalcu odpre aplikacijo v programu Access za razvoj, ne da bi se zagnal njen zagonski obrazec ali makro AutoExec, in jo najprej zgradi, če podatkovne zbirke še ni (`open`). Dvoklik na datoteko .accdb aplikacijo še naprej zažene tako, kot jo vidijo njeni uporabniki. Meni projektne datoteke ima nato podmeni „WKL Office SDK“ (v sistemu Windows 11 pod „Pokaži več možnosti“). Ob prvem dvokliku vas Windows enkrat vpraša, s katero aplikacijo naj odpira datoteke .acproj: izberite „WKL Office SDK“ in „Vedno“.

• Preverjanje paketa. Vsaka programska datoteka paketa (EXE in DLL) ima podpis Authenticode podjetja EMSR DATA, D.O.O. s časovnim žigom, SHA256SUMS pa navaja kontrolno vsoto SHA-256 vsake datoteke paketa razen same sebe. Preden mapo dodate v PATH, preverite oboje:

  Get-AuthenticodeSignature C:\Tools\WklOfficeSdk\bin\wkl-office.exe | Format-List Status, SignerCertificate
  Set-Location C:\Tools\WklOfficeSdk
  Get-Content SHA256SUMS | ForEach-Object { $hash, $file = $_ -split '  ', 2; if ((Get-FileHash -LiteralPath $file).Hash -ne $hash) { "changed: $file" } }

  Status mora biti Valid, podpisnik pa EMSR DATA, D.O.O.; drugi ukaz ne izpiše ničesar, kadar nobena datoteka ni spremenjena.

• Kaj SDK izvaja na vašem računalniku. Gradnja izvaja kodo VBA iz izvornih datotek: zaključna funkcija projekta (Finish) in funkcije modelov WKL tečejo v Accessu, ki gradi. Kdor lahko spreminja izvorne datoteke, lahko torej izvaja kodo na računalniku, ki jih gradi: gradite samo izvorne datoteke, ki jim zaupate, gradbeni agent pa naj gradi samo pregledane veje. Podatkovno zbirko, ki jo SDK odpre sam (izvoz, validate, call, test), odpre kot kopijo brez zagonskega obrazca, podatkovno zbirko z makrom AutoExec pa zavrne. Programe git, svn, Visual Studio Code in PowerShell najde prek poti PATH uporabnika; kdor lahko spremeni PATH, določa, kateri program se zažene, kot pri vsakem orodju ukazne vrstice.
• Računalniki za gradnjo. Access mora biti nameščen in aktiviran za račun, s katerim teče gradnja. Gradnja potrebuje namizno sejo tega računa, ker Access ne teče kot storitev: agent za gradnjo mora teči kot interaktivni proces prijavljenega uporabnika. Sklici aplikacije (WKL Forms Object Library, WKL Office JSON …) morajo biti za ta račun registrirani v isti 32- ali 64-bitni različici kot Access. Moduli pridejo v Access v kodni strani ANSI sistema Windows (nastavitev jezika za programe, ki ne podpirajo Unicode), zato mora ta kodna stran vsebovati vse znake, ki so v modulih. Če se gradnja z nastavitvijo ConnectionProfile poveže z viri podatkov, potrebuje gonilnike, omrežni dostop in prijavo brez poziva. Postopka za upravljanje agentov za gradnjo (samodejna prijava, zaklenjen zaslon, nadzor) SDK ne vsebuje; to uredite z običajnimi sredstvi svojega sistema za gradnjo.
• Posodobitev. Mapo zamenjajte z novo; projekti ostanejo nespremenjeni, ker noben projekt ne navaja različice SDK. Če je dodatek registriran, najprej zaprite Access, saj ima datoteke dodatka med delom odprte. Če novo izdajo namestite v ločeno mapo (na primer v mapo za vsako različico), vnos na poti PATH preusmerite na njeno podmapo bin in stari vnos odstranite, sicer novi terminali še naprej zaganjajo staro različico. Katero datoteko wkl-office.exe terminal zažene, pokaže (Get-Command wkl-office).Source. Ukaz wkl-office addin install novejšo različico programa Bootstrapper Manager namesti v ločeno mapo poleg prejšnje in nameščene različice nikoli ne prepiše, ker Access v tej datoteki shranjuje vaše spremembe. SDK odpre najvišjo nameščeno različico. Enkrat izvedite wkl-office addin install iz nove različice; tako dodatek in dvoklik na projektne datoteke uporabljata novo mapo.
• Prehod z WKL Access SDK (0.4 in starejše). Od različice 0.5 se SDK imenuje WKL Office SDK, njegov ukaz pa wkl-office; datoteke wkl-access.exe ni več. Skripte, .vscode\tasks.json in definicije gradnje, ki kličejo wkl-access, preklopite na wkl-office, uvoz Wkl.Access.Sdk.targets pa zamenjajte z Wkl.Office.Sdk.targets. Projekti, ukazi, možnosti in izhodne kode ostanejo enaki. Enkrat izvedite wkl-office addin install, da se dodatek registrira iz nove mape.
• Odstranitev. Če je bil dodatek registriran, izvedite wkl-office addin remove --all: odstrani dodatek in nastavitve SDK za vašega uporabnika (HKEY_CURRENT_USER\Software\The White Knight Labs\Access Framework\Sdk); brez --all nastavitve ostanejo za poznejšo namestitev. Nato izbrišite mapo in njen vnos na poti PATH. wkl-office addin remove programa Bootstrapper Manager ne odstrani; če ga ne potrebujete, izbrišite mapo %LOCALAPPDATA%\Programs\WKL\Bootstrapper Manager (različica pred 2.0 je v mapi %LOCALAPPDATA%\Programs\WKL\Starter Configurator).

• Vadnica: aplikacija Access pod nadzorom različic
• Gradnja z dotnet build
• Referenčni priročnik ukazne vrstice