Namestitev izdanega paketa

Izdajo WKL Forms Object Library namestite na razvijalski računalnik, tako da se kontrolniki prikažejo v Accessovem pogovornem oknu Kontrolniki ActiveX in jih pozna VBA – brez izvorne kode in brez kakršne koli gradnje.

Zahteva Windows 10 ali 11 in Microsoft 365 Access ali Access Runtime.

• Izvajalno okolje: namestite .NET 10 Desktop Runtime v bitni različici Officea.
• Datoteke: mapo izdaje za bitno različico Officea (x86 za 32-bitni Office, x64 za 64-bitni Office) kopirajte v lokalno mapo, ki ostane na svojem mestu.
• Registracija: Wkl.Forms.ObjectLibrary.dll iz te mape registrirajte z regsvr32 iste bitne različice, za trenutnega uporabnika sistema Windows (/n /i:user, brez skrbniških pravic).
• Preverjanje: v urejevalniku VBA se prikaže sklic WKL Forms x.y Object Library izdaje.

Podprta konfiguracija: 32- in 64-bitni Access (Microsoft 365 Access in Access Runtime); paket vsebuje datoteke za obe različici.

1. Ugotovite bitno različico Officea. WKL sledi programu Microsoft Access, ne sistemu Windows: z 64-bitnim Accessom uporabite datoteke x64, z 32-bitnim Accessom pa datoteke x86. V Accessu: Datoteka › Račun › Vizitka programa Access pokaže „32-bitno“ ali „64-bitno“. Bitna različica sistema Windows ni pomembna: 32-bitni Office v 64-bitnem sistemu Windows potrebuje 32-bitne datoteke (x86). Microsoft Office privzeto namesti kot 64-bitnega; 32-bitni Office ostaja razširjen tam, kjer se uporabljajo starejše rešitve VBA, kontrolniki ActiveX ali dodatki, zato sta zgrajeni obe bitni različici. Neujemanje se pokaže kot manjkajoči kontrolniki ali sklic, označen kot MISSING (odpravljanje težav).
2. Namestite .NET 10 Desktop Runtime te bitne različice s strani https://dotnet.microsoft.com/download/dotnet/10.0 (stolpec „Desktop Runtime“, x86 za 32-bitni Office, x64 za 64-bitni Office). Izvajalno okolje druge bitne različice ne pomaga.

3. Kopirajte datoteke. Izdaja vsebuje mapi x86 in x64 s kontrolniki, tools\build (orodje za gradnjo, glejte Gradnja aplikacije Access iz besedilnih izvornih datotek), control-blocks (gradniki vseh kontrolnikov WKL, glejte Vstavljanje kontrolnikov WKL v obrazce s kodo), CHANGELOG.md in addin s tools\install-addin.ps1, dodatkom WKL Extensions z oblikovalniki v meniju Orodja zbirke podatkov › Dodatki (tools\install-addin.ps1 zaženite enkrat za vsakega uporabnika sistema Windows, ko je Access zaprt). Celoten paket izdaje kopirajte v lokalno mapo, ki ostane na svojem mestu, na primer %LOCALAPPDATA%\WKL\Access Components\<version>, tako da ostanejo tools, control-blocks in themes skupaj s kontrolniki in jih projektne datoteke navajajo z enega mesta. Datoteke mape bitne različice sodijo skupaj; registracija kaže na %LOCALAPPDATA%\WKL\Access Components\<version>\x86:

   Datoteka	Namen
   Wkl.Forms.ObjectLibrary.dll	Datoteka, ki jo registrirate: izvorni zagonski modul s knjižnico tipov
   Wkl.Forms.ObjectLibrary.Managed.dll, .deps.json, .runtimeconfig.json	Kontrolniki na .NET 10, ki jih zagonski modul naloži iz iste mape
   Wkl.Forms.ObjectLibrary.Core.dll	Logika kontrolnikov brez COM
   Wkl.Office.Json.Core.dll	Mehanizem JSON za JPath in AsJSON
   *.pdb, *.xml	Simboli za razhroščevanje in datoteke dokumentacije; za izvajanje niso potrebni in jih lahko izpustite

