Chromium 134 编译指南 - Android 篇：安装构建依赖项（七）

1. 引言

欢迎来到《Chromium 134 编译指南》系列的第七篇文章！在前面的章节中，我们已经成功获取了Chromium源代码，并将其配置为支持Android平台。这些步骤为我们的编译之旅奠定了坚实的基础，但在开始实际编译之前，我们还需要安装一些特定的构建依赖项。

想象一下，如果编译Chromium是烹饪一道复杂的菜肴，那么源代码就是主要食材，而构建依赖项则是必不可少的调料和厨具。没有这些工具和辅助材料，即使拥有最好的食材，我们也无法完成烹饪过程。

这些构建依赖项主要包括Android SDK（软件开发工具包）、NDK（原生开发工具包）以及其他必要的工具链和库文件。它们共同构成了编译Android应用所需的完整工具集。好消息是，Chromium项目提供了自动化脚本，可以帮助我们一键安装所有这些依赖项，大大简化了配置过程。

在本篇文章中，我们将详细介绍如何使用这些脚本安装必要的构建依赖项，处理可能遇到的问题，并确保开发环境完全准备就绪。让我们开始这个关键的配置步骤吧！

2. 安装构建依赖项

安装Chromium编译所需的依赖项是一个相对简单的过程，因为Chromium项目提供了自动化脚本来处理大部分工作。这些脚本会检测您的系统环境，并安装所有必要的组件。

2.1 了解构建依赖项的重要性

在开始安装之前，让我们先了解一下为什么这些依赖项如此重要：

• Android SDK：提供编译和打包Android应用所需的工具和API
• Android NDK：用于开发Android原生组件（C/C++代码）的工具集
• 构建工具：包括各种编译器、链接器和其他构建工具
• 系统库：提供基础功能的各种库文件
• 开发依赖：支持开发过程的各种工具和库

小知识：Chromium为Android平台编译时，既包含Java代码（使用SDK编译），也包含大量C++代码（使用NDK编译）。这些不同语言的代码需要不同的工具链来处理，因此依赖项比单纯的Android应用更加复杂。

2.2 运行安装依赖脚本

Chromium提供了一个名为install-build-deps.sh的脚本，用于自动安装所有必要的依赖项。这个脚本位于源代码的build目录下。

首先，确保您在Chromium的src目录中：

# 确保在src目录中
cd ~/chromium/src

然后，运行依赖安装脚本，并指定Android平台：

# 运行安装依赖脚本
build/install-build-deps.sh --android

这个命令的含义：

• build/install-build-deps.sh：调用安装依赖的脚本
• --android：指定安装Android平台所需的依赖项

注意：这个脚本需要root权限来安装系统级依赖，因此可能会要求您输入密码。

当脚本运行时，您会看到类似这样的输出：

Checking for apt-get...
apt-get detected.
Checking for Ubuntu version...
Ubuntu 24.04 detected.
Installing dependencies for Ubuntu...
Reading package lists...
Building dependency tree...

脚本会自动检测您的系统类型和版本，然后安装相应的依赖项。这个过程可能需要一些时间，取决于您的网络速度和计算机性能。

2.3 处理系统不支持的问题

在运行安装脚本时，您可能会遇到系统版本不受支持的提示。这通常发生在使用较新或较旧的Linux发行版时。

如果遇到类似以下的错误信息：

ERROR: The only supported distros are...

您有两种解决方案：

2.3.1 升级系统到支持的版本

如果条件允许，将系统升级到脚本支持的版本是最佳选择。这样可以确保最佳的兼容性和支持。

2.3.2 使用--unsupported参数跳过检查

如果您不方便升级系统，或者确信当前系统能够兼容，可以使用--unsupported参数跳过系统版本检查：

# 跳过系统版本检查
build/install-build-deps.sh --android --unsupported

风险提示：使用 --unsupported参数意味着您将在未经官方测试的环境中编译Chromium。这可能会导致编译错误或其他意外问题。只有在您了解风险的情况下才使用此选项。

2.4 验证依赖项安装

依赖项安装完成后，您可以通过检查关键组件是否存在来验证安装是否成功：

# 检查Android SDK是否正确安装
ls -la third_party/android_sdk# 检查Android NDK是否正确安装
ls -la third_party/android_ndk

如果这些目录存在并包含文件，说明基本依赖项已成功安装。

3. 运行钩子脚本

安装基本依赖项后，我们还需要运行"钩子"(hooks)脚本，以下载一些额外的二进制文件和资源。钩子是Chromium构建系统中的特殊脚本，用于执行额外的设置步骤。

确保您仍在src目录中，然后运行：

# 运行钩子脚本
gclient runhooks

这个命令会执行.gclient文件中定义的所有钩子脚本，下载并设置额外的组件。您可能会看到类似以下的输出：

________ running 'vpython src/build/landmines.py' in '/home/user/chromium'
Landmines identified 6 path(s) to clobber based on 17 specifications.
________ running 'vpython src/build/gyp_chromium' in '/home/user/chromium'

小贴士： gclient runhooks命令可以随时运行，特别是在切换分支或更新代码后，以确保所有依赖项都是最新的。

3.1 钩子脚本的作用

钩子脚本执行的主要任务包括：

• 下载预编译的工具和二进制文件
• 生成必要的构建文件
• 配置编译环境
• 设置路径和环境变量
• 准备各种资源文件

这些任务对于确保编译环境的完整性至关重要。

3.2 常见问题及解决方法

运行钩子脚本时可能会遇到一些问题，以下是常见问题及其解决方法：

1. 网络连接问题

如果遇到下载失败的错误，可以尝试重新运行钩子脚本：

gclient runhooks

脚本会从中断处继续，而不是从头开始。

1. 权限问题

如果遇到权限错误，确保您对Chromium目录有足够的写入权限：

# 修复权限问题
sudo chown -R $(whoami) ~/chromium

1. Python相关错误

如果遇到Python错误，可能是因为Chromium使用的Python版本与系统默认不同。尝试让脚本使用正确的Python版本：

# 使用depot_tools中的Python
PATH="$HOME/depot_tools:$PATH" gclient runhooks

4. 总结

通过本篇文章的指导，您已经成功安装了编译Chromium 134 for Android所需的所有构建依赖项。这些依赖项为后续的编译工作提供了必要的工具和资源支持。

回顾一下我们所完成的工作：

1. 了解了构建依赖项的重要性和组成
2. 使用自动化脚本安装了基本依赖项
3. 学习了如何处理系统不支持的情况
4. 运行了钩子脚本，下载和配置了额外的组件
5. 了解了常见问题的解决方法

这些步骤确保了您的开发环境已经完全准备就绪，为实际编译Chromium打下了坚实的基础。虽然依赖项的安装可能看起来只是一个中间步骤，但它对于成功编译至关重要，就像一座大楼需要坚实的地基一样。

在下一篇文章《Chromium 134 编译指南 - Android 篇：开始编译（八）》中，我们将正式进入编译阶段，详细介绍如何配置编译参数，执行编译命令，以及处理编译过程中可能遇到的问题。我们将把所有前期准备工作转化为一个实际可用的Android应用。

敬请期待我们的下一篇文章，Chromium编译之旅即将迎来高潮！