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 überextraResourcesoderextraFileshinzufü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
  • NutzungnotarizeDie 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
  • Installationelectron-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