Repo 可以用来整合 Git 代码库，代码上传到 Gerrit 修订版本控制系统。Repo 只是为了在 Android 环境中更轻松地使用 Git。
repo 安装和配置
# Debian/Ubuntu.
$ sudo apt-get install repo
$ mkdir -p ~/.bin
$ PATH="${HOME}/.bin:${PATH}"
$ curl https://storage.googleapis.com/git-repo-downloads/repo > ~/.bin/repo
$ chmod a+rx ~/.bin/repo
1、repo命令的使用方法
$ repo [command] [options]
$ repo help //帮助
$ repo help <COMMAND>
2、repo init
该命令创建一个 .repo/ 目录，其中包含用于 Repo 源代码和标准 Android 清单文件的 Git 代码库。
$ repo init -u <URL> [<OPTIONS>] //在当前目录中安装 Repo
参数：
-u：指定要从中检索清单代码库的地址。
-m：在代码库中选择清单文件。如果未选择任何清单名称，则会默认选择 default.xml。
-b：指定分支。
#注意：对于其余的所有 Repo 命令，当前工作目录必须是 .repo/ 的父目录或相应父目录的子目录
3、repo sync
$ repo sync [<PROJECT_LIST>] //同步代码
选项：
-d：将指定项目切换回指定分支。
-f：即使某个项目同步失败，系统也会继续同步其他项目。
repo sync 运行成功后，指定项目中的代码会与远程代码库中的代码保持同步。
* 如果目标项目从未同步过，则 repo sync 相当于 git clone。
* 如果目标项目已同步过，则 repo sync 相当于以下命令：
git remote update
git rebase origin/<BRANCH>
如果 git rebase 操作导致合并冲突，那么您需要使用普通 Git 命令（例如 git rebase --continue）来解决冲突。
4、repo upload
repo upload [<PROJECT_LIST>] //上传代码
您选择一个或多个分支后，所选分支上的所有提交都会通过 HTTPS 连接传输到 Gerrit.
如果您在未使用任何参数的情况下运行 repo upload，则该操作会搜索所有项目中的更改以进行上传。
要在更改上传之后对其进行修改,应使用 git rebase -i 或 git commit --amend
5、repo diff
repo diff [<PROJECT_LIST>]
显示提交的代码和当前工作目录代码之间的差异。
6、repo download
下载特定的修改版本到本地
repo download <TARGET> <CHANGE>
例如：$ repo download platform/build 23823
repo sync 应该可以有效移除通过 repo download 检索到的任何提交
7、repo forall
这个命令会遍历所有的git仓库，并在每个仓库执行-c所指定的命令
repo forall [<PROJECT_LIST>] -c <COMMAND>
选项：
-c：要运行的命令和参数。
-p：可以在遍历到每个仓库的时候先打印出当前的pwd
-v：显示该命令向 stderr 写入的消息。
在每个项目中运行指定的 shell 命令。通过 repo forall 可使用下列额外的环境变量：
REPO_PROJECT 可设为项目的具有唯一性的名称。
REPO_PATH 是客户端根目录的相对路径。
REPO_REMOTE 是清单中远程系统的名称。
REPO_LREV 是清单中修订版本的名称，已转换为本地跟踪分支。如果您需要将清单修订版本传递到某个本地运行的 Git 命令，则可使用此变量。
REPO_RREV 是清单中修订版本的名称，与清单中显示的名称完全一致。
8、repo prune
删除已经merge的分支
repo prune [<PROJECT_LIST>]
9、repo start
创建分支
repo start <BRANCH_NAME> [<PROJECT_LIST>]
<BRANCH_NAME> 参数应简要说明您尝试对项目进行的更改。如果您不知道，则不妨考虑使用默认名称。
<PROJECT_LIST> 指定了将参与此分支的项目。
#注意：“.”是一个非常实用的简写形式，用来代表当前工作目录中的项目。
10、repo status
repo status [<PROJECT_LIST>]
显示 project 中每个仓库的状态，并打印仓库名称
要仅查看当前分支的状态，请运行 repo status。系统会按项目列出状态信息。
在第一列中，大写字母表示暂存区与上次提交状态之间的不同之处。
字母 含义 说明
- 无更改 HEAD 与索引中相同
A 已添加 不存在于 HEAD 中，但存在于索引中
M 已修改 存在于 HEAD 中，但索引中的文件已修改
D 已删除 存在于 HEAD 中，但不存在于索引中
R 已重命名 不存在于 HEAD 中，但索引中的文件的路径已更改
C 已复制 不存在于 HEAD 中，已从索引中的另一个文件复制
T 模式已更改 HEAD 与索引中的内容相同，但模式已更改
U 未合并 HEAD 与索引之间存在冲突；需要解决方案
在第二列中，小写字母表示工作区与索引之间的不同之处。
字母 含义 说明
- 新/未知 不存在于索引中，但存在于工作区中
m 已修改 存在于索引中，也存在于工作区中（但已修改）
d 已删除 存在于索引中，不存在于工作区中
11、repo foreach [ project-lists] -c command
对每一个 project 运行 command 命令
===============================================================
资料：
- Homepage:
https://gerrit.googlesource.com/git-repo/ - Mailing list:
repo-discuss on Google Groups - Bug reports:
https://bugs.chromium.org/p/gerrit/issues/list?q=component:repo - Source:
https://gerrit.googlesource.com/git-repo/ - Overview:
https://source.android.com/source/developing.html - Docs:
https://source.android.com/source/using-repo.html - repo Manifest Format:
https://gerrit.googlesource.com/git-repo/+/refs/heads/master/docs/manifest-format.md - repo Hooks:
https://gerrit.googlesource.com/git-repo/+/refs/heads/master/docs/repo-hooks.md - Submitting patches:
https://gerrit.googlesource.com/git-repo/+/refs/heads/master/SUBMITTING_PATCHES.md - Running Repo in Microsoft Windows:
https://gerrit.googlesource.com/git-repo/+/refs/heads/master/docs/windows.md - GitHub mirror:
https://github.com/GerritCodeReview/git-repo - Postsubmit tests:
https://github.com/GerritCodeReview/git-repo/actions
