android 源码下载过程和工具速览

转载：http://blogold.chinaunix.net/u2/85805/showart_1892072.html

随着第一款Android的手机上市，Google也终于发布了其Android的源码。通常情况下，一个开源项目的发布都是伴随着一个巨大的完整的xxx-src.tar.gz的源码包，然后解压、configure/make即可。而Android是基于传说中的Git来管理的，在发布方面自然也有所不同，它基于Git构造了一个可以随时同步更新的源码库。

从 http://source.android.com/download 可以找到一段简单的下载源码的介绍。大致情况是，首先要在Linux或者MacO的系统下操作，其次要保证Git的版本在1.5.4之上，Python的版本在2.4之上。

先做一个小准备，在个人home目录下建立一个bin目录，并加入到PATH环境变量中
$ mkdir ~/bin
$ export PATH=$HOME/bin:$PATH

要下载其源码，先要安装一个Android的构建工具 repo。

从服务器上获取repo,并重定向到~/bin/repo
$ curl http://android.git.kernel.org/repo > ~/bin/repo 

修改脚本的执行权限
$ chmod a+x ~/bin/repo

然后再建立一个存放源码的目录
$ mkdir ~/android ; cd ~/android

之后使用这个repo工具，来初始化这个源码仓库：
$ repo init -u git://android.git.kernel.org/platform/manifest.git

片刻等待之后，仓库初始化完成。此时，这个仓库只是更新了repo这个构建工具本身，并下载了整个Android源码仓库的一个清单的版本库，

在~/android/.repo下面能够看到这些文件。其中 ~/android/.repo/repo目录是构建工具的全部代码，基于Python写成，稍后再看。

其次是~/android/.repo/manifests/default.xml文件，这个是整个Android源码库的清单文件，之后repo这个工具会根据这个清单依次下载所有的代码。

而~/android/.repo/manifest.git则是这个清单文件的版本库  。

Git有一个有意思的特性，就是可以制定存放版本库版本信息的目录的位置，因而可以将存放版本信息的目录和实际的项目文件放置于不同的目录下，

而不是像以前的cvs或者Subversion一样在每一个目录下都有一个讨厌的.xxx隐藏目录。这也从某种程度上减少了冗余信息。

经过上述步骤之后，可以开始进行源码仓库的下载了，对于repo来说，称之为“同步”——sync。

$ repo sync

下载过程中随时可以终断，中断后重新执行同步即可更新到最新的源码仓库。

这一切其实都是基于那个名为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 -ugit://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的版本控制的特性所带来的独特的优势。