CEF127 编译指南 Linux篇 - 编译CEF(六)

1. 引言

经过前面的准备工作，我们已经完成了所有必要的环境配置。本文将详细介绍如何在 Linux 系统上编译 CEF127，包括创建项目文件、执行编译过程以及处理可能遇到的问题。按照本文的步骤，您将能够成功构建 CEF 的发布版本。

2. 编译准备

2.1 确认环境变量

首先确认必要的环境变量已正确设置：

# 检查环境变量
echo $GN_DEFINES
echo $CEF_ARCHIVE_FORMAT

# 如果未设置，重新设置
export GN_DEFINES="is_official_build=true use_sysroot=true symbol_level=1 is_cfi=false"
export CEF_ARCHIVE_FORMAT=tar.bz2

2.2 确认源码位置

验证源码目录结构：

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

3. 创建项目文件

3.1 生成项目配置

执行 CEF 的项目生成脚本：

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

📢

注意：如果修改了任何 GN 配置文件（BUILD.gn），都需要重新运行此脚本。

4. 执行编译

4.1 Release 版本编译

使用 automate-git.py 执行完整的编译过程：

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

参数说明：

• --branch=6533：指定 CEF127 对应的分支
• --minimal-distrib：生成最小化分发包
• --client-distrib：生成客户端分发包
• --force-clean：强制清理旧的构建文件
• --build-target=cefsimple：指定构建目标
• --x64-build：生成64位版本
• --with-pgo-profiles：使用 PGO 优化配置

4.2 单独构建组件

如果需要单独构建某个组件，可以使用 ninja：

cd ~/cef127/chromium_git/chromium/src
autoninja -C out/Release_GN_x64 cefsimple

5. 验证编译结果

5.1 检查输出文件

编译完成后，检查输出目录：

cd ~/cef127/chromium_git/chromium/src/out/Release_GN_x64
ls -la

5.2 运行测试程序

测试编译结果：

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

6. 常见问题处理

6.1 编译错误解决方案

1. 内存不足

   增加交换空间

   sudo swapoff -a
   sudo fallocate -l 16G /swapfile
   sudo mkswap /swapfile
   sudo swapon /swapfile

2. 构建超时

   重新运行编译命令，会从断点继续

   python3 automate-git.py [之前的参数]

3. 依赖错误

   更新系统并重新安装依赖

   sudo apt-get update && sudo apt-get upgrade
   sudo python3 ./install-build-deps.py --no-arm

6.2 优化建议

1. 提高编译速度：

   使用多线程编译

   export NINJA_PARALLEL_JOBS=$(nproc)

2. 减少内存使用：

   限制并行任务数

   export NINJA_PARALLEL_JOBS=4

7. 结语

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

CEF 的编译是一个要求较高的过程，可能会遇到各种挑战。但是通过本系列文章的指导，相信您已经掌握了在 Linux 环境下编译 CEF 的完整知识。如果在实践中遇到问题，请参考本文提供的故障排除指南，或查阅 CEF 官方文档获取更多信息。