构建步骤(Windows)
- Windows 10 / Server 2012 R2 或更高版本
- Visual Studio 2017 15.7.2 或更高版本 - 免费下载 VS 2019 社区版
- 如果您的 Visual Studio 安装在非默认目录中, 您需要 设置几个环境变量来将工具链指向您的安装路径。
- ,用您当前已安装版本替换
2019
和Community
以及用您当前安装Visual Studio的驱动器号替换DRIVE:
一般情况下将会是C:
。 WINDOWSSDKDIR = DRIVE:\path\to\Windows Kits\10
, replacingDRIVE:
with the drive that Windows Kits is on. 一般情况下将会是C:
。
- ,用您当前已安装版本替换
- 对于构建流程也是必需的。
- 如果您的 Visual Studio 安装在非默认目录中, 您需要 设置几个环境变量来将工具链指向您的安装路径。
- Node.js
- 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 files.- 不同版本的SDK可以同时安装 To install the SDK, open Visual Studio Installer, select
Modify
→Individual Components
, scroll down and select the appropriate Windows SDK to install. 另一个选择是查看 windows SDK 和仿真器存档 并分别下载 SDK 的独立版本。
- 不同版本的SDK可以同时安装 To install the SDK, open Visual Studio Installer, select
如果您当前没有安装 Windows, 上有时间限制的 Windows 版本,你可以用来构建 Electron。
构建 Electron 完全由命令行脚本完成,无法通过 Visual Studio 完成。 您可以使用任何编辑器开发 Electron,但将来将会使用 Visual Studio 构建支持。
注意: 即使 Visual Studio 不用于构建,但是仍然需要,因为我们需要它提供的构建工具链。
从Windows Security排除source tree
Windows Security 不支持Chromium 源码中部分代码,详情(see ). 此行为将会导致windows系统会删除Chromium里的危险文件从而导致 Bug. 通过following these instructions你可以在Windows Security中排除这一行为。
参照
32 位构建
其他构建步骤完全一样。
要生成 Visual Studio 项目,可以传递 --ide=vs2017
参数 给 gn gen
:
故障排查
如果你遇到了一个错误,类似 Command xxxx not found
, 可以尝试使用 VS2015 Command Prompt
控制台来执行构建脚本.
Fatal internal compiler error: C1001
确保你已经安装了 Visual Studio 的最新安装包.
LNK1181: cannot open input file ‘kernel32.lib’
重新安装 32位的 Node.js.
node-gyp is not recognized as an internal or external command
如果你使用 Git Bash 来构建,或许会遇到这个错误,可以使用 PowerShell 或 VS2015 Command Prompt 来代替.
无法在“…”处创建目录:文件名太长
node.js 有一些 极长的路径名,默认情况下,windows 上的 git 不能正确处理长路径名(即使 windows 支持它们)。 这应该可以修复它:
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.
导入错误:没有名为 win32file 的模块
确保已使用 pip install pywin32
安装了 pywin32
。
构建脚本挂起, 直到某个按键按下才有响应
这个bug 是 Windows 命令提示符的一个”功能” It happens when clicking inside the prompt window with enabled and is intended to allow selecting and copying output text easily. 由于每次意外点击都会暂停构建过程,您可能需要在命令的属性中禁用此 功能。