Aller au contenu principal

Variables d'environnement

Gère la configuration et le comportement de l'application sans modifier le code.

Certains comportements d'Electron sont contrôlés par les variables d'environnement car ils sont initialisés avant les indicateurs de ligne de commande et le code de l'application.

Exemple sur un shell POSIX :

$ export ELECTRON_ENABLE_LOGGING=true
$ electron

Exemple sur la console Windows :

> set ELECTRON_ENABLE_LOGGING=true
> electron

Variables de production

Les variables d'environnement suivantes sont destinées principalement à être utilisée lors de l'exécution des applications Electron empaquetées.

NODE_OPTIONS

Electron inclut le support pour un sous-ensemble des NODE_OPTIONS de Node. La majorité sont supportés à l'exception de celles rentrant en conflit avec l'utilisation de BoringSSL de Chromium.

Exemple :

export NODE_OPTIONS="--no-warnings --max-old-space-size=2048"

Les options non supportées sont :

--use-bundled-ca
--force-fips
--enable-fips
--openssl-config
--use-openssl-ca

NODE_OPTIONS sont explicitement interdites dans les applications empaquetées, à l'exception des éléments suivants :

--max-http-header-size
--http-parser

GOOGLE_API_KEY

La prise en charge de la géolocalisation dans Electron nécessite l'utilisation du service web de géolocalisation de la plateforme Google Cloud . Pour activer cette fonctionnalité, vous devez obtenir une clé API Google et placer le code suivant dans votre fichier de processus principal, avant d'ouvrir une fenêtre de navigateur effectuant des requêtes de géolocalisation :

process.env.GOOGLE_API_KEY = 'VOTRE_CLE_ICI'

Par défaut, une clé Google API nouvellement générée peut ne pas être autorisée à faire des requêtes de géolocalisation. Pour activer le service Web de géolocalisation pour votre projet, activez-le à travers la bibliothèque API.

N.B. You will need to add a Billing Account to the project associated to the API key for the geolocation webservice to work.

ELECTRON_NO_ASAR

Disables ASAR support. This variable is only supported in forked child processes and spawned child processes that set ELECTRON_RUN_AS_NODE.

ELECTRON_RUN_AS_NODE

Démarre le processus comme un processus normal de Node.js.

In this mode, you will be able to pass cli options to Node.js as you would when running the normal Node.js executable, with the exception of the following flags:

  • "--openssl-config"
  • "--use-bundled-ca"
  • "--use-openssl-ca",
  • "--force-fips"
  • "--enable-fips"

These flags are disabled owing to the fact that Electron uses BoringSSL instead of OpenSSL when building Node.js' crypto module, and so will not work as designed.

ELECTRON_NO_ATTACH_CONSOLE Windows

Ne s'attache pas la session courante de la console.

ELECTRON_FORCE_WINDOW_MENU_BAR Linux

N'utilise pas la bar de menu global sur Linux.

ELECTRON_TRASH Linux

Set the trash implementation on Linux. Par défaut la valeur est gio.

Options :

  • gvfs-trash
  • trash-cli
  • kioclient5
  • kioclient

Variables de développement

Les variables d'environnement suivantes sont destinés principalement aux développement et débogage.

ELECTRON_ENABLE_LOGGING

Affiche les logs interne de Chromium sur la console.

Définir cette variable revient à transmettre --enable-logging sur la ligne de commande. Pour plus d'informations, voir --enable-logging dans commutateurs en ligne de commande .

ELECTRON_LOG_FILE

Définit le fichier destination pour l'enregistrement interne de Chromium.

Définir cette variable revient à transmettre --log-file sur la ligne de commande. Pour plus d'informations, voir --log-file dans commutateurs en ligne de commande .

ELECTRON_DEBUG_DRAG_REGIONS

Ajoute la coloration aux régions "draggable"sur BrowserViewsur macOS - les régions pouvant être déplacées par glisser seront colorées vertes et les régions ne le pouvant pas en rouge pour faciliter le débogage.

ELECTRON_DEBUG_NOTIFICATIONS

Ajoute des logs supplémentaires à Notification aux cycles de vie sur macOS pour aider au débogage. Les logs supplémentaires seront affichés lorsque de nouvelles Notifications seront créées ou activées. Ils seront également affichés lorsque des actions courantes : affichage d'une notification, son rejet, bouton est cliqué, ou il a été répondu.

Exemple de sortie :

Notification created (com.github.Electron:notification:EAF7B87C-A113-43D7-8E76-F88EC9D73D44)
Notification displayed (com.github.Electron:notification:EAF7B87C-A113-43D7-8E76-F88EC9D73D44)
Notification activated (com.github.Electron:notification:EAF7B87C-A113-43D7-8E76-F88EC9D73D44)
Notification replied to (com.github.Electron:notification:EAF7B87C-A113-43D7-8E76-F88EC9D73D44)

ELECTRON_LOG_ASAR_READS

Lorsque Electron lit depuis un fichier ASAR, enregistre l'offset de lecture et le chemin d'accès vers le tmpdir du système. Le fichier résultant peut être fourni au module ASAR pour optimiser l'ordre des fichiers.

ELECTRON_ENABLE_STACK_DUMPING

Affiche la stack trace sur la console lorsqu'Electron plante.

Cette variable d'environnement ne fonctionnera pas si crashReporter est démarré.

ELECTRON_DEFAULT_ERROR_MODE Windows

Affiche la boite de dialogue de plantage lorsqu'Electron plante.

Cette variable d'environnement ne fonctionnera pas si crashReporter est démarré.

ELECTRON_OVERRIDE_DIST_PATH

Quand lancée depuis le paquet electron , cette variable dit à la commande d'electron d'utiliser la version spécifiée au lieu de celle installée avec npm install. Utilisation:

export ELECTRON_OVERRIDE_DIST_PATH=/Users/username/projects/electron/out/Testing

Défini par électron

Electron définit certaines variables dans votre environnement lors de son exécution.

ORIGINAL_XDG_CURRENT_DESKTOP

Cette variable est définie sur la valeur de XDG_CURRENT_DESKTOP avec laquelle votre application a été lancée à l’origine. Electron modifie parfois la valeur de XDG_CURRENT_DESKTOP pour affecter d’autres logiques dans Chromium, donc si vous voulez accéder à la valeur d’origine vous devrez rechercher cette variable d’environnement à la place.