关于git-repo时manifest.xml的一些整理

 在Android源码的下载和应用程序编程中,manifest.xml文件是非常重要的,是repo仓库的大管家,在里面定义着repo中可用的git项目。这里主要讲的是Android源码中的manifest.xml文件,应用程序中的manifest文件不是很了解,没有发言权。

       今天就因为一个manifest.xml文件的问题,自己纠结了一天,总是不太明白为啥没有下载合适的工程,各种google,最后自己阅读了下.repo/manifest.xml文件,才发现可能是由于网页编辑人员的失误,将项目组的名称写错了,而自己又不太会看manifest.xml文件,所以怎么也找不出来问题。

       下面以一个实际的例子来说明manifest.xml文件的结构(arndale-octa.xml),由于源文件非常大,只选取部分来进行说明:





另外,google公司给出的文档manifest-format.txt中定义了XML文件的格式:


标记之间的是由repo脚本解释执行的一些命令。


Remote 定义了远程git的名称,fetch给定了该git项目的存放地址(URL)。Review定义了当使用命令’repo upload’上传更新后,审核代码的gerrit服务器的主机名。

Name:A short name uniqueto this manifest file。用来作为每个项目的.git/config的远程名称。


Project定义了一个新的项目

Path:定义了git仓库应该把远程源码存放到本地的位置

Name:git项目的名称

Revision:定义了在仓库中使用哪个分支或者tag,如果没有说明,则repo sync会使用由标记的版本。

Groups:项目组的名称,有一些项目可能在被用在多个具体的实例中,所以将它们分组,通常有common,devel等组。

 

在大多数情况下,可能规定一个默认的元素。它的Remote和revision属性被用于当项目没有指定自己的remote和revision属性时。

Revision属性:git分支的名称。(例如master或者refs/heads/master)。

 

当我们从google网站上下载到最新的repo脚本文件后,运行repo init来初始化一个仓库,需要添加一些额外的参数例如,-u 指定从哪个仓库下载,-b指定分支,-m指定manifest文件名称,-g指定项目组。

 

      整理完后,对于manifest.xml不再感觉那么神秘难懂了,对于可能出现的错误,也可以去检查manfiest.xml文件(一般是对.repo/manifests/default.xml的链接),找出命令中可能出现的错误,再接着repo sync即可从仓库中拉下正确的源码。很方便啊!!

 

你可能感兴趣的:(arndale,octa)