📚 课程目录第3章元数据与层结构

3. 元数据与层结构

好，咱们进入第三章。这一章我打算聊聊Yocto项目里最核心的两个概念——元数据和层结构。说实话，这两个东西你搞明白了，Yocto的大门就算真正推开了。

3.1 元数据（Metadata）的概念

先说说元数据。这个词听起来挺唬人，其实说白了，就是「描述数据的数据」。在Yocto的世界里，元数据就是那些告诉BitBake「怎么做」的配方文件和配置文件。

我个人习惯把元数据分成三类：

配方文件（.bb）：描述一个软件包怎么下载、怎么编译、怎么安装
附加配方文件（.bbappend）：对已有配方进行修改和扩展
配置文件（.conf）：定义全局变量、机器特性、发行版策略等

举个例子，你写一个hello.bb文件，里面告诉BitBake去哪里下载hello-world的源码，用什么编译器，安装到哪个目录。这就是元数据。嗯，这里要注意，元数据本身不是代码，它是代码的「说明书」。

核心理解：Yocto项目的本质，就是通过元数据驱动BitBake引擎，自动完成从源码到根文件系统的构建过程。没有元数据，BitBake就是个空壳子。

我在项目中遇到过一位同事，他把元数据当成普通的shell脚本去写，结果变量覆盖搞得一团糟。后来我告诉他：元数据是声明式的，不是过程式的。你告诉系统「要什么」，而不是「怎么做」。这个思维转变很重要。

3.2 层（Layer）的结构与配置

层这个概念，你可以把它想象成一个「模块化的元数据仓库」。每一层里放着相关的配方、配置和补丁。Yocto通过层的叠加机制，把不同来源的元数据组合成一个完整的构建环境。

为什么会需要层？你想想看，一个嵌入式产品往往涉及BSP、中间件、应用软件、UI界面等多个团队。如果所有人都往一个目录里塞配方文件，那不乱套了？层的设计就是为了解决这个问题的。

3.2.1 层的标准结构

一个标准的层，目录结构大概是这样的：

meta-mylayer/
├── conf/
│   ├── layer.conf          # 层的配置文件
│   └── machine/            # 机器配置文件
├── recipes-example/
│   ├── hello/
│   │   ├── hello_1.0.bb
│   │   └── files/
│   │       └── hello.patch
│   └── world/
│       └── world_git.bb
├── classes/                # 类文件（可选）
├── files/                  # 公共文件（可选）
└── README                  # 层的说明文档

其中conf/layer.conf是必须的，它告诉BitBake这个层的基本信息：

BBPATH .= ":${LAYERDIR}"
BBFILES += "${LAYERDIR}/recipes-*/*/*.bb ${LAYERDIR}/recipes-*/*/*.bbappend"

BBFILE_COLLECTIONS += "mylayer"
BBFILE_PATTERN_mylayer = "^${LAYERDIR}/"
BBFILE_PRIORITY_mylayer = "5"

这里BBFILE_PRIORITY很关键。我曾经在调试一个莫名其妙的编译错误时，发现是两个层里定义了同名的配方，优先级高的层覆盖了低的。那次排查花了我整整一个下午。

3.2.2 bblayers.conf 配置

bblayers.conf文件位于构建目录的conf/下，它告诉BitBake哪些层参与构建。典型的配置如下：

# LAYER_CONF_VERSION 必须与POKY的版本匹配
LCONF_VERSION = "7"

BBPATH = "${TOPDIR}"
BBFILES ?= ""

# 这里列出所有需要激活的层
BBLAYERS ?= " \
  /path/to/poky/meta \
  /path/to/poky/meta-poky \
  /path/to/poky/meta-yocto-bsp \
  /path/to/meta-mylayer \
  "

个人建议：层的路径最好使用绝对路径，或者通过环境变量引用。我见过有人用相对路径，结果换了构建目录就找不到层了。另外，层的顺序也有讲究——后面的层优先级更高。

3.3 创建自定义层

