- Windows 7 / Server 2008 R2 or higher
- Visual Studio 2013 - download VS 2013 Community Edition for free
- Python 2.7
- Node.js
- git
If you don't have a Windows installation at the moment, modern.ie has timebombed versions of Windows that you can use to build Electron.
The building of Electron is done entirely with command-line scripts, so you can use any editor you like to develop Electron, but it also means you can not use Visual Studio for the development. Support of building with Visual Studio will come in the future.
Note: Even though Visual Studio is not used for building, it's still required because we need the build toolchains it provides.
Note: Visual Studio 2015 will not work. Please make sure to get MSVS 2013.
git clone https://github.com/atom/electron.git
The bootstrap script will download all necessary build dependencies and create
build project files. Notice that we're using ninja
to build Electron so
there is no Visual Studio project generated.
cd electron
python script\bootstrap.py -v
Build both Release and Debug targets:
python script\build.py
You can also only build the Debug target:
python script\build.py -c D
After building is done, you can find atom.exe
under out\D
.
To build for the 64bit target, you need to pass --target_arch=x64
when running
the bootstrap script:
python script\bootstrap.py -v --target_arch=x64
The other building steps are exactly the same.
Test your changes confirm to the project coding style using:
python script\cpplint.py
Test functionality using:
python script\test.py
If you encountered an error like Command xxxx not found
, you may try to use
the VS2012 Command Prompt
console to execute the build scripts.
Make sure you have the latest Visual Studio update installed.
If building under Cygwin, you may see bootstrap.py
failed with following
error:
Assertion failed: ((handle))->activecnt >= 0, file src\win\pipe.c, line 1430
Traceback (most recent call last):
File "script/bootstrap.py", line 87, in <module>
sys.exit(main())
File "script/bootstrap.py", line 22, in main
update_node_modules('.')
File "script/bootstrap.py", line 56, in update_node_modules
execute([NPM, 'install'])
File "/home/zcbenz/codes/raven/script/lib/util.py", line 118, in execute
raise e
subprocess.CalledProcessError: Command '['npm.cmd', 'install']' returned non-zero exit status 3
This is caused by a bug when using Cygwin python and Win32 node together. The
solution is to use the Win32 python to execute the bootstrap script (supposing
you have installed python under C:\Python27
):
/cygdrive/c/Python27/python.exe script/bootstrap.py
Try reinstalling 32bit node.js.
Simply making that directory should fix the problem:
mkdir ~\AppData\Roaming\npm
You may get this error if you are using Git Bash for building, you should use PowerShell or VS2012 Command Prompt instead.