Empaquetage et distribution pour les plateformes de bureau

electron-builder est l’outil standard pour empaqueter les applications Electron dans des installateurs distribuables. Sa configuration se trouve dans package.json, sous la clé "build", où sont indiquées les métadonnées de l’application (appId, productName), les chemins des icônes et les formats cibles propres à chaque plateforme.

electron-builder prend en charge macOS (dmg et zip), Windows (installateur NSIS) et Linux (AppImage et deb). Vous pouvez cibler plusieurs plateformes avec une seule commande de compilation ou configurer l’intégration continue pour compiler chaque plateforme sur son propre agent, afin d’obtenir la meilleure compatibilité.

macOS exige une signature du code avec un certificat Apple Developer pour que Gatekeeper autorise les utilisateurs à ouvrir l’application sans afficher d’avertissement de sécurité. Pendant la compilation, electron-builder lit votre certificat dans le trousseau de clés de macOS et signe automatiquement tous les fichiers binaires.

Au-delà de la signature du code, les versions modernes de macOS exigent également une notarisation : vous envoyez l’application au service de notarisation d’Apple, qui recherche les logiciels malveillants et délivre un ticket. electron-builder peut automatiser la notarisation via electron-notarize, et les utilisateurs de macOS 10.15 ou version ultérieure seront bloqués sans cette étape.

Windows exige un certificat Authenticode délivré par une autorité de certification de confiance (CA) pour que SmartScreen approuve votre installateur. Sans signature, les utilisateurs voient l’avertissement « Windows a protégé votre PC ». Les certificats à validation étendue (EV) suppriment immédiatement cet avertissement, tandis que les certificats OV standard gagnent la confiance au fil du temps.

Après une compilation réussie, electron-builder écrit les installateurs propres à chaque plateforme dans le répertoire dist/. Vous y trouverez le DMG ou le fichier zip pour macOS, le fichier .exe NSIS pour Windows et l’AppImage ou le fichier .deb pour Linux, ainsi qu’un manifeste de mise à jour automatique latest.yml (ou latest-mac.yml).

Les applications Electron ont besoin d’icônes dans des formats propres à chaque plateforme : un PNG 512x512 pour Linux, un fichier ICNS (multi-résolution) pour macOS et un fichier ICO (multi-résolution) pour Windows. electron-builder peut générer tous les formats à partir d’un seul PNG 1024x1024 avec l’option --icon.

Le paquet electron-updater s’intègre à electron-builder pour fournir des mises à jour automatiques. Publiez vos compilations dans les versions GitHub ou sur S3 : electron-updater peut rechercher les mises à jour au démarrage, télécharger la mise à jour différentielle en arrière-plan et proposer à l’utilisateur de redémarrer.

Appelez autoUpdater.checkForUpdatesAndNotify() dans main.js une fois l’application prête. electron-updater récupère le manifeste latest.yml depuis votre cible de publication, compare les versions et, si une mise à jour est disponible, la télécharge puis affiche une notification système native lorsqu’elle est prête à être installée.

electron-builder regroupe les fichiers JavaScript de votre application dans une seule archive ASAR (semblable à un fichier tar) pour la distribuer. Cela améliore les performances au démarrage en réduisant les recherches dans le système de fichiers et rend l’inspection directe de votre code source plus difficile, sans toutefois l’empêcher.

Les modules Node.js natifs (fichiers .node) ne peuvent pas être chargés depuis l’intérieur d’une archive ASAR : ils doivent être extraits dans le système de fichiers. Configurez asarUnpack dans electron-builder pour répertorier les modèles de modules natifs ; ceux-ci seront placés dans le répertoire app.asar.unpacked, à côté de l’archive.

Distribuer une application Electron implique de configurer les cibles d’electron-builder, de signer le code pour macOS (avec notarisation) et Windows (Authenticode), et éventuellement de configurer les mises à jour automatiques avec electron-updater. L’archive ASAR regroupe votre application pour la distribution, tandis que les modules natifs sont extraits séparément. Une chaîne CI/CD solide automatise ces étapes pour chaque plateforme.