Brave 132 编译指南 Android 篇 - 配置编译环境 (五)

1. 引言

在上一节中，我们成功地将 Brave 浏览器的源代码克隆到了本地机器。现在，我们将进入编译前的关键步骤：配置编译环境。一个正确配置的开发环境是确保编译过程顺利进行、避免潜在问题的基石。本节将详细指导您如何安装和配置 Python、Node.js 等必要的开发工具，并特别强调如何切换到与 Chromium 132 相对应的 Brave 版本分支，为构建 Brave 132 Android 版做好充分准备。

2. 切换到指定版本分支 (Brave 1.75.155)

由于 Brave 浏览器是基于 Chromium 项目进行开发的，因此确保 Brave 代码与特定版本的 Chromium 内核相匹配至关重要。在本指南中，我们将以 Chromium 132 为例，它对应的 Brave 版本为 1.75.155。因此，在开始配置编译环境之前，我们需要将代码仓库切换到相应的版本分支。

cd brave-browser
# 确保您已进入 brave-browser 目录，该目录是您之前克隆 Brave 仓库的目录
git checkout -b Brave_1.75.155 v1.75.155

这两条命令的含义是：

• cd brave-browser: 切换到 brave-browser 目录，这是您之前克隆 Brave 仓库的目录。
• git checkout -b Brave_1.75.155 v1.75.155: 这条命令做了两件事：
  • checkout: 切换分支。
  • -b Brave_1.75.155: 创建一个名为 Brave_1.75.155 的新分支。
  • v1.75.155: 基于标签 v1.75.155 创建新分支。

执行完这条命令后，您的本地代码仓库将切换到 Brave_1.75.155 分支，该分支对应着 Brave 1.75.155 版本，也就是基于 Chromium 132 的版本。

3. 检查 Python 环境

3.1 安装 Python 3

Brave 的构建脚本和工具链广泛依赖于 Python，因此正确的 Python 环境至关重要。虽然许多 Linux 发行版已经预装了 Python，但为了确保兼容性，建议安装 Python 3：

sudo apt install python3

3.2 检查 Python 3 版本

安装完成后，通过以下命令验证 Python 3 是否安装成功以及版本是否正确：

python3 --version

该命令将输出已安装的 Python 3 版本信息。

4. 使用 python-is-python3 确保 python 命令指向 Python 3

在某些 Linux 系统中，python 命令可能仍然指向 Python 2。为了确保构建脚本能够正确地调用 Python 3，我们需要安装 python-is-python3 软件包：

4.1 安装 python-is-python3

sudo apt install python-is-python3

4.2 验证 python 命令

安装 python-is-python3 后，再次使用以下命令验证 python 命令是否已正确指向 Python 3：

python --version

该命令现在应该输出 Python 3 的版本信息。

5. 安装 Python 额外软件包

根据 Brave 官方构建文档的要求，对于 Ubuntu 系统，我们还需要安装一些额外的 Python 软件包：

sudo apt-get install build-essential python3-setuptools

这些软件包包含了编译 C/C++ 代码所需的工具以及 Python 的 setuptools 模块，它们是构建过程中的必要组件。

6. 检查 Node.js 环境 (LTS v20+)

Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行时环境，它在 Brave 的构建过程中扮演着重要角色，用于执行各种前端构建任务和工具。Brave 官方推荐使用 Node.js 20.x (LTS) 版本。

6.1 安装 Node.js 20.x

sudo apt install curl
# 确保系统中已安装了 curl，如果没有安装则先安装
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

这些命令的含义是：

1. sudo apt install curl: 安装 curl 工具，用于下载 Node.js 安装脚本。
2. curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -: 这条命令做了两件事：
   • curl -fsSL https://deb.nodesource.com/setup_20.x: 下载 Node.js 20.x 的安装脚本。
   • sudo -E bash -: 以 root 权限执行下载的脚本。
3. sudo apt install -y nodejs: 使用 apt 安装 Node.js。

6.2 验证 Node.js 版本

安装完成后，通过以下命令验证 Node.js 是否安装成功以及版本是否正确：

node --version

该命令将输出已安装的 Node.js 版本信息，确保版本号为 20.x。

7. 结语

本节详细介绍了如何为 Brave 132 Android 版的编译配置开发环境，包括切换到正确的代码分支、安装和配置 Python 3、确保 python 命令指向 Python 3、安装必要的 Python 软件包，以及安装和验证 Node.js 20.x。正确配置这些环境是成功编译 Brave 的关键前提。在下一节中，我们将开始初始化构建环境，为实际的编译工作做好最后的准备。