Controle la configuración y el comportamiento de la aplicación sin cambiar el código.

Ciertos comportamientos de Electron están controlados por variables de entorno porque se inicializan antes que los indicadores de la línea de comando y el código de la aplicación.

Ejemplo de shell POSIX:

$ export ELECTRON_ENABLE_LOGGING=true
$ electron

Ejemplo de consola de Windows:

> set ELECTRON_ENABLE_LOGGING=true
> electron

Variables de producción

Las siguientes variables de entorno están diseñadas principalmente para su uso en tiempo de ejecución en aplicaciones empaquetadas de Electron.

NODE_OPTIONS

Electron incluye soporte para un subconjunto de Node’s NODE_OPTIONS. La mayoría son compatibles con la excepción de aquellos que entran en conflicto con el uso de Chromium de BoringSSL.

Ejemplo:

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

Las opciones no admitidas son:

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

NODE_OPTIONS están explícitamente prohibidos en aplicaciones empaquetadas, excepto por lo siguiente:

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

GOOGLE_API_KEY

El soporte de geolocalización en Electron requiere el uso del servicio web de geolocalización de Google Cloud Platform. Para habilitar esta función, adquiera un API de Google key y coloque el siguiente código en su archivo de proceso principal, antes de abrir cualquier ventana del navegador que realice solicitudes de geolocalización:

process.env.GOOGLE_API_KEY='YOUR_KEY_HERE'

De forma predeterminada, una API de Google recién generada key Es posible que no se le permita realizar solicitudes de geolocalización. Para habilitar el servicio web de geolocalización para su proyecto, habilítelo a través del Biblioteca de API.

NB Deberá agregar un Cuenta de facturación al proyecto asociado a la API key para que funcione el servicio web de geolocalización.

ELECTRON_NO_ASAR

Desactiva la compatibilidad con ASAR. Esta variable solo se admite en procesos secundarios bifurcados y procesos secundarios generados que establecen ELECTRON_RUN_AS_NODE.

ELECTRON_RUN_AS_NODE

Inicia el proceso como un proceso normal de Node.js.

En este modo, podrá pasar opciones de cli a Node.js como lo haría al ejecutar el ejecutable normal de Node.js, con la excepción de los siguientes indicadores:

  • “–openssl-config”
  • “–use-bundled-ca”
  • “–use-openssl-ca”,
  • “–force-fips”
  • “–enable-fips”

Estas banderas están deshabilitadas debido al hecho de que Electron usa BoringSSL en lugar de OpenSSL al compilar Node.js ‘ crypto módulo, por lo que no funcionará como se diseñó.

ELECTRON_NO_ATTACH_CONSOLEVentanas

No se conecte a la sesión actual de la consola.

ELECTRON_FORCE_WINDOW_MENU_BARLinux

No use la barra de menú global en Linux.

ELECTRON_TRASHLinux

Configure la implementación de la papelera en Linux. El valor predeterminado es gio.

Opciones:

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

Variables de desarrollo

Las siguientes variables de entorno están destinadas principalmente a fines de desarrollo y depuración.

ELECTRON_ENABLE_LOGGING

Imprime el registro interno de Chrome en la consola.

ELECTRON_LOG_ASAR_READS

Cuando Electron lee de un archivo ASAR, registre el desplazamiento de lectura y la ruta del archivo al sistema tmpdir. El archivo resultante se puede proporcionar al módulo ASAR para optimizar el orden de los archivos.

ELECTRON_ENABLE_STACK_DUMPING

Imprime el seguimiento de la pila en la consola cuando Electron falla.

Esta variable de entorno no funcionará si el crashReporter Está empezado.

ELECTRON_DEFAULT_ERROR_MODEVentanas

Muestra el cuadro de diálogo de bloqueo de Windows cuando Electron falla.

Esta variable de entorno no funcionará si el crashReporter Está empezado.

ELECTRON_OVERRIDE_DIST_PATH

Al huir del electron paquete, esta variable le dice al electron comando para usar la compilación especificada de Electron en lugar de la descargada por npm install. Uso:

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

Establecido por Electron

Electron establece algunas variables en su entorno en tiempo de ejecución.

ORIGINAL_XDG_CURRENT_DESKTOP

Esta variable se establece en el valor de XDG_CURRENT_DESKTOP con el que se lanzó originalmente la aplicación. Electron a veces modifica el valor de XDG_CURRENT_DESKTOP para afectar otra lógica dentro de Chromium, por lo que si desea acceder a la original valor, debería buscar esta variable de entorno en su lugar.