Repo 命令参考资料

Repo 简化了跨多个代码库运行的流程,与 Git 相辅相成。请参阅源代码控制工具,了解有关 Repo 和 Git 之间关系的说明。如需详细了解 Repo,请参阅 Repo README

使用 Repo 需遵循的格式如下:

repo command options

可选元素显示在方括号 [ ] 中。例如,许多命令将 project-list 作为参数。project-list 可以是项目的名称列表,也可以是项目的本地源目录路径列表:

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

帮助

此页面仅重点介绍重要选项。要了解完整详情,请参阅命令行帮助。安装 Repo 后,您可以通过运行以下命令找到最新文档,文档开头是所有命令的摘要:

repo help

您可以通过在 Repo 树中运行以下命令来查看有关某个命令的详细信息:

repo help command

例如,以下命令会生成 Repo init 参数的说明和选项列表,该参数会在当前目录中初始化 Repo。(如需了解详情,请参阅 init。)

repo help init

如果只想查看可用选项的列表,请运行:

repo command --help
例如:
repo init --help

init

repo init -u url [options]

在当前目录中安装 Repo。这样会创建一个 .repo/ 目录,其中包含存放 Repo 源代码和标准 Android 清单文件的 Git 代码库。

选项:

  • -u:指定从中检索清单代码库的网址。常见清单位于 https://android.googlesource.com/platform/manifest
  • -m:选择代码库中的清单文件。如果未选择清单名称,则默认为 default.xml
  • -b:指定修订版本,即特定的 manifest-branch

注意:对于所有剩余的 Repo 命令,当前的工作目录必须是 .repo/ 的父目录或该父目录的子目录。

sync

repo sync [project-list]

下载新的更改并更新本地环境中的工作文件,基本上可以在所有 Git 代码库中完成 git fetch。如果在未使用任何参数的情况下运行 repo sync,则该命令会同步所有项目的文件。

运行 repo sync 后,将出现以下情况:

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

  • 如果目标项目以前同步过,则 repo sync 相当于:

    git remote update
    git rebase origin/branch
    

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

  • 如果 Git rebase 操作导致合并冲突,请使用常规 Git 命令(例如 git rebase --continue)来解决冲突。

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

下面是重要选项。如需了解详情,请参阅 repo help sync

  • -c:仅获取服务器中的当前清单分支。

  • -d:将指定项目切换回清单修订版本。如果项目当前属于某个主题分支,但临时需要清单修订版本,则此选项会有所帮助。

  • -f:即使某个项目同步失败,也继续同步其他项目。

  • -jthreadcount:将同步操作拆分成多个线程,以更快地完成。确保不会使计算机超负荷运行 - 为其他任务预留一些 CPU。如需查看可用 CPU 的数量,请先运行:nproc --all

  • -q:通过抑制状态消息来确保运行过程没有干扰。

  • -s:同步到当前清单中的 manifest-server 元素指定的一个已知良好 build。

upload

repo upload [project-list]

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

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

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

如果在未使用任何参数的情况下运行 repo upload,则该命令会在所有项目中搜索要上传的更改。

如需在更改上传后对其进行修改,请使用 git rebase -igit commit --amend 等工具更新您的本地提交内容。修改完成之后,请执行以下操作:

  • 进行验证以确保更新后的分支是当前已检出的分支。
  • 使用 repo upload --replace PROJECT 打开更改匹配编辑器。
  • 对于相应系列中的每项提交,请在方括号内输入 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)。

diff

repo diff [project-list]

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

download

repo download target change

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

例如,如需将更改 23823 下载到您的 platform/build 目录,请运行以下命令:

repo download platform/build 23823

运行 repo sync 会移除使用 repo download 检索到的所有提交内容。或者,您也可以使用 git checkout m/master 检出远程分支。

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

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 写入的消息。

prune

repo prune [project-list]

删减(删除)已合并的主题。

start

repo start
branch-name [project-list]

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

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

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

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

status

repo status [project-list]

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

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

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

字母 含义 说明
- 没有变化 在 HEAD 与索引中相同
A 已添加 不存在于 HEAD 中,但存在于索引中
M 已修改 存在于 HEAD 中,但索引中的文件已修改
D 已删除 存在于 HEAD 中,但不存在于索引中
R 已重命名 不存在于 HEAD 中,索引中文件的路径已更改
C 已复制 不存在于 HEAD 中,复制自索引中的另一个文件
T 模式已更改 HEAD 与索引中的内容相同,但模式已更改
U 未合并 HEAD 与索引之间存在冲突;需要加以解决

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

字母 含义 说明
- 新/未知 不存在于索引中,但存在于工作树中
m 已修改 存在于索引中,也存在于工作树中(但在两个位置均已修改)
d 已删除 存在于索引中,但不存在于工作树中

处理 repo 错误

git commit -a # Commit local changes first so they aren't lost.
repo start branch-name # Start the branch
git reset --hard HEAD@{1} # And reset the branch so that it matches the commit before repo start
repo upload .

如果在会话开始时未运行 repo start 命令,系统会显示错误 repo: error: no branches ready for upload。若要恢复,您可以检查提交 ID,创建新分支,然后将其合并。