Electron-Paketierung und -Verteilung
Nach Abschluss der Entwicklung einer Electron-Anwendung muss die Anwendung in eine ausführbare Desktop-Datei gepackt und an Benutzer verteilt werden.
Der Paketierungs- und Verteilungsprozess umfasst mehrere Phasen, darunter Werkzeugauswahl, Konfiguration, Signierung und Update-Strategie.
Einführung in Paketierungswerkzeuge
electron-builder
- Hoch automatisiert, Unterstützung für Windows, macOS und Linux
- Unterstützt automatische Update-Funktionalität
- Einfache Konfiguration, geeignet für Produktionsumgebungen
- kann erzeugen
.exe、.dmg、.AppImageund andere Formate
electron-packager
- Offizielles empfohlenes Paketierungstool, leichtgewichtig
- Nur für die Generierung ausführbarer Dateien zuständig, kein integriertes Auto-Update
- Einfache Konfiguration, erfordert jedoch die Kombination mit anderen Tools zur Handhabung von Installationspaketen und Signierung
electron-forge
- Integriert Paketierung, Vorlagen, Auto-Update und Release-Workflows
- Sofort einsatzbereit, geeignet für Einsteiger, um schnell Projekte zu starten
- Integrierte Webpack-/ESBuild-Build-Unterstützung
Werkzeugvergleich und -auswahl
| Werkzeuge | Funktionen | Vorteile | Anwendbare Szenarien |
|---|---|---|---|
| electron-builder | Hohe Automatisierung, plattformübergreifend, unterstützt | Einfache Konfiguration, geeignet für die Produktion | Komplexe Anwendungsveröffentlichung |
| electron-packager | Leichtgewichtig, offiziell unterstützt | Flexibel mit anderen Tools kombinieren | Einfache Anwendungspaketierung |
| electron-forge | Integrierte Entwicklungswerkzeuge, schneller Start | Out-of-the-box, integrierter Build | Einsteiger oder schnelles Prototyping |
Paketierungsparameter konfigurieren
package.json-Konfiguration
"build": {
"appId": "com.example.myapp",
"productName": "MyElectronApp",
"directories": {
"output": "dist"
},
"files": ["**/*"],
"extraResources": ["assets/"],
"mac": {
"category": "public.app-category.utilities"
},
"win": {
"target": "nsis",
"icon": "build/icon.ico"
},
"linux": {
"target": ["AppImage", "deb"],
"icon": "build/icon.png"
}
}
Plattformspezifische Konfiguration
- Windows: Installer-Pakettypen (NSIS, Squirrel), Icons
.ico - macOS: Anwendungskategorie, Signierung,
.icnsicon - Linux: Zielformate (AppImage, deb, rpm), PNG-Icons
Icons und Ressourcendateien
- Icon-Größe und -Format müssen die Plattformanforderungen erfüllen
- Zusätzliche Ressourcen können abgerufen werden über
extraResourcesoderextraFileshinzufügen
Multiplattform-Paketierung
Windows-Paketierung
electron-builder --win
- kann erzeugen
.exeoder.msiInstallationsdatei - Unterstützt NSIS-Installationsassistenten und stille Installation
macOS-Paketierung
electron-builder --mac
- kann erzeugen
.dmgoder.pkg - Mit Notarisierung kann es den macOS Gatekeeper passieren
Linux-Paketierung
electron-builder --linux
- Gängige Formate: AppImage, deb, rpm
- Geeignet für die Desktop-Verteilung über verschiedene Distributionen hinweg
Cross-Kompilierung
- Electron-builder unterstützt plattformübergreifende Builds, aber macOS-Anwendungen müssen unter macOS signiert werden
- Windows/Linux können Cross-Packaging mithilfe virtueller Linux- oder Windows-Build-Maschinen erreichen
Code-Signierung
Windows-Code-Signierung
- Signierung mit digitalen Zertifikaten (.pfx)
.exeoder.msi - Beispiel:
electron-builder --win --csc-link path/to/certificate.pfx --csc-key-password yourpassword
- Benutzervertrauen stärken und SmartScreen-Blockierung vermeiden
macOS-Notarisierung
- Apple verlangt offiziell, dass Anwendungen notarisiert werden, um Gatekeeper zu passieren
- Erfordert ein Apple-Developer-Konto
- Build-Beispiel:
electron-builder --mac --publish never
- Nutzung
notarizeDie App über die API zur automatischen Notarisierung hochladen
Zertifikatsbeantragung und -verwaltung
- Windows: Erwerben Sie ein EV- oder Standard-Code-Signaturzertifikat
- macOS: Beantragen Sie ein Entwicklerzertifikat mit einem Apple-Developer-Konto
- Zertifikate müssen sicher aufbewahrt werden, um Lecks zu vermeiden
Automatische Aktualisierung
Verwendung von electron-updater
- Funktioniert mit electron-builder, unterstützt differenzielle Updates
- Installation
electron-updater:npm install electron-updater
Beispiel für den Hauptprozess:
const { autoUpdater } = require('electron-updater')
autoUpdater.on('update-available', () => console.log('发现新版本'))
autoUpdater.on('update-downloaded', () => autoUpdater.quitAndInstall())
autoUpdater.checkForUpdates()
Einrichten des Update-Servers
- Kann GitHub Releases, private Server oder CDN verwenden
- Stellt eine JSON-Datei bereit, die die Informationen zur neuesten Version beschreibt
Differenzielles Update
- Lädt nur geänderte Dateien herunter und reduziert so den Bandbreitenverbrauch
- electron-updater bietet integrierte Unterstützung für Differential-Updates mit NSIS / Squirrel / AppImage
Update-Strategie
- Automatisch nach Updates suchen (beim Start oder zeitgesteuert)
- Updates manuell auslösen
- Ein Pop-up fordert Benutzer auf, sofort zu aktualisieren oder das Update aufzuschieben
Zusammenfassung
Kernprozess des Electron-Packagings und der Verteilung:
- Tool auswählen:electron-builder、electron-packager、electron-forge
- Konfigurationsparameter: Plattform, Icons und Ressourcen in package.json definieren
- Multiplattform-Packaging:Windows、macOS、Linux
- Code-Signierung: Sicherstellen, dass die App vertrauenswürdig ist, und Sicherheitswarnungen vermeiden
- Automatisches Update: Benutzererfahrung verbessern, Differential-Updates unterstützen
Die Einhaltung von Best Practices ermöglicht es, Electron-Apps schnell und sicher an Benutzer zu verteilen und erleichtert zugleich zukünftige Iterationen und Updates.
Weitere Erweiterungen