版本历史与更新说明

本文档汇总杰理 OTA SDK（Android-JL_OTA）核心库（jl_bt_ota AAR）的版本历史、各版本更新内容、版本命名规则与交付物形态，帮助集成方选择合适版本并完成升级。

Purpose and Scope

本页面覆盖 core-library（杰理 OTA 核心库）的版本发布记录与更新说明，包括：

• 各版本（1.6.0 → 1.11.0）的发布日期与变更明细
• 版本命名规则（jl_bt_ota_V{版本}_{构建号}-release.aar）
• 版本演进脉络（新增功能、兼容性适配、缺陷修复、架构重构）
• 版本升级与选择建议

以下内容不属于本页面范围，请参考对应页面：

• 核心库的架构与实现机制 → 参见「Core Library 架构」页面
• OTA 参数配置与 API 使用 → 参见「OTA 配置与 API 参考」页面
• Demo 工程与集成步骤 → 参见「快速开始 / 集成指南」页面

版本历史数据来源于仓库根目录 README.md（第八节）与 README_en.md（第八节），以及 apk/UpdateContent.txt 更新说明文件。仓库当前快照的根目录仅包含 README.md、README_en.md 与 LICENSE，AAR 与 APK 等二进制交付物不在文本快照内，其存在性以 README 工程结构章节的描述为准。

Overview

Android-JL_OTA 是珠海市杰理科技股份有限公司为杰理蓝牙类产品提供的固件升级 SDK，核心功能为 RCSP OTA 升级，支持 BLE、SPP 等多种传输通道。SDK 的核心交付物为 OTA 升级核心库 jl_bt_ota_Vxxx-release.aar，其中包含 RCSP 协议处理、升级流程控制等功能。

版本历史（core-library.versions）反映了该核心库自 2022 年以来的持续演进：

• 功能层面：从基础 BLE/SPP 升级，逐步扩展出多设备升级、单备份 OTA 自动回连、复用空间特殊升级、Gatt Over BR/EDR 等能力；
• 兼容性层面：每个版本都跟随 Android 系统大版本（Android 11/13/14/15）与主流平台（ARM、x86/x86_64）做适配；
• 质量层面：修复了回连失败、SPP OTA 失败、TWS 单备份失败、拼包丢数据、多线程命令 SN 冲突等一系列问题；
• 工程层面：1.9.0 移除单例使用、使多设备升级流程相互独立；1.10.0 重构 APP 的 UI 框架。

flowchart LR
    subgraph sg_InfoSources["版本信息来源"]
        README_MD["README.md<br/>（第八节·中文）"]
        README_EN["README_en.md<br/>（第八节·英文）"]
        UPDATE_TXT["apk/UpdateContent.txt<br/>（APK 更新说明）"]
        AAR_NAME["libs/ 目录 AAR 文件名<br/>（版本+构建号）"]
    end

    subgraph sg_Artifacts["SDK 交付物"]
        CORE_LIB["jl_bt_ota_V1.11.0_11015-release.aar<br/>核心库"]
        TEST_APK["JLOTA_V1.9.0_10905-debug.apk<br/>测试 APK"]
        DEMO["code/ 参考 Demo 源码工程"]
    end

    subgraph sg_Consumers["版本信息消费者"]
        INTEGRATOR["集成方（选择版本）"]
        MAINTENANCE["维护方（发布新版本）"]
    end

    README_MD --> CORE_LIB
    README_EN --> CORE_LIB
    UPDATE_TXT --> TEST_APK
    AAR_NAME --> CORE_LIB
    CORE_LIB --> INTEGRATOR
    TEST_APK --> INTEGRATOR
    DEMO --> INTEGRATOR
    CORE_LIB --> MAINTENANCE

上图展示了版本信息的来源与消费关系：版本历史同时以中英文维护在 README 中，AAR 文件名本身即携带版本号与构建号（如 V1.11.0_11015 表示版本 1.11.0、构建号 11015），测试 APK 对应的更新说明保存在 apk/UpdateContent.txt。集成方通过 README 的版本历史表了解变更，通过 AAR 文件名确认具体构建，维护方则在同一处记录新版本变更。

版本信息源

版本历史详表

以下为 README.md 第八节维护的完整版本记录（按时间倒序）：

表格内容来源：README.md；英文版见 README_en.md。

各版本详解

1.11.0（2026/01/30）——当前核心库版本

这是仓库中标注的核心库最新版本（对应 libs/jl_bt_ota_V1.11.0_11015-release.aar），也是功能增量最大的一次发布：

• 复用空间特殊升级流程：针对固件分区复用场景提供特殊升级流程，扩展了 SDK 可支持的固件布局类型；
• 单备份 OTA 自动回连 BLE：单备份升级流程中设备重启后由 SDK 自动回连 BLE，降低升级中断后的用户操作成本（对应 BluetoothOTAConfigure.bleConnectParam 配置项）；
• Gatt Over BR/EDR：在经典蓝牙链路上承载 GATT 协议，为不支持 BLE 但支持 BR/EDR GATT 的设备提供升级通道；
• Android 15 兼容处理：跟随系统行为变化（如蓝牙权限模型、后台限制）做适配。

