Brave 132 编译指南 Android 篇 - 获取源代码 (四)

1. 引言

在之前的章节中，我们详细探讨了 Brave 132 浏览器的独特优势、Android 项目的精妙结构，以及编译所需的系统软硬件环境和推荐工具。至此，我们已经为编译 Brave 132 Android 版做好了充分的前期准备。现在，我们将迈出编译之旅的第一个实质性步伐：获取 Brave 的源代码。这将为我们后续的编译、定制和开发工作奠定坚实的基础。

2. Brave 源代码的获取途径

Brave 秉承开源精神，其源代码托管在 GitHub 这一全球最大的代码托管平台上，任何人都可以自由地获取、查看和学习。对于 Android 版本的编译，我们需要关注以下几个关键的源码仓库：

• Brave 浏览器官方仓库: GitHub - brave/brave-browser: Brave browser for Android, iOS, Linux, macOS, Windows.
  • 这是 Brave 浏览器的主要代码仓库，包含了 Brave 在各个平台（包括 Android）的完整代码。我们需要从这个仓库拉取代码来构建 Android 版本。
• Brave 核心代码 (brave-core): GitHub - brave/brave-core: Core engine for the Brave browser for mobile and desktop. For issues https://github.com/brave/brave-browser/issues
  • 这个仓库包含了 Brave 浏览器的核心功能实现，是 Brave 的重要组成部分。虽然我们主要从 brave-browser 仓库拉取代码，但了解 brave-core 的作用也是很有帮助的。
• 广告拦截模块 (adblock-rust): GitHub - brave/adblock-rust: Brave's Rust-based adblock engine
  • 这是 Brave 浏览器中负责广告拦截的核心模块，使用 Rust 语言编写。在编译过程中，构建系统会自动处理 adblock-rust 的构建。

3. Git 和版本控制工具的安装与配置

3.1 Git 简介

Git 是一款功能强大的分布式版本控制系统，已成为软件开发领域的事实标准，尤其在开源项目协作开发中扮演着至关重要的角色。Brave 项目全面采用 Git 进行版本管理，因此，熟练掌握 Git 的基本操作是参与 Brave 开发的必备技能。

3.2 安装 Git

在 Ubuntu 以及大多数主流 Linux 发行版中，通过系统自带的包管理器即可轻松安装 Git：

sudo apt-get update  
# 更新软件包列表
sudo apt-get install git  
# 安装 Git

安装完成后，可以通过以下命令验证 Git 是否安装成功：

git --version

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

3.3 Git 配置

在使用 Git 进行任何操作之前，我们需要配置好用户的身份信息，包括用户名和邮箱地址。这些信息将作为您提交代码的身份标识，记录在版本历史中。

git config --global user.name "Your Name"
# 将 "Your Name" 替换为您的名字
git config --global user.email "your_email@example.com"  
# 将 "your_email@example.com" 替换为您的邮箱地址

4. 从官方仓库拉取源代码

4.1 创建工作目录

首先，我们需要创建一个专门用于存放 Brave 源代码的工作目录。为了便于管理，建议将所有与 Brave 编译相关的文件都放在这个目录下。

mkdir brave-browser
# 创建一个名为 brave-browser的目录，用于存放 Brave Android 项目相关文件，您可以根据自己喜好命名
cd brave-browser   
# 切换到该目录

4.2 克隆 Brave 浏览器仓库

接下来，我们将使用 git clone 命令将 Brave 浏览器的官方仓库克隆到本地。由于我们是要编译 Android 版本，因此我们需要克隆 brave-browser 仓库。

git clone https://github.com/brave/brave-browser.git ./

这条命令会将 brave-browser 仓库的所有代码克隆到当前目录（brave-android）下。由于 Brave 项目的代码量较大，克隆过程可能需要一些时间，请耐心等待。

注意: 这里我们直接克隆到了当前目录下 (./)。你也可以根据需要克隆到指定子目录，例如 ./src。

5. 结语

在本节中，我们成功安装了 Git 并进行了基本配置，然后从 Brave 的官方 GitHub 仓库克隆了 brave-browser 的源代码到本地。这标志着我们已经完成了编译准备工作中的关键一步，为后续的编译工作奠定了坚实的基础。在接下来的章节中，我们将着手配置 Android 编译环境，包括安装必要的依赖项和工具，为最终构建 Brave 132 Android 版应用做好最后的准备。