Projekt aus Vorlagen erstellen
Beginnen Sie eine neue Projektdatei mit den Einträgen, die eine Access-Anwendung, die WKL-Komponenten, ein ODBC-Treiber, WKL Office JSON oder eine private .NET-Runtime brauchen, statt sie von Hand zu schreiben.
Voraussetzungen: WKL Bootstrapper 2.0.
Lösungsüberblick
/new-project <file> /template <names> schreibt eine Projektdatei im Format 2 aus einer oder mehreren Vorlagen und gibt
aus, was noch zu tun ist. Die Vorlagen füllen gewöhnliche Einträge aus – Dateien, Werte in der Registrierungsdatenbank,
Bedingungen, den Start –, die sich danach wie jeder andere Eintrag ändern lassen.
| Vorlage | Fügt hinzu |
|---|---|
access | Die Anwendungsdatei, die app-manifest.json des Build-Werkzeugs der WKL Forms Object Library nennt, kopiert nach [VersionDir]; die Version aus diesem Manifest; den Start der Datenbank, mit /runtime, wie das Manifest es angibt (start.runtime auto); die Bedingung Microsoft Access. |
components | WKL Forms Object Library aus components\x86 und components\x64 der Auslieferung, je Release nach [WklRoot]\Components\<release>\<bitness> kopiert und für den Benutzer registriert (registerCom); die Bedingung .NET 10 Desktop Runtime (Microsoft.WindowsDesktop.App 10.0), sofern nicht auch dotnet gewählt ist. |
odbc | Einen Beispiel-ODBC-Treiber (Wkl OData aus odbc\Wkl OData, DLL Wkl.Data.OData.Odbc.dll), je Release nach [WklRoot]\Drivers\<driver>\<release>\<bitness> kopiert, und eine Datenquelle des Benutzers (WklGateway), deren Driver der Pfad der kopierten DLL ist, in der Ansicht der Registrierungsdatenbank jeder Bitbreite. Ersetzen Sie ihn durch den ausgelieferten Treiber. |
json | WKL Office JSON aus json\x86 und json\x64 der Auslieferung, je Release nach [WklRoot]\Json\<release>\<bitness> kopiert und für den Benutzer registriert. Die Vorlage nennt Wkl.Office.JSON.dll; der Starter findet auch Wkl.Access.JSON.dll der Releases bis 1.0.3 (damals WKL Access JSON). |
dotnet | Eine private .NET-Runtime aus dotnet\x86 und dotnet\x64, je Release nach [WklRoot]\Dotnet\<release>\<bitness> kopiert, und die Variablen DOTNET_ROOT(x86) und DOTNET_ROOT für das gestartete Programm; siehe Private .NET-Runtime ausliefern. |
<release> ist die Produktversion der Hauptdatei des Eintrags ohne Build-Kennung. Jeder Eintrag mit einer Bitbreite wird
nur für die Bitbreite des Projekts installiert.
Umsetzung
- Legen Sie den Ordner an, aus dem der Starter laufen wird, benannt nach dem Produkt – der Produktschlüssel wird aus dem Namen des Ordners der Datei gebildet (Buchstaben, Ziffern,
.,-,_;Product, wenn nichts übrig bleibt). Schreiben Sie das Projekt:
Wkl.Bootstrapper.exe /new-project Kunden\bootstrapper.json /template access,components,odbc
Die Ausgabe nennt die Datei und die verbleibenden Schritte, je einen pro Zeile:
```text …\Kunden\bootstrapper.json written.
- source: 'deploy' beside the starter; set the delivery folder (a share such as \server\apps\Kunden) when it lies elsewhere.
- access: the delivery folder needs the application and its app-manifest.json (build tool of WKL Forms Object Library, target deploy).
- components: copy the folders x86 and x64 of the release package into 'components' of the delivery folder.
odbc: replace the example driver 'Wkl OData' (folder, DLL, data source 'WklGateway') with the delivered one. ```
Eine Zeile, die mit
!beginnt, nennt eine Regel, die die geschriebene Datei noch verletzt, zum Beispiel eine fehlende Version, wennaccessnicht gewählt ist.
- Arbeiten Sie die Zeilen ab: Setzen Sie
source, legen Sie die genannten Ordner in die Auslieferung, ersetzen Sie den Beispieltreiber. - Prüfen Sie das Ergebnis mit
Wkl.Bootstrapper.exe /check Kunden\bootstrapper.json.
Hinweise
sourceistdeploy, ein Ordner neben dem Starter, bis es gesetzt wird.- Ohne
accessstartet das Projekt noch nichts: Setzen Sieversion(valueoderfrom) undstart.file; siehe Beliebiges Programm mit dem Starter starten. - Ohne Vorlage entsteht ein Projekt nur mit dem Produktschlüssel und der Quelle.
- Vorlagennamen werden durch Kommas getrennt und dürfen in beliebiger Reihenfolge und Schreibweise (groß oder klein) angegeben werden.
- Eine vorhandene Datei wird nie überschrieben.
/jsongibt statt der Zeilen ein Objekt mitwritten,notesundproblemsaus, jedes Zeichen außerhalb von ASCII maskiert.- Exitcodes: 0 geschrieben; 10 keine Datei genannt; 11 eine unbekannte Vorlage, oder die Datei existiert.
componentsundjsonbrauchen eineregistration.jsonneben jedem COM-Server der Auslieferung; das Release-Paket der WKL Forms Object Library bringt sie ab 1.57 mit.- Wählen Sie
componentsnur, wenn die Auslieferung die Komponenten mitbringt: Seine Einträge kopieren sie aus der Auslieferung, sodass eine Auslieferung ohnecomponents\x86undcomponents\x64mit Code 12 endet, selbst wenn auf dem Computer ein ausreichendes Release registriert ist. Hat der Computer sie bereits (von der IT installiert oder für jede Anwendung von einer Stelle aus), wählen Sie nuraccess; eine ausreichende Registrierung, die beim Start gefunden wird, wird in beiden Fällen verwendet.