Manifest和Repo使用详解

最新推荐文章于 2024-03-20 11:39:39 发布
最新推荐文章于 2024-03-20 11:39:39 发布
阅读量3.4k 收藏 12
点赞数
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_38503885/article/details/116800139
版权

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

Manifest

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

 

  1. <?xml version="1.0" encoding="UTF-8"?>

  2. <manifest>

  3. <remote name="github"

  4. fetch=".."

  5. review="review.cyanogenmod.org" />

  6. <remote name="private"

  7. fetch="ssh://git@github.com" />

  8. <remote name="aosp"

  9. fetch="https://android.googlesource.com"

  10. review="android-review.googlesource.com"

  11. revision="refs/tags/android-7.1.1_r6" />

  12. <default revision="refs/heads/cm-14.1"

  13. remote="github"

  14. sync-c="true"

  15. sync-j="4" />

  16. <!-- AOSP Projects -->

  17. <project path="build" name="CyanogenMod/android_build" groups="pdk,tradefed">

  18. <copyfile src="core/root.mk" dest="Makefile" />

  19. </project>

  20. <project path="build/blueprint" name="platform/build/blueprint" groups="pdk,tradefed" remote="aosp" />

  21. <project path="build/kati" name="CyanogenMod/android_build_kati" groups="pdk,tradefed" />

  22. <project path="build/soong" name="platform/build/soong" groups="pdk,tradefed" remote="aosp" >

  23. <linkfile src="root.bp" dest="Android.bp" />

  24. <linkfile src="bootstrap.bash" dest="bootstrap.bash" />

  25. </project>

  26. <project path="abi/cpp" name="platform/abi/cpp" groups="pdk" remote="aosp" />

  27. <project path="art" name="CyanogenMod/android_art" groups="pdk" />

  28. </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的定义。
  • 子元素
 

  1. Project元素下面会有两个子元素。Copyfile和linkfile

  2. <copyfile src="core/root.mk" dest="Makefile" />

  3. <linkfile src="root.bp" dest="Android.bp" />

  4. Copefile:复制，cp src dest

  5. Linkfile：软链接 ，ln -s src dest

  6. Example:

  7. <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文件，然后将路径配置到环境变量里面。

 

  1. $ mkdir ~/bin

  2. $ PATH=~/bin:$PATH

  3. $ curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo

  4. $ 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 相当于以下命令：

     

    1. git remote update

    2. git rebase origin/<BRANCH>

    3.  

    4. 其中 <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。系统会按项目列出状态信息。对于项目中的每个文件，系统使用两个字母的代码来表示：
