1. 课程导入

嵌入式 Linux 产品从“能跑起来”到“可量产、可维护、可追溯”，中间隔着一整套构建工程体系。OpenEmbedded（简称 OE）正是这套体系中最具代表性的元构建框架：它不直接编译某个软件包，而是通过配方（Recipe）、层（Layer）、类（Class）与配置（Conf）描述“系统应该由什么组成、如何构建、如何打包”，再由 BitBake 调度执行，最终产出可烧录的镜像与可复用的软件包。本课程的目标，是让学习者从“会敲命令”进阶为“能设计构建系统”。

一、学习目标：从使用者到构建架构师

本课程围绕四个能力层级展开。第一层是环境与工具链能力：能独立搭建 Poky 参考环境，理解 BitBake、Hob、Toaster、devtool 等工具的定位与协作方式。第二层是元数据编写能力：能编写和修改 .bb、.bbappend、.inc、.conf 文件，掌握变量、覆盖、继承与追加的语义。第三层是系统集成能力：能通过层机制组织 BSP、发行版、应用与中间件，处理依赖、许可证、包管理与镜像裁剪。第四层是工程化与排障能力：能分析构建日志、定位任务失败、优化构建时间与缓存命中率，并建立可重复的 CI 构建流程。

二、核心概念：理解 OE 的“元数据世界观”

OpenEmbedded 的核心不是代码，而是元数据。元数据描述了“做什么”和“怎么做”，BitBake 负责“按依赖顺序执行”。理解以下概念，是后续所有章节的基础。

• 配方 Recipe（.bb）：描述一个软件包的来源、版本、依赖、编译与安装方式，是构建的最小逻辑单元。
• 层 Layer：一组配方的集合，用于隔离 BSP、发行版、应用等不同关注点，通过 bblayers.conf 启用。
• 类 Class（.bbclass）：可被多个配方继承的公共逻辑，如 autotools、cmake、systemd。
• 配置 Conf：包括 local.conf、distro.conf、machine.conf，决定目标架构、发行版策略与机器特性。
• 任务 Task：如 do_fetch、do_configure、do_compile、do_install、do_package，由 BitBake 按依赖图调度。
• 包与镜像 Package/Image：配方产出 .ipk/.rpm/.deb 包，镜像配方再将其组合成可烧录文件。

这些概念之间不是并列关系，而是层层嵌套、相互引用的关系。下面的 SVG 展示了 OpenEmbedded 构建工程的整体框架与数据流：从层与配置输入，到 BitBake 解析与任务执行，再到包、镜像与 SDK 输出。

三、方法流程：一次构建到底发生了什么

理解构建流程，比记住命令更重要。以构建一个最小镜像为例，典型流程如下：

1. 初始化环境：执行 source oe-init-build-env build，生成 conf/local.conf 与 bblayers.conf。
2. 配置目标：在 local.conf 中设置 MACHINE、DISTRO、PACKAGE_CLASSES 等关键变量。
3. 解析元数据：BitBake 读取所有启用层中的配方与类，展开变量，构建任务依赖图。
4. 执行任务：按依赖顺序执行 do_fetch 到 do_package，命中 sstate 缓存的任务直接复用。
5. 生成镜像：镜像配方收集包，生成根文件系统与可烧录镜像，并输出许可证与清单信息。

# 典型构建命令
source oe-init-build-env build
bitbake core-image-minimal

# 查看某配方的任务列表
bitbake -c listtasks busybox

# 强制重新执行某个任务
bitbake -c compile -f busybox

四、案例与场景：从“能编译”到“可交付”

假设团队要为一块 ARM 开发板交付一个带 Qt 界面的产品镜像。若直接修改 Poky 自带配方，短期能跑通，但一旦上游更新就会冲突。正确做法是：新建 meta-product 层，用 .bbappend 追加产品配置，用独立镜像配方 product-image.bb 声明所需包，并在 local.conf 中只保留机器与发行版选择。这样，BSP 层、发行版层、产品层职责清晰，升级与复用成本大幅降低。

五、常见误区与复盘