repo命令入门
https://source.android.com/setup/develop/repo
1 repo介绍
Android使用Git作为代码管理工具，开发了Gerrit进行代码审核以便更好的对代码进行集中式管理，还开发了Repo命令行工具，对Git部分命令封装，将百多个Git库有效的进行组织。
一个清单库可以包含多个清单文件和多个分支，每个清单文件和分支都有对应的版本。清单文件以xml格式组织的。举个例子：
Øremote元素，定义了名为korg的远程版本库，其库的基址为git：//172.16.1.31/
Ødefault元素，设置各个项目默认远程版本库为korg，默认的的分支为gingerbread-exdroid-stable。当然各个项目(project元素)还可以定义自己的remote和revision覆盖默认的配置
Øproject元素，用于定义一个项目，path属性表示在工作区克隆的位置，name属性表示该项目的远程版本库的相对路径
Øproject元素的子元素copyfile，定义了项目克隆后的一个附件动作，从src拷贝文件到dest
$mkdir android2.3.4
$cd android2.3.4
$git clone git://172.16.1.31/repo.git
于是在android目录下便有repo文件夹，里面包含了repo的源代码，里面有个repo脚本，用它来执行repo指令。
在本地开发的用户需要下载repo代码，在172.16.1.7服务器上开发的用户则不用下载repo代码，因为已经把repo脚本添加到了环境变量，执行repo init就会附加的下载repo代码。
备注：“*”表示新添加的指令
2.1 repo init (下载repo并克隆manifest)
Usage：
repo init –u URL [OPTIONS]
Options:
l-u:指定一个URL，其连接到一个maniest仓库
l-m:在manifest仓库中选择一个xml文件
l-b:选择一个maniest仓库中的一个特殊的分支
命令repo init要完成如下操作：
Ø完成repo工具的完整下载，执行的repo脚本只是引导程序
Ø克隆清单库manifest.git (地址来自于-u参数)
Ø克隆的清单库位于manifest.git中，克隆到本地.repo/manifests.清单.repo/manifest.xml只是符号链接，它指向.repo/manifests/default.xml
Ø如果manifests中有多个xml文件，repo init可以任意选择其中一个，默认选择是default.xml
Example：
repo init-u git://172.16.1.31/manifest.git
need-to-insert-img
在android2.3.4目录下面出现了.repo文件夹。
repo init-u git://172.16.1.31/manifest.git –m android.xml
选择的是android.xml里面的配置，.repo/manifest.xml便指向.repo/manifests/android.xml
Usage:
repo sync […]
用于参照清单文件.repo/manifest.xml克隆并同步版本库。如果某个项目版本库尚不存在，则执行repo sync命令相当于执行git clone，如果项目版本库已经存在，则相当于执行下面的两条指令：
lgit remote update
相当于对每一个remote源执行了fetch操作
lgit rebase origin/branch
针对当前分支的跟踪分支执行rebase操作。
Example:
repo sync
也可以选择克隆其中的一个项目:
repo sync platform/build
Usage:
repo start [--all | …]
刚克隆下来的代码是没有分支的,repo start实际是对git checkout –b命令的封装。为指定的项目或所有项目（若使用—all参数），以清单文件中为设定的分支，创建特性分支。这条指令与git checkout –b还是有很大的区别的，git checkout –b是在当前所在的分支的基础上创建特性分支，而repo start是在清单文件设定分支的基础上创建特性分支。
Example：
repo startstable--all
假设清单文件中设定的分支是gingerbread-exdroid-stable，那么执行以上指令就是对所有项目，在gingerbread-exdroid-stable的基础上创建特性分支stable。
repo startstableplatform/build platform/bionic
假设清单文件中设定的分支是gingerbread-exdroid-stable，那么执行以上指令就是对platform/build、platform/bionic项目，在gingerbread-exdroid-stable的基础上创建特性分支stable
Usage：
repo checkout […]
实际上是对git checkout命令的封装，但不能带-b参数，所以不能用此命令来创建特性分支。
Example：
repo checkout crane-dev
repo checkout crane-devplatform/buildplatform/bionic
Usage：
repo branches […]
Example：
repo branches
repo branches platform/build platform/bionic
Usage：
repo diff […]
实际是对git diff命令的封装,用于分别显示各个项目工作区下的文件差异。
Example：
repo diff---查看所有项目
repo diff platform/build platform/bionic---只查看其中两个项目
实际是对git add --interactive命令的封装、用于挑选各个项目工作区中的改动以加入暂存区。
Usage：
repo stage -i […]
-i代表git add --interactive命令中的--interactive，给出个界面供用户选择
实际上是对git branch –d命令的封装，该命令用于扫面项目的各个分支，并删除已经合并的分支，用法如下：
repo prune […]
实际上是对git branch –D命令的封装，用法如下：
repo abandon […]
实际上是对git diff-index、git diff-filse命令的封装，同时显示暂存区的状态和本地文件修改的状态
$repo/repo status platform/bionic
need-to-insert-img
以上的实例输出显示了platform/bionic项目分支的修改状态
Ø每个小节的首行显示羡慕名称，以及所在分支的名称
Ø第一个字母表示暂存区的文件修改状态
l-:没有改变
lA:添加（不在HEAD中，在暂存区中）
lM：修改（在HEAD中，在暂存区中，内容不同）
lD:删除（在HEAD中，不在暂存区）
lR：重命名（不在HEAD中，在暂存区，路径修改）
lC：拷贝（不在HEAD中，在暂存区，从其他文件拷贝）
lT：文件状态改变（在HEAD中，在暂存区，内容相同）
lU：未合并，需要冲突解决
Ø第二个字母表示工作区文件的更改状态
l-：新/未知（不在暂存区，在工作区）
lm：修改（在暂存区，在工作区，被修改）
ld：删除（在暂存区，不在工作区）
Ø两个表示状态的字母后面，显示文件名信息。如果有文件重名还会显示改变前后的文件名及文件的相似度
Usage:
repo remote add […]
repo remote rm […]
Example:
repo remote add org ssh://172.16.1.31/git_repo
这个指令是根据xml文件添加的远程分支，方便于向服务器提交代码，执行之后的build目录下看到新的远程分支org：
need-to-insert-img
删除远程仓库：
$reporemotermorg
repo push org
这是新添加的指令，用于向服务器提交代码，使用方法：
repo push [--all |…]
repo会自己查询需要向服务器提交的项目并提示用户。
Usage：
repo forall […] –c
迭代器，可以在所有指定的项目中执行同一个shell指令
Options：
l-c:后面所带的参数着是shell指令
l-p:在shell指令输出之前列出项目名称
l-v:列出执行shell指令输出的错误信息
additional environment variables:
lREPO_PROJECT:指定项目的名称
lREPO_PATH:指定项目在工作区的相对路径
lREPO_REMOTE:指定项目远程仓库的名称
lREPO_LREV:指定项目最后一次提交服务器仓库对应的哈希值
lREPO_RREV:指定项目在克隆时的指定分支，manifest里的revision属性
另外，如果-c后面所带的shell指令中有上述环境变量，则需要用单引号把shell指令括起来。
repo forall –c ‘echo $REPO_PROJECT’
need-to-insert-img
$repo forall–c ‘echo $REPO_PATH’
把所有项目多切换到master分支，执行以下指令将topic分支合并到master分支
repo forall –p –c git merge topic
在所有项目下打标签
repo forall –c git tag crane-stable-1.6
引用环境变量REPO_PROJECT添加远程仓库：
repo forall –c ‘git remote add korg ssh://xiong@172.16.31/$REPO_PROJECT.git’
删除远程仓库：
repo forall –c git remote add korg
repo forall –c git branch crane-dev
repo forall –c git checkout –b crane-dev
相当于对git grep的封装，用于在项目文件中进行内容查找
显示manifest文件内容
Usage:
repo manifest –o android.xml
显示repo的版本号
repo upload相当于git push，但是又有很大的不同。它不是将版本库改动推送到克隆时的远程服务器，而是推送到代码审核服务器(Gerrit软件架设)的特殊引用上，使用SSH协议。代码审核服务器会对推送的提交进行特殊处理，将新的提交显示为一个待审核的修改集，并进入代码审查流程，只有当审核通过后，才会合并到官方正式的版本库中。
因为全志没有代码审核服务器，所以这条指令用不到。
Usage：
repo upload [--re --cc] {[]… | --replace }
Options:
l-h, --help:显示帮助信息
l-t:发送本地分支名称到Gerrit代码审核服务器
l--replace:发送此分支的更新补丁集
l--re=REVIEWERS:要求指定的人员进行审核
l--cc=CC:同时发送通知到如下邮件地址
主要用于代码审核者下载和评估贡献者提交的修订
Usage
repo download {project change [patchset]}…
用于repo自身的更新
参考：
