Android源代码仓库及其管理工具Repo分析详解

Android源代码仓库及其管理工具源代码仓库及其管理工具Repo分析详解分析详解

本篇文章主要介绍了Android源代码仓库及其管理工具Repo分析详解，小编觉得挺不错的，现在分享给大家，也

给大家做个参考。一起跟随小编过来看看吧

软件工程由于需要不断迭代开发，因此要对源代码进行版本管理。Android源代码工程（AOSP）也不例外，它采用Git来进行

版本管理。AOSP作为一个大型开放源代码工程，由许许多多子项目组成，因此不能简单地用Git进行管理，它在Git的基础上

建立了一套自己的代码仓库，并且使用工具Repo进行管理。工欲善其事，必先利其器。本文就对AOSP代码仓库及其管理工

具repo进行分析，以便提高我们日常开发效率。

《《Android系统源代码情景分析》系统源代码情景分析》——点击下载

前面提到，AOSP是由许许多项目组成的，例如，在Android 4.2中，就包含了329个项目，每一个项目都是一个独立的Git仓

库。这意味着，如果我们要创建一个AOSP分支来做feature开发，那么就需要到每一个子项目去创建对应的分支。这显然不能

手动地到每一个子项目里面去创建分支，必须要采用一种自动化的方式来处理。这些自动化处理工作就是由Repo工具来完成

的。当然，Repo工具所负责的自动化工作不只是创建分支那么简单，查看分支状态、提交代码、更新代码等基础Git操作它都

可以完成。

Repo工具实际上是由一系列的Python脚本组成的，这些Python脚本通过调用Git命令来完成自己的功能。比较有意思的是，组

成Repo工具的那些Python脚本本身也是一个Git仓库。这个Git仓库在AOSP里面就称为Repo仓库。我们每次执行Repo命令的

时候，Repo仓库都会对自己进行一次更新。

上面我们讨论的是Repo仓库，但是实际上我们执行Repo命令想操作的是AOSP。这就要求Repo命令要知道AOSP都包含有哪

些子项目，并且要知道这些子项目的名称、仓库地址是什么。换句话说，就是Repo命令要知道AOSP所有子项目的Git仓库元

现在，我们就通过一个图来来勾勒一下整个AOSP的Picture，它由Repo脚本、Repo仓库、Manifest仓库和AOSP子项目仓库

组成，如图1所示：

图1 Repo脚本、Repo仓库、Manifest仓库和AOSP子项目仓库

接下来我们就看看上述脚本和仓库是怎么来的。接下来我们就看看上述脚本和仓库是怎么来的。

1. Repo脚本脚本

从官方网站可以知道，Repo脚本可以通过以下命令来获取：

$ curl http://commondatastorage.googleapis.com/git-repo-downloads/repo > ~/bin/repo

$ chmod a+x ~/bin/repo

也就是可以通过curl工具从http://commondatastorage.googleapis.com/git-repo-downloads/repo获得，并且保存在文件

~/bin/repo中。由于~/bin/repo是一个python脚本，我们通过chmod命令赋予它可执行的权限，以便接下来我们可以通过repo命

我们看看Repo脚本是如何执行repo init命令的：

def main(orig_args):

repo_main, rel_repo_dir = _FindRepo()

cmd, opt, args = _ParseArguments(orig_args)

wrapper_path = os.path.abspath(__file__)

my_main, my_git = _RunSelf(wrapper_path)

if not repo_main:

if opt.help:

_Usage()

_SetDefaultsTo(my_git)

try:

_Init(args)

except CloneFailure:

......

sys.exit(1)

repo_main, rel_repo_dir = _FindRepo()

else:

_NoCommands(cmd)

if my_main:

'--']

me.extend(orig_args)

me.extend(extra_args)

try:

os.execv(repo_main, me)

except OSError as e:

......

sys.exit(148)

if __name__ == '__main__':

main(sys.argv[1:])

REPO_MAIN = S_repo + '/main.py' # main script

def _FindRepo():

"""Look for a repo installation, starting at the current directory.

"""

curdir = os.getcwd()

repo = None

olddir = None

while curdir != '/' \

and curdir != olddir \

and not repo:

_ParseArguments无非是对Repo的参数进行解析，得到要执行的命令及其对应的参数。例如，当我们调用“repo init -u

https://android.googlesource.com/platform/manifest”的时候，就表示要执行的命令是init，这个命令后面跟的参数是“-u

https://android.googlesource.com/platform/manifest”。同时，如果我们调用“repo sync”，就表示要执行的命令是sync，这个

命令没有参数。

_RunSelf检查Repo脚本所在目录是否存在一个Repo仓库，如果存在的话，就从该仓库克隆一个新的仓库到执行Repo脚本的

目录来。实际上就是从本地克隆一个新的Repo仓库。如果不存在的话，那么就需要从远程地址克隆一个Repo仓库到本地来。

这个远程地址是Hard Code在Repo脚本里面。

_RunSelf的实现如下所示：

def _RunSelf(wrapper_path):

my_dir = os.path.dirname(wrapper_path)

'subcmds']:

if not os.path.exists(os.path.join(my_dir, name)):

return None, None

return my_main, my_git

return None, None

从这里我们就可以看出，如果Repo脚本所在的目录存在一个Repo仓库，那么要满足以下条件：

(1). 存在一个.git目录；

(2). 存在一个main.py文件；

(3). 存在一个git_config.py文件；

(4). 存在一个project.py文件；

么就说明Repo脚本所在目录存一个Repo仓库，这时候就调用_SetDefaultsTo设置等一会要克隆的Repo仓库源。

_SetDefaultsTo的实现如下所示：

GIT = 'git'

REPO_URL = 'https://gerrit.googlesource.com/git-repo'

REPO_REV = 'stable'

def _SetDefaultsTo(gitdir):

global REPO_URL

global REPO_REV

REPO_URL = gitdir

proc = subprocess.Popen([GIT,