Farbschema: Riviera
Sie befinden sich hier: start » de » Dokumentation » Werkzeuge für Microsoft Access » WKL Bootstrapper » Anleitungen » Projekt aus Vorlagen erstellen

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.

VorlageFügt hinzu
accessDie 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.
componentsWKL 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.
odbcEinen 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.
jsonWKL 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).
dotnetEine 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

  1. 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).
  2. 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, wenn access nicht gewählt ist.

  3. Arbeiten Sie die Zeilen ab: Setzen Sie source, legen Sie die genannten Ordner in die Auslieferung, ersetzen Sie den Beispieltreiber.
  4. Prüfen Sie das Ergebnis mit Wkl.Bootstrapper.exe /check Kunden\bootstrapper.json.

Hinweise

  • source ist deploy, ein Ordner neben dem Starter, bis es gesetzt wird.
  • Ohne access startet das Projekt noch nichts: Setzen Sie version (value oder from) und start.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.
  • /json gibt statt der Zeilen ein Objekt mit written, notes und problems aus, jedes Zeichen außerhalb von ASCII maskiert.
  • Exitcodes: 0 geschrieben; 10 keine Datei genannt; 11 eine unbekannte Vorlage, oder die Datei existiert.
  • components und json brauchen eine registration.json neben jedem COM-Server der Auslieferung; das Release-Paket der WKL Forms Object Library bringt sie ab 1.57 mit.
  • Wählen Sie components nur, wenn die Auslieferung die Komponenten mitbringt: Seine Einträge kopieren sie aus der Auslieferung, sodass eine Auslieferung ohne components\x86 und components\x64 mit 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 nur access; eine ausreichende Registrierung, die beim Start gefunden wird, wird in beiden Fällen verwendet.

Verwandte Themen

de/wiki/msaccess/bootstrapper/how-to/create-a-project-from-templates.txt · Zuletzt geändert: von Wolfgang van der Stille