版本历史与更新日志

本页汇总 Android-JL_Bluetooth（杰理之家 SDK，Android）的版本历史与更新日志：各 SDK 版本的发布日期、更新内容、发布物清单、版本命名规范，以及版本与仓库工程结构的对应关系，帮助集成方快速了解 SDK 演进脉络并选择适配的版本。

Purpose and Scope

本页以仓库根目录 README.md 的「八、版本历史」章节为核心依据，覆盖：

• 版本历史总表：从 2.9.0 到 4.2.0 共 8 个 SDK 版本的发布日期与修改记录；
• 各版本更新内容解读：按版本逐条说明新增、优化与修复项；
• 版本演进时间线：SDK 版本随时间的演进关系；
• 发布物清单与命名规范：apk/、libs/、code/、doc/ 中各发布物与版本号的对应关系；
• 版本配套关系与注意事项：SDK 版本、示例应用版本、AAR 库内部版本号之间的配套关系。

与本页主题相关的其他内容——如 SDK 的快速接入（三、快速开始）、工程结构总览（四、工程结构）、BluetoothOption 配置（五、配置说明）——分别属于各自的目录页面，本页仅在解释版本配套关系时引用，不做展开。英文版更新日志见 README_en.md 的 "8. Version History"。

概述

Android-JL_Bluetooth 是珠海市杰理科技股份有限公司为杰理音箱、耳机类产品提供的蓝牙控制开发平台，基于 RCSP 协议（远程控制系统协议），支持音乐控制、设备设置、文件浏览、闹钟管理、FM 控制、灯光控制、音效调节、按键设置、查找设备、ANC 设置、彩屏仓控制、AI 翻译、自定义命令等能力。

该仓库本身是一个发布型仓库：根目录仅包含 README（中/英）、LICENSE 与发布物目录，不包含 SDK 源码，因此版本历史是集成方了解 SDK 能力变化的主要入口。版本信息在仓库中有三个载体：

SDK 版本号采用语义化的三段式（主版本.次版本.修订号，如 4.2.0），发布节奏大致为：2021 年 2.x 时代，2022 年 3.0.x 时代，2023 年 3.2.0，2025 年起进入 4.x 时代（4.0.0 → 4.1.0 → 4.2.0）。

架构：版本信息在仓库中的组织方式

flowchart TD
    subgraph sg_Repo["Android-JL_Bluetooth 仓库"]
        README["README.md<br/>八、版本历史（更新日志）"]
        BADGE["Tag 徽章<br/>img.shields.io"]
        APK["apk/<br/>btsmart-V1.13.0-...-debug.apk"]
        LIBS["libs/<br/>jl_bluetooth_rcsp_V4.0.0_40015 等 AAR"]
        CODE["code/<br/>PiHome_V1.13.0_SDK_V4.2.0 源码工程"]
        DOC["doc/<br/>JieLi_Home_SDK_V4.2.0_html_zh / _en"]
        PDF["杰理之家SDK(Android)发布记录.pdf"]
    end

    BADGE -->|"点击跳转"| GHTAGS["GitHub Tags 页"]
    README --> APK
    README --> LIBS
    README --> CODE
    README --> DOC
    README --> PDF
    APK --> USERS["集成方 / 开发者"]
    LIBS --> USERS
    CODE --> USERS
    DOC --> USERS
    PDF --> USERS

上图反映了版本信息在仓库中的组织逻辑：README 的「八、版本历史」是唯一的结构化更新日志，它既是发布物的索引（apk/、libs/、code/、doc/ 中所有文件的版本号都能在版本历史表中找到对应关系），也是外部查看最新版本的入口（顶部 Tag 徽章指向 GitHub Tags）。这种"单一来源 + 发布物分散存放"的组织方式，使集成方可以通过一条记录定位到该版本对应的 APK、AAR、源码工程与文档。

版本历史总表

下表完整摘录自 README.md 第 282-293 行：

版本记录来源：README.md（表格逐行对齐原文）；英文镜像见 README_en.md。

