3. Yocto入门：核心概念、BitBake与OpenEmbedded、Recipe与Layer机制

Yocto 项目，说白了就是一个帮你构建自定义 Linux 系统的框架。很多刚接触嵌入式 Linux 的朋友，一上来就被它的概念搞晕了——什么 BitBake、OpenEmbedded、Recipe、Layer…… 我当年第一次看 Yocto 文档时，也花了整整一周才理清这些关系。

这一章，我们就从最核心的几个概念入手。我会结合自己踩过的坑，帮你快速建立起 Yocto 的知识骨架。

3.1 核心概念：Yocto、OpenEmbedded 与 BitBake 的关系

先搞清楚这三个东西到底是什么关系。很多人把它们混为一谈，其实分工很明确。

组件 角色 类比
Yocto Project 顶层项目，提供工具、文档、参考系统 汽车品牌（丰田）
OpenEmbedded (OE) 构建框架，包含元数据、类、配方 发动机与底盘
BitBake 任务调度引擎，执行构建 驾驶员

简单来说：Yocto 是项目名，OpenEmbedded 是构建系统，BitBake 是执行引擎。你下载的 Yocto 发行版（比如 Poky），本质上就是 OpenEmbedded 的一个参考实现，加上一些 Yocto 特有的工具。

关键理解： 你写 Recipe（配方），BitBake 负责按 Recipe 的指令去下载源码、打补丁、编译、打包。OpenEmbedded 则提供了大量现成的 Recipe 和类，让你不用从零开始。

3.2 BitBake：Yocto 的心脏

BitBake 是一个任务调度器。它跟 Make 有点像，但更强大。Make 只能根据文件时间戳决定要不要重新编译，而 BitBake 能处理复杂的依赖关系、跨包构建、多架构支持。

3.2.1 BitBake 的工作流程

BitBake 的核心逻辑可以概括为三步：

  1. 解析元数据：读取所有 Recipe、Layer 配置、机器配置等。
  2. 构建依赖树：分析每个 Recipe 的 DEPENDS、RDEPENDS，形成完整的依赖图。
  3. 执行任务：按依赖顺序执行 fetch、unpack、patch、configure、compile、install、package 等任务。

我刚开始用 BitBake 时，最不习惯的就是它每次构建前都要重新解析所有元数据。一个中等规模的项目，光解析就要花 30 秒。后来我学会了用 bitbake -S 生成签名文件，配合 bitbake-diffsigs 对比两次构建的差异，排查问题快多了。

小技巧： 如果你只想看某个 Recipe 的依赖树，可以用 bitbake -g <recipe> 生成 dot 文件，然后用 Graphviz 可视化。我曾经靠这个发现了一个循环依赖的 bug。

3.2.2 常用 BitBake 命令

命令 作用 我的常用场景
bitbake <recipe> 构建指定 Recipe 编译单个包
bitbake -c clean <recipe> 清理构建产物 遇到奇怪编译错误时先 clean
bitbake -c fetch <recipe> 只下载源码 网络不好时先下载所有源码
bitbake -c devshell <recipe> 进入 Recipe 的构建环境 shell 调试编译问题，手动执行 configure/make
bitbake -s | grep <pattern> 搜索所有 Recipe 快速确认某个包是否可用

注意： bitbake -c clean 只会清理当前 Recipe 的构建目录，不会清理其依赖。如果你改了全局配置（比如工具链版本），建议用 bitbake -c cleanall 彻底重来。我曾经因为只用了 clean，导致一个隐性的头文件缓存问题排查了两天。

3.3 Recipe：构建的最小单元

Recipe 是 Yocto 世界里的构建脚本。它告诉 BitBake：从哪里下载源码、如何打补丁、怎么编译、安装到哪个目录。

一个典型的 Recipe 文件长这样：

# hello_1.0.bb
SUMMARY = "A simple hello world program"
LICENSE = "MIT"
LIC_FILES_CHKSUM = "file://LICENSE;md5=..."

SRC_URI = "git://github.com/example/hello.git;branch=main"
SRCREV = "abc123def456"

S = "${WORKDIR}/git"

inherit autotools

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

这里有几个关键变量：

  • SRC_URI：源码位置，可以是 git、tarball、本地路径等。
  • S：源码解压后的目录，默认是 ${WORKDIR}/${PN}-${PV}。
  • inherit：继承某个类（class），比如 autotools、cmake、meson 等。
  • do_install：安装阶段的任务，把编译产物放到目标目录。

我的经验： 写 Recipe 时最容易出错的是 SRC_URI 的格式。GitHub 上的项目，如果用了 submodule，一定要在 SRC_URI 里加上 ;protocol=https 和 ;nobranch=1（如果指定了 commit）。我见过太多人因为 submodule 拉不下来而抓狂。