好，理论说完了，咱们动手创建一个自定义层。这部分我尽量说得细一些，因为这是你后续所有定制工作的基础。

3.3.1 使用 bitbake-layers 工具

Yocto提供了一个很方便的工具bitbake-layers，可以帮你快速创建层的骨架：

# 进入你的Yocto项目根目录
cd /path/to/poky

# 创建自定义层
bitbake-layers create-layer meta-myapp

# 查看创建结果
ls -la meta-myapp/

执行后你会看到类似这样的输出：

NOTE: Starting bitbake server...
NOTE: Created layer: meta-myapp
meta-myapp/
├── conf/
│   ├── layer.conf
│   └── layer.conf.example
├── COPYING.MIT
├── README
└── recipes-example/
    └── example/
        └── example_0.1.bb

嗯，这里要注意，bitbake-layers生成的只是一个模板。里面的example_0.1.bb是个空壳子，你需要根据自己的需求去填充。

3.3.2 手动创建层（更灵活的方式）

我个人其实更喜欢手动创建层，因为可以完全控制目录结构。步骤如下：

创建层目录：mkdir -p meta-myapp/conf
编写 layer.conf：参考上面的示例，把mylayer改成你的层名
创建配方目录：mkdir -p meta-myapp/recipes-myapp/hello
编写第一个配方：在recipes-myapp/hello/下创建hello_1.0.bb

一个简单的配方文件长这样：

SUMMARY = "A simple hello world application"
DESCRIPTION = "This is a demo recipe for Yocto course"
LICENSE = "MIT"
LIC_FILES_CHKSUM = "file://${COMMON_LICENSE_DIR}/MIT;md5=0835ade698e0bcf8506ecda2f7b4f302"

SRC_URI = "file://hello.c"

S = "${WORKDIR}"

do_compile() {
    ${CC} ${CFLAGS} ${LDFLAGS} hello.c -o hello
}

do_install() {
    install -d ${D}${bindir}
    install -m 0755 hello ${D}${bindir}
}

避坑指南：我曾经在LIC_FILES_CHKSUM这里栽过跟头。这个MD5值必须和实际许可证文件的内容完全匹配。如果你改了许可证文件，记得重新计算MD5。否则BitBake会报错，而且错误信息不太直观。

3.3.3 将自定义层加入构建

层创建好了，得让BitBake知道它的存在。编辑build/conf/bblayers.conf，在BBLAYERS变量里加上你的层路径：

BBLAYERS ?= " \
  ${TOPDIR}/../poky/meta \
  ${TOPDIR}/../poky/meta-poky \
  ${TOPDIR}/../poky/meta-yocto-bsp \
  ${TOPDIR}/../meta-myapp \
  "

然后运行bitbake-layers show-layers确认层已经被识别：

layer                 path                                      priority
==========================================================================
meta                  /path/to/poky/meta                        5
meta-poky             /path/to/poky/meta-poky                   5
meta-yocto-bsp        /path/to/poky/meta-yocto-bsp              5
meta-myapp            /path/to/meta-myapp                       5

看到meta-myapp出现在列表里，就说明层已经成功加入了。

3.4 本章知识体系

为了让你更直观地理解元数据与层的关系，我画了一张图：

这张图展示了从BitBake引擎到最终根文件系统的完整链路。你可以看到，元数据是分层组织的，每一层负责不同的功能领域。层与层之间通过优先级机制实现覆盖和扩展。

3.5 小结

这一章我们聊了元数据的概念、层的结构和配置，以及如何创建自定义层。说白了，元数据就是Yocto的「灵魂」，层就是「骨架」。把这两样东西搞清楚了，后面的配方编写、镜像定制、包管理这些内容，学起来就会顺畅很多。

我个人建议你动手创建一个简单的层，哪怕里面只放一个hello world的配方。亲手走一遍创建、配置、构建的流程，比看十遍文档都管用。我在带新人时，第一周就让他们做这个练习——能独立完成的人，后面基本不会掉队。