跳到主要内容

UOTA信息管理

核心概念：任务管理 | UOTA信息管理 | 概览

UOTA（User Over-The-Air）信息管理用于管理设备固件和系统应用的远程升级信息。

核心概念：任务管理 | UOTA信息管理 | 快速访问 (UOTA信息管理)

快速访问 (UOTA信息管理)​

在UOTA信息管理模块中，您可以快速访问在线系统。

点击访问：UOTA信息管理

关联模块
核心概念：任务管理 | UOTA信息管理 | 1. UOTA明细列表 (UOTA信息管理)

1. UOTA明细列表 (UOTA信息管理)​

列表展示了系统中所有的UOTA升级包信息。

列表查询

查询条件 (UOTA列表)​

  • 名称：UOTA升级包名称。
  • 包名：应用包名。
  • 版本号：应用版本号。
  • 版本名称：应用版本名称。

列表字段说明 (UOTA列表)​

  • ID：唯一标识。
  • 名称：UOTA升级包名称。
  • 是否开启：开关状态（是/否）。
  • 包名：应用程序包名。
  • 版本号：内部版本号。
  • 版本名称：显示版本名称。
  • 是否系统app：标识是否为系统级应用（是/否）。
  • 系统app安装路径：系统应用的安装路径。
  • 备注：备注说明。
  • 创建时间：记录创建时间。

操作按钮说明 (UOTA列表)​

  • 搜索/重置：查询或重置条件。
  • 新增：创建新的UOTA信息。
  • 导出：导出列表数据。
  • 编辑：修改现有信息。
  • 删除：删除记录。
核心概念：任务管理 | UOTA信息管理 | 2. 新增/编辑UOTA信息 (UOTA信息管理)

2. 新增/编辑UOTA信息 (UOTA信息管理)​

在UOTA信息管理模块中，您可以创建或修改UOTA升级包信息。

新增与修改

表单字段说明 (新增/编辑UOTA)​

  • 名称：必填，UOTA升级包的名称。
  • 包名：必填，应用程序的唯一包名。
  • 版本号：必填，数字版本号。
  • 版本名称：必填，显示的版本字符串。
  • 是否开启：是否启用该升级包。
  • 是否系统app：是否为系统预装应用。
  • 系统app安装路径：如果是系统应用，需指定安装路径。
  • 备注：其他说明信息。
核心概念：任务管理 | UOTA信息管理 | 关联配置管理概述 (UOTA信息管理)

关联配置管理概述 (UOTA信息管理)​

为了精准控制升级包的下发范围（如灰度发布、特定机型升级），系统提供了两种配置模式。

核心概念：任务管理 | UOTA信息管理 | 1. 规则配置管理 (新版推荐)

1. 规则配置管理 (新版推荐)​

通过集成 规则引擎，您可以实现高度自定义的升级策略。

  • 优势：
    • 灰度发布：可以配置规则只对部分MAC地址或特定地区生效。
    • 版本控制：可以限制只有满足特定系统版本的设备才能检测到此升级包。
    • 灵活组合：支持渠道、地区、MAC、设备型号等条件的自由组合。

在列表页面下方找到 规则配置组件 (RuleBusinessTabs)，点击 绑定规则 或 新增规则 即可开始配置。

核心概念：任务管理 | UOTA信息管理 | 2. 渠道配置管理 (Legacy)

2. 渠道配置管理 (Legacy)​

这是传统的配置方式，仅支持按渠道维度进行限制。

列表

  • 新增：关联新的渠道。
    • 新增
  • 删除：移除已关联的渠道。
    • 删除
异步导出

当导出数据量较大时，系统会采用异步导出方式。您可以在 导出任务管理 中查看导出进度并下载文件。

核心概念：任务管理 | UOTA信息管理 | 3. 请求处理流程 (UOTA升级)

3. 请求处理流程 (UOTA升级)​

3.1 简易流程图 (用户视角)​

Mermaid Diagram Code:

sequenceDiagram
    participant Device as "终端设备 (机顶盒)"
    participant Server as "云端服务器"

    Device->>Server: "1. 检查更新 (携带当前版本/平台)"
    Server->>Server: "2. 查找更高版本"
    Server->>Server: "3. 匹配升级策略 (灰度/地区/强制升级)"
    Server-->>Device: "4. 返回新版本信息"
    Device->>Device: "5. 下载并升级"

3.2 详细处理流程 (技术视角)​

Mermaid Diagram Code:

sequenceDiagram
    participant STB as "机顶盒/设备"
    participant Biz as "UOTA模块"
    participant Rule as "规则引擎 (RuleRunUtil)"
    participant Legacy as "传统逻辑 (渠道)"

    STB->>Biz: "1. 请求升级检查 (版本号, 平台, MAC)"
    
    Biz->>Biz: "2. 查询该平台下所有更高版本的 UOTA包"
    
    loop "3. 遍历候选升级包"
        Note right of Biz: "规则匹配"
        par "并行计算"
            Biz->>Rule: "3a. 规则引擎匹配 (matchBusinessIds)"
            Rule-->>Biz: "是否命中"
        and "传统逻辑"
            Biz->>Legacy: "3b. 匹配渠道白名单"
            Legacy-->>Biz: "是否命中"
        end
        
        alt "任意条件命中"
            Biz->>Biz: "4. 加入可用升级列表"
        end
    end
    
    Biz->>Biz: "5. 选择最新版本 (通常)"
    Biz-->>STB: "6. 返回升级包详情 (URL, MD5, 更新说明)"

3.3 逻辑详解​

  1. 版本筛选: 当设备发起请求时，服务器首先根据设备的平台（如 Rockchip/Amlogic）和当前版本号，找出所有版本号高于当前设备的升级包。
  2. 资格校验: 针对每一个候选升级包，检查其配置的发布范围：
    • 规则引擎: 检查设备是否满足升级包绑定的复杂规则（如“仅对 10% 的设备灰度发布”或“仅限特定 IP 段”）。
    • 渠道限制: 检查升级包是否限制了特定渠道。
  3. 最优解: 如果有多个满足条件的升级包，通常返回版本号最高的一个。
  4. 强制升级: 在返回的信息中，可以通过字段标记该更新是否为“强制升级”，设备端据此决定是否静默安装。
AI 问答