Buildroot目录结构与构建流程全解析

最新推荐文章于 2025-10-15 11:39:34 发布
原创 最新推荐文章于 2025-10-15 11:39:34 发布 · 953 阅读 · 20 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#redis #java #数据库 #linux #嵌入式硬件 #开发语言

📖 推荐阅读：《Yocto项目实战教程:高效定制嵌入式Linux系统》
🎥 更多学习视频请关注 B 站：嵌入式Jerry

Buildroot目录结构与构建流程全解析

本文全面讲解 Buildroot 项目的工程目录结构、核心文件功能、构建流水线、各模块间的关系与依赖，并与 Linux 内核工程进行对比，配合代码与实例帮助理解完整构建流。

在这里插入图片描述

一、Buildroot 顶层目录结构与核心文件详解

Buildroot 并不是一个典型的“源码树”，而是一个高度集成的嵌入式 Linux 系统生成工具。其目录结构清晰明了，每个目录都有专门职责。

目录主要功能与定位典型/核心文件
arch/架构支持：交叉编译、平台相关特性，定义体系结构、toolchain 配置等arm/、x86/、Config.in、arch.mk
board/开发板支持：各板卡配置、启动脚本、补丁、分区描述等各板目录、genimage.cfg、post-build.sh
boot/启动相关包：U-Boot、Barebox、AT91Bootstrap 的 package/定义uboot/、barebox/、各包 mk 文件
configs/defconfig 配置模板，每个目标系统/板卡的预设构建配置qemu_x86_64_defconfig 等
docs/官方文档、手册、帮助文件manual/、README.md
fs/文件系统镜像类型定义（ext4、squashfs、jffs2、cpio等）common.mk、各FS包.mk
linux/构建集成 Linux 内核（不是内核源码！）linux.mk、Config.in、补丁目录
package/软件包目录，每个子目录是一个包，负责获取/编译/安装等完整流程busybox/、zlib/、*.mk
support/构建工具脚本、Kconfig实现、辅助工具、外部脚本kconfig/、scripts/、legal-info/
system/根文件系统布局与核心脚本、初始化、设备节点描述等system.mk、inittab、fstab
toolchain/工具链相关（交叉 GCC/glibc/musl/uClibc等规则与包）toolchain.mk、*.mk
utils/辅助脚本、小工具check-package
CHANGES版本更新日志文本文件
Config.inKconfig 配置树入口Kconfig格式文本
COPYING许可证（GPL）文本文件
DEVELOPERS贡献者名单文本文件
Makefile构建主 Makefile，驱动整体流程Makefile 文件
README项目简要说明文本文件

【代码实例1】主目录下的结构（简略版）

$ tree -L 2 -d buildroot-2024.02/
buildroot-2024.02/
├── arch
├── board
│   ├── raspberrypi4
│   └── ...
├── boot
├── configs
├── docs
├── fs
├── linux
├── package
│   ├── busybox
│   ├── zlib
│   └── ...
├── support
│   ├── kconfig
│   ├── scripts
│   └── ...
├── system
├── toolchain
├── utils

二、构建流与文件依赖解析

1. 顶层 Makefile 驱动一切

  • 主 Makefile 是 Buildroot 构建流程的“总控”，其核心逻辑如下：

    1. include 其他 mk 文件（如 package/Makefile.in、arch/arch.mk、system/system.mk、所有包 *.mk 等）
    2. 驱动 all -> world -> target-post-image 等目标，逐步生成根文件系统、内核、Bootloader、最终镜像。
    3. 用 Kconfig 系统和 .config 文件来决定启用哪些包与特性。
