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 via
extraResourcesouextraFilesajoutez
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
- Utilisation
notarizeTé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
- Installation
electron-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