Beliebiges Programm mit dem Starter starten

Liefern Sie ein Programm aus, das keine Access-Anwendung ist – oder ein Dokument, das sich über seinen Dateityp öffnet –, sodass die Benutzer es mit einem Klick starten, immer in der aktuellen Version, für sie installiert ohne Administratorrechte.

Voraussetzungen: WKL Bootstrapper 2.0 (Projektdatei im Format 2). Microsoft Access wird nicht benötigt.

• files kopiert das Programm aus der Quelle in einen Ordner je Version, [VersionDir].
• version übernimmt die ausgelieferte Version aus einem festen Wert (value) oder aus der Produktversion einer Datei der Auslieferung (from).
• start nennt, was der Starter startet: file, arguments, folder (den Arbeitsordner) und environment (Variablen, die das gestartete Programm erhält).
• bitness entscheidet, welche mit x86 oder x64 gekennzeichneten Einträge installiert werden. Der Standard access folgt der Bitbreite von Microsoft Access und, wenn kein Access installiert ist, der von Windows; für ein eigenes Programm setzen Sie os, x86 oder x64.

1. Legen Sie die Auslieferung auf die Freigabe, zum Beispiel \\server\share\lager mit dem Programm in bin.

2. Schreiben Sie die Projektdatei bootstrapper.json neben Wkl.Bootstrapper.exe:

   {
     "format": 2,
     "product": "Lager",
     "display": { "name": "Lagerverwaltung", "publisher": "Contoso" },
     "version": { "from": "bin\\Lager.exe" },
     "source": "\\\\server\\share\\lager",
     "bitness": "os",
     "files": [ { "id": "bin", "source": "bin", "target": "[VersionDir]" } ],
     "shortcuts": [ { "folder": "[Programs]\\Contoso", "name": "Lager", "target": "[Starter]", "arguments": "[RunConfig]" } ],
     "start": {
       "file": "[VersionDir]\\Lager.exe",
       "arguments": "/user \"[Product]\" /data \"[AppDir]\\Data\"",
       "folder": "[VersionDir]",
       "environment": [ { "name": "LAGER_HOME", "value": "[Dir:bin]" } ]
     }
   }

   Die Verknüpfung startet den Starter, nicht das Programm, sodass jeder Start zuerst nach einer neuen Version sucht.

3. Prüfen Sie die Datei und probieren Sie einen Start aus, ohne etwas zu ändern:

   Wkl.Bootstrapper.exe /check bootstrapper.json
   Wkl.Bootstrapper.exe /whatif bootstrapper.json

   /check endet mit 0, wenn die Datei keine Regel verletzt; die Auslieferung liest es nicht. /whatif endet mit 0, wenn ein Start gelingen würde (die Auslieferung eingeschlossen), und listet den Plan auf.

4. Starten Sie es. Wkl.Bootstrapper.exe installiert die Version (oder verwendet die installierte) und startet Lager.exe in [VersionDir] mit den Argumenten und der Variablen.

Um statt eines Programms ein Dokument zu öffnen, nennen Sie es in start.file (zum Beispiel [VersionDir]\Handbuch.pdf); das für seinen Dateityp registrierte Programm öffnet es.

• Eine Datei mit der Erweiterung .exe, .com, .bat oder .cmd wird direkt über ihren Pfad gestartet; jede andere Datei wird über ihren Dateityp geöffnet. Ein Dateityp kann die Datei an ein Programm übergeben, das bereits läuft; das gilt trotzdem als gestartet.
• Ein Programm, das sofort endet, ist kein Fehler (ein Startprogramm, ein Skript, ein Programm, das an eine laufende Instanz übergibt). Ein Programm, das sich überhaupt nicht starten lässt, beendet den Starter mit Code 60.
• start.folder ist standardmäßig der Ordner von start.file.
• start.environment setzt jede Variable nur für das gestartete Programm; ein Name darf einmal je Bitbreite vorkommen, mit bitness x86 oder x64 an einem Eintrag, um ihn nur für diese Bitbreite zu setzen. Die installierte Version behält die Variablen, sodass auch ein Start ohne Quelle sie setzt.
• start.file liegt meist unterhalb von [VersionDir]. Es kann auch ein anderweitig installiertes Programm über seinen vollständigen Pfad nennen; der Starter installiert dann nur die übrigen Einträge des Projekts.
• start.runtime und start.command gelten nur, wenn start.file eine Access-Datenbank ist (.accdb, .accde, .accdr, .accda, .mdb, .mde, .adp, .ade); für jede andere Datei werden sie ignoriert, und stattdessen wird start.arguments verwendet.
• Ein leeres start.file installiert und startet nichts; der Starter endet dann mit 0, wenn die Installation vollständig ist.
• Der vertrauenswürdige Speicherort von Access wird nur geschrieben, wenn start.file eine Access-Datenbank ist.

• Die Projektdatei (Format 2) – jeder Eintrag und jeder Platzhalter
• Projekt aus Vorlagen erstellen
• Private .NET-Runtime ausliefern – wenn das Programm .NET braucht
• Signierte Auslieferung veröffentlichen
• Microsoft Access konnte mit der Anwendung nicht gestartet werden (Code 60)
• WKL Bootstrapper