Electron中文手册
  • 文档概述
  • 开发指南目录
  • 构建说明(Linux)
  • 构建说明(macOS)
  • 构建说明(Windows)
  • 构建系统概述
  • 编码规范
  • 在 macOS 中调试
  • 在 Windows 中调试
  • 在C ++代码中使用clang-format
  • 在调试器中设置符号服务器
  • 源代码目录结构
  • Chrome升级清单
  • Chromium 开发指南
  • V8 开发指南
  • 教程目录
    • 关于 Electron
    • Electron 版本说明
    • API弃用说明
    • 快速入门
    • 支持的平台
    • 桌面环境集成
    • 系统通知
    • 离屏渲染
    • 在线/离线事件检测
    • 多线程
    • REPL
    • 键盘快捷键
    • DevTools扩展
    • 使用原生模块
    • 使用 Pepper Flash 插件
    • 使用 Selenium 和 WebDriver
    • 使用 Widevine CDM 插件
    • 应用分发
    • 应用打包
    • 主进程调试
    • 使用 node-inspector 进行主进程调试
    • 使用 VSCode 进行主进程调试
    • Mac App Store应用提交指南
    • Windows App Store应用提交指南
    • 安全,本地功能和你的责任
    • Headless CI Systems 测试
  • API接口目录
    • API接口之公用接口
      • 应用语言
      • 开发概要
      • 专业术语
      • 常见问题
      • 环境变量
      • 快捷键字符串
      • 命令行
      • 客户端请求
      • 剪贴板
      • <File> H5 File文件操作
      • 无框窗口
      • <window.open> window.open打开新窗口或打开时传递消息
      • 沙盒选项
    • API接口之主进程接口
      • 整体控制
      • 全局快捷键
      • 图标创建与应用
      • 屏幕
      • 窗口
      • 菜单
      • 菜单项
      • 系统托盘
      • 网页内容
      • 从主进程到渲染进程的异步通信
      • 对话框
      • 创建和控制视图
      • 会话
      • 会话,缓存和代理等控制
      • 页面请求
      • HTTP/HTTPS请求处理
      • 协议的注册和处理
      • 使用系统默认应用程序管理文件或URL
      • 下载项管理
      • 进程控制
      • Chromium原生网络库
      • 获取系统首选项
      • 电源状态
      • 节能管理
      • 调试工具
      • 奔溃报告
      • 性能数据收集
      • 自动更新
      • TouchBar触摸条
      • TouchBar触摸条按钮
      • TouchBar触摸条拾色器
      • TouchBar触摸条分组
      • TouchBar触摸条scrubber
      • TouchBar触摸条分段控件
      • TouchBar触摸条label标签
      • TouchBar触摸条弹出框
      • TouchBar触摸条滑块
      • TouchBar触摸条间隔符
    • API接口之渲染进程接口
      • 页面渲染
      • <webview> webview标签
      • 渲染进程与主进程通信
      • 从渲染进程到主进程的异步通信
      • 子窗口
      • 捕获桌面资源
  • 结构列表
    • 蓝牙设备对象
    • 证书对象
    • 证书主体对象
    • Cookie对象
    • 崩溃报告对象
    • 桌面捕获源对象
    • 显示器对象
    • 打印机信息对象
    • 文件过滤器对象
    • 最近使用的项目
    • 常用列表项
    • CPU使用率对象即程序占用的CPU资源
    • IO值对象
    • 内存信息对象
    • 进程内存信息对象
    • 内存使用详细信息
    • Mime类型缓冲区
    • 矩形对象
    • 删除客户端证书对象
    • 删除密码对象
    • Scrubber项对象
    • 分段控制对象
    • 快捷方式对象
    • 任务对象
    • 缩略图工具栏按钮对象
    • 上传blob对象
    • 上传数据对象
    • 上传文件系统对象
    • 上传文件对象
    • 上传原始数据对象
Powered by GitBook
On this page
  • Gyp文件
  • 组件构建
  • 最小引导
  • 双相(Two-Phase)项目生成
  • Target名称
  • 相关测试

Was this helpful?

构建系统概述

Previous构建说明(Windows)Next编码规范

Last updated 4 years ago

Was this helpful?

Electron使用进行项目生成,使用进行构建。项目配置可以在 .gyp和 .gypi文件中找到。

Gyp文件

下面的 gyp文件包含了构建Electron的主要规则:

  • electron.gyp定义了Electron本身是如何构建的。

  • common.gypi调整Node的构建配置,使其与Chromium一起构建。

  • brightray/brightray.gyp定义brightray是如何构建的,并包含与Chromium关联的默认配置。

  • brightray/brightray.gypi包括关于构建的一般构建配置。

组件构建

由于Chromium是一个相当大的项目,最终的连接阶段可能需要几分钟,这使得开发变得困难。

为了解决这个问题,Chromium引入了 组件构建,它将每个组件构建为一个单独的共享库,使得链接非常快,但牺牲了文件大小和性能。

在Electron中,我们采用了一个非常相似的方法:

对于 Debug构建,二进制将链接到共享库版本的Chromium组件,以实现快速链接时间;

对于 Release构建,二进制将链接到静态库版本,所以我们可以有最好的二进制大小和性能。

最小引导

运行引导脚本时,会下载所有Chromium的预构建二进制文件( libchromiumcontent)。默认情况下,将下载静态库和共享库,最终大小应在800MB和2GB之间,具体取决于平台。

默认情况下, libchromiumcontent是从Amazon Web Services下载的。

如果设置了 LIBCHROMIUMCONTENT_MIRROR环境变量,引导脚本将从中下载。

如果您在访问AWS时遇到问题,可以通过 export LIBCHROMIUMCONTENT_MIRROR = http:// 7xk3d2.dl1.z0.glb.clouddn.com /

如果你只想快速构建Electron来进行测试或开发,可以通过传递 --dev参数来下载共享库版本:

$ ./script/bootstrap.py --dev
$ ./script/build.py -c D

双相(Two-Phase)项目生成

在 Release和 Debug中,Electron 链接了不同配置的库。 gyp不支持为不同的配置配置不同的链接设置。

要解决这个问题,Electron使用 gyp的变量 libchromiumcontent_component来控制要使用的链接设置,并在运行 gyp时只生成一个目标。

Target名称

与大多数项目使用 Release和 Debug作为 target名称不同,Electron使用 R和 D。

这是因为 gyp随机崩溃,如果只有一个 Release或 Debug构建配置被定义,Electron只需要一次生成一个目标,如上所述。

这只会影响开发人员,如果你重新构建了 Electron则不受影响。

相关测试

使用以下方法测试您的更改符合项目编码规范:

$ npm run lint

测试功能使用:

$ npm test

每当您对Electron源代码进行更改时,您都需要在测试之前重新运行构建:

$ npm run build && npm test

只需将 .only附加到任何 describe或 it函数时调用:

describe.only('some feature',function(){
  // ...只有在这个块中的测试才会运行
})

或者,您可以使用mocha的 grep选项仅运行与给定的正则表达式模式匹配的测试:

$ npm test - --grep child_process

要使用发布版本运行测试:

$ npm test - -R

是 libchromiumcontent的镜像。

您可以通过使用Mocha的功能隔离您当前正在使用的特定测试或块,使测试套件运行更快。

包含本地模块(例如runas)的测试不能使用调试版本执行(有关详细信息,请参阅),使用发布版本。

gyp
ninja
libchromiumcontent-qiniu-mirror
独家测试
#2558