1.10.0（2025/06/04 与 2025/08/11 两次发布）

同一年内发布了两个 1.10.0 版本，第二次为缺陷修复补丁：

• 2025/06/04：修复 SPP 通道下单备份 OTA 失败；增加 Android 14 兼容处理（含分区存储/权限变化）；重构 APP 的 UI 框架；
• 2025/08/11：修复 Android 14+ 手机存储权限申请失败；修复局域网文件传输（LAN 传包）中 IP 地址错误。

1.9.3（2024/01/26）

• 增加 x86 与 x86_64 平台支持，使 SDK 可运行在模拟器及 x86 架构设备上，方便无 ARM 真机时的调试与 CI；
• 修复 BLE 传输发数变慢的问题（与 MTU 协商、发包间隔相关）。

1.9.2（2023/03/29）

• 修复拼包出错导致丢失数据问题——这是 RCSP 分包/组包链路的可靠性修复，直接影响升级数据传输完整性；
• 增加 Android 13 兼容处理。

1.9.0（2022/12/17）——工程架构分水岭

• 支持多设备升级：去掉单例使用，使各设备升级流程相互独立——这是核心库架构层面的重要变更，此前 SDK 全局仅维护一个升级流程实例；
• 修复设备回连失败、SPP 方式 OTA 失败、双模同地址设备 OTA 失败、TWS 耳机单备份 OTA 失败等系列问题；
• 增加 Android 11 兼容处理（分区存储、蓝牙权限变化）。

1.6.0（2022/04/07）——最早记录版本

• 增加新回连方式；增加设备启动时的协议 MTU 调整；
• 修复多线程发命令 SN 相同的问题（命令序列号并发冲突）与 RCSP 认证流程数据异常问题。

版本演进脉络

flowchart TD
    V160["1.6.0<br/>2022/04/07<br/>基础能力+新回连方式"] --> V190["1.9.0<br/>2022/12/17<br/>多设备升级（去单例）+Android 11"]
    V190 --> V192["1.9.2<br/>2023/03/29<br/>拼包修复+Android 13"]
    V192 --> V193["1.9.3<br/>2024/01/26<br/>x86/x86_64 支持+BLE 提速"]
    V193 --> V1100A["1.10.0<br/>2025/06/04<br/>SPP 单备份修复+Android 14+UI 重构"]
    V1100A --> V1100B["1.10.0<br/>2025/08/11<br/>存储权限+LAN 传输修复"]
    V1100B --> V1110["1.11.0<br/>2026/01/30<br/>复用空间/自动回连/Gatt over BR-EDR+Android 15"]

该时间线揭示了三个并行演进的维度：

1. 传输与协议能力：SPP 可靠性 → BLE 传输性能 → Gatt Over BR/EDR 与复用空间流程；
2. Android 系统兼容：Android 11 → 13 → 14 → 15，每一代系统大版本发布后 SDK 均有对应适配；
3. 工程架构：1.9.0 去单例支持多设备并发升级，1.10.0 重构 APP UI 框架，属于结构性的质量投资。

版本命名与交付物

命名规则

核心库与测试 APK 均采用 {组件}_{大版本}_{构建号} 的命名模式：

命名解读：V 后跟语义化版本号（主.次.修订），下划线后为构建号（如 11015）。README 中描述核心库时以 xxx 指代版本号（jl_bt_ota_Vxxx-release.aar），集成方应按所选版本替换。

交付物清单

仓库工程结构（README.md 第四节）约定的目录布局如下：

Android-JL_OTA/
├── apk/                                # 测试APK文件夹
│   ├── JLOTA_V1.9.0_10905-debug.apk         # OTA测试版本
│   └── UpdateContent.txt                    # 更新说明
├── code/                                    # 参考源码工程文件夹
│   └── 参考Demo源码工程                  # OTA Demo项目源码
├── doc/                                     # 开发文档文件夹
│   ├── JieLi_OTA_SDK_Android_Development_Doc # 杰理OTA外接库(Android)开发文档
│   └── 杰理OTA外接库(Android)开发文档链接        # OTA在线开发文档地址
├── libs/                               # 核心库文件夹
│   ├── jl_bt_ota_V1.11.0_11015-release.aar  # 杰理OTA核心库
│   └── ReadMe.txt                           # 核心库说明文件
└── ReadMe.txt                          # 说明文件

Source: README.md

核心库以 AAR 形式分发（jl_bt_ota_Vxxx-release.aar），包含 RCSP 协议处理、升级流程控制等功能；Demo 源码工程位于 code/，测试 APK 与更新说明位于 apk/。

依赖引入方式

集成方将所选版本的 AAR 放入模块的 libs 目录，并在 build.gradle 中声明依赖：

