一、概述
OTA定向升级功能支持通过配置规则实现固件的精细化推送，可根据设备地区、固件版本等条件限定升级范围，支持两种升级模式：用户手动升级（APP端触发）和设备端静默升级（自动完成）。
核心说明：
- 定向规则通过固件上传时配置的
summary字段定义，该字段为JSON格式字符串（最大256字符）； - 升级范围校验支持地区（region）、版本区间（version_arrange）等基础条件，可按需扩展自定义字段；
- 手动升级需用户确认后触发，静默升级全程无交互，自动择机完成。
二、后台配置
创建产品-型号后，上传固件时需配置
summary 字段，用于定义本次定向升级的范围条件，字段为JSON格式字符串（最大支持256个字符）。（一）summary 配置示例
{
"region": ["China", "Hongkong"],
"version_arrange": {
"min": 0,
"max": 4294967295
}
}
示例说明：本次固件仅针对
China、Hongkong 地区，且设备固件版本在 0~4294967295 范围内的设备进行升级。（二）summary 参数定义
| 字段 | 含义 | 类型 | 值 | 说明 |
|---|---|---|---|---|
region | 要定向的国家或地区 | string 数组 | "all" 或具体国家/地区名 | "all" 表示不限制地区，支持多地区配置 |
version_arrange | 要定向升级的设备版本号范围 | JSON 对象 | 包含 min（最小版本）和 max（最大版本） | 如需覆盖所有版本，可配置为 min:0、max:0xFFFFFFFF |
| 其他 | 自定义扩展字段 | 按需定义 | 根据业务场景扩展 | 需控制总字符数不超过256 |
三、用户手动升级（APP端）
APP端通过以下步骤实现定向升级的校验与触发，需用户确认后完成升级。
（一）获取最新版本信息
从OTA服务器获取当前设备所属型号的最新固件信息：
{
"productmodel": {
"android_version": "1",
"description": "function test；",
"file_checksum": "031FC601311AD3544172CD0E35171FA9",
"file_size": 215404,
"ios_version": "1",
"summary": "{ \"region\": [\"China\", \"Hongkong\"], \"version_arrange\": { \"min\": 0, \"max\": 4294967295 } }",
"url": "https://cn-kota.s3.cn-north-1.amazonaws.com.cn/tutksz/90/191/epu/67307011/producer_39xx.bin",
"version": "67307011"
}
}
（二）范围校验
解析返回结果中的
summary 字段，比对当前设备的以下信息是否符合升级范围：- 设备所属地区（region）是否在定向列表中；
- 设备当前固件版本是否在
version_arrange定义的 [min, max] 范围内。
（三）触发升级
若设备符合升级范围，APP向用户展示升级提示，用户确认后通知设备开始升级。
四、设备端静默升级
设备端自动完成升级检测与定向校验，无需用户干预，全程自动化执行。
（一）获取最新版本信息
设备主动从OTA服务器拉取所属型号的最新固件信息（返回格式与APP端一致）：
{
"productmodel": {
"android_version": "1",
"description": "function test；",
"file_checksum": "031FC601311AD3544172CD0E35171FA9",
"file_size": 215404,
"ios_version": "1",
"summary": "{ \"region\": [\"China\", \"Hongkong\"], \"version_arrange\": { \"min\": 0, \"max\": 4294967295 } }",
"url": "https://cn-kota.s3.cn-north-1.amazonaws.com.cn/tutksz/90/191/epu/67307011/producer_39xx.bin",
"version": "67307011"
}
}
（二）范围校验
设备解析
summary 字段，自动校验：- 设备预设的地区信息是否在定向列表中；
- 设备当前固件版本是否在
version_arrange定义的范围内。
（三）择机升级
若设备符合升级范围，将在合适时机（如设备空闲时段、低功耗状态）自动下载固件并完成升级，全程无用户交互。
五、说明
- 定向升级的精细化控制完全依赖
summary字段的定义，支持根据业务需求扩展定向策略（如设备型号、硬件版本、网络类型等）； summary字段为JSON格式字符串，需确保语法正确且字符数不超过256；- 地区名称需统一规范（如
"China"、"Hongkong"），避免因命名不一致导致校验失败； - 版本号支持32位无符号整数范围（
0~4294967295），配置时需注意版本号格式一致性。
