用Google Repo管理多仓库项目之Repo命令

来自Repo Command Reference

Repo命令的基本格式如下：

$ repo <command> [options] 

可选元素显示在方括号 [ ] 中。例如，许多命令会用到项目列表 (project-list) 参数。项目列表可以是一个名称列表，也可以是一个本地源代码目录的路径列表：

$ repo sync [project0 project1 ... projectn]
$ repo sync [/path/to/project0 ... /path/to/projectn]

1、 repo help

安装 Repo 后，您可以通过运行以下命令找到最新文档（开头是包含所有命令的摘要）：

$ repo help

也可以通过在 Repo 树中运行以下命令来获取有关某个命令的信息：

$ repo help <command>

例如，要获取repo init的帮助文档，我们可以使用以下指令：

$ repo help init

2、repo init

repo init的基本格式为：

$ repo init -u <url> [options]

该指令会在当前目录中安装Repo，创建一个.repo目录，其中包含Repo源代码和指向的工程清单文件的git代码库。该.repo目录中，还包含一个指向.repo/mainfests/目录中所选清单的符号链接manifest.xml。

选项：

• -u：指定要从中检索清单代码库的网址。若是AOSP，则可从https://android.googlesource.com/platform/manifest 中找到通用清单；
• -m：选择代码库中的一个清单文件。如果未选择任何清单名称，则会默认选择 default.xml；
• -b：指定修订版本，即特定的清单分支；
• --repo-url=<repo-url>：指定repo更新源；
• –depth=DEPTH： 指定clone的深度，为1表示只clone最近一次commit；

3、repo sync

repo sync的基本格式为：

$ repo sync [project-list]

该操作会下载新的更改并更新本地环境中的工作文件。若未指定[project-list]，则该操作会同步所有项目的文件。

运行repo sync后，可能会出现以下情况：

• 如果目标项目从未同步过，则 repo sync 相当于 git clone。远程代码库中的所有分支都会复制到本地项目目录中；

• 如果目标项目以前同步过，则 repo sync 相当于以下命令：

    $ git remote update
    $ git rebase origin/<branch>
  

  其中 branch 是本地项目目录中当前已检出的分支。如果本地分支没有在跟踪远程代码库中的分支，则项目不会发生任何同步。

• 如果 Git rebase操作导致合并冲突，请使用常规 Git 命令（例如 git rebase --continue）解决冲突。

repo sync运行成功后，指定项目中的代码即处于最新状态，已与远程代码库中的代码同步。

选项：

• -d：将指定项目切换回清单修订版本。如果项目当前属于某个主题分支，但临时需要清单修订版本，则此选项会有所帮助。
• -s：同步到当前清单中的 manifest-server 元素指定的一个已知良好版本。
• -f：即使某个项目同步失败，也继续同步其他项目。
• --no-clone-bundle：不下载clone.bundle，详见Server does not provide clone.bundle

4、repo upload

repo upload的基本格式为：

$ repo upload [project-list]

对于指定的项目，Repo 会将本地分支与最后一次 repo sync 时更新的远程分支进行比较。Repo 会提示选择一个或多个尚未上传以供审核的分支。

接下来，所选分支上的所有提交都会通过 HTTPS 连接传输到 Gerrit。您需要配置一个 HTTPS 密码以启用上传授权。要生成新的用户名/密码对以用于 HTTPS 传输。

当 Gerrit 通过其服务器接收对象数据时，它会将每项提交转变成一项更改，以便审核者可以针对特定提交给出意见。要将几项“检查点”提交合并为一项提交，请使用 git rebase -i，然后再运行 upload。

如果您在未使用任何参数的情况下运行 repo upload，则该操作会搜索所有项目中的更改以进行上传。

要在更改上传后对其进行修改，请使用 git rebase -i 或 git commit --amend 等工具更新您的本地提交。修改完成之后，请执行以下操作：

