1. 课程导入

在嵌入式Linux产品开发中，SDK根文件系统（RootFS）是连接内核与上层应用的“地基”。它决定了系统启动后能看到哪些目录、加载哪些库、运行哪些服务，也直接影响产品的稳定性、安全性和可维护性。很多团队在开发阶段能跑通功能，却在版本发布时频繁踩坑：镜像体积失控、依赖缺失、权限错误、升级失败、不同硬件版本混用。本课程的目标，就是把“能跑”的根文件系统，变成“可发布、可追溯、可回滚”的工程化交付物。

一、整体框架：从源码到可发布镜像

根文件系统发布工程不是简单的“打包一个tar”。它是一条从配置到交付的链路，核心环节包括：构建环境准备、包管理与依赖解析、根文件系统组装、镜像格式生成、版本与元数据注入、校验与签名、发布归档、以及升级与回滚验证。下图展示了这条链路的整体结构，以及各环节之间的数据流与产物关系。

二、核心价值：为什么需要“发布工程”

很多团队把根文件系统当作“构建副产品”，结果在量产阶段付出高昂代价。发布工程的价值体现在四个维度：

• 一致性：同一版本号对应同一份二进制内容，避免“我这边能跑，你那边不行”。
• 可追溯：每个镜像都能追溯到Git提交、配置文件和依赖清单，问题定位从“猜”变成“查”。
• 可回滚：升级失败时能快速退回上一稳定版本，降低现场变砖风险。
• 可审计：签名与校验和保证镜像未被篡改，满足安全与合规要求。

三、方法流程：一条可执行的发布流水线

下面给出一条最小可用的发布流程，适合大多数基于Yocto、Buildroot或自研SDK的项目。你可以根据团队规模逐步增加自动化程度。

# 1. 准备构建环境
source ./sdk-env.sh
export TARGET_ARCH=arm64
export ROOTFS_VERSION=1.0.0
export BUILD_NUMBER=$(git rev-parse --short HEAD)

# 2. 构建根文件系统
make rootfs-defconfig
make rootfs -j$(nproc)

# 3. 生成版本元数据
cat > rootfs/manifest.json <<EOF
{
  "version": "${ROOTFS_VERSION}",
  "build": "${BUILD_NUMBER}",
  "arch": "${TARGET_ARCH}",
  "timestamp": "$(date -u +%Y-%m-%dT%H:%M:%SZ)"
}
EOF

# 4. 打包镜像
tar -czf rootfs-${ROOTFS_VERSION}-${BUILD_NUMBER}.tar.gz -C rootfs .

# 5. 生成校验和并签名
sha256sum rootfs-*.tar.gz > checksum.sha256
gpg --detach-sign --armor checksum.sha256

# 6. 归档发布
mkdir -p release/${ROOTFS_VERSION}
cp rootfs-*.tar.gz checksum.sha256 checksum.sha256.asc release/${ROOTFS_VERSION}/

这条流程的关键在于：版本号、构建号、时间戳和校验和必须与镜像一起归档。缺少任何一项，后续追溯都会变得困难。

四、适用场景与常见误区

发布工程适用于多种场景：消费类智能硬件量产、工业网关远程升级、车载终端版本管理、以及需要多硬件版本并行的产品线。不同场景对镜像格式、升级方式和安全等级的要求不同，但“版本可追溯、内容可校验、失败可回滚”是共同底线。

五、复盘：从“能跑”到“可发布”