Empaquetage et distribution d'Electron

Une fois le développement de l'application Electron terminé, l'application doit être empaquetée dans un fichier exécutable de bureau et distribuée aux utilisateurs.

Le processus d'empaquetage et de distribution implique plusieurs étapes, notamment la sélection des outils, la configuration, la signature et la stratégie de mise à jour.


Introduction aux outils d'empaquetage

electron-builder

  • Hautement automatisé, compatible avec Windows, macOS et Linux
  • Prend en charge la fonctionnalité de mise à jour automatique
  • Configuration simple, adaptée aux environnements de production
  • peut générer.exe、.dmg、.AppImageet d'autres formats

electron-packager

  • Outil d'empaquetage officiel recommandé, léger
  • Responsable uniquement de la génération de fichiers exécutables, sans mise à jour automatique intégrée
  • Configuration simple, mais nécessite de combiner d'autres outils pour gérer les paquets d'installation et la signature

electron-forge

  • Intègre l'empaquetage, les modèles, la mise à jour automatique et les workflows de publication
  • Prêt à l'emploi, adapté aux débutants pour démarrer rapidement des projets
  • Prise en charge intégrée de la compilation Webpack / ESBuild

Comparaison et sélection des outils

Outils Fonctionnalités Avantages Scénarios applicables
electron-builder Automatisation élevée, multiplateforme, prend en charge les mises à jour Configuration simple, adaptée à la production Publication d'applications complexes
electron-packager Léger, officiellement pris en charge Combinaison flexible avec d'autres outils Packaging d'application simple
electron-forge Outils de développement intégrés, démarrage rapide Prêt à l'emploi, build intégré Débutants ou prototypage rapide

Configurer les paramètres de packaging

configuration de package.json

"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"
  }
}

Configuration spécifique à la plateforme

  • Windows: types de paquets d'installation (NSIS, Squirrel), icônes.ico
  • macOS: catégorie d'application, signature,.icnsicon
  • Linux: formats cibles (AppImage, deb, rpm), icônes PNG

Icônes et fichiers de ressources

  • La taille et le format de l'icône doivent respecter les exigences de la plateforme
  • Des ressources supplémentaires sont accessibles viaextraResourcesouextraFilesajoutez

Empaquetage multiplateforme

Empaquetage Windows

electron-builder --win
  • peut générer.exeou.msiFichier d'installation
  • Prend en charge l'assistant d'installation NSIS et l'installation silencieuse

Empaquetage macOS

electron-builder --mac
  • peut générer.dmgou.pkg
  • Avec la notarisation, il peut franchir le Gatekeeper de macOS

Empaquetage Linux

electron-builder --linux
  • Formats courants : AppImage, deb, rpm
  • Adapté à la distribution de bureau sur différentes distributions

Compilation croisée

  • Electron-builder prend en charge les builds multiplateformes, mais les applications macOS doivent être signées sur macOS
  • Windows/Linux peuvent réaliser un empaquetage croisé via des machines virtuelles de build Linux ou Windows

Signature de code

Signature de code Windows

  • Signature avec des certificats numériques (.pfx).exeou.msi
  • Exemple :
electron-builder --win --csc-link path/to/certificate.pfx --csc-key-password yourpassword
  • Renforcer la confiance des utilisateurs et éviter le blocage par SmartScreen

Notarisation macOS

  • Apple exige officiellement que les applications soient notarisées pour passer Gatekeeper
  • Nécessite un compte Apple Developer
  • Exemple de build :
electron-builder --mac --publish never
  • UtilisationnotarizeTéléverser l'application via l'API pour une notarisation automatique

Demande et gestion de certificats

  • Windows : Acheter un certificat de signature de code EV ou standard
  • macOS : Demander un certificat de développeur avec un compte Apple Developer
  • Les certificats doivent être stockés de manière sécurisée pour éviter les fuites

Mise à jour automatique

Utilisation d'electron-updater

  • Fonctionne avec electron-builder, prend en charge les mises à jour différentielles
  • Installationelectron-updater:npm install electron-updater

Exemple de processus principal :

const { autoUpdater } = require('electron-updater')

autoUpdater.on('update-available', () => console.log('发现新版本'))
autoUpdater.on('update-downloaded', () => autoUpdater.quitAndInstall())
autoUpdater.checkForUpdates()

Configuration du serveur de mise à jour

  • Peut utiliser GitHub Releases, des serveurs privés ou un CDN
  • Fournit un fichier JSON décrivant les informations sur la dernière version

Mise à jour différentielle

  • Télécharge uniquement les fichiers modifiés, ce qui réduit la consommation de bande passante
  • electron-updater dispose d'une prise en charge intégrée des mises à jour différentielles NSIS / Squirrel / AppImage

Stratégie de mise à jour

  • Vérification automatique des mises à jour (au démarrage ou planifiée)
  • Déclencher manuellement les mises à jour
  • Une fenêtre contextuelle invite les utilisateurs à mettre à jour immédiatement ou à reporter la mise à jour

Résumé

Processus principal de l'empaquetage et de la distribution Electron :

  • Choisir l'outil: electron-builder, electron-packager, electron-forge
  • Paramètres de configuration: Définir la plateforme, les icônes et les ressources dans package.json
  • Empaquetage multiplateforme: Windows, macOS, Linux
  • Signature de code: Garantir la fiabilité de l'application et éviter les avertissements de sécurité
  • Mise à jour automatique: Améliorer l'expérience utilisateur, prendre en charge les mises à jour différentielles

Le respect des bonnes pratiques permet de distribuer rapidement et en toute sécurité les applications Electron aux utilisateurs, tout en facilitant les itérations et les mises à jour futures.

autres extensions