Android中Repo常用命令参考详解
可选元素显示在[]中,例如,许多命令将项目列表作为参数,你可以指定项目列表作为项目的本地源目录的名称列表或路径列表
repo sync [... ] repo sync [ ... ]
help
一旦安装了repo,你可以通过运行以下命令的摘要来查找最新的文档:
repo help
你可以通过repo tree 中运行下面命令来获取有关任何命令的信息:
repo help
例如,下面的命令产生一个描述和repo 的 init 参数选项列表,它初始化当前目录中的repo：
repo help init
init
repo init -u []
当前目录中安装Repo.将会创建一个.repo目录,其中主要包含用于repo源代码和标准android清单文件的git存储库. repo目录还包含manifest.xml, 它是./repo/maninfests/目录中所选清单的符号链接
选项:
-u: 指定从检索清单存储库的URL.常见的manifest可以在https://android.googlesource.com/platform/manifest找到 -m:选择存储库中的清单文件.如果没有选择清单名称,则默认为default.xml -b: 指定一个修订,一个特定的manifest-branch.
注意:对于所有余下的Repo命令,当前工作目录必须是./repo的父目录或父目录的子目录.
sync
下载新的更改并更新本地环境中的工作文件.如果你运行repo sync没有任何参数,它将同步所有项目的文件.
当运行repo sync,这是发生了什么事:
如果项目从未同步过,那么repo sync相当于git clone. 远程仓库中的所有分支复制到本地项目目录中. 如果项目已经同步过一次,那么repo sync相当于:
git remote update git rebase origin/
其中
执行repo sync成功后,指定项目中代码与远程仓库中代码保持同步.
选项:
-d: 将指定的项目切换到manifest修订版.如果项目当前位于主题分支上,但是暂时需要manifest修订,则会有帮助.
--s: 同步到由当前清单中的manifest-server元素指定的已知好的构建.
--f: 即使项目无法同步,也要继续同步其他项目.
upload
repo upload []
对于指定的项目,repo比较本地分支与上次repo sync期间更新的远程分支. Repo将提示你选择一个或多个尚未上传的分支进行审查.选择一个或多个分支后,所选分支上的所有提交将通过https连接传送个gerrit.你需要配置https密码才能启用上传授权.请访问Password Generator生成新的用户名/密码对,以便通过https使用.
当gerrit通过服务器接受到对象数据,它会将每个提交变成一个变化,以便审阅者可以单独评论每个提交.将几个checkpoint提交合并为一个提交,在运行repo上传之前使用git rebase -i.
如果你运行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 (or –cbr 简写).
diff
repo diff []
在使用git diff的提交和工作树之间显示了突出的变化.
download
repo download
从审查系统中下载指定的更改,并使其在项目的本地工作目录中可用.
例如,将change 23823
下载到platform/build目录中
repo download platform/build 23823
repo sync应该有效删除通过repo download检索任何提交.或者,你可以检出远程分支,例如:git checkout m/master.
注意:在Gerrit的网页上发生变化时,以及由于全球所有服务器的复制延迟而导致所有用户的repo download都能够找到它时,会有轻微的镜像延迟.
forall
repo forall [] -c
在每个项目中执行给定的shell命令,以下附加环境变量可通过repo forall
REPO_PROJECT 被设置为项目的唯一名称 REPO_PATH 是相对于客户端根目录的路径 REPO_REMOTE 是manifest中远程系统的名称 REPO_LREV 是manifest中的修订名称,翻译为本地跟踪分支.如果你需要将manifest修订传递给本地执行的git命令,则使用此方法. REPO_RREV 是manifest中修订的名称,完全如manifest中所写.
选项:
-c: 命令和参数来执行,该命令通过/bin/sh和任何参数在作为shell位置参数传递之后进行评估. -p: 在输出指定的命令之前显示项目标题,这是通过管道绑定到命令stdin,stdout和sterr流实现的,并将所有输出管道连接到一个连续的流中,该流将显示在单个会话中. -v:显示命令写入stderr的消息
prune
repo prune []
修改(删除) 已经合并的主分支
start
repo start []
从manifest中指定的修订开始,开始一个新的开发分支.
参数应该提供你正试图对项目进行更改的简短说明. 如果你不知道,请考虑使用默认名称.
指定哪些项目将参与这个主题分支
注意: 是当前工作目录中项目的有用缩写
status
repo status []
将工作树与临时区域(索引)进行比较,并在指定的每个项目中对该分支(HEAD)上的最近提交进行比较,显示这三个状态之间存在差异的每个文件的摘要.
运行run status 只查看当前分支的状态,状态信息按项目列出.对于项目中的每个文件,使用两个字母代码;
在第一列中,大写字母表示暂存区域与上次提交状态的区别.
| 字母 | 含义 | 描述 |
|---|---|---|
| - | no changer | same in HEAD and index |
| A | added | not in HEAD, in index |
| M | modified | in HEAD, modified in index |
| D | deleted | in HEAD, not in index |
| R | renamed | not in HEAD, path changed in index |
| C | copied | not in HEAD, copied from another in index |
| T | mode changed | same content in HEAD and index, mode changed |
| U | unmerged | conflict between HEAD and index; resolution required |
在第二列中,小写字母表示工作目录与索引的不同之处.
| 字母 | 含义 | 描述 |
|---|---|---|
| - | new/unknown | not in index, in work tree |
| m | modified | in index, in work tree, modified |
| d | deleted | in index, not in work tree |