Manifest和Repo使用详解

Android使用repo来管理多个Git项目。它需要一个manifest??XML文件来指示这些git项目的属性。

Manifest

repo manifest?XML可以包含下面的元素。
以如下，manifest片段为例：https://github.com/CyanogenMod/android

<?xml version="1.0" encoding="UTF-8"?>
<manifest>
  <remote  name="github"
           fetch=".."
           review="review.cyanogenmod.org" />
  <remote  name="private"
           fetch="ssh://[email protected]" />
  <remote  name="aosp"
           fetch="https://android.googlesource.com"
           review="android-review.googlesource.com"
           revision="refs/tags/android-7.1.1_r6" />
  <default revision="refs/heads/cm-14.1"
           remote="github"
           sync-c="true"
           sync-j="4" />
  <!-- AOSP Projects -->
  <project path="build" name="CyanogenMod/android_build" groups="pdk,tradefed">
    <copyfile src="core/root.mk" dest="Makefile" />
  </project>
  <project path="build/blueprint" name="platform/build/blueprint" groups="pdk,tradefed" remote="aosp" />
  <project path="build/kati" name="CyanogenMod/android_build_kati" groups="pdk,tradefed" />
  <project path="build/soong" name="platform/build/soong" groups="pdk,tradefed" remote="aosp" >
    <linkfile src="root.bp" dest="Android.bp" />
    <linkfile src="bootstrap.bash" dest="bootstrap.bash" />
  </project>
  <project path="abi/cpp" name="platform/abi/cpp" groups="pdk" remote="aosp" />
  <project path="art" name="CyanogenMod/android_art" groups="pdk" />
</manifest>

Manifest元素

最顶层的XML元素。

remote元素

设置远程git服务器的属性，包括下面的属性：

  • name: 远程git服务器的名字，直接用于git fetch, git remote 等操作
  • alias: 远程git服务器的别名，如果指定了，则会覆盖name的设定。在一个manifest中， name不能重名，但alias可以重名。
  • fetch: 所有projects的git URL 前缀
  • review: 指定Gerrit的服务器名，用于repo upload操作。如果没有指定，则repo upload没有效果。

一个manifest文件中可以配置多个remote元素，用于配置不同的project默认下载指向。

default元素

设定所有projects的默认属性值，如果在project元素里没有指定一个属性，则使用default元素的属性值。

  • remote: 之前定义的某一个remote元素中name属性值，用于指定使用哪一个远程git服务器。
  • revision: git分支的名字，例如master或者refs/heads/master
  • sync_j: 在repo sync中默认并行的数目。
  • sync_c: 如果设置为true，则只同步指定的分支(revision 属性指定)，而不是所有的ref内容。
  • sync_s: 如果设置为true，则会同步git的子项目

Example:

    <default remote="main" revision="platform/main"/>

??

project元素

指定一个需要clone的git仓库。

  • name: 唯一的名字标识project，同时也用于生成git仓库的URL。格式如下：
    ????? ${remote_fetch}/${project_name}.git
  • path: 可选的路径。指定git clone出来的代码存放在本地的子目录。如果没有指定，则以name作为子目录名。
  • remote: 指定之前在某个remote元素中的name。
  • revision: 指定需要获取的git提交点，可以是master, refs/heads/master, tag或者SHA-1值。如果不设置的话，默认下载当前project，当前分支上的最新代码。
  • groups: 列出project所属的组，以空格或者逗号分隔多个组名。所有的project都自动属于"all"组。每一个project自动属于name:‘name‘ 和path:‘path‘组。
    例如<project name="monkeys" path="barrel-of"/>，它自动属于default, name:monkeys, and path:barrel-of组。如果一个project属于notdefault组，则，repo sync时不会下载。
  • sync_c: 如果设置为true，则只同步指定的分支(revision 属性指定)，而不是所有的ref内容。
  • sync_s: 如果设置为true，则会同步git的子项目。
  • upstream: 在哪个git分支可以找到一个SHA1。用于同步revision锁定的manifest(-c 模式)。该模式可以避免同步整个ref空间。
  • annotation: 可以有多个annotation，格式为name-value pair。在repo forall 命令中这些值会导入到环境变量中。
  • remove-project: 从内部的manifest表中删除指定的project。经常用于本地的manifest文件，用户可以替换一个project的定义。
  • 子元素
    Project元素下面会有两个子元素。Copyfile和linkfile
        <copyfile src="core/root.mk" dest="Makefile" />
        <linkfile src="root.bp" dest="Android.bp" />
            Copefile:复制，cp src dest
            Linkfile：软链接 ，ln -s src dest
    Example:
    <project groups="aosp" path="device/driver/armv7" revision="600aab270ce712b62b268055737cabcded59bf04"/>

