Repo 使用详解

0.31字数 2122阅读 12714

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 "you@example.com"

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文件
大体格式如下:

<?xml version="1.0" encoding="UTF-8" ?>

<manifest>
    <remote name="local" fetch="git://localhost/" />
    <default remote="local" revision="master"/>
    <project path="hello" name="helo"/>
</manifest>

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

<?xml version="1.0" encoding="UTF-8"?>
<manifest>
<remote fetch="git://[http://xxx.xxx.xxx**]" name="origin" review="[http://xxx.xxx.xxx:8080**](https://link.zhihu.com/?target=http%3A//xxx.xxx.xxx%3A8080/)"/>
<default remote="origin" revision="main_dev"/>
<project name="platform/mediatek/modem/buildscript" path="buildscript">
<copyfile dest="m" src="m"/>
<copyfile dest="Make.bat" src="Make.bat"/>
<copyfile dest="make.pl" src="make.pl"/>
<copyfile dest="make.sh" src="make.sh"/>
<copyfile dest="M.bat" src="M.bat"/>
<copyfile dest="BuildMMAA.pl" src="BuildMMAA.pl"/>
</project><project name="platform/mediatek/modem/driver" path="driver"revision="352b1d8fb184a0169c6a17b5f6a858730fc51966"upstream="main_release" />
<project name="platform/mediatek/modem/make" path="make"revision="main_release" />
<project name="platform/mediatek/modem/middleware" path="middleware"revision="tag_20160316" />
<project name="platform/mediatek/modem/modem" path="modem" />
<project name="platform/mediatek/modem/mtk_rel" path="mtk_rel"/>
<project name="platform/mediatek/modem/custom" path="custom"/>
<project name="platform/mediatek/modem/tools" path="tools"/>
<project name="platform/mediatek/modem/interface" path="interface"/>
<project name="platform/mediatek/modem/service" path="service"/>
</manifest>

先看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 分支名 [<project>…]

删除已经合并分支

$ repo prune [<project>…]

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

切换分支

$ repo checkout <branchname>  [<project>…]

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

查看修改

$ repo diff [<project>…]

提交和上传代码

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 [<project>…]

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

上传本地提交至服务器

$ repo upload

查看文件状态

$ repo status

向服务器提交代码

repo push <remotename> [--all |<project>…]

merge(合并多个分支)

repo forall –p –c git merge topic

tag(打标签)

repo forall  [<project>...] –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  [<project>...] -c 'commitID=`git log --before "2017-03-17 07:00" -1 --pretty=format:"%H"`; git reset --hard $commitID'

推荐阅读更多精彩内容

  • 1.git的安装 1.1 在Windows上安装Git msysgit是Windows版的Git,从https:/...
  • 本文为 Git教程的学习笔记,教程源自廖雪峰的博客。这是一个由浅入深,学完后能立刻上手的Git教程。另,附上另一本...
  • 今天第一天开始上班,没有任务,于是开始学习Git这一程序猿必须掌握之技能,希望今天的积累过后,对与Git或者...
  • 种植水稻多少年,育秧 栽插,面朝黄土背朝天千年的模式,被现代的机械化取代。育秧从传统的浸种落谷秧苗拔秧栽...