• 进行验证以确保更新后的分支是当前已检出的分支。

• 对于相应系列中的每项提交，请在方括号内输入 Gerrit 更改 ID：

    # Replacing from branch foo
    [ 3021 ] 35f2596c Refactor part of GetUploadableBranches to lookup one specific...
    [ 2829 ] ec18b4ba Update proto client to support patch set replacments
    # Insert change numbers in the brackets to add a new patch set.
    # To create a new change record, leave the brackets empty.
  

上传完成后，这些更改将拥有一个额外的补丁程序集。

如果您希望只上传当前已检出的 Git 分支，则可以使用标记 --current-branch（简称 --cbr）。

repo upload仅供在存在代码审核时使用，其作用为提交代码到 Gerrit code review 中。如果没有使用 Gerrit，则应手动操作单个仓库 push 或者使用 repo forall -c git push xxx

5、repo diff

repo diff的基本格式为：

$ repo diff [project-list]

使用 git diff 显示提交与工作树之间的明显更改。

6、repo download

repo download的基本格式为：

$ repo download target change

从审核系统中下载指定更改，并放在您项目的本地工作目录中供使用。

例如，要将名为”23823”的更改下载到您的 platform/build 目录，请运行以下命令：

$ repo download platform/build 23823

运行 repo sync 会删除使用 repo download 检索到的任何提交。或者，您可以使用 git checkout m/master 检出远程分支。

注意：由于全球的所有服务器均存在复制延迟，因此某项更改出现在网络上（位于 Gerrit 中）的时间与所有用户可通过 repo download 找到此项更改的时间之间存在些许的镜像延迟。

7、repo forall

repo forall的基本格式为：

$ repo forall [project-list] -c <command>

在每个项目中运行指定的 shell 命令。通过 repo forall 可使用下列额外的环境变量：

• REPO_PROJECT 设为了项目的唯一名称。
• REPO_PATH 是相对于客户端根目录的路径。
• REPO_REMOTE 是清单中远程系统的名称。
• REPO_LREV 是清单中修订版本的名称，已转换为本地跟踪分支。如果您需要将清单修订版本传递到某个本地运行的 Git 命令，则可使用此变量。
• REPO_RREV 是清单中修订版本的名称，与清单中显示的名称完全一致。

选项：

• -c：要运行的命令和参数。此命令会通过 /bin/sh 进行评估，它之后的任何参数都将作为 shell 位置参数传递。
• -p：在所指定命令的输出结果之前显示项目标头。这通过以下方式实现：将管道绑定到命令的 stdin、stdout 和 sterr 流，然后通过管道将所有输出结果传输到一个分页会话中显示的连续流中。
• -v：显示该命令向 stderr 写入的消息。

8、repo prune

repo prune的基本格式为：

$ repo prune [project-list]

删减（删除）已合并的主题。

9、repo start

repo start的基本格式为：

$ repo start
<branch-name> [project-list]

从清单中指定的修订版本开始，创建一个新的分支进行开发。

BRANCH_NAME 参数用于简要说明您尝试对项目进行的更改。如果您不知道，则不妨考虑使用名称 default。

project-list 参数指定了将参与此主题分支的项目。

注意：句点 (.) 是一个简写形式，用来代表当前工作目录中的项目。

10、repo status

repo status的基本格式为：

$ repo status [project-list]

对于每个指定的项目，将工作树与临时区域（索引）以及此分支 (HEAD) 上的最近一次提交进行比较。在这三种状态存在差异之处显示每个文件的摘要行。

要仅查看当前分支的状态，请运行 repo status。系统会按项目列出状态信息。对于项目中的每个文件，系统使用两个字母的代码来表示：

在第一列中，大写字母表示临时区域与上次提交状态之间的不同之处。

在第二列中，小写字母表示工作目录与索引之间的不同之处。

• Previous
  Manage Project with Google Repo -- About Repo
• Next
  Manage Project with Google Repo -- Example