50 lines
1.6 KiB
Markdown
50 lines
1.6 KiB
Markdown
# 标准收发器离线升级包最小样例
|
|
|
|
本目录提供 `STANDARD_APP` 离线升级包的最小示例骨架，用于对齐打包方、后端和联调流程。
|
|
|
|
目录结构：
|
|
|
|
```text
|
|
standard-app/
|
|
├── manifest.json
|
|
└── payload/
|
|
└── scripts/
|
|
└── orchestrator.sh
|
|
```
|
|
|
|
说明：
|
|
|
|
- 本目录中的 `manifest.json` 使用了占位符 `__PAYLOAD_SHA256__`
|
|
- 真正打包前，需要先对 `payload.zip` 计算 `SHA-256`，再替换该字段
|
|
- `signature.sig` 不放在仓库示例里，必须由打包方使用“固件完整性密钥”私钥在打包阶段生成
|
|
|
|
推荐打包步骤：
|
|
|
|
1. 进入当前示例目录
|
|
2. 将 `payload/` 压缩为 `payload.zip`
|
|
3. 计算 `payload.zip` 的 `SHA-256`
|
|
4. 用实际摘要替换 `manifest.json` 中的 `__PAYLOAD_SHA256__`
|
|
5. 对 `manifest.json` 原始字节生成 `signature.sig`
|
|
6. 将 `manifest.json`、`signature.sig`、`payload.zip` 压缩成最终 `upgrade-package.zip`
|
|
|
|
参考命令：
|
|
|
|
```bash
|
|
cd docs/examples/upgrade-package/standard-app
|
|
|
|
zip -rq payload.zip payload
|
|
PAYLOAD_SHA256="$(shasum -a 256 payload.zip | awk '{print $1}')"
|
|
sed "s/__PAYLOAD_SHA256__/${PAYLOAD_SHA256}/g" manifest.json > manifest.generated.json
|
|
|
|
# 这里改为公司正式签名工具，生成 manifest.generated.json 对应的 signature.sig
|
|
# sign-manifest manifest.generated.json > signature.sig
|
|
|
|
zip -j upgrade-package.zip manifest.generated.json signature.sig payload.zip
|
|
```
|
|
|
|
联调时建议：
|
|
|
|
- 先用这个目录骨架做一个 `STANDARD_APP` 预检样包
|
|
- `orchestrator.sh` 可以先只输出日志并返回 `0`
|
|
- 等预检、建任务、执行链路跑通后，再替换成真实升级脚本
|