Windows-Installer für eine Electron-App erstellen

Electron liefert Ihnen eine lauffähige Windows-App in einem Ordner: MyApp.exe, ein paar DLLs, resources/app.asar und die Locales. Diesen Ordner in eine Setup.exe zu verwandeln, ist ein eigener Schritt, und die üblichen Werkzeuge (electron-builder, Squirrel, die Maker von electron-forge) bringen jeweils ihre eigene Konfiguration, ihre Eigenheiten und ihre Anforderungen an den Build-Rechner mit. Wenn Sie sich das für einen Installer mit Assistent lieber ersparen möchten, ist dies der kurze Weg.

Schritt 1: Die App in einen Ordner paketieren

Sie brauchen die paketierte App, nicht das Entwicklungsprojekt. Beide Werkzeuge unten erzeugen einen Ordner, den Sie ausliefern können.

Electron Packager (ein Befehl, keine Konfigurationsdatei):

npx @electron/packager . MyApp --platform=win32 --arch=x64 --icon=build/icon.ico --overwrite

Das erzeugt MyApp-win32-x64/ mit MyApp.exe darin.

Electron Forge, falls Ihr Projekt es bereits verwendet:

npm run package

Der Ordner erscheint unter out/, zum Beispiel out/MyApp-win32-x64/.

Beide Befehle laufen unter Windows, macOS und Linux. Das Flag --icon (oder packagerConfig.icon bei Forge) legt das in MyApp.exe eingebettete Symbol fest; halten Sie diese .ico-Datei bereit, Sie brauchen sie auch für den Installer.

Öffnen Sie den Ordner und doppelklicken Sie auf MyApp.exe, um sicherzugehen, dass die paketierte App startet. Verwenden Sie stattdessen --arch=ia32, wenn Sie einen 32-Bit-Build benötigen.

Schritt 2: Den Ordner zippen

Zippen Sie den Inhalt von MyApp-win32-x64/ (die .exe, die DLLs, resources/, locales/), nicht das übergeordnete Projekt. Alles im Zip wird unverändert installiert, lassen Sie also weg, was nicht ausgeliefert werden soll.

Schritt 3: Den Installer bauen

1. Laden Sie das Zip bei ExeTup hoch. Es listet die Dateien auf und wählt MyApp.exe als Hauptprogramm; bestätigen Sie das.
2. Geben Sie App-Namen, Version (passend zur package.json), Herausgeber und optional eine Lizenz ein.
3. Wählen Sie den Installationsbereich. Electron-Apps werden üblicherweise pro Benutzer installiert; das braucht keine Administratorrechte und entspricht dem, was Squirrel-basierte Installer tun. Wählen Sie alle Benutzer, wenn die App für alle auf dem Rechner in Program Files liegen soll.
4. Belassen Sie es bei 64-Bit für ein x64-Paket.
5. Laden Sie dieselbe .ico für Installer und Verknüpfungen hoch, aktivieren Sie die Verknüpfungen im Startmenü und auf dem Desktop und, wenn Sie möchten, „Nach der Installation starten“.
6. Bauen, Setup.exe herunterladen und unter Windows testen.

Besonderheiten bei Electron

• Größe. Eine paketierte Electron-App ist unkomprimiert 150 bis 250 MB groß. Der Installer verwendet solide LZMA-Kompression, die sie üblicherweise auf 60 bis 90 MB bringt. Prüfen Sie vor dem Zippen das Upload-Limit im Preisbereich; es wird von der Website festgelegt.
• Auto-Updates. Dieser Installer enthält keinen Update-Feed. Wenn Sie electron-updater oder den Update-Mechanismus von Squirrel nutzen, bleiben Sie dabei; diese Anleitung richtet sich an Apps, die neue Versionen als neuen Installer ausliefern, was einfacher ist und für viele Apps völlig ausreicht.
• Autostart. Bevorzugen Sie die Installer-Option „Beim Systemstart ausführen“ gegenüber app.setLoginItemSettings, wenn die Entscheidung bei der Installation getroffen werden soll; beide schreiben dieselbe Art von Run-Eintrag.
• Codesignierung. Die paketierte MyApp.exe und die Setup.exe sind unsigniert, solange Sie sie nicht signieren. Unsignierte Downloads können die SmartScreen-Warnung auslösen; siehe die SmartScreen-Anleitung.

Im Vergleich zum NSIS-Target von electron-builder

electron-builder kann ebenfalls einen NSIS-Installer erzeugen und ist ein gutes Werkzeug, wenn Sie seinen vollen Funktionsumfang brauchen: Delta-Updates, eigene NSIS-Skripte, MSI-Ausgabe, Signing-Hooks. Der Preis dafür sind Konfiguration und eine zu pflegende Build-Umgebung. ExeTup baut dieselbe Art von NSIS-Installer aus dem paketierten Ordner, mit Optionen, die in einem Formular gesetzt werden; das passt zu Teams, die nur gelegentlich veröffentlichen oder auf einem Mac bauen und keine Windows-Pipeline allein für den Installer wollen.

Häufige Fragen

Kann ich statt der paketierten App den Electron-Projektordner hochladen?

Nein. Der Installer umhüllt die Ausgabe von Electron Packager oder Forge: den Ordner, der MyApp.exe enthält. Das Quellprojekt, node_modules und die Entwicklungswerkzeuge gehören nicht hinein.

Welchen Installationsbereich sollte eine Electron-App verwenden?

Pro Benutzer ist die übliche Wahl, weil die Installation ohne Administratorabfrage in den eigenen Ordner des Benutzers erfolgt. Wählen Sie alle Benutzer, wenn IT-Abteilungen die App für jedes Konto auf einem Rechner ausrollen.

Kommt der Installer damit zurecht, wenn die App während der Deinstallation geöffnet ist?

Der Deinstaller entfernt die Dateien, die er installiert hat. Bitten Sie die Benutzer, die App vorher zu schließen, wie bei jedem Windows-Programm; eine laufende .exe lässt sich erst löschen, wenn sie beendet ist.

Funktioniert das auch für Apps, die mit Tauri oder NW.js gebaut sind?

Ja. Jeder Ordner mit einer Windows-.exe und ihren Dateien lässt sich umhüllen. Tauri bringt einen eigenen Bundler mit, aber die einfache paketierte Ausgabe funktioniert hier genauso.