构建系统概览

优质

小牛编辑

140浏览

2023-12-01

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 ，将不会成功.