嵌入式 Linux 与 RTOS / 系统课时
用 Yocto 组织可复用产品构建
用 Yocto 组织可复用产品构建
Yocto 的价值不是“把根文件系统编出来”,而是把板级配置、软件配方和产品镜像拆成可复用元数据。本篇先建立 Poky、Layer、Recipe、Machine 与 Image 的关系,再创建最小应用 recipe,并用可维护性标准判断何时应选 Yocto 而不是 Buildroot。
学习目标
- 解释 Poky、Layer、Recipe、Machine 与 Image 在构建中的职责和依赖关系。
- 为一个本地 C 应用编写最小 recipe,并把软件包加入目标镜像。
- 根据板型数量、产品寿命和定制复杂度选择 Yocto 或 Buildroot。
看清 Yocto 的元数据关系
Poky 是 Yocto Project 的参考发行组合,通常包含 BitBake、OpenEmbedded-Core、meta-poky 与参考 BSP 元数据。真正参与产品构建的是多个 Layer:每个 Layer 可以提供 recipe、配置、补丁或对其他 recipe 的扩展。
Recipe 描述“某个软件如何获取、编译、安装和打包”;Machine 描述“为哪块硬件构建”,包括架构、内核和板级特征;Image 描述“最终根文件系统里需要哪些包”。BitBake 读取启用的 Layer,再结合 Machine、发行配置和 Image 计算任务图。

这种拆分让同一个应用 recipe 可以被多个 Machine 复用,也让同一块板可以通过不同 Image 组合成开发镜像、量产镜像或诊断镜像。产品差异不应靠复制整套构建树解决,而应尽量落到独立 Layer 和可追踪的配置里。
编写最小应用 recipe
假设自定义层名为 meta-myproduct,应用源码放在 recipes-apps/hello/files/hello.c。源码是构建输入,不依赖 Yocto 之外的库。
#include <stdio.h>
int main(void) {
puts("hello from yocto");
return 0;
}对应的 recipes-apps/hello/hello_1.0.bb 可以保持很小。${CC}、${CFLAGS} 和 ${LDFLAGS} 由 Yocto 根据目标 Machine 与工具链注入,因此不要在 recipe 中硬编码主机编译器。
SUMMARY = "Minimal hello application"
LICENSE = "CLOSED"
SRC_URI = "file://hello.c"
S = "${WORKDIR}"
do_compile() {
${CC} ${CFLAGS} ${LDFLAGS} ${S}/hello.c -o hello
}
do_install() {
install -d ${D}${bindir}
install -m 0755 hello ${D}${bindir}/hello
}
FILES:${PN} += "${bindir}/hello"若这个 recipe 只属于当前产品,就放在产品 Layer;若它会被多个产品长期复用,可以再拆到独立公共 Layer。这样升级 BSP 或切换 Machine 时,应用层不需要复制。
把应用加入镜像并验证构建
先把产品 Layer 加入当前 build,再把 hello 包追加到镜像。下面假设已经进入 Poky 源码根目录,且 meta-myproduct 与 poky 位于同级目录。
source oe-init-build-env build
bitbake-layers add-layer ../../meta-myproduct
echo 'IMAGE_INSTALL:append = " hello"' >> conf/local.conf
bitbake core-image-minimal
bitbake -e core-image-minimal | grep '^IMAGE_INSTALL=' | grep -q ' hello' && echo 'hello included'预期结果中 BitBake 的任务数量会随缓存和元数据变化,但最后的显式检查应输出:
hello included镜像启动到目标板或适配的仿真环境后,执行应用完成运行时验收:
hello预期输出:
hello from yocto量产项目通常不建议长期把产品内容写在 local.conf。更可维护的做法是创建自己的 image recipe 或 packagegroup,把包集合版本化到产品 Layer;local.conf 更适合开发机差异和临时实验。
让多板型与长期维护保持可复用
当产品有两块板但上层应用基本一致时,应优先复用同一组应用 recipe,只切换 MACHINE 与对应 BSP Layer。若不同 SKU 的根文件系统内容不同,则通过多个 Image 或 packagegroup 表达差异,而不是复制 recipe。
Layer 之间也要控制职责边界:BSP Layer 放板级与内核相关元数据,产品 Layer 放镜像组合和产品策略,通用中间件放独立软件 Layer。遇到上游 recipe 需要小幅修改时优先使用 .bbappend,这样升级上游版本时差异仍然可见。
在 Yocto 与 Buildroot 之间做选择
| 判断维度 | Yocto | Buildroot |
|---|---|---|
| 多板型、多产品复用 | Layer、Machine、Image 组合能力强 | 可以复用,但大型产品通常需要更多自定义约定 |
| 软件包定制与补丁维护 | recipe、bbappend、任务模型细粒度 | 机制更直接,学习成本更低 |
| 增量构建与共享缓存 | 支持共享状态缓存与下载缓存,适合团队和 CI | 构建模型更简单,适合规模较小的系统 |
| 长周期产品维护 | 元数据边界清晰,适合持续升级 BSP 与组件 | 适合配置稳定、产品变体较少的场景 |
| 上手与构建系统复杂度 | 较高 | 较低 |
如果目标只是单板、固定软件集合和较短维护周期,Buildroot 往往更省时间;如果需要多个 Machine、多个镜像变体、团队协作和多年升级,Yocto 的元数据分层会更有价值。选择构建体系时应看维护规模,而不是只比较第一次把镜像编出来的速度。