So testen Sie ein Projekt vorab und erstellen das MSI-Paket

Drei Befehle der Seite Projekte lassen den Starter mit der gespeicherten Projektdatei arbeiten, ohne etwas zu installieren: Vorschau zeigt, wie seine Fenster aussehen, Probelauf spielt einen Start durch, MSI erstellen baut das Paket, mit dem die IT den Starter verteilt. Wählen Sie auf Projekte das Projekt und den Befehl. Alle drei speichern das Projekt zuerst, denn der Starter liest die Datei. Jeder braucht den Starter (siehe So richten Sie den Bootstrapper Manager ein und starten ihn); MSI erstellen zusätzlich WiX.

Vorgehen:

1. Wählen Sie Vorschau.
2. Der Starter zeichnet sein Fortschrittsfenster mit Logo, Name, Sprache und Farbschema des Projekts als Bild (/preview progress), ohne ein Fenster zu öffnen; Windows zeigt das Bild mit dem Programm, das für PNG-Dateien eingestellt ist.

Ergebnis: Sie sehen das Fenster so, wie der Benutzer es beim Einrichten sieht. Die Zeile unter dem Text und der Fortschritt sind Beispiele des Starters, nicht Werte des Projekts. Das Bild liegt als wkl-configurator-preview.png im Ordner %TEMP% und wird bei der nächsten Vorschau ersetzt.

Kontrolle: Name, Herausgeber, Logo und Text entsprechen den Feldern der Seite Darstellung.

Vorgehen:

1. Wählen Sie Probelauf (Alt+L).
2. Der Starter geht einen Start durch, als liefe er beim Benutzer (/whatif): jede Prüfung und was er wohin installieren würde. Er ändert dabei nichts.

3. Die Meldung mit dem Titel Probelauf zeigt in der ersten Zeile das Ergebnis mit Code (0 Ok, sonst Code, Name und Ursache), darunter den Plan Zeile für Zeile, mit den Pfaden dieses Rechners:

   0 Ok
   version 3.2.0 (x86) into C:\Users\<Konto>\AppData\Local\WKL\Kasse\Frontends\3.2.0
   1 file(s) into C:\Users\<Konto>\AppData\Local\WKL\Kasse\Frontends\3.2.0
   ...
   1 registry key(s) below HKEY_CURRENT_USER
   shortcut C:\Users\<Konto>\Desktop\Kassensystem.lnk

Ergebnis: Code 0 heißt: Ein Start würde auf diesem Rechner gelingen – mit dem hier installierten Access und der von hier erreichbaren Lieferung. Ein anderer Code nennt, woran der Start scheitern würde; die Codes beschreibt Fehlercodes des Starters (Dokumentation von WKL Bootstrapper).

Kontrolle: Vergleichen Sie den Plan mit den Listen des Projekts: Jeder Eintrag der Seite Dateien erscheint mit Quelle und vollständigem Ziel, jede Verknüpfung mit ihrem Pfad, am Ende steht, was der Starter startet.

Vorgehen:

1. Wählen Sie MSI erstellen.

2. Geben Sie die Version des Pakets ein: zwei oder drei Zahlen, höher als die des zuletzt verteilten Pakets – sonst ersetzt Windows Installer das alte nicht. Die Paketversion ist unabhängig von der Version der Anwendung.

   

3. Der Bootstrapper Manager ruft das Skript New-StarterMsi.ps1 mit Projektdatei, Starter und Version auf.

Ergebnis: Die Meldung nennt das Paket <Produkt>-<Fassung>.msi im Ordner der Projektdatei:

Damit installiert die IT den Starter einmal für alle Benutzer eines Rechners; wie, beschreibt Starter per MSI verteilen (Dokumentation von WKL Bootstrapper).

Das Paket enthält nur den Starter, die Projektdatei und, wenn das Projekt eines nennt und es neben der Projektdatei liegt, das Logo; die Anwendung kommt beim Start aus dem Lieferordner. Den Inhalt sehen Sie ohne Installation und ohne Administratorrechte, indem Sie das Paket auspacken:

msiexec /a C:\Lieferung\Kasse\Kasse-1.0.0.msi /qn TARGETDIR=C:\Lieferung\msi-inhalt

Ergebnis: Unter C:\Lieferung\msi-inhalt\PFiles\WKL\<Produkt> liegen Wkl.Bootstrapper.exe und die Projektdatei. Wie Sie das Paket mit einer Testinstallation prüfen, zeigt Schritt 7 im Tutorial: Eine Access-Anwendung vom Lieferordner bis zur geprüften Installation.

• Probelauf auf Ihrem Rechner: Der Probelauf prüft die Bedingungen dieses Rechners, nicht die eines Benutzers. Fehlt hier etwas, das beim Benutzer vorhanden ist (oder umgekehrt), weicht das Ergebnis ab.
• Lieferung für 64-Bit-Office: Der Probelauf spielt den Start in der Bitbreite des Access durch, das auf Ihrem Rechner installiert ist. Eine Lieferung für Benutzer mit 64-Bit-Office prüfen Sie auf einem Rechner mit 64-Bit-Office: Installieren Sie dort den Starter mit dem MSI-Paket und rufen Sie im Ordner des Starters Wkl.Bootstrapper.exe /diagnose auf. Die erste Zeile 0 Ok heißt: Ein Start wird gelingen. /diagnose ändert nichts am Rechner.
• Langer Plan: Die Meldung zeigt etwa die ersten 1 000 Zeichen, danach „…“. Den vollständigen Plan zeigt der Starter selbst: Wkl.Bootstrapper.exe /whatif <Projektdatei>.
• Quelle als vollständiger Pfad: Das Paket installiert den Starter nach Program Files (x86)\WKL\<Produkt>. Ein relativer Pfad im Feld Quelle gilt dort nicht mehr; tragen Sie vor MSI erstellen einen vollständigen Pfad oder eine Freigabe ein.
• Gleiche Version noch einmal: Ein Paket mit gleichem Namen im Ordner der Projektdatei wird ohne Rückfrage ersetzt. Ist es schon verteilt, erhöhen Sie die Version, statt das Paket mit derselben Version neu zu bauen.
• MSI-Werkzeug: Der Bootstrapper Manager nimmt das Skript der Einstellung MsiTool (Tabelle ConfiguratorSetting), sonst tools\New-StarterMsi.ps1 neben dem Starter. Es braucht die WiX-Kommandozeile wix ab Version 6. Schlägt der Bau fehl, nennt die Meldung die Ausgabe des Skripts.

• So stellen Sie Produkt, Version, Darstellung und Startziel ein
• Störungen und ihre Behebung
• Der Installer des Bootstrappers 2.0 (Dokumentation von WKL Bootstrapper)