Instructions pour compiler Electron
Suivez les instructions ci-dessous pour compiler Electron, afin d'ontenir une version personnalisée d'Electron. Pour regrouper et distribuer le code de votre application avec les binaires précompilés d'Electron, reportez-vous au guide de la distribution d'applications.
Prérequis de la plateforme
Vérifiez les prérequis de build pour votre plateforme avant de continuer
Outils de build
Electron's Build Tools automatise une grande partie de la configuration pour compiler Electron à partir des sources avec différentes configurations et cibles de compilation. Si vous souhaitez configurer l'environnement manuellement, les instructions sont énumérées ci-dessous.
Electron utilise GN pour la génération de projet et ninja pour la construction. Les configurations du projet peuvent être trouvées dans les fichiers .gn
et .gni
.
Fichiers GN
Les fichiers gn
suivants contiennent les règles principales pour la construction d'Electron :
BUILD.gn
définit comment Electron lui-même est construit et inclut les configurations par défaut pour se connecter avec Chromium.build/args/{testing,release,all}.gn
contient les arguments de construction par défaut pour compilant Electron.
Prérequis GN
Vous devrez installer depot_tools
, l'ensemble d'outils utilisé pour récupérer Chromium et ses dépendances.
De plus, sous Windows, vous devrez définir la variable d'environnement DEPOT_TOOLS_WIN_TOOLCHAIN=0
. Pour ce faire, ouvrez Panneau de configuration
→ Système et Sécurité
→ Système
→ Paramètres système avancés
et ajouter une variable système DEPOT_TOOLS_WIN_TOOLCHAIN
avec la valeur 0
. Cela indique au depot_tools
d’utiliser votre version locale de Visual Studio (par défaut, depot_tools
essaiera de télécharger une version interne de Google uniquement accessible à ses utilisateurs).
Mise en place du cache git
Si vous prévoyez de vérifier Electron plus d'une fois (par exemple, d'avoir plusieurs répertoires parallèles vérifiés sur différentes branches), l'utilisation de du cache git accélérera les appels suivants à gclient
. Pour cela, définissez une variable d'environnement GIT_CACHE_PATH
:
$ export GIT_CACHE_PATH="${HOME}/.git_cache"
$ mkdir -p "${GIT_CACHE_PATH}"
# Cela utilisera environ 16G.
Obtenir le code
$ mkdir electron && cd electron
$ gclient config --name "src/electron" --unmanaged https://github. om/electron/electron
$ gclient sync --with_branch_heads --with_tags
# Cela prendra un certain temps, allez prendre un café.
Au lieu de
https://github.com/electron/electron
, vous pouvez utiliser votre propre fork ici (quelque chose commehttps://github.com/<username>/electron
).
Une note lors du tirage/poussage
Si vous avez l'intention d'effectuer un git pull
ou un git push
du dépôt officiel electron
dans le futur, vous devez maintenant mettre à jour les URL d'origine des répertoires respectifs.
$ cd src/electron
$ git remote remove origin
$ git remote add origin https://github. om/electron/electron
$ git checkout main
$ git branch --set-upstream-to=origin/main
$ cd -
📝 gclient
fonctionne en vérifiant un fichier appelé DEPS
à l'intérieur du dossier src/electron
pour les dépendances (comme Chromium ou Node.js). Exécuter gclient sync -f
garantit que toutes les dépendances requises pour construire Electron correspondent à ce fichier.
Donc, pour effectuer le pull, vous exécuterez les commandes suivantes :
$ cd src/electron
$ git pull
$ gclient sync -f