?

Include元素

通过name属性可以引入另外一个manifest文件(路径相对与manifest repository‘s root)。

Repo

Android?使用?Git?作为代码管理工具，开发了?Gerrit?进行代码审核以便更好的对代码进行集中式管理，还开发了?Repo?命令行工具，对?Git?部分命令封装，将百多个?Git?库有效的进行组织。

清单库

所谓的清单库，就是我们为manifest文件单独建的一个库，一个清单库可以包含多个清单文件和多个分支，每个清单文件和分支都有对应的版本。我们就是根据不同的manifest文件来下载不同的代码。

安装repo

在ubuntu中可以通过命令进行repo的安装：

Sudo apt-get install repo

也可以直接下载repo文件，然后将路径配置到环境变量里面。

$ mkdir ~/bin
$ PATH=~/bin:$PATH
$ curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
$ chmod a+x ~/bin/repo

Repo help

安装 Repo 后，您可以通过运行以下命令找到最新文档（开头是包含所有命令的摘要）：

repo help

您可以通过在 Repo 树中运行以下命令来获取有关某个命令的信息：

repo help <COMMAND>

例如，以下命令会生成 Repo init 参数的说明和选项列表，该参数会在当前目录中初始化 Repo。（要了解详情，请参阅 init。）

repo help init

Repo init

Usage

repo init –u URL [OPTIONS]

在当前目录中安装 Repo。这会创建一个 .repo/ 目录，其中包含用于 Repo 源代码和标准 Android 清单文件的 Git 代码库。该 .repo/ 目录中还包含 manifest.xml，这是一个指向 .repo/manifests/ 目录中所选清单的符号链接。

Options:

  • u：指定一个URL，其连接到一个manifest仓库
  • m：在manifest仓库中选择一个xml文件，如果未选择，默认指向default.xml
  • b：选择一个maniest仓库中的一个特殊的分支
  • --mirror：下一步和源同步的时候，本地按照源的版本库组织方式进行组织
  • --reference=<path>：path为一个镜像地址，从镜像同步代码。
  • --repo-url=<url>：url为repo 库的位置，用于修改repo文件中REPO-URL参数的指向。

命令repo init?要完成如下操作：

  • 完成repo工具的完整下载，执行的repo脚本只是引导程序
  • 克隆清单库manifest.git (地址来自于-u?参数)
  • 克隆的清单库位于manifest.git中，克隆到本地.repo/manifests.清单.repo/manifest.xml只是符号链接，它指.repo/manifests/default.xml
  • 如果manifests中有多个xml文件，repo init?可以任意选择其中一个，默认选择是default.xml

Repo sync

Usage

repo sync [<PROJECT_LIST>]

下载新的更改并更新本地环境中的工作文件。如果您在未使用任何参数的情况下运行 repo sync，则该操作会同步所有项目的文件。
运行 repo sync 后，将出现以下情况：

  • 如果目标项目从未同步过，则 repo sync 相当于 git clone。远程代码库中的所有分支都会复制到本地项目目录中。
  • 如果目标项目已同步过，则 repo sync 相当于以下命令： 
    git remote update
git rebase origin/<BRANCH>

其中 <BRANCH> 是本地项目目录中当前已检出的分支。如果本地分支没有在跟踪远程代码库中的分支，则相应项目不会发生任何同步。
  • 如果 git rebase 操作导致合并冲突，那么您需要使用普通 Git 命令（例如 git rebase --continue）来解决冲突。repo sync 运行成功后，指定项目中的代码会与远程代码库中的代码保持同步。