4. Zaprite vse primerke Accessa (Access naloženo DLL obdrži, dokler se ne konča), nato registrirajte za trenutnega uporabnika sistema Windows. Za 32-bitni Office:

   %windir%\SysWOW64\regsvr32.exe /n /i:user "%LOCALAPPDATA%\WKL\Access Components\<version>\x86\Wkl.Forms.ObjectLibrary.dll"

   Za 64-bitni Office:

   %windir%\System32\regsvr32.exe /n /i:user "%LOCALAPPDATA%\WKL\Access Components\<version>\x64\Wkl.Forms.ObjectLibrary.dll"

   regsvr32 uspeh sporoči v polju s sporočilom; v skriptih ga preprečite z /s (izhodna koda je tedaj ob uspehu 0). Registracija izdaje za tega uporabnika odstrani registracije vseh drugih različic knjižnice, zato podatkovna zbirka nikoli ne izbere starejše kopije.

5. Preverjanje. Odprite podatkovno zbirko, odprite urejevalnik VBA (Alt+F11), izberite Orodja › Sklici in poiščite WKL Forms <version> Object Library (različica izdaje). Obrazec v pogledu načrta zdaj ponuja kontrolnike v Načrt obrazca › Kontrolniki › Kontrolniki ActiveX („WKL Grid“, „WKL TreeView“ …). Access sklic WKL Forms x.y Object Library nastavi sam, ko vstavite kontrolnik; ta zagotavlja IntelliSense in konstante (wke…, wso…, wdz… in tako naprej). WklToast in WklLinkManager sta objekta, ne kontrolnika: sklic nastavite v urejevalniku VBA (Orodja › Sklici › WKL Forms x.y Object Library) in ju ustvarite z New.

Registracijo odstranite tako, da zaprete Access in isti ukaz zaženete z /u:

%windir%\SysWOW64\regsvr32.exe /u /n /i:user "%LOCALAPPDATA%\WKL\Access Components\<version>\x86\Wkl.Forms.ObjectLibrary.dll"

Novejšo izdajo namestite tako, da zaprete Access, izdajo kopirate v lastno mapo in jo registrirate kot v 4. koraku; nato izbrišite staro mapo.

• Za posameznega uporabnika sistema Windows. /n /i:user piše samo v HKEY_CURRENT_USER. Vsak uporabnik sistema Windows na računalniku, ki odpre podatkovno zbirko, se enkrat registrira zase. Registracija za vse uporabnike računalnika (regsvr32 brez /n /i:user, kot skrbnik) v tej izdaji ni podprta.
• Mapa mora ostati. Če mapo premaknete ali izbrišete, se registracija pokvari: kontrolnikov ni v pogovornem oknu, sklic pa je označen kot MISSING. Registrirajte znova z novega mesta.
• Kako je videti registracija. Razred (ProgID-ji WklForms.* in njihovi ID-ji razredov) je v vseh izdajah enak, zato podatkovna zbirka, zgrajena s starejšo izdajo, najde novejšo. Knjižnica tipov ima različico izdaje, x.y; Windows jo kot ime ključa zapiše šestnajstiško pod HKEY_CURRENT_USER\Software\Classes\TypeLib\{A37D549E-FCD0-48EC-8B14-C7323B747E4F}, zato je izdaja 1.56 ključ 1.38 (0x38 = 56) z imenom „WKL Access Components 1.56“ kot vrednostjo, 0\win32 in 0\win64 pa navajata DLL vsake bitne različice. Urejevalnik VBA prikazuje desetiško ime. Podatkovna zbirka se na knjižnico tipov veže po njenem ID-ju in ob odpiranju razreši različico, ki je registrirana (glejte Različice).
• Brez lastnega namestitvenega programa. Namestite z zgornjimi koraki ali s skriptom z njimi (Uvajanje aplikacije s kontrolniki WKL v računalnike uporabnikov) ali pa komponente namestite skupaj z aplikacijo prek WKL Bootstrapper, ki jih registrira za vsakega uporabnika.
• Druga različica .NET v Accessu. Izvorni zagonski modul v MSACCESS.EXE naloži izvajalno okolje .NET 10. Proces lahko izvaja samo eno različico .NET (CoreCLR): če je drug dodatek v Access prej naložil drugo različico, se kontrolniki ne morejo zagnati, zagonski modul pa to sporoči v sporočilu, namesto da bi motil Access; glejte Access sporoča, da je naložena druga različica .NET.

• Uvajanje aplikacije s kontrolniki WKL v računalnike uporabnikov
• Kaj zapiše registracija za posameznega uporabnika – za preverjanje računalnika po registraciji ali odstranitvi registracije
• Okolje .NET 10 Desktop Runtime ni nameščeno
• Kontrolnik WKL ali sklic manjka (napačna bitna različica)
• CHANGELOG.md v paketu izdaje – kaj vsebuje posamezna izdaja