Repo 使用详解

Repo 是一款工具，可让您在 Android 环境中更轻松地使用 Git。

安装GIT

省略

安装Repo

要安装 Repo，请执行以下操作：
1.确保主目录下有一个 bin/ 目录，并且该目录包含在路径中：

$ mkdir ~/bin
$ PATH=~/bin:$PATH

2.下载 Repo 工具，并确保它可执行：

$ curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
$ chmod a+x ~/bin/repo

初始化Repo客户端

安装 Repo 后，设置您的客户端以访问 Android 源代码代码库：
1.创建一个空目录来存放您的工作文件。如果您使用的是 MacOS，必须在区分大小写的文件系统中创建该目录。为其指定一个您喜欢的任意名称：

$ mkdir WORKING_DIRECTORY
$ cd WORKING_DIRECTORY

2.使用您的真实姓名和电子邮件地址配置 Git。要使用 Gerrit 代码审核工具，您需要一个与已注册的 Google 帐号关联的电子邮件地址。确保这是您可以接收邮件的有效地址。您在此处提供的姓名将显示在您提交的代码的提供方信息中。

$ git config --global user.name "Your Name"
$ git config --global user.email "[email protected]"

3.运行 repo init 以获取最新版本的 Repo 及其最近的所有错误更正内容。您必须为清单指定一个网址，该网址用于指定 Android 源代码中包含的各个代码库将位于工作目录中的什么位置。

$ repo init -u https://android.googlesource.com/platform/manifest

初始化repo成功
我们要管理自己的仓库，所以要建立一个自己的manifest.git

建立自己的manifest.git

1.打开 WORKING_DIRECTORY 文件夹
2.进入.repo文件夹
3.进入manifest文件夹，修改其中的defaule.xml文件
大体格式如下：

可以看到,根元素manifest,里边定义了remote,default,project.
remote可以多个,每个定义了一个远程拉取仓库, fetch是仓库的url, 可以使用”..”表示使用repo init -u url里的url
default则设置每个项目的默认仓库和默认分支
project定义了一个项目,它指明一个远程仓库,和clone到本地来后的目录名称. name为项目的远程仓库名,以上代码拉取的项目是git://localhost/helo

先看remote部分，fetch是服务器地址，可以用“..”来代替；name是默认的remote name，就是git push origin里面那个origin；review是gerrit地址（这点是我猜的，不确定）。然后是default部分，里面定义了默认的remote和revision。下面是project部分，这部分定义了整包代码由哪些git组成。name是git在服务器上的相对路径，path是把代码下载下来后在本地的相对路径，path是可以省略的，如果省略那么就认为path和name一样，revision是指下载下来的代码要checkout到哪个revision上，这里的revision可以是commit id、branch name、tag name，反正本质上都是commit id。利用branch name的特性，revision写branch name的话，那总可以下载到并且checkout出该branch上最新的代码，default.xml中通常用branch name做revision。而commit id和tag name就是固定的某个commit了。如果revision用commit id的话，那后面必须跟上upstream，upstream的值是个branch name。revision部分如果省略的话，就等于使用default部分定义的revision。project还有个group属性，但我没实际用过，就不展开了。还有copyfile部分，这是用来处理一些无法或者不方便直接归类到某个git中去的文件的，譬如项目代码根目录下的几个零散文件，这几个文件所在目录做成一个git的话，等于把整包代码做成了一个git。虽然git是可以嵌套的，但这样不方便。repo的做法是将这些文件先放到某个已知git中去，本例就是先放到project buildscript里面去。当然，放到某个git里去的动作是由你来做的。然后下载完后再将它们copy到应该在的地方，本例就是根目录下。dest是相对于根目录的路径，src是相对于project path的路径。

要管理的仓库 要管理的仓库是普通的git. 当以上一切准备完毕. 我们就可以

$ repo sync

远程仓库被拉取到了本地.

创建xxx项目对应的分支

从远程库同步下来的项目是没有分支的，所以必须要创建xxx项目的分支