dependencies {
    //1.将上面的aar文件放入工程目录中的对应moudle的lib文件夹下
	//2.在moudlu的build.gradle中添加
	implementation fileTree(include: ['*.aar'], dir: 'libs')
}

Source: README.md

采用 fileTree 引入意味着升级核心库时只需替换 libs/ 下的 AAR 文件（如从 V1.9.0 换为 V1.11.0），无需改动 build.gradle 配置，这保证了版本升级的平滑性。需要留意的是，升级后应同步核对 BluetoothOTAConfigure 等配置项是否有新增字段（如 1.11.0 的 bleConnectParam 自动回连参数）。

升级与版本选择建议

升级路径

1. 确认目标版本：在版本历史表中确认目标版本的变更内容与发布日期；存在同版本号两次发布（如 1.10.0）时，优先选用日期较新的补丁版本；
2. 替换 AAR：将 libs/ 下的核心库替换为目标版本 AAR（保持文件名约定的 V{版本}_{构建号} 形态）；
3. 核对配置：对照对应版本的 README 配置章节，检查新增配置项（如 MTU、回连参数、认证开关）并按需设置；
4. 回归测试：重点关注升级流程与目标机型组合，尤其是历史上修复过的场景（SPP 单备份、TWS 单备份、双模同地址设备、多设备并发升级）；
5. 跟随系统版本：若 APP 的 targetSdk/minSdk 覆盖 Android 11/13/14/15，应确保核心库版本不低于对应兼容适配版本（1.9.0 / 1.9.2 / 1.10.0 / 1.11.0）。

版本选择矩阵

变更模式分析

对全部版本记录按变更类型归类，可以清晰看到 SDK 的维护策略：

按变更类型统计

修复主题的时间线（可靠性演进）

sequenceDiagram
    participant Dev as 集成方/设备
    participant SDK as jl_bt_ota 核心库
    participant BT as 蓝牙协议栈 (BLE/SPP)

    Note over SDK: 1.6.0 (2022/04)
    SDK->>SDK: 修复多线程发命令 SN 相同
    SDK->>SDK: 修复 RCSP 认证流程数据异常

    Note over SDK: 1.9.0 (2022/12)
    SDK->>SDK: 修复设备回连失败 / SPP OTA 失败
    SDK->>SDK: 修复双模同地址、TWS 单备份 OTA 失败
    SDK->>SDK: 去单例，支持多设备并发升级

    Note over SDK: 1.9.2 (2023/03)
    SDK->>SDK: 修复拼包出错导致数据丢失

    Note over SDK: 1.10.0 (2025/06, 2025/08)
    SDK->>SDK: 修复 SPP 单备份 OTA 失败
    SDK->>SDK: 修复 Android 14+ 存储权限申请失败
    SDK->>SDK: 修复局域网传输 IP 地址错误

修复内容高度集中于蓝牙链路的可靠性（回连、SPP、TWS、双模、拼包、SN 冲突）与系统权限/存储模型变化（Android 11/13/14/15），这正是 OTA 类 SDK 最易出问题的两个领域，也解释了版本迭代节奏为何与 Android 系统版本发布周期强相关。

运维与集成注意事项

• 版本与构建号双重标识：同名 AAR 的版本号相同但构建号不同（如 V1.10.0 存在两个构建），集成方在排查问题时需同时核对版本号与构建号，避免混淆补丁版本；
• 权限配置随版本演进：高版本 Android 要求 BLUETOOTH_SCAN、BLUETOOTH_CONNECT、定位权限等，接入低版本 SDK 的旧工程升级时应同步 AndroidManifest.xml 的权限声明；
• AAR 热替换：implementation fileTree(include: ['*.aar'], dir: 'libs') 的引入方式使版本切换成本极低，但替换后需清理构建缓存（Build → Clean）避免旧 AAR 残留；
• 发布渠道：版本 tag 通过 GitHub Releases/Tags 维护（README 顶部 badge 链接指向 tags 页），正式集成前建议对照 tag 与 README 版本历史核对一致性；
• 文档中心：详细开发文档与每个版本的配置说明以在线文档中心（中文 / 英文）为准。

已知局限与说明

• 仓库文本快照中不包含 AAR/APK 二进制文件与 apk/UpdateContent.txt 的实际内容，本文档版本信息以 README 维护的版本历史表为准；
• 1.6.0 为 README 中记录的最早版本，更早版本（如有）未在仓库中公开；
• 1.10.0 存在两次发布，README 未给出区分性内部代号，升级时建议以「日期 + 构建号」共同确认。

Related Links

• README.md（中文，含版本历史第八节）
• README_en.md（英文版本历史）
• README.md 工程结构（第四节）
• README.md OTA 参数配置（第五节）
• LICENSE（Apache License 2.0）
• 相关页面：Core Library 架构 · OTA 配置与 API 参考 · 快速开始 / 集成指南