repo是Google开发的用于管理Android版本库的一个工具,repo是使用Python对git进行了一定的封装,并不是用于取代git,它简化了对多个Git版本库的管理。用repo管理的版本库都需要使用git命令来进行操作。
一、安装配置repo
1,全局安装curl工具,使用curl下载repo
plain
sudo apt install curl
curl https://storage.googleapis.com/git-repo-downloads/repo > ~/.bin/repo
也可以从清华的镜像下载:
plain
git clone https://mirrors.tuna.tsinghua.edu.cn/git/git-repo
- 根目录下创建.bin文件夹
plain
mkdir ~/.bin
- 拷贝git-repo文件夹中的repo 到 ~/.bin 目录下
plain
cp git-repo/repo ~/.bin/
- 添加执行权限
plain
sudo chmod a+x ~/.bin/repo
- 配置环境变量
plain
export PATH=~/.bin:$PATH
echo "export PATH=~/.bin:$PATH">> ~/.bashrc
6,配置下载代码repo地址环境
export REPO_URL='https://mirrors.tuna.tsinghua.edu.cn/git/git-repo/'
plain
echo "export REPO_URL='https://mirrors.tuna.tsinghua.edu.cn/git/git-repo/'">> ~/.bashrc
二、下载Android源码
1, 执行命令查看是否配置ok
plain
vi ~/.bashrc
2,如果 在文件的最尾部可以看到如下,说明配置成功
plain
export PATH=~/.bin:/home/xx/.bin:
export REPO_URL='https://mirrors.tuna.tsinghua.edu.cn/git/git-repo/'
3,使用repo下载Android源码,比如下载Android14源码
plain
repo init -u https://mirrors.tuna.tsinghua.edu.cn/git/AOSP/platform/manifest -b android-14.0.0_r1
repo sync
三、repo常用命令
拉取代码命令
例如下面是拉取某个项目的命令:
plain
repo init -u ssh://ppgerrit.com/Mstar648/manifest.git -b 648_cultraview -m ppos4.5.0_cultraview.xml
说明如下:
-
-u:指定一个URL,其连接到一个manifest仓库
-
-b:选择manifest仓库中的一个特殊分支
-
-m:在manifest仓库中选择一个xml文件
repo init要完成如下操作:
-
完成repo工具的完整下载,执行的repo脚本只是引导程序
-
clone清单库manifest.git (地址是-u后面的参数)
-
clone的清单库位于manifest.git中,clone到本地.repo/manifest中,.repo/manifest.xml只是符号链接,它指向的是.repo/manifests/default.xml
-
如果manifest中有多个xml文件,repo init可以任意选择其中一个,默认选择的是default.xml。
代码同步
执行了repo init 命令后,我们需要执行如下命令同步代码:
plain
repo sync
如果项目版本库不存在,则执行repo sync命令相当于执行git clone;如果项目版本库存在,则相当于执行下面两条指令:
- git remote update:相当于对每一个remote源执行了fetch操作
- git rebase origin/branch: 对当前分支的跟踪分支执行rebase操作
创建分支
clone出来的项目默认是没有分支的。repo start 的实质就是对git checkout -b 的封装,可以为单个项目或所有项目以清单文件中已设定的分支为基础,在本地创建新的分支。
repo start 与 git checkout -b 的区别:
- repo start 是在清单文件设定的分支基础上创建新的分支
- git checkout -b 是在当前所在分支的基础上创建新的分支
如果清单文件中设定的分支是remoteBranchName,创建新的分支localBranchName。为单个项目创建localBranchName分支的命令如下:
plain
repo start localBranchName 项目绝对路径
为所有项目创建localBranchName分支的命令如下:
plain
repo start localBranchName --all
切换分支
切换分支语法:
plain
repo checkout brancnName
查看文件状态
该命令实际上是对git diff-index 和git diff-filse命令的封装,同时显示暂存区的状态和本地文件修改的状态。查看文件状态语法:
plain
repo status
其中:
-
每个小节的第一行显示的是项目名称和所在的分支名称
-
每个小节的第二行的第一个字母表示暂存区文件修改的状态
- -:没有改变
- A:添加(不在HEAD中,在暂存区中)
- M:修改(在HEAD中,在暂存区中,内容不同)
- D:删除(在HEAD中,不在暂存区)
- R:重命名(不在HEAD中,在暂存区,路径修改)
- C:拷贝(不在HEAD中,在暂存区,从其他文件拷贝)
- T:文件状态改变(在HEAD中,在暂存区,内容相同)
- U:未合并,需要冲突解决
-
每个小节的第二行的第二个字母表示工作区文件的更改状态
- -:新/未知(不在暂存区,在工作区)
- m:修改(在暂存区,在工作区,被修改)
- d:删除(在暂存区,不在工作区
删除指定分支
该命令实质是对git branch -D的封装,语法如下:
plain
repo abandon branchName