构建说明(Windows)
在Windows中,构建Electron
前提要求
- Windows 7/Server 2008 R2或者更高的版本
- Visual Studio 2015 Update 3 - 免费下载VS 2015社区版
- Python 2.7 (已实践证明的一点的是该版本的Python安装后重启电脑才可使用!)
- Node.js
- Git
- Windows调试工具
假如需要创建一个完整发行版,则使用 symstore.exe在.pdb文件中新建符号存储.
如果你现在还没有安装 Windows , modern.ie 有一个 timebombed 版本的 Windows ，你可以用它来构建 Electron.
Building Electron完全使用命令行脚本完成，您可以使用任何编辑器开发Electron,但不能使用Visual Studio完成(将来可能支持)。
注意：即使Visual Studio不用于构建，但它仍然是必须的，因为我们需要它提供的构建工具链。
获取代码
$ git clone https://github.com/electron/electron.git
引导
引导脚本将下载所有必需的构建依赖项并创建构建项目文件,由于使用了 ninja进行构建,因此不存在 Visual Studio项目.
$ cd electron
$ python script\bootstrap.py -v
构建
创建 Release和 Debug target:
$ python script\build.py
还可以仅构建 Debug target :
$ python script\build.py -c D
在构建完成后,你可以在 out\D (debug target) 或者 out\R (release target)下找到 Electron.exe .
32位系统支持
要构建32位目标，需要在运行引导脚本时传递 --target_arch=ia32参数:
$ python script\bootstrap.py -v --target_arch=ia32
Visual Studio项目
要生成Visual Studio项目,可以传递 --msvs参数:
$ python script\bootstrap.py --msvs
清理
清理构建文件:
$ npm run clean
只清理out和dist目录:
$ npm run clean-build
注意：以上两个clean命令都需要在构建之前再次运行 bootstrap。
相关测试
故障排除
未找到命令xxxx
遇到如 Command xxxx not found之类错误, 你可以尝试使用 VS2015命令提示控制台来执行构建脚本
致命内部编译器错误:C1001
确保您已安装最新的Visual Studio
Assertion failed: ((handle))->activecnt >= 0
如果在 Cygwin 下构建的，你可能会看到 bootstrap.py 失败并且附带下面错误 :
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
这是由同时使用 Cygwin Python 和 Win32 Node 造成的 bug.解决办法就是使用 Win32 Python 执行 引导脚本 (假设你已经在目录 C:\Python27 下安装了 Python):
$ /cygdrive/c/Python27/python.exe script/bootstrap.py
LNK1181: cannot open input file 'kernel32.lib'
重新安装 32位的 Node.js.
Error: ENOENT, stat 'C:\Users\USERNAME\AppData\Roaming\npm'
创建一个一样的目录 ,应该可以解决问题.
$ mkdir ~\AppData\Roaming\npm
node-gyp is not recognized as an internal or external command
如果你使用 Git Bash 来构建，或许会遇到这个错误，可以使用 PowerShell 或 VS2015 Command Prompt 来代替 .