值得注意的是，记录从 2.9.0 直接跳至 4.2.0 结束，中间（2.9.1 至 4.1.0）并非按季度发布，而是由功能里程碑驱动：2025 年 4 月起 3 个月内连续发布 4.0.0、4.1.0，半年后发布 4.2.0，说明 4.x 是当前活跃的迭代主线。

各版本更新内容解读

4.2.0（2026/01/21）—— LE Audio 与 AI 翻译主线

当前最新版本，更新量最大，围绕新一代音频技术展开：

• LE Audio 与 RCSP 并存：在保持 RCSP 协议控制通道的同时支持 LE Audio 音频通道，为后续 Auracast 等广播场景打基础；
• AI 翻译功能：README 概述中列出的录音翻译、面对面翻译、音视频翻译、通话翻译在此版本落地；
• Auracast Broadcast 功能：支持 Auracast 广播接收，适配 Auracast 音箱等产品形态；
• Gatt Over BR/EDR 连接方式：新增基于经典蓝牙（BR/EDR）承载 GATT 的连接方式，扩展了双模设备的接入路径；
• Android 15 兼容处理：延续每个大版本适配新 Android 系统的惯例（对比 4.0.0 的 Android 14 适配）；
• 彩屏仓本地资源修改：修复彩屏仓相关本地资源问题。

配套发布物：示例应用工程 PiHome_V1.13.0_SDK_V4.2.0、测试 APK btsmart-V1.13.0-202601231637-113126-debug.apk、中英文开发文档 JieLi_Home_SDK_V4.2.0_html_zh / _en（见 README.md 工程结构）。

4.1.0（2025/07/18）—— 彩屏仓扩展

聚焦彩屏仓（带屏充电仓）产品线的 SDK 能力扩充，全部围绕 701N 和 707N 两款芯片平台：屏幕亮度控制、屏幕保护程序控制、天气同步、消息同步。该版本与硬件平台强绑定——彩屏仓功能依赖 AC701N / AC707N 芯片的固件支持（README「二、运行环境」中列出的硬件要求为 AC701N、AC707N、AC697N、AC696N、AC695N 等）。

4.0.0（2025/04/15）—— 架构重构基线

• 分离蓝牙实现和 RCSP 功能实现：这是 4.x 最重要的架构变更，将底层蓝牙通信（BLE/SPP）与 RCSP 命令功能解耦，使 SDK 可以独立演进蓝牙层与协议层；
• 优化 SDK 日志输出：呼应 README「六、调试技巧」中"SDK 提供详细的日志输出"；
• 优化文件浏览功能：改善 SD 卡、U 盘等存储器的文件列表浏览体验；
• 增加 Android 14 兼容处理：适配 Android 14 的蓝牙权限（BLUETOOTH_SCAN / BLUETOOTH_CONNECT）与运行时权限要求。

3.2.0（2023/11/23）—— TWS 一拖二

新增 TWS 耳机一拖二（一台手机同时连接两只耳机）功能与接口，并修复已知问题。这是 3.x 的最后一个版本，此后进入长时间的 4.x 重构期。

3.0.8（2022/08/12）—— 辅听耳机验配

新增辅听耳机（助听类产品）的验配功能，扩展耳机类产品覆盖范围。

3.0.7（2022/07/20）—— 挂脖耳机 UI

增加挂脖耳机（颈挂式耳机）的 UI 支持，丰富耳机产品形态。

2.9.1（2021/08/25）—— 兼容性修复

修复手机兼容性问题，属于稳定性维护版本。

2.9.0（2021/05/18）—— 首个记录版本

增加音箱 SDK 的闹钟贪睡模式、耳机 SDK 的主动降噪（ANC）设置功能。作为记录中的最早版本，它确立了"音箱 + 耳机"双产品线并行的 SDK 形态，此后的 2.9.1 至 4.x 均在此基础上扩展。

版本演进时间线

