Saltar al contenido principal

Instrucciones de compilación (Windows)

Follow the guidelines below for building Electron itself on Windows, for the purposes of creating custom Electron binaries. For bundling and distributing your app code with the prebuilt Electron binaries, see the application distribution guide.

Prerequisites​

  • Windows 10 / Server 2012 R2 o superior
  • Visual Studio 2019 (>=16.0.0) to build, but Visual Studio 2022 (>=17.0.0) is preferred - download VS 2022 Community Edition for free
    • Vea the Chromium build documentation para mas detalles sobre cuales componentes de Visual Studio son requeridos.
    • Si tu Visual Studio está instalado en un directorio diferente que el predeterminado, necesitarás establecer unas pocas variables de entorno para apuntar las toolchains a tu ruta de instalación.
      • vs2022_install = DRIVE:\path\to\Microsoft Visual Studio\2022\Community, sustituyendo 2022 y Comunidad por sus versiones instaladas y sustituyendo DRIVE: por la unidad en la que Visual Studio está activada. A menudo, esto será C:.
      • WINDOWSSDKDIR = DRIVE:\path\to\Windows Kits\10, replacing DRIVE: with the drive that Windows Kits is on. A menudo, esto será C:.
  • Node.js
  • Git
  • Debugging Tools for Windows of Windows SDK 10.0.15063.468 if you plan on creating a full distribution since symstore.exe is used for creating a symbol store from .pdb files.
    • Diferentes versiones del SDK se pueden instalar juntas. Para instalar el SDK, abra Visual Studio Installer, seleccione Modify → Individual Components, desplácese hacia abajo y seleccione el SDK de Windows apropiado para instalar. Otra opción sería mirar el Windows SDK y el archivo emulador y descargar la versión independiente del SDK respectivamente.
    • Las herramientas de depuración de SDK también deben ser instaladas.https://crowdin.com/translate/electron/13/en-es#246828 Si el SDK de Windows 10 fue instalado a través del instalador de Visual Studio, entonces se puede instalar yendo a: Panel de Control → Programas → Programas y Características → Seleccione "Windows Software Development Kit" → Change → Change → Check "Debugging Tools For Windows" → Change. O puede descargar el instalador independiente del SDK y usarlo para instalar el Debugging Tools.

If you don't currently have a Windows installation, developer.microsoft.com has timebombed versions of Windows that you can use to build Electron.

Electron se construye casi completamente con script de comandos de linea y no puede ser generado con Visual Studio. Puede desarrollar Electron con cualquier editor pero el soporte para construir con Visual Studio vendrá en el futuro.

Nota: A pesar de que Visual Studio no es usado para construir, todavía se requiere debido a que necesitamos las herramientas que provee para construir.

Exclude source tree from Windows Security​

Windows Security doesn't like one of the files in the Chromium source code (see https://crbug.com/441184), so it will constantly delete it, causing gclient sync issues. You can exclude the source tree from being monitored by Windows Security by following these instructions.

Compilando​

See Build Instructions: GN

Arquitectura 32bit​

Para construir para 32bit, usted necesita pasar target_cpu = "x86" como un argumento GN. Usted puede construir para 32bit junto con el target de 64bit usando diferentes carpetas de salida para GN, por ejemplo: out/Release-x86 con diferentes argumentos.

$ gn gen out/Release-x86 --args="import(\"//electron/build/args/release.gn\") target_cpu=\"x86\""

El resto de los pasos son exactamente los mismos.

Proyecto de Visual Studio​

Para generar un project de Visual Studio, puede pasar el parametro --ide=vs2017 a gn gen:

$ gn gen out/Testing --ide=vs2017

Problemas​

Comand xxxx not found​

Si encuentra un error como Comand xxxx not found, intente usar la Consola de Comandos de VS2015 para ejecutar los scripts de compilacion.

Fatal internal compiler error: C1001​

Asegúrese de que tiene instalada la última versión de Visual Studio.

LNK1181: cannot open input file 'kernel32.lib'​

Intente reinstalar Node.js 32bit.

Error: ENOENT, estatus 'C:\Users\USERNAME\AppData\Roaming\npm'​

Creando ese directorio should fix the problem:

$ mkdir ~\AppData\Roaming\npm

node-gyp is not recognized as an internal or external command​

Debe obtener este error si está usando Git Bash para la compilación, en cambio debería usar PowerShell o la ventana de comandos de VS2015.

no se puede crear el directorio en '...': Nombre demasiado largo​

node.js tiene algunos extremely long pathnames, y por defecto git en windows no maneja correctamente los nombres de rutas largos(a pesar de que windows los soporta). Esto debería arreglarlo:

$ git config --system core.longpaths true

error: uso del identificador no declarado 'DefaultDelegateCheckMode'​

This can happen during build, when Debugging Tools for Windows has been installed with Windows Driver Kit. Uninstall Windows Driver Kit and install Debugging Tools with steps described above.

Los scripts de compilacion se bloquean haste que se presione una tecla​

Este error es una "característica" del intérprete de comandos de Windows. Ocurre cuando se pulsa dentro de la ventana prompt con QuickEdit habilitado y está destinado a permitir seleccionar y copiar el texto de la salida fácilmente. Dado que cada click accidental pausará el proceso de compilación, puede que quiera desactivar esta característica en la propiedades del símbolo del sistema.