$ repo start xxx --all 

(--all意为将所有模块都归为当前xxx分支下)

2017-08-24 17-10-03屏幕截图.png

例如：

$  repo start  stable  platform/build platform/bionic

假设清单文件中设定的分支是gingerbread-exdroid-stable，那么执行以上指令就是对platform/build、platform/bionic项目，在gingerbread-exdroid-stable的基础上创建特性分支stable

查看当前项目代码所在的分支

$ repo branch

例如：

2017-08-24 17-08-23屏幕截图.png

删除不用的本地分支

$ repo abandon 分支名 […]

删除已经合并分支

$ repo prune […]

实际上是对git branch –d命令的封装，该命令用于扫面项目的各个分支，并删除已经合并的分支

切换分支

$ repo checkout   […]

实际上是对git checkout 命令的封装，但不能带-b参数，所以不能用此命令来创建特性分支。

查看修改

$ repo diff […]

提交和上传代码

a) 如果本地有代码修改，需要提交，请到相应的工作目录，按照git的commit方式提交，上传的时候才需要用到repo
b) 如果改动的工程较多，建议用repo stage命令来增加文件的track动作，但是提交就要到相应的目录里面老老实实的用git commit来提交了。
c) Repo upload 命令在上传代码时，仅是上传到gerrit，还需要进行review后才会在代码库中体现。格式为 repo upload --re=zan.wang kernel。这里的kernel为project名称。这里的--re添加review人员命令，我试过是无效的，不知道是否是本地服务器有问题。Upload过程根据屏幕提示，确认几次。成功后，到172.16.99.44:8080 gerrit服务器添加审核人员。
d) 如果远程的git库有可写权限，也可以在每个project下面用git进行提交，不过目前仅是可读权限，如果个别人员开放了写权限，可以进行此操作，和单独操作git库无异。
e) 目前i800JB项目的remote名称为phicomm，可以查看在manifests库里面的i800JB.xml文件。用git上传某个project的修改时需注意这里的remote为phicomm，而非origin。

把文件添加到index表中

实际是对git add --interactive命令的封装、用于挑选各个项目工作区中的改动以加入暂存区。

$ repo stage -i […]

-i代表git add --interactive命令中的--interactive，给出个界面供用户选择

上传本地提交至服务器

$ repo upload

查看文件状态

$ repo status

向服务器提交代码

repo push  [--all |…]

merge(合并多个分支)

repo forall –p –c git merge topic

tag(打标签)

repo forall  [...] –c git tag crane-stable-1.6

为单个项目下打标签

repo forall –c git tag crane-stable-1.6

在所有项目下打标签

显示manifest文件内容

$ repo manifest

显示repo的版本号

$ repo version

repo自身的更新

$ repo selfupdate

查看本地repo管理的所有projects

$ repo list

Repo版本回退

所有仓库回退

$ repo forall -c 'commitID=`git log --before "2017-03-17 07:00" -1 --pretty=format:"%H"`; git reset --hard $commitID'

参数说明：
forall　　操作分支中的所有仓库
-c　　只操作当前分支
--before　　早于指定时间点的提交记录
-1　　只显示最近的1条记录（注意这是数字 1 ，如果要显示 2 条就写 2，以此类推）
"2017-03-17 07:00"　　希望回退到的日期（时间点）
--pretty　　以指定格式显示提交记录%H　　提交记录的hash值，即commit id（其它格式及更详细的信息可以使用命令git log --help打印帮助信息并查看“PRETTY FORMATS”小节）命令含义： 这条repo命令的实质就是在当前分支的每个仓库下执行[Git] log命令，找出该仓库下符合时间条件的第一个提交记录，然后对该仓库执行[git]+ reset --hard操作。就这么简单。
某几个或者某几个仓库的版本回退

$ repo forall  [...] -c 'commitID=`git log --before "2017-03-17 07:00" -1 --pretty=format:"%H"`; git reset --hard $commitID'