flowchart LR
    V2090["2.9.0<br/>2021/05<br/>闹钟贪睡 + ANC 设置"] --> V291["2.9.1<br/>2021/08<br/>手机兼容性修复"]
    V291 --> V307["3.0.7<br/>2022/07<br/>挂脖耳机 UI"]
    V307 --> V308["3.0.8<br/>2022/08<br/>辅听耳机验配"]
    V308 --> V320["3.2.0<br/>2023/11<br/>TWS 一拖二"]
    V320 --> V400["4.0.0<br/>2025/04<br/>蓝牙/RCSP 分离 + Android 14"]
    V400 --> V410["4.1.0<br/>2025/07<br/>彩屏仓 SDK（701N/707N）"]
    V410 --> V420["4.2.0<br/>2026/01<br/>LE Audio + AI 翻译 + Auracast"]

时间线揭示了三个演进阶段：

1. 功能扩展期（2021-2023，2.x → 3.x）：以单点功能扩充为主（ANC、贪睡、UI、验配、一拖二），版本节奏稳定；
2. 架构重构期（2024-2025，4.0.0）：蓝牙层与 RCSP 功能层解耦，为后续多协议并存做架构准备；
3. 新技术融合期（2025-2026，4.1.0 → 4.2.0）：彩屏仓生态、LE Audio、Auracast、AI 翻译等新能力密集落地，同时同步跟进 Android 系统版本（14 → 15）兼容。

对集成方的启示：若项目需要 LE Audio / AI 翻译 / Auracast 等能力，应直接基于 4.2.0 接入；若仅需基础蓝牙控制且对 Android 版本要求较低，3.2.0 仍可作为稳定基线，但不再有新功能演进。

版本与发布物映射

仓库中每个发布物都携带独立的版本号，且与 SDK 版本（4.2.0）构成一套配套关系。下表整理自 README.md「四、工程结构」：

flowchart TD
    subgraph sg_SDK420["SDK 4.2.0（2026/01/21）"]
        PIHOME["code/<br/>PiHome_V1.13.0_SDK_V4.2.0"]
        APK420["apk/<br/>btsmart-V1.13.0-202601231637-113126-debug.apk"]
        DOC420["doc/<br/>JieLi_Home_SDK_V4.2.0_html_zh/en"]
        LIBRCSP["jl_bluetooth_rcsp_V4.0.0_40015"]
        LIBOTA["jl_bt_ota_V1.10.0_10931"]
        LIBDEC["jldecryption_v0.4"]
    end
    PIHOME -->|"编译依赖"| LIBRCSP
    PIHOME -->|"编译依赖"| LIBOTA
    PIHOME -->|"编译依赖"| LIBDEC
    APK420 -->|"运行验证"| PIHOME
    DOC420 -->|"配套说明"| PIHOME

上图说明：SDK 版本号（4.2.0）与各 AAR 库的版本号是两套独立的编号体系。RCSP 核心库自身版本为 4.0.0（内部构建号 40015），OTA 库为 1.10.0，加解密库为 0.4——这些 AAR 的版本由各库独立演进，而 SDK 4.2.0 表示的是"这一整套配套发布物组合"的版本。集成方在升级时务必整体替换 libs/ 目录下的 AAR 集合，并同步升级示例工程与文档，避免混用不同 SDK 版本的 AAR 导致协议不匹配。

发布物命名规范

AAR 库命名

格式为 库名_V主版本.次版本.修订号_内部构建号-release.aar，例如：

• jl_bluetooth_rcsp_V4.0.0_40015-release.aar：库名 jl_bluetooth_rcsp，版本 4.0.0，构建号 40015；
• jl_bt_ota_V1.10.0_10931-release.aar：库名 jl_bt_ota，版本 1.10.0，构建号 10931；
• jl_eq_V1.1.0_10101-release.aar：库名 jl_eq，版本 1.1.0，构建号 10101。

README 在「3.3 添加依赖库」中明确指出 xxx 为版本号（README.md 第 104 行），集成方需按实际下载的 AAR 版本号替换 Vxxx。

APK 命名

格式为 应用名-应用版本-构建时间戳-构建号-构建类型.apk，例如 btsmart-V1.13.0-202601231637-113126-debug.apk 表示：杰理之家（btsmart）应用版本 1.13.0，构建时间 2026/01/23 16:37，构建号 113126，debug 类型。该 APK 位于 apk/ 目录，用于快速体验 SDK 功能（见 README.md 第 152-155 行）。

版本发布与集成核心流程