Option:

  • d：将指定项目切换回清单修订版本。如果项目当前属于某个主题分支，但只是临时需要清单修订版本，则此选项会有所帮助。
  • s：同步到当前清单中清单服务器元素指定的一个已知的良好版本。
  • f：即使某个项目同步失败，系统也会继续同步其他项目。

Repo start

Usage

repo start <BRANCH_NAME> [<PROJECT_LIST>]

从清单中指定的修订版本开始，创建一个新的分支进行开发。

  • <BRANCH_NAME> 参数应简要说明您尝试对项目进行的更改。如果您不知道，则不妨考虑使用默认名称。
  • <PROJECT_LIST> 指定了将参与此主题分支的项目。

Repo diff

Usage

repo diff [<PROJECT_LIST>]

使用 git diff 显示提交与工作树之间的明显更改。

Repo prune

Usage

repo prune [<PROJECT_LIST>]

删减（删除）已合并的主题。

Repo status

Usage

repo status [<PROJECT_LIST>]

对于每个指定的项目，将工作树与临时区域（索引）以及此分支 (HEAD) 上的最近一次提交进行比较。在这三种状态存在差异之处显示每个文件的摘要行。
要仅查看当前分支的状态，请运行 repo status。系统会按项目列出状态信息。对于项目中的每个文件，系统使用两个字母的代码来表示：
在第一列中，大写字母表示临时区域与上次提交状态之间的不同之处。

{|
|   字母    ||  含义      ||  说明
|-
|   -       ||  无更改    ||  HEAD 与索引中相同
|-
|   A       ||  已添加    ||  不存在于 HEAD 中，但存在于索引中
|-
|   M       ||  已修改    ||  存在于 HEAD 中，但索引中的文件已修改
|-
|   D       ||  已删除    ||  存在于 HEAD 中，但不存在于索引中
|-
|   R       ||  已重命名  ||  不存在于 HEAD 中，但索引中的文件的路径已更改
|-
|   C       ||  已复制    ||  不存在于 HEAD 中，已从索引中的另一个文件复制
|-
|   T       ||  模式已更改||  HEAD 与索引中的内容相同，但模式已更改
|-
|   U       ||  未合并    ||  HEAD 与索引之间存在冲突；需要解决方案
|}

在第二列中，小写字母表示工作目录与索引之间的不同之处。

{|
|   字母    |   含义       |   说明
|-
|   -       |   新/未知    |   不存在于索引中，但存在于工作树中
|-
|   m       |   已修改     |   存在于索引中，也存在于工作树中（但已修改）
|-
|   d       |   已删除     |   存在于索引中，不存在于工作树中
|}

Repo forall

Usage

repo forall [<PROJECT_LIST>] -c <COMMAND>

在每个项目中运行指定的 shell 命令。通过 repo forall 可使用下列额外的环境变量：

  • REPO_PROJECT 可设为项目的具有唯一性的名称。
  • REPO_PATH 是客户端根目录的相对路径。
  • REPO_REMOTE 是清单中远程系统的名称。
  • REPO_LREV 是清单中修订版本的名称，已转换为本地跟踪分支。如果您需要将清单修订版本传递到某个本地运行的 Git 命令，则可使用此变量。
  • REPO_RREV 是清单中修订版本的名称，与清单中显示的名称完全一致。

Option：

  • c：要运行的命令和参数。此命令会通过 /bin/sh 进行求值，它之后的任何参数都将作为 shell 位置参数传递。
  • p：在指定命令输出结果之前显示项目标头。这通过以下方式实现：将管道绑定到命令的 stdin、stdout 和 sterr 流，然后通过管道将所有输出结果传输到一个页面调度会话中显示的连续流中。
  • v：显示该命令向 stderr 写入的消息。

原文地址：http://blog.51cto.com/muyusen/2316227

时间： 2024-10-07 19:08:07

Manifest和Repo使用详解的相关文章

Repo用法详解

Android 为企业提供一个新的市场,无论大企业,小企业都是处于同一个起跑线上.研究 Android 尤其是 Android 系统核心或者是驱动的开发,首先需要做的就是本地克隆建立一套 Android 版本库管理机制. Android 使用 Git 作为代码管理工具,开发了 Gerrit 进行代码审核以便更好的对代码进行集中式管理,还开发了 Repo 命令行工具,对 Git 部分命令封装,将 百多个 Git 库有效的进行组织.要想克隆和管理这百多个 Git 库,还真不是一件简单的事情. 在研究

