智能穿戴设备（智能手环/手表）市场近年来快速增长，但硬件厂商普遍面临一个痛点：为了给用户提供App，需要组建独立的移动端开发团队，且往往需要同时维护Android和iOS两个原生App，成本高、迭代慢。更棘手的是，当同一套硬件方案卖给多个品牌客户时，每个客户都要求定制自己的App，导致厂商需要为每个客户重复开发相似功能。本项目立项源于一家智能穿戴方案商的真实需求：将已上线的成熟健康管理App中的全部设备通信能力（BLE协议、健康数据解析、设备控制、OTA升级等）抽取出来，封装成一套可复用的SDK，让客户无论使用Flutter、Android原生还是iOS原生开发，都能快速集成设备控制能力，只需专注做UI和业务定制，大幅降低客户接入成本和厂商的交付成本。
DeepFit Health SDK是一套面向智能穿戴设备的跨平台通信中间件，支持三种集成方式（Flutter源码引用、Android FlutterEngine嵌入、iOS FlutterEngine嵌入），为宿主App提供完整的设备控制能力：
1. BLE设备发现与连接管理：支持扫描附近蓝牙设备、设备过滤、建立GATT连接、绑定/解绑、自动重连、连接状态监听等。
2. 健康数据采集与解析：支持心率、睡眠、血压、血氧、血糖、血脂、尿酸、体温、微体检、运动步数、设备校准等12类健康数据的协议解析（真实字节流协议，含CRC16校验与ACK确认），解析结果以统一数据模型返回。
3. 设备设置与控制：支持闹钟管理、吃药提醒、久坐提醒、喝水提醒、通讯录同步、SOS紧急联系人、表盘切换、勿扰模式、功能列表开关、单位设置等20+设备端功能控制。
4. 主动测量能力：支持通过App发起血压/血氧/血糖/体温/尿酸/血脂等主动测量指令，并实时接收测量结果。
5. ECG心电测量与运动心率：支持ECG数据采集与心率变异性分析、运动模式下实时心率监测。
6. OTA固件升级：集成Realtek OTA SDK（8773e芯片），支持Android Java和iOS Objective-C双端实现，提供固件版本检测、升级包下载、升级进度回调、断点续传能力。
7. 网络层与离线缓存：基于Dio网络库实现SM2/AES混合加密传输+Token自动注入，支持请求失败自动存储、网络恢复后数据合并重试。
8. 通知监听与转发：支持来电/短信/微信/QQ等手机通知的识别与转发至设备端。
本人作为核心开发/迁移负责人，独立完成App→SDK的架构抽取、UI依赖剥离、三端桥接及交付验收。
技术栈：
- Dart/Flutter（SDK核心层、Flutter宿主集成层）
- Kotlin/Java（Android桥接层 + FlutterEngine嵌入封装）
- Swift/Objective-C（iOS桥接层 + FlutterEngine嵌入封装）
- BLE：CoreBluetooth（iOS）+ BluetoothGatt（Android）+ flutter_blue（Flutter层）
- 网络：Dio + SM2/AES混合加密
- OTA：Realtek SDK（8773e芯片）
- 测试：Robolectric/JUnit（Android）+ XCTest（iOS）
架构设计要点：
- SDK采用双模式架构（源码引用模式/Engine嵌入模式），通过DeepFitSdk单例入口统一对外API，SdkResult统一返回模型。
- 关键架构改造：将原App中30+依赖UI状态（Provider/ChangeNotifier）全部重构为StreamController+Stream数据流，支持跨Isolate和跨Engine通信，彻底消除UI依赖，宿主可按需集成纯通信能力。
- 三端通信设计统一的MethodChannel契约规范（60+方法名、20+事件名），设计三端一致的SdkErrorCodes错误码体系（Dart/Android/iOS各一份枚举定义保证值一一对应），确保跨端行为可预期。
- 通信协议层设计了基于seqId的请求-回调精确匹配机制与超时管理，重构requestId状态机解决跨命令串扰和回调悬挂等P0/P1缺陷；OTA模块将UI与核心逻辑分离，离线模块按SdkConfig可选启用。
- 交付阶段建立“测试源码+checksum全量校验+47项对抗性验收”可复现流水线，三轮客户独立复验最终Characterization 30/30、Acceptance 47/47全绿通过。
评论