Flutter 鸿蒙化实战flutter_blue_plus 适配 OpenHarmony前言随着鸿蒙生态的快速发展越来越多的 Flutter 应用需要适配 OpenHarmony 平台。但生态早期大量常用三方库只有 Android / iOS 实现鸿蒙侧只能自己造轮子。为了解决这个问题CPF-Flutter 社区对一批高频使用的 Flutter 三方库做了 OpenHarmony 平台适配统一托管在 GitCode 的 CPF-Flutter 组织 下全部通过 TAG 版本隔离、配套门禁编译验证开箱即用。本篇是系列文章之一主角是flutter_blue_plus—— 蓝牙扫码、连接与数据读写的核心插件。flutter_blue_plus 是什么flutter_blue_plus 是 Flutter 社区最主流的 BLE 蓝牙插件鸿蒙版与上游 API 高度对齐覆盖设备扫描startScan/onScanResults/scanResults扫描周边 BLE 设备连接管理connect/disconnect/connectionState连接与状态监听GATT 服务discoverServices、read/write/setNotifyValue读写特征值适配器控制turnOn/turnOff/adapterState、isSupported等。单个库即可支撑蓝牙手环、体脂秤、智能门锁等 IoT 设备的连接与数据交换。适配情况Flutter 框架版本TAG 名称分支名3.71.33.5-ohos-1.0.0br_v1.33.5_ohos3.221.33.5-ohos-1.0.0br_v1.33.5_ohos3.272.1.0-ohos-1.0.0br_v2.1.0_ohos3.352.1.0-ohos-1.0.0br_v2.1.0_ohos说明3.7 / 3.22 对应原库 1.33.5TAG1.33.5-ohos-1.0.03.27 / 3.35 对应原库 2.1.0TAG2.1.0-ohos-1.0.0。快速接入在 pubspec.yaml 中添加 git 依赖dependencies:flutter_blue_plus:git:url:https://gitcode.com/CPF-Flutter/fluttertpc_flutter_blue_plus.git# 按你的 Flutter 框架版本从上方映射表选择对应 TAGref:2.1.0-ohos-1.0.0执行flutter pub get使用示例importpackage:flutter_blue_plus/flutter_blue_plus.dart;// 检查设备是否支持蓝牙bool supportedawaitFlutterBluePlus.isSupported;// 扫描周边 BLE 设备ListScanResultresultsawaitFlutterBluePlus.startScan(timeout:Duration(seconds:10));// 连接设备awaitFlutterBluePlus.connect(results.first.device);// 发现 GATT 服务ListBluetoothServiceservicesawaitresults.first.device.discoverServices();// 读写特征值BluetoothCharacteristiccharacteristicservices.first.characteristics.first;awaitcharacteristic.write([0x01]);finalvalueawaitcharacteristic.read();API 支持一览API说明ohos 支持isSupported检查设备是否支持蓝牙yesadapterState / turnOn / turnOff蓝牙适配器状态与开关yesstartScan / stopScan / scanResults扫描周边 BLE 设备yesconnect / disconnect / isConnected连接 / 断开设备yesdiscoverServices发现 GATT 服务yesread / write / setNotifyValue读写特征值 / 订阅通知yesremoveBond删除设备配对对应移除配对no[!TIP] 本库为鸿蒙原生 BLE 适配与上游 API 高度对齐removeBond在鸿蒙平台暂不支持返回错误语义为仅 Android。仓库地址OpenHarmony 适配仓库https://gitcode.com/CPF-Flutter/fluttertpc_flutter_blue_plus使用问题反馈请到 CPF-Flutter 社区 Issues 提交问题社区统一收集跟进本仓库 Issues 区亦可。系列预告截至目前CPF-Flutter 社区已完成250 个Flutter 三方库的 OpenHarmony 平台适配覆盖权限管理、UI 组件、设备信息、位置服务、媒体处理、网络、支付等多个领域完整的适配清单含每个库的版本映射表见适配总览文档https://gitcode.com/CPF-Flutter/docs/blob/main/ThirdpartyLibrarites.md仓库组织https://gitcode.com/CPF-Flutter本系列后续会陆续挑选高频库展开讲解比如视频压缩VideoCompress、应用升级r_upgrade、二维码扫描qr_code_scanner等。如果你的 Flutter 应用正在计划适配鸿蒙欢迎关注 CPF-Flutter 组织也欢迎参与共建。