centos yum的配置文件 repo文件详解

什么是repo文件?repo文件是Fedora中yum源(软件仓库)的配置文件,通常一个repo文件定义了一个或者多个软件仓库的细节内容,例如我们将从哪里下载需要安装或者升级的软件包,repo文件中的设置内容将被yum读取和应用!YUM的工作原理并不复杂,每一个 RPM软件的头(header)里面都会纪录该软件的依赖关系,那么如果可以将该头的内容纪录下来并且进行分析,可以知道每个软件在安装之前需要额外安装 哪些基础软件.也就是说,在服务器上面先以分析工具将所有的RPM档案进行分析,然后将该分析纪

Red Hat Enterprise Linux(RHEL)中yum的repo文件详解

Yum(全称为 Yellow dog Updater, Modified)是一个在Fedora和RedHat以及CentOS中的Shell前端软件包管理器.基于RPM包管理,能够从指定的服务器自动下载RPM包并且安装,可以自动处理依赖性关系,并且一次安装所有依赖的软件包,无须繁琐地一次次下载.安装. 使用yum help查看所有支持的命令: 首先查看/etc/yum.conf的内容: 下面逐行介绍这个配置文件里每一行的作用. cachedir=/var/cache/yum/$basearch/$

Linux yum配置文件详解

说明:经过网上抄袭和自己的总结加实验,非常详细,可留作参考. yum的配置一般有两种方式: 一种是直接配置/etc目录下的yum.conf文件, 另外一种是在/etc/yum.repos.d目录下增加.repo文件. 一.yum的配置文件yum.conf详解  $ cat /etc/yum.conf [main] cachedir=/var/cache/yum #yum下载的RPM包的缓存目录 keepcache=0 #缓存是否保存,1保存,0不保存. debuglevel=2 #调试级别(0-

YUM源详解以及EPEL源的创建

YUM是什么? yum(全称为Yellowdog Updater Modified)是一个在CentOS.RedHat和Fedora操作系统中使用的Shell前端软件包管理器.yum主要管理基于rpm的软件包,Centos先将发布的软件放置到YUM服务器内,然后分析这些软件的依赖属性问题,将软件内的记录信息写下来(header).然后再将这些信息分析后记录成软件相关性的清单列表.这些列表数据与软件所在的位置可以称为仓库(repository).当客户端有软件安装的需求时,客户端主机会向网络上面的

yum的配置文件yum.conf详解

说明:经过网上抄袭和自己的总结加实验,非常详细,可留作参考. yum的配置一般有两种方式:   一种是直接配置/etc目录下的yum.conf文件, 另外一种是在/etc/yum.repos.d目录下增加.repo文件. 一.yum的配置文件yum.conf详解 view sourceprint? 01.$ cat /etc/yum.conf 02. 03.[main] 04.cachedir=/var/cache/yum         #yum下载的RPM包的缓存目录 05.keepcach

AndroidMainfest详解

基于TV settings和SettingsProvider Android启动模式对activity行为的影响 AndroidManifest.xml文件详解 Manifest文件中,application和activity标签属性详解 android之manifest.xml内provider详解 coreApp <manifest ··· coreApp="true" ··· </manifest> 在manifest中增加该属性,其实并不是代表该APP具有系统

[转] - JAR文件包及jar命令详解 ( MANIFEST.MF的用法 )

常常在网上看到有人询问:如何把 java 程序编译成 .exe 文件.通常回答只有两种,一种是制作一个可执行的 JAR 文件包,然后就可以像. chm 文档一样双击运行了:而另一种是使用 JET 来进行 编译.但是 JET 是要用钱买的,而且据说 JET 也不是能把所有的 Java 程序 都编译成执行文件,性能也要打些折扣.所以,使用制作可执行 JAR 文件包的方法就是最佳选择了,何况它还能保持 Java 的跨平台特性. 下面就来看看什么是 JAR 文件包吧: 1. JAR 文件包 JAR 文件

manifest文件详解

<?xml version="1.0" encoding="utf-8"?><manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.exe.phone" <?xml version="1.0" encoding="utf-8"?> <manife