4. Yocto项目结构详解

大家好，我是你们的讲师。今天咱们来聊聊Yocto项目的目录结构。说实话，我刚接触Yocto那会儿，面对那一堆文件夹，心里是有点懵的。meta、meta-poky、meta-yocto-bsp……这些到底干嘛用的？构建完的tmp目录里又是什么鬼？

别急，今天我就带你把Yocto项目的家底翻个底朝天。搞清楚了这些，后面做板级适配才能游刃有余。

1.1 源码目录结构：三大核心层

Yocto项目最核心的设计思想就是「分层」。说白了，就是把通用的东西和特定板子的东西分开管理。你想想看，这样多灵活——换块板子，我只需要换掉板级支持包那一层就行了。

我们来看一下源码根目录下最重要的几个目录：

目录名	作用	我的经验
meta	核心层，包含OpenEmbedded的基础框架、bitbake核心类、通用配方	这个目录我基本不动，它是Yocto的「心脏」
meta-poky	Poky参考发行版配置层，定义了默认的发行版策略	做产品时我通常会从这里fork一份，改成自己的发行版
meta-yocto-bsp	官方支持的板级支持包，比如qemu模拟器、一些参考板	我刚开始学Yocto时，就是拿qemux86-64练手的
meta-selftest	用于Yocto自身测试的层	普通开发者基本用不到

嗯，这里要注意一点：meta-poky和meta-yocto-bsp是Poky项目特有的。如果你用的是纯OpenEmbedded，那这两个目录是没有的。我个人习惯把Poky看作Yocto的「官方参考实现」。

1.2 构建输出目录：tmp的秘密

执行完bitbake core-image-minimal之后，你会发现在build目录下多了一个tmp文件夹。这个文件夹可不小，我第一次构建完占了将近20GB。里面到底装了啥？

我带你看看tmp目录的核心子目录：

• tmp/work — 每个配方的工作目录。下载、解压、打补丁、编译、安装，全在这里完成。我曾经为了调试一个编译错误，在这个目录里翻了好几个小时。
• tmp/deploy — 最终产物输出目录。包括镜像文件（.wic、.tar.bz2）、内核、设备树、根文件系统等。你要烧录到板子上的东西，全在这里。
• tmp/sstate-cache — 共享状态缓存。说白了就是编译好的中间产物。下次构建时如果配方没变，就直接从缓存里拿，不用重新编译。这个机制帮我节省了大量时间。
• tmp/log — 构建日志。出问题时，我第一件事就是去这里看cooker.log和task.log。

1.3 关键配置文件：Yocto的「三驾马车」

Yocto项目有三个配置文件，我称之为「三驾马车」。搞懂了它们，你就掌握了Yocto的命脉。

1.3.1 local.conf — 你的私人定制

这个文件位于build/conf/local.conf。它定义了构建的本地配置，比如目标机器、并行编译线程数、下载目录等。

# 我常用的local.conf配置
MACHINE = "qemux86-64"          # 目标机器
BB_NUMBER_THREADS = "8"         # bitbake并行任务数
PARALLEL_MAKE = "-j 8"          # make并行编译线程数
DL_DIR = "/home/user/downloads" # 源码下载目录
SSTATE_DIR = "/home/user/sstate-cache" # 共享状态缓存目录

我曾经犯过一个错误：把BB_NUMBER_THREADS设成了CPU核心数的两倍，结果构建时内存爆了，系统直接卡死。后来我学乖了，一般设为核心数或核心数+1。

1.3.2 bblayers.conf — 层的「通讯录」

这个文件位于build/conf/bblayers.conf。它告诉bitbake：你要从哪些层里找配方和配置文件。

# 我项目中的bblayers.conf示例
BBLAYERS ?= " \
  /home/user/poky/meta \
  /home/user/poky/meta-poky \
  /home/user/poky/meta-yocto-bsp \
  /home/user/meta-myboard \
  "

注意看，我把自己的板级支持层meta-myboard加到了最后。为什么？因为后添加的层优先级更高。这样我就可以用自己的配方覆盖官方层的配方。

1.3.3 meta/conf/bitbake.conf — 全局「宪法」

这个文件位于meta/conf/bitbake.conf。它是Yocto的全局配置文件，定义了所有配方的默认行为。比如：

• 默认的源码下载方式（git、http、svn等）
• 默认的编译和安装步骤
• 文件系统路径（/usr/bin、/etc等）
• 包管理器的默认设置

说实话，这个文件我很少直接修改。因为它太底层了，改错了整个Yocto都可能崩掉。我更倾向于在local.conf或自己的层里覆盖特定变量。

1.4 知识体系总览

为了让你更直观地理解Yocto项目的结构，我画了一张图：

1.5 实战建议

好了，理论讲完了，我给你几条实战建议：

1. 先跑通官方参考板 — 我建议你从qemux86-64开始，用bitbake core-image-minimal构建一次。成功了再换自己的板子。
2. 学会看日志 — 构建失败时，tmp/log/cooker.log是你的第一求助对象。我90%的问题都是从这里找到线索的。
3. 善用sstate-cache — 如果你经常构建不同的项目，可以把sstate-cache目录共享出来。这样每个项目都能复用之前的编译结果，速度能快好几倍。
4. 不要直接修改meta层 — 想改什么，就在自己的层里覆盖。这是Yocto的最佳实践，也是我踩过坑之后的血泪教训。