Repo 使用详解

参考文章:

清华镜像之Android 镜像使用帮助

Android系统源码编译

Repo工具的使用

前言

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

一、环境准备

1) ubuntu24.04(250G+6核+16GRAM)
2) VirtualBox6.1.34

二、安装repo

1) 安装python

apt-get install python
alias python=python3

2)安装Git & 配置Git信息

sudo apt-get install git
git config --global user.name "afinalstone"
git config --global user.email "afinalstone@foxmail.com"
git config --list

3)安装curl

sudo apt-get install curl

4) 安装repo

curl https://mirrors.tuna.tsinghua.edu.cn/git/git-repo > ~/bin/repo
chmod a+x ~/bin/repo
export PATH=~/bin:$PATH

二、初始化Repo客户端

1)创建源码存放目录

 mkdir /home/ubuntu/android (根据实际情况来新建目录)
 cd /home/ubuntu/android

2)初始化仓库

repo init -u https://aosp.tuna.tsinghua.edu.cn/platform/manifest

3)repo指定Android版本

repo init -u https://aosp.tuna.tsinghua.edu.cn/platform/manifest -b android-9.0.0_r8

三、查看repo初始化获取到的的manifest配置文件。

1.打开/home/ubuntu/android文件夹
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的路径。

三、系统编译
1)同步源码

repo sync  (等待源代码下载完成,长时间等待,若失败请检查网络等情况)
sudo apt-get update # 更新已经的安装

四、搭配Gerrit修改仓库配置

如果项目有搭配使用Gerrit,一般还需要修改代码仓库地址和自己的Gerrit路径相对应。

1、打开**.repo**文件,该文件目录如下所示:
.repo文件目录
其中manifest.xml中指定了当前使用的代码分支名称,一般都是manifest_xxx.xml,如下所示:

<?xml version="1.0" encoding="UTF-8"?>
<manifest>
  <include name="manifest_xxx.xml" />
</manifest>

2、继续打开manifests文件夹,找到对应名称为manifest_xxx.xml的配置文件,修改代码仓库地址

<?xml version="1.0" encoding="UTF-8"?>
<manifest>
<remote name="origin" fetch="ssh://xxx@xxx.xxx.xxx/"review="ssh://xxx@xxx.xxx.xxx/"/>
<default remote="origin" revision="main_dev"/>
...代码省略...
</manifest>

xxx(自己的Gerrit名称)@xxx.xxx.xxx(仓库地址)

五、管理仓库

要管理的仓库是普通的git。当以上一切准备完毕. 我们就可以进行代码同步了:

 repo sync

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

六、常用指令

1、创建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

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

repo branch

3、删除不用的本地分支

repo abandon 分支名 [<project>…]

4、删除已经合并分支

repo prune [<project>…]

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

5、切换分支

repo checkout <branchname>  [<project>…]

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

6、查看修改

repo diff [<project>…]

7、提交和上传代码

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。

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

repo stage -i [<project>…]

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

9、上传本地提交至服务器

repo upload

10、查看文件状态

repo status

11、向服务器提交代码

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

12、merge(合并多个分支)

repo forall –p –c git merge topic

13、tag(打标签)

  • 为单个项目下打标签
repo forall  [<project>...] –c git tag crane-stable-1.6
  • 在所有项目下打标签
repo forall –c git tag crane-stable-1.6

14、显示manifest文件内容

repo manifest

15、显示repo的版本号

repo version

16、repo自身的更新

repo selfupdate

17、查看本地repo管理的所有projects

repo list

18、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'
  • 2
    点赞
  • 34
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值