当前位置：首页 > article >正文

CEF132 编译指南 Linux 篇 - CEF 编译实战：构建 CEF（六）

article 2026/4/19 2:07:39

1. 引言

经过前几篇的精心准备，我们已经完成了所有必要的环境配置和源码下载。现在，我们将进入激动人心的 CEF 编译阶段。本篇将详细指导你在 Linux 系统上编译 CEF 6834 分支（对应 Chromium 132 版本），包括创建项目文件、执行编译过程以及处理可能遇到的问题。按照本篇的步骤，你将能够成功构建 CEF 的发布版本。

2. 编译前的准备工作

2.1 确认环境变量

在开始编译之前，我们需要再次确认必要的环境变量已正确设置：

# 检查环境变量
echo $GN_DEFINESecho $CEF_ARCHIVE_FORMAT
# 如果未设置，重新设置
export GN_DEFINES="is_official_build=true use_sysroot=true symbol_level=1 is_cfi=false proprietary_codecs=true ffmpeg_branding=Chrome"
export CEF_ARCHIVE_FORMAT=tar.bz2

2.2 确认源码位置

验证源码目录结构是否正确：

cd ~/cef132/chromium_git/chromium/src/cef
ls -la

3. 生成项目文件：构建的蓝图

3.1 执行项目生成脚本

cd ~/cef132/chromium_git/chromium/src/cef
./cef_create_projects.sh

重要提示： 如果你修改了任何 GN 配置文件（如 BUILD.gn），都需要重新运行此脚本，以确保构建配置的正确性。

4. 执行编译：CEF 的诞生

4.1 使用 automate-git.py 执行编译

现在，我们可以使用 automate-git.py 脚本执行完整的编译过程：

cd ~/cef132/automate
python3 ./automate-git.py \  --download-dir=/home/$USER/cef132/chromium_git \  --depot-tools-dir=/home/$USER/depot_tools \  --branch=6834 \  --minimal-distrib \  --client-distrib \  --force-clean \  --build-target=cefsimple \  --x64-build \  --no-debug-build \  --with-pgo-profiles \ --no-chromium-update

参数说明：

--branch=6834：指定 CEF 132 版本对应的分支。
--minimal-distrib：生成最小化分发包，包含运行 CEF 的最小文件集。
--client-distrib：生成客户端分发包，包含用于开发 CEF 应用程序的头文件和库文件。
--force-clean：强制清理之前的构建文件，确保构建的纯净性。
--build-target=cefsimple：指定构建目标为 cefsimple 示例程序，用于验证编译结果。
--x64-build：指定构建 64 位版本的 CEF。
--no-debug-build: 取消编译debug版本
--with-pgo-profiles：使用 PGO（Profile-Guided Optimization）优化配置，提升性能。

4.2 使用 Ninja 直接构建

如果你需要单独构建某个组件，或者进行增量构建，可以直接使用 Ninja：

cd ~/cef132/chromium_git/chromium/srcautoninja -C out/Release_GN_x64 cefsimple

5. 验证编译成果

5.1 检查输出文件

编译完成后，检查输出目录，确认编译生成的文件：

cd ~/cef132/chromium_git/chromium/src/out/Release_GN_x64ls -la

5.2 运行 cefsimple 示例程序

运行编译生成的 cefsimple 示例程序，测试 CEF 是否正常工作：

cd ~/cef132/chromium_git/chromium/src
./out/Release_GN_x64/cefsimple

6. 常见问题及优化建议

6.1 编译错误解决方案

内存不足：

# 增加交换分区大小
sudo swapoff -asudo fallocate -l 16G /swapfile 
# 或者更大的swap空间，根据你自己的情况
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

构建超时：

# 重新运行编译命令，Ninja 会从上次中断的地方继续编译
python3 automate-git.py [之前的参数]

依赖错误：

# 更新系统并重新安装依赖sudo apt-get update && sudo apt-get upgrade
sudo python3 ~/cef132/install-build-deps.py --no-arm --no-chromeos-fonts --no-nacl

6.2 编译优化建议

提高编译速度：

# 使用多线程编译，利用所有 CPU 核心
export NINJA_JOBS=$(nproc)

减少内存使用：

# 限制 Ninja 的并行任务数，避免内存耗尽
export NINJA_JOBS=4 # 或者更小的数字，具体取决于你的机器配置

7. 结语

至此，我们完成了 CEF 6834 分支（对应 Chromium 132 版本）在 Linux 环境下的完整编译过程。通过遵循本系列文章的指导，你应该已经成功构建了 CEF 框架。这个过程虽然复杂，但是通过正确的配置和耐心的执行，我们最终达到了目标。

CEF 的编译是一个对系统资源要求较高的过程，可能会遇到各种挑战。但是通过本系列文章的指导，相信你已经掌握了在 Linux 环境下编译 CEF 的完整知识。如果在实践中遇到问题，请参考本文提供的故障排除指南，或查阅 CEF 官方文档获取更多信息。希望你能享受到CEF带来的便利，祝你开发工作一切顺利！