初识BitBake：Recipe、Layer与Configuration

说实话，刚接触Yocto那会儿，我最头疼的就是BitBake。一堆概念砸过来——Recipe、Layer、Configuration，感觉像在学一门新语言。但后来我发现，BitBake其实没那么玄乎。它就是个构建系统，专门帮我们把源码变成可运行的镜像。

今天我们就来聊聊BitBake的三个核心概念。然后，我会带你写第一个Hello World Recipe。嗯，动手才是最好的学习方式。

BitBake到底是什么？

BitBake本质上是一个任务执行引擎。你可以把它想象成一个智能的“厨师长”——它知道每个菜（Recipe）需要什么原料（依赖），知道按什么顺序下锅（任务依赖关系），还能根据你的口味（配置）调整做法。

我在项目中遇到过一位同事，他总把BitBake和Makefile混为一谈。其实差别很大：Makefile是线性执行，BitBake则是基于依赖关系的并行执行。说白了，BitBake更聪明，它会自动分析哪些任务可以同时跑，哪些必须等前面完成。

Recipe：构建的“菜谱”

Recipe是BitBake世界里的基本单元。它描述了一个软件包怎么构建——从哪里下载源码、需要什么补丁、怎么编译、安装到哪个目录。

一个典型的Recipe文件以.bb结尾，内容大致长这样：

DESCRIPTION = "我的第一个Hello World程序"
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}
}

你看，Recipe里定义了三个关键部分：

• 元信息：描述、许可证、版本号等
• 源码来源：从哪里获取代码
• 构建任务：编译、安装等具体操作

我个人习惯把Recipe想象成“菜谱”——它告诉你需要什么原料（源码）、怎么处理（编译）、最后装盘（安装）。

Layer：模块化的“积木盒”

Layer是Recipe的集合。它把相关的Recipe、配置文件和补丁打包在一起。为什么要这么做？为了复用和隔离。

你想想看，一个嵌入式项目通常包含几十上百个软件包。如果所有Recipe都堆在一个目录里，那画面太美我不敢看。Layer让我们可以按功能划分——比如一个Layer放BSP相关的东西，另一个Layer放应用层软件。

典型的Layer结构：

meta-mylayer/
├── conf/
│   └── layer.conf
├── recipes-example/
│   └── hello/
│       ├── hello_1.0.bb
│       └── files/
│           └── hello.c
└── COPYING.MIT

每个Layer必须有一个conf/layer.conf文件，告诉BitBake这个Layer的基本信息：

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

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

我在项目中遇到过一个问题：两个Layer里都有同名的Recipe，结果构建时总是用错版本。后来才发现是优先级没设对。嗯，这里要注意——Layer的优先级决定了哪个Recipe会胜出。

Configuration：全局的“调味料”

Configuration文件控制整个构建过程的行为。它定义了一些全局变量，比如目标架构、发行版类型、镜像格式等。

最重要的配置文件是local.conf，它位于构建目录的conf/文件夹下：

MACHINE = "qemuarm"
DISTRO = "poky"
PACKAGE_CLASSES = "package_rpm"
BB_NUMBER_THREADS = "4"
PARALLEL_MAKE = "-j 4"

Configuration的优先级是这样的：

优先级	配置文件	说明
最高	local.conf	用户本地配置，覆盖其他所有
中	distro.conf	发行版级别的配置
低	machine.conf	机器/板级配置

说白了，Configuration就是BitBake的“全局变量表”。你在这里设的值，所有Recipe都能读到。

知识体系总览

为了让你更直观地理解这三个概念的关系，我画了张图：

动手：编写第一个Hello World Recipe

光说不练假把式。我们来写一个真正的Hello World Recipe。整个过程分三步走。

第一步：创建Layer

先创建一个自己的Layer，别把东西都塞到默认Layer里：

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

然后创建meta-hello/conf/layer.conf：

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

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

第二步：编写源码和Recipe

创建meta-hello/recipes-example/hello/files/hello.c：

#include <stdio.h>

int main() {
    printf("Hello from Yocto!\n");
    return 0;
}

创建meta-hello/recipes-example/hello/hello_1.0.bb：

DESCRIPTION = "简单的Hello World程序"
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}
}

第三步：添加到构建中

把Layer路径加到bblayers.conf里：

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

然后运行BitBake：

bitbake hello

如果一切顺利，你会看到BitBake开始下载、编译、打包。最后生成的IPK或RPM包会放在tmp/deploy/目录下。

Recipe的常用变量速查

变量名	作用	示例
DESCRIPTION	软件包描述	"一个简单的工具"
LICENSE	许可证类型	"MIT"
SRC_URI	源码来源	"file://hello.c"
S	源码目录	"${WORKDIR}"
D	安装目标目录	"${WORKDIR}/image"
bindir	二进制文件安装路径	"/usr/bin"

嗯，到这里你应该对BitBake有了基本认识。Recipe是构建的最小单元，Layer是组织Recipe的方式，Configuration控制全局行为。这三者配合，构成了Yocto强大的构建体系。

下次遇到复杂的构建需求，别慌。先拆成Recipe，再归到Layer，最后用Configuration调优。一步一步来，你会发现BitBake其实挺顺手的。