在 Android 开发中，repo 是 Google 用来管理多 Git 仓库的一种工具。Android 项目代码由多个 Git 仓库组成，repo 提供了一个高效的机制来批量管理这些仓库，尤其适用于大型项目和团队协作。
1. 什么是 Repo 工具？
repo 是一个基于 Python 的脚本工具，封装了多条 Git 命令，帮助管理 Android 源码中的多个 Git 仓库。它主要解决的问题包括：
- 批量同步、管理多个 Git 仓库。
- 支持分支操作、提交和变更审查等功能。
- 简化多个项目的版本控制。
注意：repo本身不是版本控制工具，而是一个用于管理多个 Git 仓库的工具。
2. Repo 安装
在 Linux 或 macOS 系统中，安装 repo 工具可以使用以下命令：
mkdir ~/bin
PATH=~/bin:$PATH
curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
chmod a+x ~/bin/repo
添加 PATH 之后，即可在终端中使用 repo 命令。
3. 使用 Repo 初始化项目
在初始化项目时，repo 会读取一个叫做 manifest 的 XML 配置文件，它定义了项目中需要的 Git 仓库和版本。使用以下命令初始化项目：
repo init -u -b
- -u <manifest_url>：指定 manifest 文件的 Git 仓库地址。
- -b <branch>：指定分支名称，通常指 Android 的版本分支。
示例
repo init -u https://android.googlesource.com/platform/manifest -b android-13.0.0_r3
4. Repo 命令详解
4.1 常用命令
以下是一些常用的 repo 命令：
| 命令 | 描述 |
|---|---|
| repo init | 初始化项目目录，下载 manifest 配置文件。 |
| repo sync | 同步代码，克隆或更新项目中所有 Git 仓库。 |
| repo start <branch> | 在所有仓库中创建新的本地分支。 |
| repo status | 显示项目中各仓库的变更状态。 |
| repo diff | 显示项目中的差异。 |
| repo upload | 上传本地提交以供代码审查，通常与 Gerrit 配合使用。 |
| repo forall | 在项目的所有仓库中执行特定的 Git 命令。 |
示例
- 同步代码：
repo sync
- 查看变更状态：
repo status
- 在所有仓库中执行命令：
repo forall -c 'git checkout -b new_feature'
4.2 repo 配置选项
repo 工具支持多种配置选项，例如：
- –no-clone-bundle：禁用预先克隆的包文件（适用于网络连接不佳的场景）。
- –depth：设置克隆的深度，用于节省下载时间和空间。
5. Manifest 文件详解
manifest 文件是一个 XML 文件，定义了项目中每个仓库的位置、分支、路径等信息。它包含以下主要标签：
5.1 <manifest>
manifest 文件的根标签。
5.2 <remote>
定义仓库的远程信息，包括 name、fetch 等属性。
<remote name="aosp" fetch="https://android.googlesource.com/" />
5.3 <default>
定义默认属性，应用于其他标签。
<default revision="main" remote="aosp" />
5.4 <project>
定义项目的 Git 仓库，通常包含 name、path 和 revision 等属性。
<project name="platform/frameworks/base" path="frameworks/base" revision="master" />
5.5 <group>
用于对项目进行分组，方便在不同设备或模块间切换项目。
<project name="platform/packages/apps/Settings" groups="default,optional" />
示例 Manifest 文件
<manifest><remote name="aosp" fetch="https://android.googlesource.com/" /><default revision="main" remote="aosp" sync-j="4" /><project name="platform/frameworks/base" path="frameworks/base" /><project name="platform/packages/apps/Settings" path="packages/apps/Settings" />
</manifest>
6. 小结
repo 工具是管理 Android 项目源码的重要工具，它基于 manifest 文件，支持对多个 Git 仓库的批量操作。对于大型项目，repo 提供了同步代码、管理分支、审查提交等功能，大大提高了效率。通过 repo，开发者可以轻松获取、管理和构建 Android 的整个源码树。
