UOTA信息管理
UOTA 信息管理用于维护设备端 UOTA 应用的升级资源、版本信息和启用状态。入口为“任务信息管理 → UOTA管理”。
快速访问：UOTA 信息管理
升级信息是怎样生成和下发的
新增或编辑 UOTA 时，管理员从文件管理中选择升级资源。系统会读取该文件的包名、版本号和版本名称；如果文件已经不存在，配置将无法保存。因此，页面中的包名和版本不是单独填写的，出现错误时应先检查文件管理中的 APK 信息。
保存成功后，启用且符合设备范围的终端才能取得这项升级配置。修改配置后，系统会使用新内容；删除配置时，也会清除它与历史渠道、MAC 的关联。停用记录则保留资料，但不会继续作为可用升级配置下发。
“是否系统APP”决定安装方式；只有开启时系统APP路径才有业务意义。路径应填写终端系统能够识别的目标位置，普通APP不应为了通过填写而随意设置系统路径。
当前推荐使用规则中心设置设备范围。页面仍保留历史渠道配置，是为了兼容旧终端和旧数据，并不表示新配置需要同时维护两套范围。只有排查老设备时才需要结合UOTA旧版逻辑，新配置以规则中心为准。
1. 查询 UOTA
可按名称、包名、版本号和版本名称查询。
| 列表字段 | 说明 |
|---|---|
| ID、名称 | UOTA 记录编号和识别名称。 |
| 是否开启 | 当前升级配置是否可用，可在列表中切换。 |
| 包名 | APK 包名。 |
| 版本号、版本名称 | 从所选资源中识别出的版本信息。 |
| 是否系统app | 是否按系统应用方式安装。 |
| 系统app安装路径 | 系统应用的目标安装路径；非系统应用通常为空。 |
| 备注 | 用途和维护说明。 |
| 创建时间 | 记录创建时间。 |
切换“是否开启”会直接影响该记录是否可用，操作前应确认目标版本和规则范围。
2. 新增和编辑
点击“新增”或操作列“编辑”，填写以下字段：
| 字段 | 必填与显示条件 | 说明 |
|---|---|---|
| 名称 | 必填 | 用于识别升级项 |
| 资源配置 | 必填 | 从文件管理的 APK 文件中选择，包名、版本号和版本名称由所选文件带出，不是数据字典 |
| 是否开启 | 必填 | 控制该配置是 否可用；数据字典 enable，新增默认“否” |
| 是否系统 app | 显示 | 数据字典 system_uota，新增默认“否” |
| 系统 APP 路径 | 仅“是否系统 app”为“是”时显示且必填 | 系统应用在设备中的安装路径 |
| 渠道配置 | 仅新增时显示且必选 | 历史兼容字段，选项来自渠道资料；编辑时不显示。当前新业务范围仍应通过规则中心维护 |
| 备注 | 可选 | 记录发布目的、适用版本等信息 |
保存前应核对包名、版本号和版本名称，避免把其他应用资源作为 UOTA 升级包。
3. 目标设备规则
当前主流程通过规则引擎确定目标设备。在规则中心按业务类型“uota升级”和当前 UOTA 业务 ID 绑定规则；一个 UOTA 可以绑定多条规则，设备命中任意一条即可匹配。
完整操作参见规则中心：业务侧集成。
旧版渠道和 MAC 配置仍可能用于历史数据或问题排查，但不应作为新配置方案。详情见UOTA旧版逻辑。
4. 数据字典
以下数据截至 2026-08-27 17:48:07（UTC+8），所有字典项当前均为启用状态。
是否开启
字典名称：是否开启；字典类型：enable。
| 显示名称 | 取值 |
|---|---|
| 否 | 0 |
| 是 | 1 |
是否系统app
字典名称：系统UOTA；字典类型：system_uota。
| 显示名称 | 取值 | 含义 |
|---|---|---|
| 否 | 0 | 按普通应用处理。 |
| 是 | 1 | 按系统应用处理，并填写系统 APP 路径。 |
注意事项
- 升级资源变更后，应再次核对包名和版本信息。
- 停用记录不会删除资源文件或历史记录。
- 规则匹配成功只表示设备有资格取得配置；是否实际升级还取决于设备是否请求、当前版本和设备端执行结果。
5. 设备升级链路
- 设备上报身份和当前版本，服务端只查询已启用的 UOTA 配置。
- 服务端通过规则引擎计算该设备可用的 UOTA，不再为新配置同时维护旧版渠道/MAC 范围。
- 命中后返回文件地址、包名、版本、MD5、系统 APP 标识及安装参数。
- 设备比较当前版本与目标版本，决定是否下载和安装。
排障顺序
- 无配置：先查启用状态、规则绑定、规则命中和设备身份。
- 有配置但不下载：检查版本比较、文件是否存在、下载地址和网络。
- 已下载但不安装：检查 MD5、系统 APP 路径、安装权限和设备端日志。
验收时至少覆盖升级、同版本不重复升级、规则不命中、配置停用和文件不可用五类场景。