嵌入式 Linux 与 RTOS / 系统课时
加入自定义程序和软件包
加入自定义程序和软件包
把应用手工复制到开发板,只能证明程序“这次能跑”,无法证明镜像可复现。本节用 Buildroot 的 rootfs overlay、post-build 脚本和自定义 package 三条路径,把静态文件、构建后改动以及需要交叉编译的程序全部纳入构建过程。
学习目标
- 能根据文件性质选择 rootfs overlay、post-build 或自定义 package
- 能用
BR2_EXTERNAL纳入自定义程序及其依赖,而不直接修改 Buildroot 主树 - 能在构建后验证应用与配置已进入根文件系统,并可由 defconfig 重建
先按职责选择接入方式
rootfs overlay 适合“不需要编译、目标路径固定”的文件,例如配置、启动脚本、证书或静态资源;post-build 适合在所有 package 安装完成后对目标树做一次可重复变换;自定义 package 则适合需要交叉编译、依赖声明、Kconfig 开关和版本管理的程序。

三种机制可以同时使用,但不要职责重叠。例如同一个配置文件既由 overlay 提供,又被 post-build 覆盖,会让最终来源难以追踪。最简单的原则是:能直接复制就用 overlay,需要“加工目标树”才用 post-build,需要编译和依赖关系就做 package。
用 overlay 和 post-build 管理板级文件
假设外部树名为 MYBOARD。把固定配置放到 board/myboard/rootfs-overlay/etc/myapp/app.conf,并在 Buildroot 中设置 BR2_ROOTFS_OVERLAY 指向这个目录。overlay 的目录结构就是目标根文件系统的目录结构,构建时会覆盖到 output/<BOARD>/target/。
若某个文件必须根据构建结果动态生成,可使用 post-build 脚本。下面是片段示例:它依赖 Buildroot 把目标根文件系统目录作为第一个参数传入,因此不应脱离 post-build 上下文单独调用。脚本只修改该目录,并保持重复执行仍得到相同结果。
#!/bin/sh
set -eu
TARGET_DIR="$1"
install -d "$TARGET_DIR/etc/myapp"
printf '%s\n' 'generated_by=buildroot' > "$TARGET_DIR/etc/myapp/generated.conf"
chmod 0644 "$TARGET_DIR/etc/myapp/generated.conf"
echo "post-build-applied"预期输出:
post-build-applied把脚本保存为 board/myboard/post-build.sh,授予可执行权限,并通过 BR2_ROOTFS_POST_BUILD_SCRIPT 引用。它的生效行为是生成 etc/myapp/generated.conf;实际构建时应继续通过 $1 获取 TARGET_DIR,不要把 output/<BOARD>/target 写死进脚本。
把需要编译的应用做成 package
对源码应用,推荐放进 BR2_EXTERNAL,让它拥有独立 Kconfig 开关、依赖和安装逻辑。下面三个文件均为片段示例,依赖一个名为 MYBOARD 的 BR2_EXTERNAL 外部树,并由 Buildroot 构建系统加载。
package/board-agent/Config.in:
config BR2_PACKAGE_BOARD_AGENT
bool "board-agent"
help
Minimal board agent for the target image.package/board-agent/board-agent.mk:
BOARD_AGENT_VERSION = 1.0
BOARD_AGENT_SITE = $(BR2_EXTERNAL_MYBOARD_PATH)/package/board-agent/src
BOARD_AGENT_SITE_METHOD = local
define BOARD_AGENT_BUILD_CMDS
$(TARGET_CC) $(TARGET_CFLAGS) $(@D)/board-agent.c -o $(@D)/board-agent
endef
define BOARD_AGENT_INSTALL_TARGET_CMDS
$(INSTALL) -D -m 0755 $(@D)/board-agent $(TARGET_DIR)/usr/bin/board-agent
endef
$(eval $(generic-package))package/board-agent/src/board-agent.c:
#include <stdio.h>
int main(void)
{
puts("board-agent ok");
return 0;
}外部树根目录的 Config.in 需要 source 这个 package 的 Config.in,external.mk 则需要包含 package 下的 .mk 文件。随后在 menuconfig 的 Target packages 中启用 BR2_PACKAGE_BOARD_AGENT,并把该选择保存进 defconfig。若应用依赖其他 Buildroot package,应使用 BOARD_AGENT_DEPENDENCIES 明确声明,而不是假设编译顺序恰好满足。
构建后只验证产物,不手改 target
完成配置后,从板级 defconfig 重新构建,并检查应用与配置是否已经进入目标树。
BOARD="<BOARD>"
EXTERNAL="$PWD/br2-external"
make O="output/$BOARD" BR2_EXTERNAL="$EXTERNAL" "${BOARD}_defconfig"
make O="output/$BOARD" BR2_EXTERNAL="$EXTERNAL" -j"$(nproc)"
test -x "output/$BOARD/target/usr/bin/board-agent"
test -f "output/$BOARD/target/etc/myapp/app.conf"
test -f "output/$BOARD/target/etc/myapp/generated.conf"
echo "customization-ready"预期输出:
customization-ready这里检查 target/ 只用于确认安装结果;真正烧录仍应使用 output/<BOARD>/images 中重新生成的 rootfs 或整盘镜像。<BOARD>、构建耗时和具体镜像文件名会随板级配置而变化。
保持可复现的边界
不要在目标板上 scp 完再把变化“记在脑子里”,也不要直接编辑 output/<BOARD>/target 后继续打包。前者无法审计,后者会在下一次干净构建时消失。
可复现的边界应非常明确:静态文件来自 overlay,构建后变换来自 post-build,自定义源码和依赖来自 package,所有开关回收到 defconfig。只要删除 output/<BOARD> 后仍能仅凭这些受版本控制的输入重新生成同样的应用、配置与镜像,这套定制才真正进入了 Buildroot 构建系统。