【代码实例2】关键 Makefile include 片段
include package/Makefile.in
include $(sort $(wildcard package/*/*.mk))
include arch/arch.mk
include system/system.mk
include linux/linux.mk
  • 所有包的 .mk 文件和规则都被主 Makefile 汇总进来，形成一个大工程。

2. Kconfig 配置树（Config.in 系统）

  • Config.in、package/Config.in、linux/Config.in 等类似 Linux 内核 Kconfig 配置。
  • 通过 make menuconfig、nconfig 调用 support/kconfig 的工具，生成 .config。
【代码实例3】Config.in 片段（顶层入口）
source "toolchain/Config.in"
source "package/Config.in"
source "linux/Config.in"
source "system/Config.in"
  • 每个 package/ 下包也有各自 Config.in（用于“在 menuconfig 勾选包”）。

3. 各目录之间的关系与依赖

  • package/ 定义所有要构建的软件包。比如 busybox、zlib、alsa、应用等。
  • linux/ 管理 kernel 包（下载源码、打补丁、内核配置等），最终被纳入 package/。
  • toolchain/ 定义工具链构建规则，是其他所有包的交叉编译基础。
  • fs/ 提供 rootfs 的文件系统格式支持（如生成 ext4、cpio、jffs2 镜像）。
  • system/ 负责系统初始化脚本、inittab、设备节点表（用于生成基础 rootfs 内容）。
  • arch/ 针对架构做平台特定适配，如 arch/arm/ 下可以定义特殊补丁、参数。
  • board/ 定义某开发板的特殊启动脚本、分区脚本、定制补丁（与 configs/ 一起决定“板级定制”）。
【依赖流实例】
  • 构建 busybox 时，会自动依赖 zlib（如果配置了 BR2_PACKAGE_BUSYBOX_DEPENDENCIES = zlib）。
  • 构建 rootfs 镜像时，会依赖所有已 enable 的包已编译并安装到 target 目录。

4. 构建主流程（流水线）

  1. 读取 defconfig，生成 .config

  2. make menuconfig（选包/特性）

  3. 主 Makefile 展开所有包/规则

  4. 依赖链驱动：

    • 先编译 toolchain
    • 再编译内核、bootloader、所有应用包
    • 每个包（如 busybox）流水线依赖：下载→解压→打补丁→配置→编译→安装
    • 构建 system/init 文件，生成目标 rootfs
    • 使用 fs/ 配置文件系统格式，最终合成完整镜像（如 rootfs.ext4、sdcard.img）

  5. 所有产物汇总到 output/images/

【代码实例4】包流水线目标生成（伪码）
BUSYBOX_DEPENDENCIES = zlib
$(eval $(generic-package))

# 自动展开以下依赖链
busybox-extract → busybox-patch → busybox-configure → busybox-build → busybox-install

三、Buildroot 与 Linux Kernel 构建机制区别

对比项BuildrootLinux Kernel (Kbuild)
构建核心顶层 Makefile+Kconfig+包级 .mkKbuild/Kconfig 递归Makefile
递归目录构建否，全部主 Makefile串联、包级管理是，自动递归目录/obj-y
目录功能按照构建目标分类源码、模块、驱动分类
新增内容方式新包放 package/ 下，自定义 mk/config新驱动/模块直接加源码树
依赖管理包级手工指定变量（如 xxx_DEPENDENCIES）递归自动，obj-y、obj-m机制
构建产物镜像/文件系统/bootloader等内核镜像、模块、dtb

【Makefile 结构对比】

Buildroot
all: world
world: target-post-image
# 各包/模块均主控串联
include package/Makefile.in
include $(sort $(wildcard package/*/*.mk))
Linux Kernel
# arch/arm/Makefile
obj-y += kernel/ mm/ mach-omap2/
# 会自动递归进入 kernel/ mm/ mach-omap2/ 下的 Makefile

四、Buildroot 典型目录依赖与协作实例

【实例1】新增一个定制驱动包

  1. 在 package/mydriver/ 下创建 mydriver.mk、Config.in
  2. mydriver.mk 定义编译规则、依赖、安装路径
  3. 在 package/Config.in 里 source “package/mydriver/Config.in”
  4. 通过 menuconfig 勾选 BR2_PACKAGE_MYDRIVER
    y
  5. make，主 Makefile 自动串联 mydriver 流程到整体构建流

【实例2】定制某开发板启动脚本和分区

  • 在 board/myboard/ 下写 post-build.sh、genimage.cfg
  • 在 configs/ 下加 myboard_defconfig
  • 启动构建后，分区方案/启动脚本被自动集成进最终镜像

五、完整构建流简图

menuconfig
   |
.defconfig → .config
   |
主 Makefile 展开所有包.mk
   |
[toolchain] ←→ [arch/board/定制]
   |
[linux/kernel/bootloader]
   |
[所有package（应用/库/驱动）]
   |
[system/根文件系统] + [fs/镜像格式]
   |
output/images/（rootfs.ext4, sdcard.img等）

