Aller au contenu principal

Distribution de l'Application

Vue d'ensemble

Pour distribuer votre application avec Electron, vous devez l’empaqueter et la rebaptiser. Pour ce faire, vous pouvez utiliser des outils spécialisés ou une approche manuelle.

Avec des Outils

Vous pouvez utiliser les outils suivants pour distribuer votre application :

Ces outils se chargeront des différentes opérations nécessaires à l'obtention d'une application Electron distribuable telles que l'empaquetage, le renommage de l'exécutable et l'initialisation des icones.

Vous pouvez consulter un exemple d’empaquetage d'une application avec electron-forge dans le guide de démarrage rapide.

Distribution manuelle

Avec des binaires précompilés

Pour distribuer votre application manuellement, vous devez télécharger les binaires précompilés d'Electron. Ensuite, vous devez nommer app le dossier contenant votre application et le placer dans le répertoire des ressources d’Electron, comme illustré dans les exemples suivants.

REMARQUE: l’emplacement des binaires précompilés d’Electron est indiqué avec electron/ dans les exemples ci-dessous.

Sur macOS :

electron/Electron.app/Contents/Resources/app/
├── package.json
├── main.js
└── index.html

Sur Windows et Linux :

electron/resources/app
├── package.json
├── main.js
└── index.html

Exécutez ensuite Electron.app sous macOS, electron sous Linux ou electron.exe sous Windows, et Electron démarrera en tant qu'application. Le répertoire electron sera alors votre distribution à livrer aux utilisateurs.

Avec une archive du code source de l'application

Au lieu de distribuer votre application en copiant tous ses fichiers sources, vous pouvez empaqueter votre application dans une archive asar pour améliorer les performances de lecture des fichiers sur des plateformes telles que Windows, si vous n’utilisez pas déjà un bundler tel que Parcel ou Webpack.

Pour utiliser une archive asar au lieu du dossier app, vous devez renommer l'archive en app.asar et la placer dans le dossier ressources d'Electron comme ci-dessous. Ainsi, Electron essaiera de lire l'archive et de se lancer à partir de celle-ci.

Sur macOS :

electron/Electron.app/Contents/Resources/
└── app.asar

Sur Windows et Linux :

electron/resources/
└── app.asar

Vous pouvez trouver plus de détails sur l'utilisation de asar dans le dépôt electron/asar.

Renommer avec les binaires téléchargés

Après avoir empaqueté votre application dans Electron, vous pouvez vouloir renommer Electron avant de la distribuer aux utilisateurs.

macOS

Vous pouvez renommer Electron.app avec le nom qui vous plaît, mais vous devrez aussi renommer les champs CFBundleDisplayName, CFBundleIdentifier and CFBundleName dans les fichiers suivants :

  • Electron.app/Contents/Info.plist
  • Electron.app/Contents/Frameworks/Electron Helper.app/Contents/Info.plist

Vous pouvez aussi renommer l'application d'aide pour éviter d'afficher Electron Helper dans le moniteur d'activité, mais assurez vous d'avoir renommé le nom du fichier exécutable de l'application d'aide.

La structure d'une application renommée se présentera ainsi :

MyApp.app/Contents
├── Info.plist
├── MacOS/
│   └── MyApp
└── Frameworks/
└── MyApp Helper.app
├── Info.plist
└── MacOS/
   └── MyApp Helper

Windows

Vous pouvez renommer electron.exe avec le nom qui vous plaît et modifier son icône et d'autres informations avec des outils tels que rcedit.

Linux

Vous pouvez renommer l'exécutable electron comme vous le voulez.

Renommage en recompilant Electron à partir du code source

Il est aussi possible de renommer Electron en modifiant le "product name" et en le re-compilant depuis le code source. Pour faire cela, vous devez définir les arguments de compilation correspondant au nom du produit (electron_product_name = "LeNomDeVotreProduit") dans le fichier args.gn et recompiler.