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分支下)
例如:
$ repo start stable platform/build platform/bionic
假设清单文件中设定的分支是gingerbread-exdroid-stable,那么执行以上指令就是对platform/build、platform/bionic项目,在gingerbread-exdroid-stable的基础上创建特性分支stable
查看当前项目代码所在的分支
$ repo branch
例如:
删除不用的本地分支
$ 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'
原文链接:https://www.jianshu.com/p/9c57696165f3