SDK 版本历史

本页记录 HarmonyOS-JL_OTA（杰理 OTA SDK for HarmonyOS）的发布版本、发布日期与各版本变更内容，帮助开发者了解 SDK 的功能演进、选择合适版本并安全升级。

Purpose and Scope

本页面向使用杰理 OTA SDK（HarmonyOS 版）的开发者，提供该 SDK 的版本历史与变更记录（Changelog），内容直接提取自仓库根目录的 README.md 与 README_en.md。

本页不涉及以下内容（请参阅对应目录页）：

SDK 的集成步骤、工程结构 —— 参见「快速开始 / 工程结构」相关页面
各 API 的详细签名与调用方式 —— 参见「API 参考」相关页面
BLE/SPP 升级流程的协议细节 —— 参见「OTA 升级流程」相关页面
配置项说明与调试技巧 —— 参见「配置说明 / 调试技巧」相关页面

官方发布记录（含每个版本的完整说明）还同步发布在杰理在线文档中心的 publish_record 页面，本页与其保持一致。

Overview

HarmonyOS-JL_OTA 是珠海市杰理科技股份有限公司面向其蓝牙类产品提供的固件升级开发平台，专门实现杰理蓝牙类产品的 RCSP OTA 升级功能，支持 BLE、SPP 等多种传输方式，并提供完整的固件升级流程（见 README.md）。

SDK 的核心能力决定了版本演进的脉络：

功能	说明	首次出现版本
BLE 升级	通过 BLE 通道进行固件升级	V1.0.0
SPP 升级	通过经典蓝牙 SPP 通道进行固件升级	V1.0.1（兼容支持）
自动回连	单备份 OTA 自动回连 BLE 功能，提升用户体验	V1.0.0 起具备

运行环境基线（README.md）：

操作系统：HarmonyOS 5.0+（支持 BLE 功能）
硬件：支持 RCSP OTA 功能的杰理 SDK，如 AC707N、AC703N、AC701N、AC697N、AC696N、AC695N 等
开发平台：DevEco Studio（建议最新版本）
语言支持：ArkTS（提供完整 API 支持）

版本管理方式：仓库通过 GitHub Tag 管理发布版本（仓库头部徽章指向 Tags 页面），版本号采用 Jieli_OTA_SDK_HarmonyOS_Vx.y.z 的命名规范；README 中的版本历史表与在线文档中心的发布记录（publish_record）共同构成完整的变更说明。

架构与版本演进

版本时间线

flowchart TD
    subgraph sg_Timeline["SDK 版本时间线"]
        V100["V1.0.0<br/>2024/09/03"] -->|"首次发布"| V101["V1.0.1<br/>2024/12/12"]
    end

    subgraph sg_Features["功能演进"]
        F1["OTA 升级（BLE）"] --> F2["+ SPP 升级兼容支持"]
        F2 --> F3["自动回连 BLE"]
    end

    V100 --> F1
    V101 --> F2
    F1 -.->|"基础能力"| F3

该图展示了两个已发布版本之间的递进关系：V1.0.0 是 SDK 的首个正式版本，提供核心的 OTA 升级能力；V1.0.1 在既有能力之上修复并兼容支持了 SPP 升级方式，使 SDK 覆盖 BLE 与经典蓝牙 SPP 两条升级通道。

版本信息发布渠道

flowchart LR
    subgraph sg_Upstream["版本信息源头"]
        A["GitHub Tags<br/>github.com/Jieli-Tech/HarmonyOS-JL_OTA/tags"]
    end

    subgraph sg_Docs["发布渠道"]
        B["README.md 八、版本历史"]
        C["README_en.md 8. Version History"]
        D["在线文档中心 publish_record"]
    end

    A --> B
    A --> C
    B --> D
    C --> D

版本信息在仓库 README（中/英双语）与杰理在线文档中心三处同步维护，开发者可从任一渠道确认当前最新版本号与变更内容。

版本明细

以下为截至当前仓库状态的全部已发布版本，数据来源于 README.md 的「八、版本历史」章节：

日期	版本号	发布内容
2024/12/12	Jieli_OTA_SDK_HarmonyOS_V1.0.1	1. 修复功能 1.1 兼容支持 SPP 升级方式
2024/09/03	Jieli_OTA_SDK_HarmonyOS_V1.0.0	1. 增加功能 1.1 OTA 升级

英文版同步记录见 README_en.md（8. Version History）。

V1.0.0（2024/09/03）—— 首个正式版本

性质：首次发布（增加功能）。
核心能力：OTA 升级，即通过 BLE 通道完成固件升级的完整流程。
设计意图：作为 SDK 的能力地基，V1.0.0 建立了 RCSP OTA 升级的协议实现、升级状态机与 ArkTS API 层，后续版本均在此之上做增量演进。

