Electron 使用 gyp 来生成项目 ,使用 ninja 来构建项目. 项目配置可以在 .gyp 和 .gypi 文件中找到.
Gyp 文件
下面的 gyp
文件包含了构建 Electron 的主要规则 :
atom.gyp
定义了 Electron 它自己是怎样被构建的.common.gypi
调整 node 的构建配置,来让它结合 Chromium 一起构建.vendor/brightray/brightray.gyp
定义了brightray
是如何被构建的,并且包含了默认配置来连接到 Chromium.vendor/brightray/brightray.gypi
包含了常用的创建配置.
创建组件
在 Chromium 还是一个相当大的项目的时候,最后链接阶段会花了好几分钟,这让开发变得很困难. 为了解决这个困难,Chromium 引入了 "component build" ,这让每个创建的组建都是分隔开的共享库,让链接更快,但是这浪费了文件大小和性能.
在 Electron 中,我们采用了一个非常相似的方法 : 在创建 Debug
, 二进制文件会被链接进入一个 Chromium 组件的共享版本库来达到快速链接; 在创建 Release
, 二进制文件会被链接进入一个静态版本库, 所以我们可以有最小的二进制文件size和最佳的体验.
Minimal Bootstrapping
在运行 bootstrap 脚本的时候,所有的 Chromium 预编译二进制文件会被下载.默认静态库和共享库会被下载,并且项目的最后大小会在 800MB 到 2GB 之间,这取决于平台类型.
默认,libchromiumcontent
是从 Amazon Web Services 上下载下来的.如果设置了 LIBCHROMIUMCONTENT_MIRROR
环境变量,bootstrap脚本会从这里下载下来. libchromiumcontent-qiniu-mirror
是 libchromiumcontent
的映射.如果你不能连接 AWS,你可以切换下载路径:export LIBCHROMIUMCONTENT_MIRROR=http://7xk3d2.dl1.z0.glb.clouddn.com/
如果只是想快速搭建一个 Electron 的测试或开发环境,可以通过 --dev
参数只下载共享版本库:
$ ./script/bootstrap.py --dev
$ ./script/build.py -c D
Two-Phase Project Generation
在 Release
和 Debug
构建的时候后,Electron 链接了不同配置的库 .然而 gyp
不支持为不同的配置文件进行不同的链接设置.
为了规避这个问题,Electron 在运行 gyp
的时候,使用了一个 gyp
的变量 libchromiumcontent_component
来控制应该使用哪个链接设置,并且只生成一个目标.
Target Names
与大多数的项目不同,它们使用 Release
和 Debug
作为目标名字,而 Electron 使用使用的是 R
和 D
.这是因为如果只定义了一个 Release
或 Debug
构建配置,gyp
会随机崩溃,并且在同一时候,Electron 只生成一个目标,如上所述.
这只对开发者可用,如果想重新构建 Electron ,将不会成功.
下一节:遵循下面的引导,在 OS X 上构建 Electron .