# RECEIVER 离线升级包最小样例

本目录保留原有 `standard-app` 路径，便于继续联调，但样例内容已经切换到当前第一版 `RECEIVER` 升级包契约。

目录结构：

```text
standard-app/
├── manifest.json
├── build-package.sh
└── payload/
    └── scripts/
        ├── execute.sh
        ├── precheck.sh
        ├── verify.sh
        └── rollback.sh
```

说明：

- `execute.sh` 必填
- `precheck.sh`、`verify.sh`、`rollback.sh` 可选
- 本样例里四个脚本都给出，方便联调
- `signature.sig` 不放在仓库示例里，必须由打包方在打包阶段生成
- `build-package.sh` 会把 `manifest.json`、`signature.sig` 和 `payload/` 打成最终 `upgrade-package.zip`

推荐打包步骤：

1. 进入当前示例目录
2. 根据实际设备修改 `manifest.json` 中的 `productType`、`version`、`minCompatibleVersion`
3. 对 `manifest.json` 原始字节生成真实的 `signature.sig`
4. 执行 `./build-package.sh`

参考命令：

```bash
cd docs/examples/upgrade-package/standard-app

# 这里替换为正式签名工具，生成 manifest.json 对应的 signature.sig
# sign-manifest manifest.json > signature.sig

chmod +x build-package.sh
./build-package.sh
```

联调时建议：

- 先用这个目录骨架做一个 `RECEIVER` 预检样包
- 脚本可以先只输出日志并返回 `0`
- 等预检、建任务、执行、回滚链路跑通后，再替换成真实升级脚本
- 如果当前环境启用了真实密码卡验签，占位 `signature.sig` 无法通过预检