Saltar al contenido principal

Instrucciones de Instalación Avanzada

Para instalar los binarios precompilado de Electron, usa npm. El método preferido es instalar Electrón como una dependencia de desarrollo en tu aplicación:

npm install electron --save-dev

Por favor, echa un vistazo a Electron versioning doc para información de como manejar version de Electron en tus apps.

Ejecutando Electron ad-hoc

Si estás en apuros y prefieres no usar npm install en tu proyecto local, también puede ejecutar Electron ad-hoc usando el comando npx incluido con npm:

npx electron .

El comando anterior ejecutará Electron en el directorio de trabajo actual. Ten en cuenta que ninguna dependencia será instalada en tu aplicación.

Personalización

Si quieres cambiar la arquitectura que será descargada (e.g, ia32 en una máquina x64), puedes usar el flag --arch con npm install o configurar la variable de entorno npm_config_arch:

npm install --arch=ia32 electron

Además de cambiar la arquitectura, también se puede especificar la plataforma (e.g., win32, linux, etc.) utilizando el flag --platform:

npm install --platform=win32 electron

Proxies

Si necesita usar un proxy HTTP, necesita establecer la variable ELECTRON_GET_USE_PROXY a cualquier valor, además de variables de entorno adicionales dependiendo de la versión de Node del sistema anfitrión (host):

Espejos y cachés personalizados

Durante la instalación, el módulo electron llamara a electron-download para descargar binarios precompilados de Electron para tu plataforma. Lo hará poniéndose en contacto con la página de descarga de versiones de GitHub (https://github.com/electron/electron/releases/tag/v$VERSION, donde $VERSION es la versión exacta de Electron).

Si no puede acceder a GitHub o necesita proporcionar una compilación personalizada, puede hacerlo proporcionando un espejo o un directorio de caché existente.

Espejo

Puede usar variables de entorno para anular la URL base, la ruta en la cual buscar binarios de Electron y el nombre del archivo binario. La URL usada por @electron/get se compone de la siguiente forma:

url = ELECTRON_MIRROR + ELECTRON_CUSTOM_DIR + '/' + ELECTRON_CUSTOM_FILENAME

Por ejemplo, para usar el mirror CDN de China:

ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/"

Por defecto, ELECTRON_CUSTOM_DIR está establecido a v$VERSION. Para cambiar el formato, use el marcador de posición {{ version }}. Por ejemplo, version-{{ version }} se resuelve a version-5.0.0, {{ version }} se resuelve a 5.0.0, y v{{ version }} es equivalente al valor predeterminado. Como un ejemplo más concreto, para usar el mirror de China que no es un CDN:

ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/"
ELECTRON_CUSTOM_DIR="{{ version }}"

La configuración anterior se descargará de URLs como https://npmmirror.com/mirrors/electron/8.0.0/electron-v8.0.0-linux-x64.zip.

If your mirror serves artifacts with different checksums to the official Electron release you may have to set electron_use_remote_checksums=1 directly, or configure it in a .npmrc file, to force Electron to use the remote SHASUMS256.txt file to verify the checksum instead of the embedded checksums.

Caché

Alternativamente, puede anular la memoria caché local. @electron-get almacenará en caché los archivos binarios descargados en un directorio local para no sobrecargar tu red. Puede usar esa carpeta de caché para proporcionar compilaciones personalizadas de Electron o para evitar hacer contacto con la red en absoluto.

  • Linux: $XDG_CACHE_HOME or ~/.cache/electron/
  • macOS: ~/Library/Caches/electron/
  • Windows: $LOCALAPPDATA/electron/Cache or ~/AppData/Local/electron/Cache/

En entornos que han estado usando versiones anteriores de Electron, también podrás encontrar la caché en ~/.electron.

También se puede anular la ubicación de almacenamiento en caché local al proporcionar una variable de entorno electron_config_cache.

La caché contiene la versión oficial del fichero zip junto con la suma de verificaciones (checksum), y está almacenada como [checksum]/[filename]. Un caché típico podría verse así:

├── a91b089b5dc5b1279966511344b805ec84869b6cd60af44f800b363bba25b915
│ └── electron-v15.3.1-darwin-x64.zip

Omitir la descarga del archivo binario

Bajo suyo, la API JavaScript de Electron se une a un binario que contiene sus implementaciones. Debido a que este binario es crucial para la función de cualquier aplicación de Electron, se descarga por defecto en el paso postinstall cada vez que instalas electron desde el registro de npm.

Sin embargo, si deseas instalar las dependencias de su proyecto, pero no necesitas usar la funcionalidad de Electron, puedes establecer la variable de entornoELECTRON_SKIP_BINARY_DOWNLOAD para evitar que el binario sea descargado. Por ejemplo, esta característica puede ser útil en entornos de integración continua al ejecutar pruebas unitarias que simulan el módulo electron.

ELECTRON_SKIP_BINARY_DOWNLOAD=1 npm install

Problemas

Cuando ejecutamos npm install electron, ocasionalmente algunos usuarios encuentran errores en la instalación.

En casi todos los casos, estos errores son resultados de problemas en la red y no de problemas con el paquete npm de electron. Errores como ELIFECYCLE, EAI_AGAIN, ECONNRESET y ETIMEDOUT son indicadores de dichos problemas de red. La mejor solución es tratar de cambiar las redes, o esperar un poco e instalar de nuevo.

También puede intentar descargar Electron directamente de electron/electron/releases si la ruta de instalación npm está fallando.

Si la instalación falla con un error EACCESS puede que se necesite los fix your npm permissions.

Si el error anterior persiste, puede ser que el flagunsafe-perm necesite estar establecida a true:

sudo npm install electron --unsafe-perm=true

En redes lentas, puede ser aconsejable utilizar la marca --verbose de manera que se muestre el progreso de la descarga:

npm install --verbose electron

Si necesitas forzar que se vuelva a descargar el recurso y el archivo SHASUM, establece la variable de entorno force_no_cache a true.