Aller au contenu principal

Créer une archive

Pour distribuer votre application avec Electron, vous devez l’empaqueter et la rebaptiser. To do this, you can either use specialized tooling or manual approaches.

Avec des Outils​

Il existe un certain nombre d'outils pour empaqueter et distribuer votre application Electron. Nous vous recommandons d’utiliser Electron Forge . Vous pouvez consulter directement sa documentation ou vous référer à la partie Packaging and Distribution du tutoriel d'Electron.

Empaquetage manuel​

Dans le cas où vous préférez cette approche, il y a 2 façons de distribuer votre application :

  • Avec des binaires précompilés
  • Avec une archive du code source de l'application

Avec des binaires précompilés​

Pour distribuer votre application manuellement, vous devez télécharger les binaires précompilés d'Electron. Ensuite, le dossier contenant votre application devra être nommé app et placé dans le répertoire de ressources d'Electron, comme illustré dans les exemples suivants.

remarque

The location of Electron's prebuilt binaries is indicated with electron/ in the examples below.

macOS
electron/Electron.app/Contents/Resources/app/
├── package.json
├── main.js
└── index.html
Windows and 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.

With an app source code archive (asar)​

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.

macOS
electron/Electron.app/Contents/Resources/
└── app.asar
Windows
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 voudrez renommer votre application avant de la distribuer aux utilisateurs.

  • Windows: You can rename electron.exe to any name you like, and edit its icon and other information with tools like rcedit.

  • Linux: You can rename the electron executable to any name you like.

  • macOS: You can rename Electron.app to any name you want, and you also have to rename the CFBundleDisplayName, CFBundleIdentifier and CFBundleName fields in the following files:

    • 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 serait comme :

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

il est aussi possible de renommer Electron par le nom du produit et le compiler 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.

Keep in mind this is not recommended as setting up the environment to compile from source is not trivial and takes significant time.