repo使用介绍

repo 是 Google 为管理大型项目而开发的工具，特别适用于包含多个 Git 仓库的项目。它在管理 Android 操作系统的源代码中非常流行，因其简化了多个子仓库的版本控制、依赖管理和同步操作。 repo 的核心思想是使用 manifest 文件来统一管理和组织子仓库，形成一个逻辑上的整体项目。下面详细介绍 repo 的原理、使用方法以及在 Linux 系统中的多种部署方式。

---

一、repo 原理

repo 通过 manifest 文件来定义多个 Git 仓库的路径、分支、URL 等信息，这些信息共同构成项目的仓库组织结构。

• manifest 文件：manifest 文件一般使用 XML 格式，位于一个独立的 manifest 仓库中，文件中详细列出各子仓库的 URL、分支、存储路径等。通过 manifest 文件，repo 工具可以轻松同步、管理多个仓库。
• .repo 目录：在项目目录下，.repo 目录用于存放 manifest 仓库及管理项目元数据，包含仓库的配置信息。
• 版本控制：通过在 manifest 文件中定义版本（分支或标签），项目可以确保各子仓库的版本一致性，避免由于不兼容的版本而出现的错误。

二、repo 使用详解

1. 安装 repo 工具

在 Linux 系统中，repo 工具可以直接下载并赋予可执行权限。

# 下载 repo 工具
curl https://storage.googleapis.com/git-repo-downloads/repo > /usr/local/bin/repo
chmod a+x /usr/local/bin/repo

2. 初始化项目 (repo init)

repo init 命令用于初始化项目，并指定 manifest 仓库和分支信息。初始化时，repo 会在项目目录创建 .repo 目录并克隆 manifest 文件。

repo init -u <manifest-repo-url> -b <branch-name>

• -u：指定 manifest 仓库的 URL。
• -b：指定初始化时使用的分支或标签。

3. 同步项目代码 (repo sync)

使用 repo sync 命令同步所有子仓库的代码。它根据 manifest 文件的定义，将所有子仓库代码拉取到本地，适用于首次拉取和日常更新。

repo sync

4. 查看项目状态 (repo status)

repo status 用于查看每个子仓库的状态，包含本地更改或分支信息。适用于开发过程中检查各个仓库的工作状态。

repo status

5. 管理分支 (repo start)

在所有子仓库或指定子仓库中创建新的本地分支，方便在多仓库项目中管理统一的开发分支。

repo start <branch-name>