【Android-Source】Install Git and repo to get android source code

Git是Linux Torvalds（Linux之父）为了帮助管理Linux内核开发而开发的一个开放源码的分布式版本控制软件，它不同于Subversion、CVS这样的集中式版本控制系统。在集中式版本控制系统中只有一个仓库（Repository），许多个工作目录（Working Copy），而在Git这样的分布式版本控制系统中（其他主要的分布式版本控制系统还有BitKeeper、Mercurial、GNU Arch、Bazaar、Darcs、SVK、Monotone等），每一个工作目录都包含一个完整仓库，它们支持离线工作，本地提交可以稍后提交到服务器上。

至于Git的参考文档，我推荐Git Magic，这里还有一个Git Magic的中文版。

因为Android是由Kernel、Dalvik、Bionic、Prebuilt、build等多个项目组成，如果我们分别使用Git来逐个获取显得很麻烦，所以Android项目编写了一个名为Repo的Python的脚本来统一管理这些项目的仓库，使得项目的获取更加简单。

在Ubuntu 8.04上安装Git只需要设定正确的更新源，然后使用apt-get就可以了，apt-get是一条Linux命令，主要用于自动从互联网的软件仓库中搜索、安装、升级、卸载软件或操作系统。

apt-get命令一般需要root权限执行，所以一般跟着sudo命令。

sudo apt-get install git-core curl

这条命令会从互联网的软件仓库中安装git-core和curl。

其中curl是一个利用URL语法在命令行方式下工作的文件传输工具，它支持很多协议，包括FTP、FTPS、HTTP、HTTPS、TELENT等，我们需要安装它从网络上获取Repo脚本文件。

curl http://android.git.kernel.org/repo >~/bin/repo

这句命令会下载repo脚本文件到当前主目录的/bin目录下，并保存在文件repo中。

最后我们需要给repo文件可执行权限

chmod a+x ~/bin/repo

接下来我们就可以利用repo脚本和Git、curl软件获取Android的源代码了：）

首先建一个目录，比如~/android。

然后使用下面命令获取源码：

repo init –u git://android.git.kernel.org/platform/manifest.git

这个过程会持续很长的时间下载完毕后会看到repo initialized in /android这样的提示，说明本地的版本库已经初始化完毕。

在运行这个工具的时候，它首先会去检查当前目录下的.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文件，在这个文件中描述了获取代码的远程版本库地址、其中所涉及到的每个项目的地址等等。下面是其中一部分：

             fetch="git://android.git.kernel.org/"
           review="review.source.android.com" />
     
 
  
 
   
     
     
     
   
 
  
  ... ...
  

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

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的版本控制的特性所带来的独特的优势。

如果我们想拿某个分支版本的代码，而不是主线代码，需要使用-b参数指定branch的名字，比如：

repo init –u git://android.git.kernel.org/platform/manifest.git –b cupcake

如果我们只是想获取某一个project的代码，比如kernel/common，就不需要repo脚本了，直接使用Git工具即可，如果仔细研究repo脚本会发现，repo脚本其实就是组织Git工具去获取各个Project并把它们组织到同一个项目Android内。

git clone git://android.git.kernel.org/kernel/common.git

我们上面使用repo脚本获取了各个项目，那么接下来就需要把整个Android代码树同步到本地，如下：

repo sync

这样就获得了我们所需要的Android源码