Android源码构建工具速览（二）—— 清单文件

上回已经简单的在本地构造了一个Android的源码库，这回来看看这个源码库是如何构造出来的。

这一切其实都是基于那个名为repo的构造工具。回到最开始的命令 $ curl http://android.git.kernel.org/repo > ~/bin/repo
这个命令从网站上下载了一个名为repo的脚本，它实际上是段python的代码，这个代码仔细看看还是有点意思的。它其实是整个构建工具的一小部分代码，而这一小部分的代码的功能主要就是去下载自身其它的代码，并初始化构建环境。

在运行这个工具的时候，它首先会去检查当前目录下的.repo目录，然后从脚本内置的（或命令行指定的）一个地址 git://android.kernel.org/tools/repo.git 去使用git clone一份最新的repo工具的完整的版本库放置到 .repo/repo 目录下，之后checkout出最新的代码。这些代码就是repo的其它部分的代码。这其中的 main.py 就是repo构建工具的主干入口代码。

而在之前的构造过程中的调用命令 $ repo init -u git://android.git.kernel.org/platform/manifest.git 中，repo首先完成了前面所说的对自身的更新和初始化，然后通过调用后面补充进来的代码完成init的操作。在这个操作中， repo从 git://android.git.kernel.org/platform/manifest.git 这个地址下载了一份整个源码仓库的清单的版本库，并checkout出一份最新的清单，即 .repo/manifests/default.xml 文件。该文件是一个xml文件，在这个文件中描述了获取代码的远程版本库地址、其中所涉及到的每个项目的地址等等。下面是其中一部分：

<manifest branch="master">

<remote name="korg"

fetch="git://android.git.kernel.org/"

review="review.source.android.com" />

<project path="bionic" name="platform/bionic" />

<project path="external/clearsilver" name="platform/external/clearsilver">

<import>

<remap strip="clearsilver-%version%/" />

<mirror url="http://android.git.kernel.org/pub/clearsilver-%version%.tar.gz" />

<snapshot version="0.10.5" check="ec5fff5d7367ddd29a619cf81ae264687fde94c8" />

</import>

</project>

... ...

</manifest>

这里只是截取了其中一小部分的片段用来说明问题。

remote节点的fetch属性描述了远程的版本库的基本地址，之后是一系列的project节点。每一个project节点都有一个path和name属性，path是该项目在本地的存储地址，如bionic则是存储在本地的 ./repo/projects/bionic 下面，而name属性是远程版本库中的路径，与remote的fetch的地址结合起来即可得到该项目的版本库地址，如bionic的版本库是在 git://android.git.kernel.org/platform/bionic

而有的project定义中有import节点，该import节点中定义的一般都是该项目所依赖的第三方的独立项目，这些项目是没有历史版本信息的，因此只是一个tar.gz的包。repo在同步的过程中会将其下载下来，解压、加入到该项目的版本库中，并打上一个tag标记。

通过这个清单文件，repo可以实现整个源码库的随时更新和同步，这也是基于git的版本控制的特性所带来的独特的优势。