So erstellen, öffnen oder übernehmen Sie ein Projekt

Ein Projekt beginnt auf eine von drei Arten: neu aus den Vorlagen des Starters (Neu), als vorhandene Projektdatei (Öffnen) oder als Konfiguration des früheren Starters (StarterPro.config.xml, Übernehmen). Alle drei Befehle stehen auf der Seite Projekte. In jedem Fall schreibt bzw. liest der Bootstrapper Manager eine Projektdatei im Format 2, nimmt das Projekt in die Liste auf und wählt es, damit die übrigen Seiten es bearbeiten.

Vorgehen:

1. Klicken Sie auf der Seite Projekte auf den Pfeil neben Neu, und wählen Sie eine Vorlage:

   Eintrag	Was die Projektdatei danach enthält
   Leeres Projekt	Nur Produkt und Quelle. Version und Startziel fehlen noch; Prüfen meldet das, bis Sie sie eintragen
   Access-Anwendung	Die Datenbank, die app-manifest.json im Lieferordner nennt, kopiert nach [VersionDir]; die Version aus diesem Manifest; ihren Start (/runtime wie im Manifest); die Bedingung Microsoft Access. Das Manifest beschreibt die gebaute Anwendung; das WKL Office SDK (wkl-office deliver) und das Bauwerkzeug der WKL Forms Object Library legen es mit ihr im Lieferordner ab
   Access-Anwendung mit WKL-Komponenten	Dazu die WKL Forms Object Library aus components\x86 und components\x64 der Lieferung, für den Benutzer registriert, und die Bedingung .NET 10 Desktop Runtime
   … mit WKL-Komponenten und ODBC-Treiber	Dazu einen Beispiel-ODBC-Treiber mit Datenquelle des Benutzers – zu ersetzen durch den gelieferten
   … mit WKL-Komponenten und WKL JSON	Dazu die Bibliothek WKL Office JSON aus json\x86 und json\x64
   … mit WKL-Komponenten und eigener .NET-Laufzeit	Dazu eine private .NET-Laufzeit aus dotnet\x86 und dotnet\x64 statt der Bedingung .NET 10

   Ein Klick auf Neu selbst (nicht auf den Pfeil) verwendet die Vorlage Access-Anwendung. Sie braucht eine app-manifest.json; eine Anwendung, die ohne das WKL Office SDK und ohne das Bauwerkzeug der WKL Forms Object Library entsteht, beginnt mit Leeres Projekt (siehe Tutorial). Liefern Sie mit dem SDK aus, brauchen Sie Neu nicht: Das SDK schreibt die Projektdatei selbst und öffnet sie im Bootstrapper Manager (siehe Start aus dem WKL Office SDK). Wählen Sie eine Vorlage mit WKL-Komponenten nur, wenn die Lieferung die Komponenten mitbringt; sonst fehlt dem Starter beim Benutzer der Ordner components. Was die Vorlagen genau eintragen, beschreibt Projekt aus Vorlagen erstellen (Dokumentation von WKL Bootstrapper).

2. Im Dialogfeld Neue Projektdatei des Starters wählen Sie Ordner und Dateinamen. Vorgeschlagen ist bootstrapper.json – der Name, den der Starter ohne weitere Angabe liest. Legen Sie die Datei in den Ordner, in dem später auch Wkl.Bootstrapper.exe liegt.
3. Gibt es die Datei schon, fragt der Bootstrapper Manager, ob er sie ersetzen soll.
4. Die Meldung mit dem Titel Neu nennt, was noch zu tun ist: welche Ordner die Lieferung braucht und welche Beispielwerte (etwa der ODBC-Treiber) zu ersetzen sind.

Ergebnis: Das Projekt ist gewählt. Die Produktkennung (Feld Produkt) ist der Name des gewählten Ordners, der Lieferordner (Feld Quelle) deploy neben dem Starter; beides ändern Sie auf der Seite Allgemein.

Kontrolle: Wählen Sie Prüfen. Bei Leeres Projekt meldet die Seite Probleme die noch fehlende Version (version needs either value or from.). Prüfen liest nur die Projektdatei; ob der Lieferordner enthält, was das Projekt nennt, zeigt erst der Probelauf.

Vorgehen:

1. Wählen Sie Öffnen und die Projektdatei (*.json, Format 2).
2. Steht die Datei schon in der Liste, liest der Bootstrapper Manager sie neu – es sei denn, das Projekt hat Änderungen, die noch nicht in der Datei stehen: Dann fragt er, ob er die Datei neu lesen und die Änderungen verwerfen soll. Nein (Vorgabe) wählt das Projekt mit seinen Änderungen.

Ergebnis: Das Projekt ist gewählt und steht oben in der Liste, weil es zuletzt gelesen wurde.

Kontrolle: Der Untertitel der übrigen Seiten nennt das Projekt, etwa „Projekt Kasse (Kassensystem)“.

Vorgehen:

1. Wählen Sie Übernehmen und die Datei StarterPro.config.xml.
2. Wählen Sie, wohin die neue Projektdatei kommt; vorgeschlagen ist bootstrapper.json neben der alten Konfiguration. Eine vorhandene Datei ersetzt Übernehmen nicht; wählen Sie dann einen anderen Namen.
3. Der Starter wandelt die Konfiguration um (/import-starterpro). Die Meldung mit dem Titel Übernehmen nennt, was er nicht übernommen hat.

Ergebnis: Das neue Projekt ist gewählt. Die SQL-Verbindung und Kennwörter der alten Konfiguration übernimmt der Starter nie: Sie gehören nicht in eine Projektdatei, die auf jeden Arbeitsplatz kopiert wird. Wie es danach weitergeht, beschreibt Vom bisherigen Starter umsteigen (Dokumentation von WKL Bootstrapper).

Kontrolle: Gehen Sie die Punkte der Meldung Übernehmen durch und wählen Sie danach Prüfen und Probelauf: Erst der Probelauf zeigt, ob der Starter mit dem übernommenen Projekt auf diesem Rechner starten würde.

Die Liste ist nach Zuletzt gelesen oder gespeichert sortiert, das jüngste Projekt oben; beim Start ist es gewählt.

• Der Starter muss erreichbar sein für Neu und Übernehmen. Wo der Bootstrapper Manager ihn sucht, einschließlich der Orte, die nur für diese beiden Befehle gelten, steht in So richten Sie den Bootstrapper Manager ein und starten ihn, Schritt 3.
• Ersetzen ist sicher: Schlägt Neu fehl (kein Starter, Fehler des Starters), steht die vorige Datei unverändert wieder da.
• Format 1 lehnt Öffnen mit einer Meldung zum Format ab. Eine solche Datei schreiben Sie von Hand auf Format 2 um, siehe Die Projektdatei (Format 2), Abschnitt Format 1 (Dokumentation von WKL Bootstrapper).

• So stellen Sie Produkt, Version, Darstellung und Startziel ein
• So speichern Sie ein Projekt