1. 版本管理总体流程

1.1 适用场景

本章定义的版本管理总体流程适用于所有需要通过OTA（Over‑The‑Air）方式对嵌入式设备固件进行远程升级的产品线。典型的适用场景包括：

• 消费电子：智能家居网关、可穿戴设备、扫地机器人等需要固件迭代的终端产品。
• 汽车电子：T‑Box、IVI（车载信息娱乐系统）、ECU（电子控制单元）的固件升级。
• 工业物联网：远程传感器、边缘计算节点的固件推送与漏洞修复。
• 医疗/安防：需要满足合规审计要求，对固件版本进行严格追溯的场景。

1.2 前置条件

在启动版本管理流程之前，必须完成以下基础设施搭建与规则定义：

• 已建立稳定的CI/CD构建环境，能够自动化输出可重复的构建产物（如 .bin、.hex、.s19）。
• 已为产品线定义统一的版本号规范（推荐遵循 Semantic Versioning）。
• 已分配专用存储库（如 S3、Artifactory）用于版本工件的持久化存储。
• 已完成OTA签名用的私钥/公钥基础设施（PKI）部署。
• 已编排OTA平台（如阿里云IoT、华为云OTA、自研平台）上的产品/设备群组。

1.3 操作步骤

1. 源代码提交 & CI 触发： 开发人员完成功能或补丁开发后，向受控分支（如 main、release/*）提交代码。提交动作自动触发 CI 管道。
2. 构建与打包： CI 系统根据构建脚本编译固件，生成最终交付件（.bin / .hex），同时生成构建元数据（如构建时间、Git Commit ID）。
3. 版本登记与签名： 构建产物被推送至版本管理服务。系统自动分配唯一版本号（如 2.1.0+build.20240501），并使用私钥对固件包进行签名。
4. 金丝雀发布（Canary）： 将新版本推送至占总量 5% ~ 10% 的预定义设备群组，观察启动、连接、功能等核心指标是否异常。
5. 全量部署： 金丝雀观察期（例如 24 小时）通过后，系统逐步扩大发布范围，直至覆盖全部目标设备。

1.4 输入输出物

1.5 责任边界

1.6 异常处理

1.7 记录材料

每个版本的完整生命周期记录必须被持久化，以备合规审计与问题追踪。典型记录材料包括：

• 版本清单文件： 记录版本号、产物哈希、构建 Commit、签名指纹、发布时间。
• 发布说明（Release Notes）： 列举新特性、修复的问题、已知限制。
• OTA 部署报告： 包含目标设备数、成功数、失败数、回滚数、总耗时。

版本清单示例（JSON 格式）：

{
  "version": "2.1.0+build.20240501",
  "product": "SmartSensor-X",
  "target_platform": "esp32-s3",
  "checksum_sha256": "a1b2c3d4e5f678901234567890abcdef1234567890abcdef1234567890abcdef",
  "signature_algorithm": "ECDSA-P256",
  "release_date": "2024-05-01T10:30:00Z",
  "deployment_strategy": "canary",
  "change_log_url": "https://artifact.example.com/release-notes/v2.1.0.md"
}

1.8 验收标准