So stellen Sie Produkt, Version, Darstellung und Startziel ein
Drei Seiten der Gruppe Projekt enthalten die Einzelwerte der Projektdatei: Allgemein (was installiert wird und wohin), Darstellung (wie die Fenster des Starters aussehen) und Startziel (was der Starter am Ende startet). Jede Seite ist eine Feldliste mit Gruppen; ein leeres Feld bedeutet die Vorgabe des Starters. Wählen Sie das Projekt, dann die Seite in der Navigation, und tragen Sie die Werte ein. Jede Änderung gilt sofort im Bootstrapper Manager; in die Projektdatei kommt sie mit Speichern oder Strg+S.
Was jedes Feld bewirkt, welche Werte erlaubt sind und was ohne Eintrag gilt, legt der Starter fest: Die Projektdatei (Format 2), Abschnitt Eigenschaftswert (Dokumentation von WKL Bootstrapper). Diese Seite sagt, welches Feld welchem Teil der Projektdatei entspricht und was der Bootstrapper Manager dabei selbst tut.
Seite Allgemein
| Feld | In der Projektdatei | Was der Bootstrapper Manager dazu tut |
|---|---|---|
| Produkt | product | – |
| Projektdatei | – | Zeigt, wo die Datei liegt; nicht bearbeitbar |
| Version, Version aus Datei | version.value, version.from | – |
| Quelle | source | Ausgangsordner für Dateien hinzufügen und Ordner hinzufügen |
| Lieferschlüssel | deliveryKey | – |
| Bitbreite | bitness | Auswahl der Werte des Starters |
| Anwendungsordner, Versionsordner | appDir, versionDir | – |
| Versionen behalten | keepVersions | – |
| INI-Datei | ini.path | Die Werte stehen auf der Seite INI-Datei |
Füllen Sie entweder Version oder Version aus Datei, nicht beide.
Bitbreite. Das Feld legt fest, welche Einträge der Seite Dateien mit eigener Bitbreite der Starter
beim Benutzer einrichtet, etwa die WKL-Komponenten aus components\x86 oder aus components\x64:
| Wert | Es gelten die Einträge für |
|---|---|
leer oder access (Vorgabe) | die Bitbreite des installierten Access; ist kein Access installiert, die von Windows |
os | die Bitbreite von Windows |
x86, x64 | diese Bitbreite, unabhängig vom installierten Access |
Lassen Sie das Feld in der Regel leer: Dann erhält jeder Benutzer die Einträge, die zu seinem Access
passen. Die Prüfungen des Starters beim Benutzer (Access, WKL-Komponenten, .NET, ODBC-Treiber) richten
sich immer nach dem installierten Access, auch bei x86 oder x64.
Seite Darstellung
| Feld | In der Projektdatei | Was der Bootstrapper Manager dazu tut |
|---|---|---|
| Name, Herausgeber | display.name, display.publisher | – |
| Copyright (Zeilen), Autoren (Zeilen) | display.copyright, display.authors | Eine Zeile des Felds wird ein Eintrag der Liste |
| Logo | display.logo | – |
| Text beim Einrichten, Text beim Starten | display.preparing, display.starting | – |
| Sprache, Farbschema | display.language, display.colorScheme | Auswahl der Werte des Starters |
Wie die Fenster damit aussehen, zeigt Vorschau auf der Seite Projekte, siehe So testen Sie ein Projekt vorab und erstellen das MSI-Paket.
Die Texte beim Einrichten und Starten formulieren
Den Text beim Einrichten liest der Benutzer der Anwendung, während der Starter eine neue Version kopiert oder die WKL-Komponenten einrichtet, oft morgens beim ersten Start. Schreiben Sie ihn für diesen Moment:
- Sagen Sie, was die Anwendung gerade tut, nicht, was der Benutzer tun soll: Er kann den Vorgang nicht beschleunigen und muss nichts beheben.
- Eine kurze Zeile, die mit „ …“ endet, in der Sprache, die unter Sprache eingestellt ist. Ist Sprache leer, folgt das Fenster der Sprache von Office, und Ihr Text stünde neben Texten in einer anderen Sprache.
- Keine Fachbegriffe, Versionen oder Pfade; die nennen die Diagnosedetails des Fensters für den Support.
- Lassen Sie das Feld leer, erscheint der Standardtext „Die neue Version wird eingerichtet …“ in der Sprache des Benutzers.
- Für den Text beim Starten gelten dieselben Regeln; das Fenster zeigt ihn, während der Starter den Computer prüft und die Anwendung startet (Starter ab 2.4.1). Leer: „Die Anwendung wird gestartet …“.
| Sprache | Beispiel |
|---|---|
| Englisch | Setting up the cash register system … |
| Deutsch | Das Kassensystem wird eingerichtet … |
| Slowenisch | Trenutek, blagajniški sistem se nastavlja … |
Seite Startziel
| Feld | In der Projektdatei | Was der Bootstrapper Manager dazu tut |
|---|---|---|
| Datei oder Programm, Argumente, Arbeitsordner | start.file, start.arguments, start.folder | – |
| Access: /runtime, Access: /cmd | start.runtime, start.command (nur für eine Access-Datenbank) | Auswahl der Werte des Starters für /runtime |
Technische Einzelheiten
- Produktkennung nach der ersten Auslieferung nicht mehr ändern. Nach dem Wert im Feld Produkt benennt der Starter den Ordner der Anwendung im Profil des Benutzers und ihren Eintrag bei den Apps von Windows; eine neue Produktkennung ist für Windows eine andere Anwendung.
- Quelle und MSI-Paket: Ein relativer Pfad gilt ab dem Ordner des Starters. Das passt, solange der Starter neben dem Lieferordner bleibt, etwa wenn Benutzer ihn von der Freigabe aus starten. Das MSI-Paket installiert den Starter dagegen nach
Program Files (x86)\WKL\<Produkt>; dort gilt ein relativer Pfad nicht mehr. Für ein Projekt, das Sie als MSI-Paket ausliefern, tragen Sie einen vollständigen Pfad oder eine Freigabe ein, etwa\\server\Kasse\deploy. - Lieferschlüssel: Das Feld nimmt nur den öffentlichen Teil des Schlüssels auf. Den Schlüssel erzeugen und jede Auslieferung signieren Sie mit dem Starter (
/new-key,/publish); der Bootstrapper Manager tut beides nicht. Mit Lieferschlüssel installiert der Starter ab 2.2.4 nie eine ältere Version als die höchste, die der Benutzer schon hat; eine ältere Auslieferung, die wieder in der Quelle liegt, bleibt also ohne Wirkung. Wollen Sie bewusst zu einer früheren Version zurück, veröffentlichen Sie diese mit/publish /withdraw. Beides beschreibt Signierte Auslieferung veröffentlichen (Dokumentation von WKL Bootstrapper), Abschnitt „Zu einer früheren Version zurückkehren“. - Rote Markierung an einem Feld: Die letzte Prüfung des Starters hat dort ein Problem gefunden; den Text dazu zeigt die Seite Probleme. Sobald Sie das Feld ändern, verschwindet die Markierung, weil der Starter den neuen Wert noch nicht beurteilt hat. Prüfen Sie erneut, siehe So prüfen Sie ein Projekt und beheben Probleme.
- Werte ohne Übersetzung: Die Auswahlwerte (
access,automatic,auto…) sind die Werte der Projektdatei, wie sie die Referenz des Starters beschreibt. - Nicht auf diesen Seiten: Fenster beim Start (
start.window), Mindestanzeige des Startfensters (start.splash) und Umgebungsvariablen (start.environment) haben kein Feld. Der Bootstrapper Manager lässt sie beim Speichern unverändert; bearbeiten Sie sie in der Projektdatei.
Verwandte Themen
- Die Projektdatei (Format 2), Abschnitte Eigenschaftswert und Platzhalter (Dokumentation von WKL Bootstrapper) – Bedeutung, Werte und Vorgaben jedes Felds
- Signierte Auslieferung veröffentlichen (Dokumentation von WKL Bootstrapper) – Lieferschlüssel erzeugen, Auslieferungen signieren und zurückziehen