4. 下载缓存（DL_DIR）管理：合理设置DL_DIR，使用预下载和离线构建模式，避免重复下载
Yocto 构建过程中，最让人头疼的事情之一就是——网络。我见过不少团队，每次构建都要从零开始下载几百兆甚至上 GB 的源码包。网络一波动，构建就卡住。说白了，DL_DIR 就是你的本地源码仓库，管好了它，构建效率能翻倍。
4.1 DL_DIR 是什么？为什么它这么重要？
DL_DIR 是 Yocto 用来存放所有下载源码包（tarball、git 仓库等）的目录。默认情况下，它位于构建目录下的 downloads/ 文件夹。但问题来了——如果你有多个项目，或者需要反复清理构建目录，默认配置会让你吃尽苦头。
核心原则：DL_DIR 应该独立于构建目录，并且被多个项目共享。这样，一个包只要下载一次，所有项目都能复用。
我在项目中遇到过这样的情况：团队里 5 个人各自构建同一个 BSP，每个人都在重复下载 Linux 内核源码。后来我们把 DL_DIR 统一挂载到 NAS 上，构建时间直接缩短了 40%。你想想看，这省下来的可都是真金白银。
4.2 如何合理设置 DL_DIR？
设置 DL_DIR 其实很简单，但很多人忽略了几个关键点。我建议你按照下面的步骤来操作：
- 选择一个稳定的存储位置：最好是 SSD 或者高速 NAS，不要放在 /tmp 这种临时目录。
- 在 local.conf 中显式指定：
# 推荐：使用绝对路径，独立于构建目录
DL_DIR = "/opt/yocto/downloads"
# 或者使用相对路径（不推荐，容易混淆）
# DL_DIR = "${TOPDIR}/../shared-downloads"- 确保目录权限正确：如果多人共享，建议设置 755 权限，并确保所有用户都有读写权限。
- 定期清理过期包：虽然 DL_DIR 会复用，但有些旧版本包可能不再需要。我习惯写个 cron 脚本，每季度清理一次。
小技巧：你可以在 local.conf 中同时设置 BB_GENERATE_MIRROR_TARBALLS = "1"，这样 git 仓库也会被打包成 tarball 缓存起来，离线构建时更方便。
4.3 预下载模式：让构建不再依赖网络
预下载，说白了就是先把所有需要的源码包下载好，然后再开始构建。这在网络不稳定或者需要离线构建的场景下特别有用。
具体做法分两步：
第一步：执行预下载
# 只下载，不构建
bitbake -c fetchall <target-image>
# 或者针对特定 recipe
bitbake -c fetch linux-yocto嗯，这里要注意：fetchall 会下载所有依赖的源码包，包括工具链、库文件等。我第一次用的时候，发现它下载了将近 2GB 的数据，吓了一跳。但想想看，这些数据迟早要用，提前下载总比构建时卡住强。
第二步：验证下载完整性
下载完成后，我建议你检查一下校验和：
# 检查所有下载文件的校验和
bitbake -c checkuri <target-image>
# 如果某个包校验失败，可以单独重新下载
bitbake -c cleanall <recipe>
bitbake -c fetch <recipe>避坑指南：我曾经遇到过一个问题——预下载时网络正常，但正式构建时某个源站挂了。后来我养成了一个习惯：预下载完成后，立即执行一次 bitbake -c checkuri，确保所有包都是可用的。另外，建议在预下载时使用 BB_NUMBER_THREADS = "8" 加速下载。
4.4 离线构建模式：彻底摆脱网络依赖
离线构建，就是完全在无网络环境下完成 Yocto 构建。这在军工、医疗等涉密场景中非常常见。实现离线构建需要做好三件事：
| 步骤 | 操作 | 说明 |
|---|---|---|
| 1 | 准备完整的 DL_DIR | 确保所有源码包都已下载，包括 git 仓库的完整克隆 |
| 2 | 配置本地镜像源 | 使用 PREMIRRORS 将远程源指向本地 |
| 3 | 禁用网络访问 | 设置 BB_NO_NETWORK = "1" |
具体配置如下：
# local.conf 中配置离线构建
# 1. 禁用网络
BB_NO_NETWORK = "1"
# 2. 配置本地镜像源（将远程 URL 映射到本地 DL_DIR）
PREMIRRORS_prepend = "\
git://.*/.* file:///opt/yocto/downloads/git2/ \n \
ftp://.*/.* file:///opt/yocto/downloads/ \n \
http://.*/.* file:///opt/yocto/downloads/ \n \
https://.*/.* file:///opt/yocto/downloads/ \n"
# 3. 确保 git 仓库被完整缓存
BB_GENERATE_MIRROR_TARBALLS = "1"关键点：离线构建时，PREMIRRORS 的配置顺序很重要。Yocto 会先尝试本地镜像，如果找不到才会尝试远程。所以一定要把本地镜像放在前面。
我曾在某个项目中，需要把完整的 Yocto 构建环境搬到一台离线服务器上。当时我先把 DL_DIR 打包成 tar.gz，然后 scp 到目标机器。结果发现 git 仓库的缓存方式有点特殊——它们被存放在 downloads/git2/ 目录下，而且每个仓库都是一个 bare 仓库。如果你直接复制，记得保持目录结构完整。
4.5 DL_DIR 管理的最佳实践
根据我多年的经验，总结了几条 DL_DIR 管理的黄金法则：
- 共享优先：多个项目共享同一个 DL_DIR，避免重复下载。
- 定期备份：DL_DIR 里的源码包来之不易，建议每周备份一次。
- 版本锁定：在
local.conf中固定PREFERRED_VERSION，避免因版本更新导致缓存失效。 - 监控磁盘：DL_DIR 很容易膨胀到几十 GB，建议设置磁盘告警。
- 使用符号链接：如果磁盘空间紧张，可以把 DL_DIR 链接到大容量分区。
我的习惯：我会在 local.conf 中同时设置 DL_DIR 和 SSTATE_DIR，并且把这两个目录都放在同一个高速存储上。这样，下载缓存和编译缓存都能被多个项目共享，构建效率最大化。
4.6 知识体系：DL_DIR 管理全景图
下面这张图展示了 DL_DIR 在整个 Yocto 构建流程中的位置，以及它与预下载、离线构建的关系：
4.7 常见问题与解决方案
在实际使用中，你可能会遇到一些问题。我整理了几个高频问题：
| 问题 | 原因 | 解决方案 |
|---|---|---|
| 下载速度慢 | 网络带宽不足或源站限速 | 使用国内镜像源，或搭建本地代理缓存 |
| 校验和失败 | 下载文件损坏或不完整 | 执行 bitbake -c cleanall 后重新下载 |
| 磁盘空间不足 | DL_DIR 积累过多旧版本包 | 定期清理，或使用 BB_GENERATE_MIRROR_TARBALLS = "0" |
| 多人共享冲突 | 同时写入导致文件锁问题 | 使用 NFS 或 Ceph 等分布式文件系统 |
特别注意：如果你使用 NFS 共享 DL_DIR，记得在 local.conf 中设置 BB_FETCH_PREMIRRORONLY = "1"，避免多个构建实例同时下载同一个包导致冲突。我曾经因为这个原因，导致构建失败率飙升到 30%。