1. 引言
在完成了所有必要工具的安装和配置后,我们进入到获取 CEF 源码的阶段。对于 macOS 平台,CEF 的源码获取过程需要特别注意不同芯片架构(Intel 和 Apple Silicon)的区别以及版本管理。本文将详细介绍如何在 macOS 系统上获取并准备 CEF 源码,包括创建工作目录、下载初始代码以及同步依赖项等步骤。
2. 工作目录准备
2.1 创建目录结构
# 创建主要工作目录
mkdir -p ~/code/chromium_git
mkdir -p ~/code/automate
# 进入工作目录
cd ~/code
2.2 目录结构说明
-
~/code/chromium_git
:存放 Chromium 和 CEF 源码 -
~/code/automate
:存放自动化脚本 -
~/code/depot_tools
:工具集目录(之前已创建)
3. 下载自动化脚本
3.1 获取脚本
cd ~/code/automate
curl -o automate-git.py https://bitbucket.org/chromiumembedded/cef/raw/master/tools/automate/automate-git.py
3.2 创建更新脚本
在 ~/code/chromium_git
目录中创建 update.sh
:
cd ~/code/chromium_git
cat <<EOL > update.sh
#!/bin/bash
# 为 Intel Mac
python3 ../automate/automate-git.py \\
--download-dir=/Users/\$USER/code/chromium_git \\
--depot-tools-dir=/Users/\$USER/code/depot_tools \\
--no-distrib \\
--no-build \\
--branch=6533 \\
--x64-build
# 为 Apple Silicon Mac,替换最后一行为:
# --arm64-build
EOL
3.3 设置脚本权限
chmod 755 update.sh
4. 拉取源码
4.1 配置环境变量
# 设置基本环境变量
export CEF_USE_GN=1
export GN_DEFINES="is_official_build=true use_sysroot=true symbol_level=1"
export CEF_ARCHIVE_FORMAT=tar.bz2
# 对于 Apple Silicon Mac 额外添加
# export GN_DEFINES="is_component_build=true"
4.2 执行更新脚本
cd ~/code/chromium_git
./update.sh
???? 重要提示:
- 源码下载过程可能需要几个小时
- 确保有稳定的网络连接
- 需要大约 150GB 的磁盘空间
- 下载过程中可能出现断点续传
5. 源码管理
5.1 验证源码结构
# 检查目录结构
ls -la ~/code/chromium_git/chromium/src
ls -la ~/code/chromium_git/cef
5.2 目录说明
-
chromium/src
:Chromium 源码 -
cef
:CEF 源码 -
chromium/src/cef
:CEF 构建目录
6. 常见问题处理
6.1 网络问题
# 设置 git 代理
git config --global http.proxy http://proxy.example.com:8080
# 断点续传
# 重新运行 update.sh 脚本,会从断点继续
6.2 空间问题
如果磁盘空间不足:
- 清理其他不必要的文件
- 使用外部存储设备
- 确保至少有 150GB 可用空间
6.3 权限问题
# 修复权限问题
sudo chown -R $(whoami) ~/code/chromium_git
chmod -R u+w ~/code/chromium_git
7. 结语
通过本文的操作,我们已经完成了 CEF 源码的获取和准备工作。这个过程虽然看起来简单,但是正确的配置和足够的耐心是成功的关键。确保所有步骤都准确执行,这将为后续的编译工作打下坚实的基础。
在下一篇文章《CEF127 编译指南 MacOS 篇 - 配置编译环境(六)》中,我们将继续介绍如何配置编译环境,包括设置特定的 SDK 版本和编译参数等内容。让我们继续这个循序渐进的 CEF 编译之旅。