需要能够科学上网,下载相关技术资料。
1.文件结构
所有平台都将使用相同的文件结构。“~”可以是不包含空格或特殊字符的任何路径。我们将在以下部分为每个平台构建此目录结构。
~/code/
automate/
automate-git.py <-- CEF build script
chromium_git/
cef/ <-- CEF source checkout
chromium/
src/ <-- Chromium source checkout
update.[bat|sh] <-- Bootstrap script for automate-git.py
depot_tools/ <-- Chromium build tools
使用此文件结构,您可以并排开发多个 CEF/Chromium 分支。例如,使用“chromium_git1”而不是“chromium_git”作为目录名重复以下说明。
2.Mac OS X 设置
2.1 需要什么
- BranchesAndBuilding Wiki 页面上列出的 macOS 构建要求。
- 所有版本都支持在 Intel Mac 上构建。从 M93(4577 分支)开始支持在 Apple Silicon (ARM64) Mac 上构建。
- 至少 8GB RAM(推荐 16GB+)和 100GB 可用磁盘空间(用于调试版本)。
- 使用快速互联网连接 (100Mbps) 和快速构建机器(2.4Ghz、16 个逻辑核心、SSD)大约需要 4 小时。
2.2 分步指南
在这个例子中,“”是“/Users/marshall”。请注意,在某些情况下必须使用绝对路径。本节中描述的环境变量可以添加到您的“/.bash_profile”文件中,以便跨会话保存它们。
1.创建以下目录。
mkdir ~/code
mkdir ~/code/automate
mkdir ~/code/chromium_git
2.使用 Git 下载“~/code/depot_tools”。
cd ~/code
git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git
3.将“~/code/depot_tools”目录添加到您的 PATH。注意这里使用了绝对路径。
export PATH=/Users/marshall/code/depot_tools:$PATH
4.将automate-git.py脚本下载到“~/code/automate/automate-git.py”。
5.使用以下内容创建“~/code/chromium_git/update.sh”脚本。
#!/bin/bash
python ../automate/automate-git.py --download-dir = /Users/marshall/code/chromium_git --depot-tools-dir = /Users/marshall/code/depot_tools --no -distrib --no-build --x64-build
替换–x64-build用–arm64-build,如果使用的是 Apple Silicon Mac,而不是Intel Mac。给它可执行权限。
cd ~/code/chromium_git
chmod 755 update.sh
运行“update.sh”脚本并等待 CEF 和 Chromium 源代码下载。CEF 源代码将下载到“~/code/chromium_git/cef ”,Chromium 源代码将下载到“~/code/chromium_git/chromium/src”。下载完成后,CEF 源代码将被复制到“~/code/chromium_git/chromium/src/cef”。
cd ~/code/chromium_git
./update.sh
6.运行“~/code/chromium_git/chromium/src/cef/cef_create_projects.sh”脚本,创建Ninja工程文件。如果在 GN 配置(BUILD.gn 文件)中更改项目配置或添加/删除文件,请重复此步骤。
cd ~/code/chromium_git/chromium/src/cef
./cef_create_projects.sh
如果使用 Apple Silicon Mac 而不是 Intel Mac,请export GN_DEFINES=is_component_build=true在运行前添加cef_create_projects.sh。
7.使用 Ninja 创建 CEF/Chromium 的调试版本。在“~/code/chromium_git/chromium/src/cef”处编辑 CEF 源代码并多次重复此步骤以在开发时执行增量构建。
cd ~/code/chromium_git/chromium/src
ninja -C out/Debug_GN_x64 cef
如果使用 Apple Silicon Mac 而不是 Intel Mac,请将“x64”替换为“arm64”。将“调试”替换为“发布”以生成发布版本而不是调试版本。
8.运行生成的 cefclient、cefsimple 和/或 ceftests 示例应用程序。
cd ~/code/chromium_git/chromium/src
open out/Debug_GN_x64/cefclient.app
# 或者直接在控制台运行查看日志输出:
./ out/Debug_GN_x64/cefclient.app/Contents/MacOS/ cefclient
4.作者答疑
如有疑问,请留言。