Manifest和Repo使用详解

时间  2019-11-05
标签 manifest repo 使用 详解 繁體版
原文   原文链接

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

Manifest

repo manifest XML能够包含下面的元素。
以以下，manifest片断为例：https://github.com/CyanogenMod/androidgit

<?xml version="1.0" encoding="UTF-8"?>
<manifest>
  <remote  name="github"
           fetch=".."
           review="review.cyanogenmod.org" />
  <remote  name="private"
           fetch="ssh://git@github.com" />
  <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元素。github

remote元素

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

  • 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默认下载指向。bootstrap

default元素

设定全部projects的默认属性值，若是在project元素里没有指定一个属性，则使用default元素的属性值。ubuntu

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

Example:api

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

  

project元素

指定一个须要clone的git仓库。bash

  • 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 库有效的进行组织。ssh

清单库

所谓的清单库，就是咱们为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 写入的消息。
相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程