repo命令详解
1 repo介绍
Android 使⽤ Git 作为代码管理⼯具，开发了 Gerrit 进⾏代码审核以便更好的对代码进⾏集中式管理，还开发了 Repo 命令⾏⼯具，对Git 部分命令封装，将百多个 Git 库有效的进⾏组织。
1.1    清单库⽂件介绍
⼀个清单库可以包含多个清单⽂件和多个分⽀，每个清单⽂件和分⽀都有对应的版本。清单⽂件以xml格式组织的。举个例⼦：
remote元素，定义了名为korg的远程版本库，其库的基址为git：//172.16.1.31/
default元素，设置各个项⽬默认远程版本库为korg，默认的的分⽀为gingerbread-exdroid-stable。当然各个项⽬(project元素)还可以定义⾃⼰的remote和revision覆盖默认的配置
project元素，⽤于定义⼀个项⽬，path属性表⽰在⼯作区克隆的位置，name属性表⽰该项⽬的远程版本库的相对路径
project元素的⼦元素copyfile，定义了项⽬克隆后的⼀个附件动作，从src拷贝⽂件到dest
1.2 下载repo代码
$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 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.清单.l只是符号链接，它指
向.repo/l
如果manifests中有多个xml⽂件，repo init 可以任意选择其中⼀个，默认选择是l
Example：
repo init  -u git://172.16.1.31/manifest.git
在android2.3.4⽬录下⾯出现了.repo⽂件夹。
repo  init  -u git://172.16.1.31/manifest.git –l
选择的是l⾥⾯的配置，.l便指向.repo/l
2.2 repo sync(下载代码)
Usage:
repo sync [<project>…]
⽤于参照清单⽂件.l克隆并同步版本库。如果某个项⽬版本库尚不存在，则执⾏repo sync 命令相当于执⾏git clone，如果项⽬版本库已经存在，则相当于执⾏下⾯的两条指令：
l        git remote update
相当于对每⼀个remote源执⾏了fetch操作
l        git rebase origin/branch
针对当前分⽀的跟踪分⽀执⾏rebase操作。
Example:
repo sync
也可以选择克隆其中的⼀个项⽬:
repo sync platform/build
2.3 repo start(创建并切换分⽀)
Usage:
repo start  <newbranchname> [--all | <project>…]
刚克隆下来的代码是没有分⽀的,repo start实际是对git checkout –b 命令的封装。为指定的项⽬或所有项⽬（若使⽤—all参数），以清单⽂件中为设定的分⽀，创建特性分⽀。这条指令与git checkout –b 还是有很⼤的区别的，git checkout –b 是在当前所在的分⽀的基础上创建特性分⽀，⽽repo start是在
清单⽂件设定分⽀的基础上创建特性分⽀。
Example：
repo start  stable  --all
假设清单⽂件中设定的分⽀是gingerbread-exdroid-stable，那么执⾏以上指令就是对所有项⽬，在gingerbread-exdroid-stable的基础上创建特性分⽀stable。
repo start  stable  platform/build platform/bionic
假设清单⽂件中设定的分⽀是gingerbread-exdroid-stable，那么执⾏以上指令就是对platform/build、platform/bionic项⽬，在gingerbread-exdroid-stable的基础上创建特性分⽀stable
2.4 repo checkout(切换分⽀)
Usage：
repo checkout <branchname>  [<project>…]
实际上是对git checkout 命令的封装，但不能带-b参数，所以不能⽤此命令来创建特性分⽀。
Example：
repo checkout crane-dev
repo checkout crane-dev  platform/build  platform/bionic
2.5 repo branches(查看分⽀)
Usage：
repo branches [<project>…]
Example：
repo branches
repo branches platform/build platform/bionic
2.6 repo diff(查看⼯作区⽂件差异)
Usage：
repo diff [<project>…]
实际是对git diff 命令的封装,⽤于分别显⽰各个项⽬⼯作区下的⽂件差异。
Example：
repo diff                            ---查看所有项⽬
repo diff platform/build platform/bionic  ---只查看其中两个项⽬
2.7 repo stage(把⽂件添加到index表中)
实际是对git add --interactive命令的封装、⽤于挑选各个项⽬⼯作区中的改动以加⼊暂存区。
Usage：
repo stage -i [<project>…]
-i代表git add --interactive命令中的--interactive，给出个界⾯供⽤户选择
2.8 repo prune(删除已经合并分⽀)
实际上是对git branch –d命令的封装，该命令⽤于扫⾯项⽬的各个分⽀，并删除已经合并的分⽀，⽤法如下：
repo prune [<project>…]
2.9 repo abandon(删除指定分⽀)
实际上是对git branch –D 命令的封装，⽤法如下：
repo abandon <branchname> [<project>…]
2.10 repo status(查看⽂件状态)
实际上是对git diff-index、git diff-filse命令的封装，同时显⽰暂存区的状态和本地⽂件修改的状态
$repo/repo status platform/bionic
以上的实例输出显⽰了platform/bionic项⽬分⽀的修改状态
每个⼩节的⾸⾏显⽰羡慕名称，以及所在分⽀的名称
l        -：没有改变
l        A：添加（不在HEAD中，在暂存区中）
l        M：修改（在HEAD中，在暂存区中，内容不同）
l        D：删除（在HEAD中，不在暂存区）
l        R：重命名（不在HEAD中，在暂存区，路径修改）
git常用指令l        C：拷贝（不在HEAD中，在暂存区，从其他⽂件拷贝）
l        T：⽂件状态改变（在HEAD中，在暂存区，内容相同）
l        U：未合并，需要冲突解决
第⼆个字母表⽰⼯作区⽂件的更改状态
l        -：新/未知（不在暂存区，在⼯作区）
l        m：修改（在暂存区，在⼯作区，被修改）
l        d：删除（在暂存区，不在⼯作区）
两个表⽰状态的字母后⾯，显⽰⽂件名信息。如果有⽂件重名还会显⽰改变前后的⽂件名及⽂件的相似度
2.11 *repo remote(设置远程仓库)
Usage:
repo remote add <remotename>  <url> [<project>…]
repo remote rm <remotename>  [<project>…]
Example:
repo remote add org ssh://172.16.1.31/git_repo
这个指令是根据xml⽂件添加的远程分⽀，⽅便于向服务器提交代码，执⾏之后的build⽬录下看到新的远程分⽀org：
删除远程仓库：
$repo  remote  rm  org
2.12 *repo push
repo push org
这是新添加的指令，⽤于向服务器提交代码，使⽤⽅法：
repo push <remotename> [--all |<project>…]
repo会⾃⼰查询需要向服务器提交的项⽬并提⽰⽤户。
2.13repo forall
Usage：
repo forall [<project>…] –c <command>
迭代器，可以在所有指定的项⽬中执⾏同⼀个shell指令
Options：
l        -c：后⾯所带的参数着是shell指令
l        -p：在shell指令输出之前列出项⽬名称
l        -v：列出执⾏shell指令输出的错误信息
additional environment variables:
l        REPO_PROJECT：指定项⽬的名称
l        REPO_PATH：指定项⽬在⼯作区的相对路径
l        REPO_REMOTE：指定项⽬远程仓库的名称
l        REPO_LREV：指定项⽬最后⼀次提交服务器仓库对应的哈希值
l        REPO_RREV：指定项⽬在克隆时的指定分⽀，manifest⾥的revision属性
另外，如果-c后⾯所带的shell指令中有上述环境变量，则需要⽤单引号把shell指令括起来。
3.13.1 添加的环境变量
repo forall –c ‘echo $REPO_PROJECT’
$repo forall  –c ‘echo $REPO_PATH’
3.13.2 merge(合并多个分⽀)
把所有项⽬多切换到master分⽀，执⾏以下指令将topic分⽀合并到master分⽀
repo forall –p –c git merge topic
3.13.3 tag(打标签)
在所有项⽬下打标签
repo forall –c git tag crane-stable-1.6
3.13.4 remote (设置远程仓库)
引⽤环境变量REPO_PROJECT添加远程仓库：
repo forall –c ‘git remote add korg ssh://xiong@172.16.31/$REPO_PROJECT.git’
删除远程仓库：
repo forall –c git remote add korg
3.13.5 branch(创建特性分⽀)
repo forall –c git branch crane-dev
repo forall –c git checkout –b crane-dev
3 repo的额外命令集
3.1 repo grep
相当于对git grep 的封装，⽤于在项⽬⽂件中进⾏内容查
3.2 repo manifest
显⽰manifest⽂件内容
Usage:
repo manifest –l
3.3 repo version
显⽰repo的版本号
3.4 repo upload
repo upload相当于git push，但是⼜有很⼤的不同。它不是将版本库改动推送到克隆时的远程服务器，⽽是推送到代码审核服务器(Gerrit 软件架设)的特殊引⽤上，使⽤SSH协议。代码审核服务器会对推送的提交进⾏特殊处理，将新的提交显⽰为⼀个待审核的修改集，并进⼊代码审查流程，只有当审核通过后，才会合并到官⽅正式的版本库中。
因为全志没有代码审核服务器，所以这条指令⽤不到。
Usage：
repo upload [--re --cc] {[<project>]… | --replace <project>}
Options:
l        -h, --help：显⽰帮助信息
l        -t：发送本地分⽀名称到Gerrit代码审核服务器
l        --replace：发送此分⽀的更新补丁集
l        --re=REVIEWERS：要求指定的⼈员进⾏审核
l        --cc=CC：同时发送通知到如下邮件地址
3.5 repo download
主要⽤于代码审核者下载和评估贡献者提交的修订
Usage
repo download {project change [patchset]}…
3.6 repo selfupdate
⽤于repo⾃⾝的更新
参考：
wenku.baidu/view/672c8faddd3383c4bb4cd257.html
4 添加的remote指令
在sumcmds中添加remote.py，程序如下：
# Copyright (C) 2009 The Android Open Source Project
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#      /licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
import sys
from color import Coloring
from command import Command
from progress import Progress
class Remote(Command):
common = True
helpSummary = "View current topic branches"
helpUsage = """
%prog add <remotebranchname> <url> [<project>...]
%prog rm  <remotebranchname> [<project>...]
--------------
"""
def str_last(self ,string):
for c in string:
last=c
return last
def Execute(self, opt, args):
if not args:
print >>sys.stderr, "error:.........."
print >>sys.stderr, "Usage:repo remote add <remotebranchname> <url> [<project>...]"      print >>sys.stderr, "      repo remote rm  <remotebranchname> [<project>...] "                print >>sys.stderr, "................................"
return
err = []
operate=args[0]
#url = args[2]
# branch_name=args[1]
if operate == "rm":
if not len(args) >=2:
print >>sys.stderr, "error:miss remotebrancname"
return

版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。