51. 构建系统概览

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-mirrorlibchromiumcontent 的映射.如果你不能连接 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

ReleaseDebug 构建的时候后,Electron 链接了不同配置的库 .然而 gyp不支持为不同的配置文件进行不同的链接设置.

为了规避这个问题,Electron 在运行 gyp 的时候,使用了一个 gyp 的变量 libchromiumcontent_component来控制应该使用哪个链接设置,并且只生成一个目标.

Target Names

与大多数的项目不同,它们使用 ReleaseDebug 作为目标名字,而 Electron 使用使用的是 RD.这是因为如果只定义了一个 ReleaseDebug 构建配置,gyp 会随机崩溃,并且在同一时候,Electron 只生成一个目标,如上所述.

这只对开发者可用,如果想重新构建 Electron ,将不会成功.

下一节:遵循下面的引导,在 OS X 上构建 Electron .