嵌入式 Linux 多仓库管理入门:repo 与 manifest 清单仓库的工作原理
在嵌入式 Linux 开发中,工程师拿到的 SDK 通常不是一个代码仓库,而是几十甚至上百个独立 Git 仓库的集合——内核、U-Boot、驱动、工具链、第三方库各自维护,彼此之间还存在版本依赖。
以EASY-EAI-Nano-TB的 SDK 为例,初始化命令是这样的:
repoinit --repo-url ssh://git@os.easy-eai.com/ubuntu_sdk/repo \ -u git@os.easy-eai.com:ubuntu_sdk/manifest -b lmo -m lmo-linux.xml
不少初学者的第一反应是"照着文档复制粘贴",但一旦需要切换 SDK 版本、更换硬件配置或排查同步失败,就容易卡住——因为不理解-u、-b、-m这三个参数到底在指定什么。
本文基于EASY-EAI工程师的内部学习分享,梳理 repo 工具的定位、manifest 清单仓库的组织结构、.repo目录的作用,以及常用命令与 git 的对照关系,为刚接触多仓库 SDK 的开发者建立一套完整的认知框架。
01
repo 是什么?
repo 由 Google 开发,最初用于管理 Android(AOSP)源码——AOSP 引用了大量开源项目,每个子项目都是一个独立 Git 仓库,每个仓库又有多个分支版本,需要一个上层工具统一批量处理。
关键认知
repo 不是新的版本控制系统,它是 Git 的上层封装工具。由一系列 Python 脚本组成,对部分 git 命令进行封装,把上百个 git 库有效地组织起来。所有真正的版本操作,底层依然是 git,repo 只负责批量调度。
为什么需要它?
Git 擅长管理单个仓库;而大型项目会拆分成几十个、上百个独立 Git 仓库,仓库之间存在版本依赖关系。完全手工操作意味着逐个 clone、逐个切分支、逐个拉代码、逐个处理提交——效率极低,且极易出现各子仓库版本对不齐。
02
核心概念manifest 清单仓库
理解 repo 的关键,在于理解清单仓库(Manifests Repository)。
清单仓库的定位
清单仓库本质上是一个 Git 仓库,但它的作用不是存储项目代码,而是描述项目的整体结构与子仓库的组织方式。通俗地说,它告诉 repo 四件事:
一个容易混淆的点:清单仓库和其它代码仓库是同一个等级的 Git 仓库,只不过它里面存储的是"如何管理其他仓库"的文件。所以在一个使用 repo 管理的项目中,一定有一个清单仓库。
清单仓库的组成
从 Git 仓库的角度看,一个典型的清单仓库结构如下:
Manifest Repository├── manifests/ # 存放 Manifest XML 文件│ ├──default.xml│ ├── lmo.xml│ └── lmo-linux.xml└── .git/ # 清单仓库自身的 Git 数据
特别注意:清单仓库不是manifests/目录本身,而是整个 Git 仓库;manifests/只是其中用于存放 Manifest 文件的目录。
一个清单仓库中可以存在多个Manifest 文件,不同的 Manifest 用于描述不同的项目版本、分支或硬件配置。这也是为什么前面那条初始化命令要用-m lmo-linux.xml指定具体清单——同一份 SDK 下,可能有面向不同配置的多份清单。
Manifest 文件:三个核心节点
Manifest 文件本质是 XML 文件,通过不同节点描述整个多仓库工程。以 default.xml 为例:
工程价值:project中的path属性可以很好地组织本地目录结构——这就是为什么拉取后的 SDK 目录层次是设计好的,而不是一堆平铺的仓库名。
03
repo init 之后.repo 目录里有什么
执行repo init后,repo 会在当前工程目录下创建.repo/目录,用于保存运行信息及当前工程的 Manifest:
.repo├── manifests # manifest 仓库(清单库)内容,对应 repo init 的 -u 选项├── manifests.git # manifest 仓库的 .git 目录├── manifest.xml # 指明当前生效的 Manifest 文件,对应 -m 选项(默认 default.xml)└── repo # repo 命令的主体,包含最新的 repo 命令
至此,整个协作关系就清楚了:
清单仓库负责描述"工程由哪些 Git 仓库组成"
.repo是 repo 管理这个工程时使用的控制目录
这也解释了开头那条命令中三个参数的含义:
repoinit-u https://example.com/git/manifests.git -b linux -m manifest.xml
04
repo 基础使用同步与常用命令
同步远程代码:
reposync
该命令会根据 manifest.xml 中的定义,从远程仓库拉取代码。
常用参数:
repo 命令与 git 命令对照:
其中repo forall值得特别关注——它是 repo 相对 git 的核心增量能力:一条命令在所有子仓库中批量执行,这正是多仓库场景下最典型的诉求。
结语
repo 的学习曲线并不陡,真正的门槛在于建立"清单仓库"这个概念。
只需要理解"清单仓库描述工程由哪些 Git 仓库组成、.repo是 repo 的控制目录",repo init的三个参数、repo sync的行为、以及 manifest.xml 中remote/default/project三个节点就不再是需要死记的命令,而是有明确因果关系的配置——切换 SDK 版本、更换硬件配置,本质上就是换一个 manifest 文件。
而在日常开发中,最常用的是两条:repo sync拉代码,repo forall批量执行。其余命令基本都能在 git 中找到对应,按上表迁移即可。