3.4 Layer：模块化组织的基石

Layer 是 Yocto 实现模块化的核心机制。你可以把 Layer 想象成一个插件包，每个 Layer 包含一组 Recipe、配置、类文件。

典型的 Layer 目录结构：

meta-mylayer/
├── conf/
│   ├── layer.conf          # Layer 配置文件
│   └── machine/            # 机器配置
├── recipes-example/
│   └── hello/
│       ├── hello_1.0.bb
│       └── files/
│           └── hello.patch
├── classes/                # 自定义类
└── README

每个 Layer 必须有一个 conf/layer.conf，告诉 BitBake 这个 Layer 的优先级和路径：

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

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

BBFILE_PRIORITY 决定了当多个 Layer 提供相同 Recipe 时，哪个优先。数值越大，优先级越高。

避坑指南： 我曾经在一个项目里，因为两个 Layer 都提供了 openssl 的 Recipe，但优先级没设对，导致 BitBake 用了旧版本的 Recipe，编译出来的系统有安全漏洞。后来我养成了一个习惯：每次添加新 Layer，先用 bitbake-layers show-recipes 检查有没有冲突。

3.5 知识体系总览

下面这张图，把 Yocto 的核心概念串起来了。你可以把它当作本章的思维导图：

Yocto 核心概念关系图 Yocto Project OpenEmbedded 构建框架 BitBake 任务引擎 Recipe 配方 Layer 层 解析元数据 → 构建依赖树 → 执行任务 SRC_URI / DEPENDS / do_install conf/layer.conf / BBFILE_PRIORITY 核心工作流 1. 用户编写 Recipe，放入 Layer 2. BitBake 解析所有 Layer 的元数据 3. 构建依赖树，按序执行 fetch → patch → configure → compile → install → package 4. 输出：IPK/DEB/RPM 包，或完整的根文件系统镜像

3.6 实战：创建一个最简单的 Layer 和 Recipe

光说不练假把式。我们动手创建一个 Layer，里面放一个打印 "Hello Yocto" 的 Recipe。

步骤 1：创建 Layer 目录结构

mkdir -p meta-hello/conf
mkdir -p meta-hello/recipes-example/hello/files

步骤 2：编写 layer.conf

# meta-hello/conf/layer.conf
BBPATH .= ":${LAYERDIR}"
BBFILES += "${LAYERDIR}/recipes-*/*/*.bb \
            ${LAYERDIR}/recipes-*/*/*.bbappend"

BBFILE_COLLECTIONS += "hello"
BBFILE_PATTERN_hello = "^${LAYERDIR}/"
BBFILE_PRIORITY_hello = "5"

步骤 3：编写 Recipe

# meta-hello/recipes-example/hello/hello_1.0.bb
SUMMARY = "Prints Hello Yocto"
LICENSE = "MIT"
LIC_FILES_CHKSUM = "file://${COMMON_LICENSE_DIR}/MIT;md5=0835ade698e0bcf8506ecda2f7b4f302"

SRC_URI = "file://hello.sh"

S = "${WORKDIR}"

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

# 确保 hello.sh 被包含在包中
FILES:${PN} += "${bindir}/hello.sh"

步骤 4：创建源码文件

# meta-hello/recipes-example/hello/files/hello.sh
#!/bin/sh
echo "Hello Yocto!"

步骤 5：将 Layer 加入构建

在 build/conf/bblayers.conf 中添加：

BBLAYERS ?= " \
  /path/to/poky/meta \
  /path/to/poky/meta-poky \
  /path/to/poky/meta-yocto-bsp \
  /path/to/meta-hello \
  "

步骤 6：构建

bitbake hello

构建成功后，你会在 tmp/deploy/rpm 或 tmp/deploy/ipk 下找到 hello-1.0-r0 包。把它安装到目标系统上，运行 hello.sh 就能看到输出了。

注意： 如果你用的是 Poky 以外的发行版，${COMMON_LICENSE_DIR} 的路径可能不同。建议先用 bitbake -e hello | grep COMMON_LICENSE_DIR 确认一下。我有个同事因为这个路径问题，折腾了半天才发现是 BSP 层改了默认路径。

3.7 本章小结

这一章我们覆盖了 Yocto 的三个核心概念：

  • BitBake：任务调度引擎，负责解析元数据、构建依赖树、执行任务。
  • Recipe：构建脚本，描述如何下载、编译、安装一个软件包。
  • Layer：模块化组织单元，把 Recipe、配置、类打包在一起。

理解这三者的关系，是掌握 Yocto 的第一步。说实话，Yocto 的学习曲线确实陡峭，但一旦你理解了它的设计哲学——一切皆 Recipe，一切皆 Layer——你就会发现它其实非常优雅。

← 上一章 📖 返回目录 下一章 →