flowchart TD
    Start([发布新 SDK 版本]) --> Record["在 README「八、版本历史」新增一行<br/>版本号 + 日期 + 修改记录"]
    Record --> Artifacts["同步更新发布物<br/>apk / libs / code / doc"]
    Artifacts --> Tag["更新 GitHub Tag（徽章自动显示）"]
    Artifacts --> PDF["更新发布记录 PDF"]
    Tag --> Integrate["集成方按版本整体接入"]
    Integrate --> Check{"协议/版本匹配？"}
    Check -->|"是"| Done([运行正常])
    Check -->|"否"| Fix["核对 libs 目录 AAR 版本配套<br/>对照版本历史表选择正确基线"]
    Fix --> Integrate

该流程解释了集成方遇到问题时如何定位：先确认自己的 SDK 版本是否能在版本历史总表中找到，再核对 libs/ 下各 AAR 是否与该版本配套发布物一致。由于 README 是版本历史的唯一权威来源，任何版本疑问都应先回到该表核对。

使用示例

示例一：按版本添加 AAR 依赖

集成方需要按所选择 SDK 版本的配套 AAR 集合配置 build.gradle。以下片段来自 README.md「3.3 添加依赖库」：

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

	implementation 'com.google.code.gson:gson:2.13.1'
}

Source: README.md

这段配置通过 fileTree(include: ['*.aar'], dir: 'libs') 将 libs/ 目录下的全部 AAR 一次性引入工程。设计意图：杰理 SDK 以"版本配套 AAR 集合"的形式分发，整体引入可避免逐个声明时漏掉某个配套库（如 OTA 库、加解密库），从而降低因库缺失导致的协议功能不可用风险。

示例二：按版本核对工程结构与发布物

以 4.2.0 为例，仓库工程结构如下（摘自 README.md「四、工程结构」）：

Android-JL_Bluetooth/
├── apk/                                     # 测试APK文件夹
│   ├── btsmart-V1.13.0-202601231637-113126-debug.apk    # 杰理之家测试版本
│   ├── UpdateContent.txt                                # 更新说明
│   └── 杰理之家导出打印日志说明.pdf                          # 杰理之家APP导出打印日志说明
├── code/                                    # 参考源码工程文件夹
│   ├── PiHome_V1.13.0_SDK_V4.2.0                        # 杰理之家项目源码
│   └── 杰理音频编解码库开发资料_V2.1.0_Android               # 杰理音频编解码开发资料(OPUS)
├── doc/                                     # 开发文档文件夹
│   ├── JieLi_Home_SDK_V4.2.0_html_zh                    # 杰理之家SDK开发说明文档(中文版本)
│   ├── JieLi_Home_SDK_V4.2.0_html_en                    # 杰理之家SDK开发说明文档(英文版本)
│   ├── 杰理开放平台接入说明文档.pdf                          # 接入杰理之家服务器的说明文档
│   ├── 杰理之家APP用户手册V1.2.pdf                         # 杰理之家的操作说明文档
│   ├── 杰理OTA(Android)在线开发文档                        # OTA库的开发说明文档
│   ├── 杰理之家SDK(Android)开发文档                        # 杰理之家SDK开发说明文档(线上版)
│   ├── 杰理音频编码库开发说明.pdf                           # 杰理OPUS编解码开发说明文档
│   └── JLA_V2编解码库开发说明.pdf                          # 杰理JLA_V2编解码开发说明文档
├── libs/                                    # 核心库文件夹
│   ├── jl_bt_ota_V1.10.0_10931-release.aar              # 杰理OTA相关
│   ├── jl_bluetooth_rcsp_V4.0.0_40015-release.aar       # 杰理之家SDK相关
│   ├── jldecryption_v0.4-release.aar                    # 加密解密相关
│   ├── BmpConvert_V1.6.0_10604-release.aar              # 转码静态图片(png,jpeg,bmp等)
│   ├── GifConvert_V1.3.0_42-release.aar                 # 转码Gif(动态图片)
│   ├── jl_eq_V1.1.0_10101-release.aar                   # 杰理均衡器曲线算法库
│   ├── jl_audio_decode_V2.1.0_20012-release.aar         # 杰理OPUS编解码库
│   └── jl_audio_v2_V1.0.0_9-release.aar                 # 杰理JLA_V2编解码库
├── 杰理之家SDK(Android)发布记录.pdf            # SDK发布记录
└── ReadMe.txt                               # 说明文件

