原文地址
译者：远方的自由
转载请注明出处: http://blog.csdn.net/z2066411585
Repo使用形式如下:
repo <COMMAND> <OPTIONS>
可选元素显示在[]中,例如,许多命令将项目列表作为参数,你可以指定项目列表作为项目的本地源目录的名称列表或路径列表
repo sync [<PROJECT0> <PROJECT1> ... <PROJECTN>]
repo sync [</PATH/TO/PROJECT0> ... </PATH/TO/PROJECTN>]
help
一旦安装了repo,你可以通过运行以下命令的摘要来查找最新的文档:
repo help
你可以通过repo tree 中运行下面命令来获取有关任何命令的信息:
repo help <COMMAND>
例如,下面的命令产生一个描述和repo 的 init 参数选项列表,它初始化当前目录中的repo：
repo help init
init
repo init -u <URL> [<OPTIONS>]
当前目录中安装Repo.将会创建一个.repo目录,其中主要包含用于repo源代码和标准android清单文件的git存储库. repo目录还包含manifest.xml, 它是./repo/maninfests/目录中所选清单的符号链接. 有关更新manifest的说明,请参阅manifest-format.txt.
选项:
-
-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/<BRANCH>
- 其中
<BRANCH>是本地项目目录中当前检出的分支.如果本地分支没有跟踪远程仓库中的分支,那么项目不会发生同步. - 如果
git rebase操作导致合并冲突,你将需要使用正常的git命令(例如git rebase --continue)来解决冲突.
执行repo sync成功后,指定项目中代码与远程仓库中代码保持同步.
选项:
-
-d:将指定的项目切换到manifest修订版.如果项目当前位于主题分支上,但是暂时需要manifest修订,则会有帮助.
--s:同步到由当前清单中的manifest-server元素指定的已知好的构建.
--f:即使项目无法同步,也要继续同步其他项目.
upload
repo upload [<PROJECT_LIST>]
对于指定的项目,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 [<PROJECT_LIST>]
在使用git diff的提交和工作树之间显示了突出的变化.
download
repo download <TARGET> <CHANGE>
从审查系统中下载指定的更改,并使其在项目的本地工作目录中可用.
例如,将 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是manifest中远程系统的名称 -
REPO_LREV是manifest中的修订名称,翻译为本地跟踪分支.如果你需要将manifest修订传递给本地执行的git命令,则使用此方法. -
REPO_RREV是manifest中修订的名称,完全如manifest中所写.
选项:
-
-c: 命令和参数来执行,该命令通过/bin/sh和任何参数在作为shell位置参数传递之后进行评估. -
-p: 在输出指定的命令之前显示项目标题,这是通过管道绑定到命令stdin,stdout和sterr流实现的,并将所有输出管道连接到一个连续的流中,该流将显示在单个会话中. -
-v:显示命令写入stderr的消息
prune
repo prune [<PROJECT_LIST>]
修改(删除) 已经合并的主分支
start
repo start <BRANCH_NAME> [<PROJECT_LIST>]
从manifest中指定的修订开始,开始一个新的开发分支.
<BRANCH_NAME> 参数应该提供你正试图对项目进行更改的简短说明. 如果你不知道,请考虑使用默认名称.
<PROJECT_LIST>指定哪些项目将参与这个主题分支
注意: 是当前工作目录中项目的有用缩写
status
repo status [<PROJECT_LIST>]
将工作树与临时区域(索引)进行比较,并在指定的每个项目中对该分支(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 |
网友评论