六、总结与实践建议

  • Buildroot 结构清晰、职责分明、定制灵活，但不是源码递归型系统，一切都靠主 Makefile 驱动包级流水线。
  • 想掌握 Buildroot，建议从包的新增、defconfig 管理、board 定制等实践入手。
  • 记住 package/ 下的 .mk 和 Config.in 决定了一切，懂依赖和流水线，就懂了整个 Buildroot！

📖 推荐阅读：《Yocto项目实战教程:高效定制嵌入式Linux系统》
🎥 更多学习视频请关注 B 站：嵌入式Jerry

Buildroot 之二 详解构建系统架构、构建流程、本地代码、external tree
技术干货
03-11 1246
 Buildroot 是一个运行于 Linux 平台的用于构建完整嵌入式 Linux 运行环境的自动化工具。使用 Buildroot 可以构建出一个完整的可以直接烧写到机器上运行的嵌入式 Linux 配套镜像文件（包含 bootloader、kernel、rootfs 以及 rootfs 中的各种库和应用程序、交叉编译工具链）。而且，所有命令均不需要 root 权限，避免对开发环境中的已有软件包产生影响。
构建定制化的嵌入式 Linux 系统：了解 Buildroot
小灰灰的博客
07-10 3302
configs/：该目录包含了Buildroot的配置文件，每个配置文件对应一个不同的目标平台。可以在此目录下找到示例配置文件和自定义配置文件。docs/：该目录包含了Buildroot的文档文件，包括用户手册、开发者手册、常见问题解答等。dl/：该目录用于存放下载的软件包源码压缩包。output/：该目录是构建过程的输出目录，其中包含完整的目标文件系统镜像和其他生成的文件。package/：该目录是Buildroot的核心目录之一，它包含了构建所需的各个软件包的描述文件。
Buildroot根文件系统构建
lengyuefeng212的博客
08-22 6799
文章目录Buildroot根文件系统构建一、何为buildroot？1. buildroot简介2. buildroot下载二、buildroot构建根文件系统1. 配置buildroot1. 配置 Target options2. 配置 Toolchain3. 配置 System configuration4. 配置 Filesystem images5. 禁止译 编译 Linux 内核和 uboot6. 配置 Target packages2. 编译buildroot3. buildroot根文件
buildroot制作根文件系统
最新发布
m0_61973119的博客
10-15 650
方法一：指定交叉编译版本方法二：交叉编译最新版本。
【buildroot】buildroot使用总结
iriczhao的博客
12-05 4630
一、buildroot使用步骤 1、构建图形配置界面 make menuconfig 编译出图形配置界面，如下图所示： 2、配置Target options ​ 在该项下，主要有以下配置选项： 这里以ARM contex-A7型处理器为例，配置选项如下： Target options -> Target Architecture = ARM (little endian) -> Target Binary Format = ELF -> Ta
一、buildroot目录结构
weixin_44698673的博客
07-22 1828
Buildroot是linux平台上一个开源的嵌入式Linux系统自动构建框架。一个linux系统主要包含bootloader、kernal和rootfs三部分。我们可以独立去开发各个部分，在使用的时候分别去交叉编译，烧写这些软件组件。buildroot这个工具提供了一种更为高效的方法，他把bootloader、kernal和rootfs集成在一起，可以非常方便的去定制、管理、编译和组装一个自己需要的、针对自己的设备的一个完整的软件系统。......
第四节: Buildroot目录结构
kunkliu的博客
11-21 1826
转载地址：https://blog.youkuaiyun.com/abedg126/article/details/79539668 buildroot/output: 是编译出来的输出文件夹.  output/build: 存放解压后的各种软件包编译完成后的现场.  output/host: 存放着制作好的编译工具链，如gcc、arm-linux-gcc等工具.  output/images: 存放着编译...
【深入解码Buildroot】：源码结构与构建流程详解
[【深入解码Buildroot】：源码结构与构建流程详解](https://www.stefanocottafavi.com/assets/img/buildroot-rpi/buildroot-cover.png) # 摘要 Buildroot作为一个流行的嵌入式Linux发行版，为开发者提供了从源码...
Buildroot 之一 详解总体架构、源码文件、Package 处理流程及新增说明
技术干货
03-11 1361
Buildroot 是一个运行于 Linux 平台的用于构建完整嵌入式 Linux 运行环境的自动化工具。使用 Buildroot 可以构建出一个完整的可以直接烧写到机器上运行的嵌入式 Linux 配套镜像文件（包含 bootloader、kernel、rootfs 以及 rootfs 中的各种库和应用程序、交叉编译工具链）。而且，所有命令均不需要 root 权限，避免对开发环境中的已有软件包产生影响。
Buildroot开发者指南：工作原理与构建流程详解
2. **目录结构**： - **toolchain/**：存储与交叉编译工具链相关的软件Makefile，如binutils、gcc、gdb等。 - **arch/**：定义Buildroot支持的所有处理器架构，确保硬件兼容性。 - **package/**：存放用户空间...
Buildroot 之三 详解移植、配置、构建过程、输出镜像文件、使用验证
技术干货
03-11 1446
Buildroot 是 Linux 平台上的一个用于构建嵌入式 Linux 系统的框架。使用 Buildroot 可以构建出一个完整的可以直接烧写到机器上运行的嵌入式 Linux 配套镜像文件（包含 bootloader、kernel、rootfs 以及 rootfs 中的各种库和应用程序、交叉编译工具链）。Buildroot 中默认并没有对 STM32F769I-EVAL 开发板的支持，移植后就可以直接构建 STM32F769I-EVAL 开发板固件了
【Buildroot】基础知识：目录、根文件系统目录覆盖、编译性能分析（编译时间、目标尺寸、包依赖图）
似水流年
04-25 4680
Buildroot是一个非常完善的根文件构建系统软件，里面有很多有用的工具可以帮助我们分析或改善我们开发中的问题。
Buildroot 构建根文件系统简单步骤
shengnan89的博客
04-16 1888
1 buildroot 下载 官网地址为 https://buildroot.org/，下载.bz2 压缩格式的源码。 2 配置 buildroot 将 buildroot 源码 buildroot-2019.02.6.tar.bz2 拷贝到 ubuntu 中，解压 tar -vxjf buildroot-2019.02.6.tar.bz2 进入解压目录，打开图形化配置界面 make menuconfig 第一步：配置 Target options 第二步：配置 Toolchain 第三步：配置
Buildroot构建指南--快速上手与实用技巧
danshiming的博客
11-24 1338
《Buildroot构建指南--快速上手与实用技巧》
关于瑞芯微SDK中buildroot的架构分析、配置细节、以及一些使用步骤
Hyjks的博客
09-04 952
摘要：瑞芯微SDK基于Buildroot框架，针对RK3568等芯片提供定制化开发环境。核心目录包括buildroot（配置与编译框架）、kernel（定制内核）和u-boot（引导程序）。开发流程为：1）加载芯片默认配置；2）通过menuconfig定制系统（架构、内核、软件包等）；3）可选修改内核配置。关键硬件适配需修改设备树(dts)和分区表(parameter.txt)，系统行为通过启动脚本(S90network)调整。最终执行make编译生成可烧录固件。该框架通过配置文件驱动，实现从工具链构建到固
Buildroot构建指南——根文件系统(Rootfs)
danshiming的博客
11-21 5617
《Buildroot构建指南——根文件系统(Rootfs)》
使用 Buildroot 构建文件系统
wei_Embedded_z的博客
07-09 2500
使用 busybox 构建文件系统但是 busybox 构建的文件系统很多东西需要自己交叉编译添加，某些软件需要自己去移植，所以移植过程是非常繁琐的。有另外一种非常实用的根文件系统构建方法——使用 Buildroot 来构建根文件系统。Buildroot 不仅集成了 busybox，而且还集成了各种常见的第三方库和软件，需要什么软件，选择哪个软件就好。Buildroot 介绍和实操接下来我们直接使用 Buildroot 来制作根文件系统。如何决定是否编译某些包：菜单内容来自哪里？
解析Buildroot
weixin_42446445的博客
06-15 1867
Buildroot是一个嵌入式Linux系统构建工具，可自动生成包含工具链、内核、bootloader和根文件系统的完整镜像。
Buildroot
calm_agan的专栏
06-28 710
Buildroot官方全英文使用手册的链接是https://buildroot.org/downloads/manual/manual.html Chapter 1. About Buildroot Buildroot is a tool that simplifies and automates the process of building a complete L
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值