Source: README.md

该结构是"按版本成套发布"的直接体现：code/ 中的工程名、doc/ 中的文档名、apk/ 中的 APK 时间戳均与 4.2.0 版本（2026/01/21）对应，而 libs/ 中的 AAR 保持各自独立版本号。设计意图：将"SDK 版本"与"底层库版本"解耦，让 OTA、编解码、图片转换等通用库可以独立于主 SDK 迭代，同时通过"成套发布"保证集成方拿到的是经过联调的版本组合。

示例三：英文版更新日志对照

英文 README 的版本历史位于 "8. Version History" 章节，与中文版内容对应（README_en.md）。对外集成团队可对照中英文两个版本确认更新细节，避免语言理解偏差。

版本维护与注意事项

版本配套关系（最容易踩的坑）

• SDK 版本 ≠ AAR 库版本：SDK 4.2.0 对应的 RCSP 核心库是 jl_bluetooth_rcsp_V4.0.0_40015-release.aar（4.0.0），两者版本号不同步。升级时必须按版本与发布物映射整体替换 AAR 集合；
• 示例应用版本独立：示例工程 PiHome_V1.13.0 的 1.13.0 是应用自身的版本号，与 SDK 4.2.0 无关，但两者成套发布；
• 混用风险：若只更新 jl_bluetooth_rcsp 而不更新 OTA 库或加解密库，可能出现协议版本不匹配导致的命令失败。README 未提供 AAR 版本兼容矩阵，因此官方建议是整体替换。

硬件与系统版本依赖

• 彩屏仓功能依赖芯片平台：4.1.0 的屏幕亮度、屏保、天气、消息同步等功能仅支持 701N/707N 彩屏仓（见 README.md「二、运行环境」），选用前需确认硬件平台；
• Android 系统兼容按版本演进：4.0.0 增加 Android 14 兼容，4.2.0 增加 Android 15 兼容。高版本 Android 需要声明 BLUETOOTH_SCAN / BLUETOOTH_CONNECT 权限（见 README.md 第 129-131 行），低版本 SDK（3.x 及以下）在高版本系统上的行为未被官方文档覆盖，属于已知边界；
• 最低系统要求：Android 5.1+（支持 BLE 功能），低于该版本无法使用 SDK。

设备认证开关

README「5.1 SDK 配置」中 setUseDeviceAuth(true) 默认开启设备认证，并注明"与固件工程师确认"（README.md 第 195 行）。设备认证行为与固件版本强相关，固件升级后若认证失败，需先核对固件与 SDK 的配套版本，再排查 SDK 版本问题。

其他边界情况

• Tag 徽章指向 GitHub：README 顶部的 Tag 徽章链接到 GitHub Tags 页，而本仓库在 Gitee 镜像维护，两者版本可能短暂不同步，以 README 版本历史表为准；
• 更新记录粒度：版本历史表只记录重大变更，未列出全部修复明细；更细粒度的历史归档在根目录 杰理之家SDK(Android)发布记录.pdf 与 apk/UpdateContent.txt 中；
• 并发升级场景：多人同时升级时，建议以 README 版本历史表为唯一事实来源，统一各模块使用的 SDK 版本，避免 libs/ 目录下 AAR 集合被部分覆盖。

相关链接

• README.md（中文） —— 版本历史表与全部发布物说明的权威来源
• README_en.md（英文） —— 英文版概述与 "8. Version History"
• 杰理之家 SDK 在线文档中心 —— SDK 开发文档（与版本同步更新）
• 杰理之家 SDK(Android) 发布记录.pdf发布记录.pdf) —— 官方发布记录归档（仓库根目录）
• apk/UpdateContent.txt —— 测试 APK 的更新说明
• GitHub Tags —— 仓库版本 Tag 列表（README 徽章指向）
• LICENSE —— Apache License 2.0 开源协议