2. 理解BitBake

说实话，刚接触Yocto的时候，我最困惑的就是BitBake。它到底是什么？为什么Yocto离不开它？今天我就带你彻底搞懂这个核心工具。

BitBake是什么？

BitBake说白了就是一个构建引擎。你可以把它想象成一个超级智能的厨师：

• 输入：配方文件（.bb）、配置文件（.conf）、类文件（.bbclass）
• 输出：可运行的根文件系统、软件包、镜像文件
• 核心能力：解析依赖、执行任务、管理缓存

我刚开始用Yocto时，总觉得BitBake就是个高级版的Make。后来踩了不少坑才明白——它比Make强大得多。Make只管「文件依赖」，BitBake管的是「任务依赖」和「环境依赖」。

举个例子。你写一个C程序，Makefile里写的是「先编译.c文件，再链接成可执行文件」。BitBake里写的是「先下载源码，再打补丁，再配置，再编译，再安装到目标目录」。每个步骤都是一个独立的任务，可以单独执行、缓存、甚至被其他配方复用。

BitBake的语法基础

嗯，这里要注意。BitBake的语法看着像Shell，但其实是它自己的DSL（领域特定语言）。我见过不少同事把Shell脚本直接塞进.bb文件，结果跑得一脸懵。

变量

变量是BitBake最基础的元素。定义方式很简单：

# 字符串变量
PN = "hello-world"
PV = "1.0"
PR = "r0"

# 列表变量（用空格分隔）
SRC_URI = "file://hello.c file://Makefile"

# 追加变量（常用！）
CFLAGS += "-O2"
CFLAGS_append = " -Wall"

我在项目中遇到过最坑的事：用+=和_append搞混了。+=是在变量末尾加空格再加值，_append是直接拼接。如果你不小心，CFLAGS += "-O2"和CFLAGS_append = "-Wall"结果会不一样——前者多一个空格，后者没有。嗯，这种细节能让你调试一整天。

任务

任务是BitBake的执行单元。每个配方默认有一些标准任务：

任务名	作用	我常用的场景
do_fetch	下载源码	从GitHub拉取代码
do_unpack	解压源码	处理tar.gz、zip等
do_patch	打补丁	修复上游bug
do_configure	配置	运行./configure或cmake
do_compile	编译	执行make
do_install	安装到目标目录	复制文件到${D}
do_package	打包成ipk/deb/rpm	生成软件包

你可以自定义任务。比如我经常加一个do_debug任务来打印变量：

do_debug() {
    bbnote "当前源码目录: ${S}"
    bbnote "当前构建目录: ${B}"
    bbnote "安装目录: ${D}"
    ls -la ${S}
}

addtask debug after do_unpack before do_configure

依赖

依赖是BitBake最强大的特性。有两种依赖：

• 构建依赖（DEPENDS）：编译时需要先构建的包
• 运行时依赖（RDEPENDS）：运行时需要安装的包

# 构建时需要libfoo和libbar
DEPENDS = "libfoo libbar"

# 运行时需要libbaz
RDEPENDS:${PN} = "libbaz"

我曾经犯过一个低级错误：只写了DEPENDS没写RDEPENDS。编译没问题，但运行时程序报错找不到动态库。你想想看，这种问题排查起来多痛苦——编译通过了，但跑不起来。

编写第一个BitBake配方

好了，理论说够了。我们来写一个真正的.bb文件。这个配方会编译一个简单的Hello World程序，并把它安装到根文件系统中。

先准备源码文件。创建一个目录files，里面放两个文件：

files/hello.c

#include <stdio.h>

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

files/Makefile

CC = gcc
CFLAGS = -Wall -O2

all: hello

hello: hello.c
    $(CC) $(CFLAGS) -o $@ $^

install:
    install -d $(DESTDIR)/usr/bin
    install -m 0755 hello $(DESTDIR)/usr/bin

clean:
    rm -f hello

然后创建配方文件hello-world_1.0.bb：

# 基础信息
SUMMARY = "A simple Hello World program"
DESCRIPTION = "This is my first BitBake recipe. It compiles a hello world program."
LICENSE = "MIT"
LIC_FILES_CHKSUM = "file://${COMMON_LICENSE_DIR}/MIT;md5=0835ade698e0bcf8506ecda2f7b4f302"

# 源码位置（本地文件）
SRC_URI = "file://hello.c \
           file://Makefile"

# 源码目录和构建目录
S = "${WORKDIR}"
B = "${WORKDIR}"

# 继承autotools类（这里我们手动写Makefile，所以不需要）
# 但我们可以用base类提供的基本功能

# 编译任务
do_compile() {
    oe_runmake
}

# 安装任务
do_install() {
    oe_runmake install DESTDIR=${D}
}

# 运行时依赖（这个程序不需要额外依赖）
RDEPENDS:${PN} = ""

# 文件清单
FILES:${PN} = "/usr/bin/hello"

把这个.bb文件放到你的layer里（比如meta-custom/recipes-example/hello-world/），然后运行：

bitbake hello-world

如果一切顺利，你会看到BitBake依次执行fetch、unpack、compile、install、package等任务。最终在tmp/deploy/ipk/目录下生成一个hello-world_1.0-r0_arch.ipk包。

知识体系总览

下面这张图帮你理清BitBake的核心逻辑：

这张图展示了BitBake的三个核心要素：变量定义构建参数，任务定义执行步骤，依赖定义构建顺序。三者缺一不可。

写到这里，我想起刚学Yocto时的一个教训。我写了一个配方，编译通过了，但生成的镜像里没有我的程序。查了半天，发现是FILES:${PN}没写对。BitBake默认只打包/usr/bin、/usr/lib等标准目录下的文件，如果你的程序安装到了别的地方，必须显式声明。

所以我的建议是：第一次写配方时，先跑bitbake -c devshell hello-world进入开发shell，手动执行make install看看文件装到了哪里。确认无误后再写do_install和FILES。这样能省去很多调试时间。