在第一列中，大写字母表示临时区域与上次提交状态之间的不同之处。

 

  1. {|

  2. | 字母 || 含义 || 说明

  3. |-

  4. | - || 无更改 || HEAD 与索引中相同

  5. |-

  6. | A || 已添加 || 不存在于 HEAD 中，但存在于索引中

  7. |-

  8. | M || 已修改 || 存在于 HEAD 中，但索引中的文件已修改

  9. |-

  10. | D || 已删除 || 存在于 HEAD 中，但不存在于索引中

  11. |-

  12. | R || 已重命名 || 不存在于 HEAD 中，但索引中的文件的路径已更改

  13. |-

  14. | C || 已复制 || 不存在于 HEAD 中，已从索引中的另一个文件复制

  15. |-

  16. | T || 模式已更改|| HEAD 与索引中的内容相同，但模式已更改

  17. |-

  18. | U || 未合并 || HEAD 与索引之间存在冲突；需要解决方案

  19. |}

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

 

  1. {|

  2. | 字母 | 含义 | 说明

  3. |-

  4. | - | 新/未知 | 不存在于索引中，但存在于工作树中

  5. |-

  6. | m | 已修改 | 存在于索引中，也存在于工作树中（但已修改）

  7. |-

  8. | d | 已删除 | 存在于索引中，不存在于工作树中

  9. |}

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 写入的消息。
weixin_38503885
关注
  • 0
    点赞
  • 踩
  • 12
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
Android 中Manifest.xml文件详解
08-31
主要介绍了Android 中Manifest.xml文件详解的相关资料,需要的朋友可以参考下
反思｜Android源码模块化管理工具Repo分析
却把清梅嗅的博客
05-05 1762
「反思」 系列是笔者对于 学习归纳 一种新的尝试，其起源与目录请参考 这里 。 起源 随着Android项目 模块化 或 插件化 项目业务的愈发复杂，开发流程中通过版本控制工具（比如Git）管理项目的成本越来越高。 以大名鼎鼎的 Android源代码开源项目 （Android Open-Source Project，下文简称 ASOP）为例，截止2020年初，Android10的源码项目，其模...
[Repo Git] manifests的写法
最新发布
锡城小凯的博客
03-20 851
每个元素描述了一个名称-值对，在“forall”命令期间，该名称-值对将带有REPO__前缀导出到每个项目的环境中。此外，还有一个可选属性“keep”，它接受不区分大小写的值“true”（默认值）或“false”。此元素在本地清单文件中最为有用，可以修改现有项目的属性而不必完全替换现有的项目定义。符号链接在“dest”（相对于树的顶部）创建，并指向由“src”指定的路径，该路径是项目中的一个路径。​ 这就像是复制文件，并与复制文件同时运行，但它不复制文件，而是创建一个符号链接。​修改已命名项目的属性。
android repo中manifest.xml的详解
热门推荐
私房菜
02-20 3万+
android 项目工程的第一步就是通过repo 将所有的 source code 信息获取并最终成功fetch 到本地，而这些git 的管理就是通过manifest.xml 进行，这一篇主要是对原文进行翻译，并结合自己的经验进行总结，希望对各位有所帮助，也希望不吝指教。
Openharmony之repo manifest XML文件格式介绍
fangye945a的博客
03-17 1395
在开发openharmony时，会涉及到很多git仓库，而每个仓库负责的功能不同，开发人员也不同，我们需要将这些仓库组合起来，进行构建编译，这就会用到repo命令来同时管理多个仓库。 仓库个数及每个仓库的分支都很多，而repo命令是怎么同时管理这么多仓库，又不出错的呢？ 细心的小伙伴会发现在使用repo下载代码时会通过-m参数指定一个xxx.xml文件，该文件的作用其实就是告诉repo命令，需要同步下载管理哪些仓库，这些仓库clone地址是什么、分支是什么、远程仓库名称是什么、下载下来后存储的路径及命名是什
关于repo的理解
司马如风
07-12 2549
关于repo的理解 注：repo用于管理多个git项目，同一产品可能包含多个git项目，不同的git项目集合，可能形成不同产品，通过repo可以实现方便的管理。repo主要包含repo配置信息、以及repo所管理的git项目集合。 对于所有git管理的项目，例如mygitproject，其中mygitproject/.git是git目录（或git库）；mygitproject/中除.git之外...
android Manifest.xml详解
11-06
android Manifest.xml详解 介绍了很多标签和属性
【Android】Manifest和Repo详解
weixin_41028159的博客
12-18 1840
?可以设置多个remote地址，用后面的name区分。后面可以选择使用哪一个remote地址。name: 远程git服务器的名字，直接用于git fetch, git remote 等操作alias: 远程git服务器的别名，如果指定了，则会覆盖name的设定。在一个manifest中， name不 能重名，但alias可以重名。fetch: 所有projects的git URL 前缀review: 指定Gerrit的服务器名，用于repo upload操作。
repo manifest.xml详解
Cailand的专栏
05-19 1873
在xml中可以有多个<remote>标签，每个<remote>标签代表了一个Git仓库的地址，一个或多个<project>可以使用该地址来下载代码，并且<remote>标签还可以通过。<remove-project>这个属性不知道怎么用，但是从翻译来看，这个属性经常用在内部的manifest中，这样就允许同一个manifest中后来的<project>用不同的。:当设置该值为true的时候，同步project的时候就只会同步<revision>指定的branch，而不是所有的branch.
repo 切换manifest
星辰旋风的博客
04-20 5064
repo init -b newManifest.xml repo sync -cdf --force-sync -j4
repo详解与如何更改manifest快速获取和复用AOSP代码
TonyHo's NotePad
02-15 1万+
源起 现在很多企业的网络一般都比较快, 但是有的企业却会限速, 如果需要从github和google code上面git clone大的仓库的话, 那么需要耗费的时间是很客观的,  例如从github或者google code, 或者其他托管服务站点获取Android中需要的多个Kernel仓库, 一般一个kernel仓库都有几GB, 如果是100KB/S的话, 那么将需要很长的时间. 与此同
详解HTML5中的manifest缓存使用
09-28
主要介绍了详解HTML5中的manifest缓存使用,文中同时介绍了相关的一些自动化工具,需要的朋友可以参考下
MANIFEST.MF 文件内容详解(转)
03-17
NULL 博文链接：https://wv1124.iteye.com/blog/573020
Repo manifests默认default.xml清单文件中的各个标签详解
ezconn的博客
08-24 1791
Repo是一个用于管理多个Git存储库的工具，通常与Google的Android开发项目一起使用。它允许您在一个命令下轻松地进行多个Git存储库的同步、下载和管理。
repo根目录文件提交
zmlovelx(帅得不敢出门 程序员群31843264)
05-11 240
当一个工程非常大时，通常会拆分成多个小工程．小工程用git管理，由小工程整组成一个大工程，大工程用repo管理 比如Android　SDK项目，通常总包大小会有20G以上，二级目录有30多个． 需求 在一级根目录中，有时候需要放一些单个文件，比如放一些README或者编译脚本，但是根目录下没有git管理．比如上面列的目录中的文件README.md，build.sh及连接　bootstrap.bash，　Android.bp
repo manifest, 如何导出并使用清单文件？
洛奇看世界
01-05 1万+
题图：Photo by Pankaj Patel on Unsplash 本文原创发布于微信公众号“洛奇看世界”。 本文主要介绍’repo manifest’命令的使用，如果只对结论感兴趣，请直接跳转到 [第4节 总结]。 说明： 本文基于repo v1.12.37和repo launcher 1.23 文中manifest文件有时也称为清单文件 文中对40个字符的commit id进行...
repo的实际使用
Danny_llp的博客
02-21 7809
一. repo简介 repo是Google开发的用于管理Android版本库的一个工具，repo是使用Python对git进行了一定的封装，并不是用于取代git，它简化了对多个Git版本库的管理。用repo管理的版本库都需要使用git命令来进行操作。 1 介绍清单库文件 清单文件是以xml的格式组织的，一个清单库可以包含多个清单文件和多个分支，每个清单文件和分支都有对应的版本。 1.1 remote元素 定义了名为korg的远程版本库，库的基址为git://172.16.1.31 1.2 project元素
Repo--管理仓库的版本控制工具（二）
陈粤鹏的博客
01-14 523
Repo 命令详解 使用 Repo 需遵循的格式如下： repo command options 可选元素显示在方括号 [ ] 中。例如，许多命令会用到项目列表 (project-list) 参数。项目列表可以是一个名称列表，也可以是一个本地源代码目录的路径列表： repo sync [project0 project1 … projectn] repo sync [/path/to/pro...
Android Studio manifest和layout
09-14
在Android开发中，manifest和layout是两个重要的文件。 manifest文件是每个Android应用程序中必须包含的一个文件，它位于项目的根目录下的"AndroidManifest.xml"文件中。它描述了应用程序的整体结构和配置信息，...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值