嵌入式 Linux 多仓库管理入门:repo 与 manifest 清单仓库的工作原理

2026-11-07 1491阅读

在嵌入式 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 的开发者建立一套完整的认知框架。

9fe99012-d9b6-11f1-9642-92fbcf53809c.png

01

repo 是什么?

repo 由 Google 开发,最初用于管理 Android(AOSP)源码——AOSP 引用了大量开源项目,每个子项目都是一个独立 Git 仓库,每个仓库又有多个分支版本,需要一个上层工具统一批量处理。

关键认知

repo 不是新的版本控制系统,它是 Git 的上层封装工具。由一系列 Python 脚本组成,对部分 git 命令进行封装,把上百个 git 库有效地组织起来。所有真正的版本操作,底层依然是 git,repo 只负责批量调度。

为什么需要它?

Git 擅长管理单个仓库;而大型项目会拆分成几十个、上百个独立 Git 仓库,仓库之间存在版本依赖关系。完全手工操作意味着逐个 clone、逐个切分支、逐个拉代码、逐个处理提交——效率极低,且极易出现各子仓库版本对不齐。

a02013ee-d9b6-11f1-9642-92fbcf53809c.png

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 为例:

manifest>

a04ad8d6-d9b6-11f1-9642-92fbcf53809c.png

工程价值: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

a07a5818-d9b6-11f1-9642-92fbcf53809c.pnga084d5a4-d9b6-11f1-9642-92fbcf53809c.png

04

repo 基础使用同步与常用命令

同步远程代码:

reposync

该命令会根据 manifest.xml 中的定义,从远程仓库拉取代码。

常用参数:

a09a5a0a-d9b6-11f1-9642-92fbcf53809c.png

repo 命令与 git 命令对照:

a0afbdfa-d9b6-11f1-9642-92fbcf53809c.png

其中repo forall值得特别关注——它是 repo 相对 git 的核心增量能力:一条命令在所有子仓库中批量执行,这正是多仓库场景下最典型的诉求。

结语

repo 的学习曲线并不陡,真正的门槛在于建立"清单仓库"这个概念。

只需要理解"清单仓库描述工程由哪些 Git 仓库组成、.repo是 repo 的控制目录",repo init的三个参数、repo sync的行为、以及 manifest.xml 中remote/default/project三个节点就不再是需要死记的命令,而是有明确因果关系的配置——切换 SDK 版本、更换硬件配置,本质上就是换一个 manifest 文件。

而在日常开发中,最常用的是两条:repo sync拉代码,repo forall批量执行。其余命令基本都能在 git 中找到对应,按上表迁移即可。