V1.0.1（2024/12/12）—— 兼容性修复版本

性质：Bug Fix（修复功能）。
核心变更：兼容支持 SPP 升级方式，使 SDK 不再局限于 BLE 单一通道，可覆盖使用经典蓝牙 SPP 连接的产品场景。
设计意图：SPP 在部分杰理蓝牙产品（如不支持 BLE 或 BLE 连接不稳定的场景）中仍是主流传输通道；该版本在不破坏 V1.0.0 API 的前提下扩展传输层抽象，属于向后兼容的增量发布。

版本演进解读

stateDiagram-v2
    [*] --> V1_0_0: 2024/09/03 首次发布
    V1_0_0 --> V1_0_1: 2024/12/12 修复+兼容
    V1_0_1 --> [*]

从版本策略看：SDK 采用语义化的小步快跑节奏，V1.0.1 仅修复并扩展传输方式，未引入破坏性变更，说明传输层（BLE/SPP）被设计为可插拔扩展点。开发者在集成时，应优先选用**最新版本（V1.0.1）**以获得 SPP 兼容支持。

使用示例

在 README 中维护版本历史表

版本历史的权威来源是 README 顶部的目录结构，其「八、版本历史」章节以 Markdown 表格形式维护：

## 八、版本历史

| 日期       | 版本号                                                       | 发布内容                                 |
| ---------- | ------------------------------------------------------------ | ---------------------------------------- |
| 2024/12/12 | [Jieli_OTA_SDK_HarmonyOS_V1.0.1](https://doc.zh-jieli.com/Apps/HarmonyOS/ota/zh-cn/master/Other/publish_record.html#version-1-0-1) | 1. 修复功能<br />1.1 兼容支持SPP升级方式 |
| 2024/09/03 | [Jieli_OTA_SDK_HarmonyOS_V1.0.0](https://doc.zh-jieli.com/Apps/HarmonyOS/ota/zh-cn/master/Other/publish_record.html#version-1-0-0) | 1. 增加功能<br />1.1OTA升级              |

来源：README.md

注意：每个版本号均链向在线文档中心 publish_record 页面对应的锚点（如 #version-1-0-1），点击可查看该版本的官方详细发布说明。英文版表格结构完全一致，见 README_en.md。

通过 GitHub Tag 获取对应版本源码

仓库头部徽章直接链接到 Tags 页面，用于发布与检索各版本源码：

[tag download]:https://github.com/Jieli-Tech/HarmonyOS-JL_OTA/tags
[tag_badgen]:https://img.shields.io/github/v/tag/Jieli-Tech/HarmonyOS-JL_OTA?style=plastic&logo=android&labelColor=ffffff&color=informational&label=Tag&logoColor=blue

# HarmonyOS-JL_OTA  [![tag][tag_badgen]][tag download]

来源：README.md

该徽章动态显示仓库最新的 Tag 版本号，是开发者快速判断「当前最新 SDK 版本」的入口；每个 Tag 对应一份可下载的版本快照。

集成时的版本引用

README 在工程结构/依赖说明中约定版本号以占位符形式出现（见 README.md）：

说明	取值
版本号占位符	`xxx`（PS: xxx 为版本号）
当前最新版本	`Jieli_OTA_SDK_HarmonyOS_V1.0.1`（2024/12/12 发布）

开发者在配置依赖时，应将 xxx 替换为上方版本明细表中实际的版本号；如需 SPP 升级能力，务必使用 V1.0.1 及以上版本。

兼容性与边界情况

基于版本记录可以归纳出以下注意点（均来自源仓库可验证信息）：

传输方式覆盖差异：V1.0.0 仅发布 OTA 升级（BLE 通道）能力；若产品需要经典蓝牙 SPP 升级，必须升级到 V1.0.1。这是两个版本之间最直接的兼容性边界。
操作系统基线：SDK 要求 HarmonyOS 5.0+（BLE 功能依赖），低于该版本的系统无法保证 BLE 升级链路可用。
硬件适配范围：SDK 面向支持 RCSP OTA 的杰理芯片（AC707N、AC703N、AC701N、AC697N、AC696N、AC695N 等），选用版本前需确认目标产品的芯片在适配列表内。
文档一致性：版本历史同时维护于中文 README、英文 README 与在线文档中心三处；若三处信息出现差异，以在线文档中心 publish_record 页面的官方记录为准。

说明：截至本页撰写时，仓库仅发布了上述两个版本；后续如有新版本发布，README「八、版本历史」章节会同步追加记录。