mirrors/electron
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages 1 Wiki Activity Actions 1

Merge pull request #830 from paulcbetts/windows-build-instructions

Browse source 
Windows build instructions
This commit is contained in:
Cheng Zhao 2014-11-15 15:15:59 +08:00
commit bf1a4e12f1
1 changed files with 22 additions and 21 deletions
Download patch file Download diff file Expand all files Collapse all files

43
docs/development/build-instructions-windows.md
View file

@ -2,15 +2,16 @@
## Prerequisites ## Prerequisites
* Windows 2008 at least * Windows 7 / Server 2008 R2 or higher
* Visual Studio 2013 * Visual Studio 2013 - [download VS 2013 Community Edition for
free](http://www.visualstudio.com/products/visual-studio-community-vs)
* [Python 2.7](http://www.python.org/download/releases/2.7/) * [Python 2.7](http://www.python.org/download/releases/2.7/)
* 32bit [node.js](http://nodejs.org/download/) * 32bit [node.js](http://nodejs.org/download/)
* [git](http://git-scm.com) * [git](http://git-scm.com)
The instructions below are executed under [cygwin](http://www.cygwin.com), If you don't have a Windows installation at the moment,
but it's not a requirement, you can also build atom-shell under the Windows [modern.ie](https://www.modern.ie/en-us/virtualization-tools#downloads) has
command prompt or other terminals. timebombed versions of Windows that you can use to build Atom Shell.
The building of atom-shell is done entirely with command-line scripts, so you The building of atom-shell is done entirely with command-line scripts, so you
can use any editor you like to develop atom-shell, but it also means you can can use any editor you like to develop atom-shell, but it also means you can
@ -22,8 +23,8 @@ Studio will come in the future.
## Getting the code ## Getting the code
```bash ```powershell
$ git clone https://github.com/atom/atom-shell.git git clone https://github.com/atom/atom-shell.git
``` ```
## Bootstrapping ## Bootstrapping
@ -32,23 +33,23 @@ The bootstrap script will download all necessary build dependencies and create
build project files. Notice that we're using `ninja` to build atom-shell so build project files. Notice that we're using `ninja` to build atom-shell so
there is no Visual Studio project generated. there is no Visual Studio project generated.
```bash ```powershell
$ cd atom-shell cd atom-shell
$ python script/bootstrap.py python script\bootstrap.py
``` ```
## Building ## Building
Build both Release and Debug targets: Build both Release and Debug targets:
```bash ```powershell
$ python script/build.py python script\build.py
``` ```
You can also only build the Debug target: You can also only build the Debug target:
```bash ```powershell
$ python script/build.py -c Debug python script\build.py -c Debug
``` ```
After building is done, you can find `atom.exe` under `out\Debug`. After building is done, you can find `atom.exe` under `out\Debug`.
@ -60,8 +61,8 @@ Currently atom-shell can only be built for 32bit target on Windows, support for
## Tests ## Tests
```bash ```powershell
$ python script/test.py python script\test.py
``` ```
## Troubleshooting ## Troubleshooting
@ -73,7 +74,7 @@ the `VS2012 Command Prompt` console to execute the build scripts.
### Assertion failed: ((handle))->activecnt >= 0 ### Assertion failed: ((handle))->activecnt >= 0
When building under cygwin, you could see `bootstrap.py` failed with following If building under Cygwin, you may see `bootstrap.py` failed with following
error: error:
``` ```
@ -91,8 +92,8 @@ Traceback (most recent call last):
subprocess.CalledProcessError: Command '['npm.cmd', 'install']' returned non-zero exit status 3 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 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 solution is to use the Win32 python to execute the bootstrap script (supposing
you have installed python under `C:\Python27`): you have installed python under `C:\Python27`):
```bash ```bash
@ -107,6 +108,6 @@ Try reinstalling 32bit node.js.
Simply making that directory [should fix the problem](http://stackoverflow.com/a/25095327/102704): Simply making that directory [should fix the problem](http://stackoverflow.com/a/25095327/102704):
```bash ```powershell
mkdir /cygdrive/c/Users/USERNAME/AppData/Roaming/npm mkdir ~\AppData\Roaming\npm
``` ```