更新记录

1.2（2021-12-16）

1、解决uniapp iOS端蓝牙DFU固件升级

平台兼容性

原生插件通用使用流程：

1. 购买插件，选择该插件绑定的项目。
2. 在HBuilderX里找到项目，在manifest的app原生插件配置中勾选模块，如需要填写参数则参考插件作者的文档添加。
3. 根据插件作者的提供的文档开发代码，在代码中引用插件，调用插件功能。
4. 打包自定义基座，选择插件，得到自定义基座，然后运行时选择自定义基座，进行log输出测试。
5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项：使用HBuilderX2.7.14以下版本，如果同一插件且同一appid下购买并绑定了多个包名，提交云打包界面提示包名绑定不一致时，需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择

升级方法

/// 同步方法
- (void)startDfuUpdate:(NSDictionary *)dic;

/// dic为入参，map类型，其中key-value如下
key1: "mac" ----  value1: "设备的mac地址" // 低功耗蓝牙必传，因为低功耗蓝牙不能直接在iOS设备的蓝牙列表中连接，需要通过mac地址查询到设备
key2: "deviceName" ---- value2: "设备名称" // 如果可以在iOS设备的蓝牙列表中连接，
key3: "updatePath" ---- value3: "升级资料zip压缩文件所在路径" // 升级文件所在路径，需要绝对路径，uniapp相对路径转绝对路径参考：https://blog.csdn.net/weixin_45432615/article/details/111040035?utm_medium=distribute.pc_aggpage_search_result.none-task-blog-2~aggregatepage~first_rank_ecpm_v1~rank_v31_ecpm-1-111040035.pc_agg_new_rank&utm_term=uniapp+绝对路径&spm=1000.2123.3001.4430

uni调用iOS端同步方法参考官方文档

全局回调监听事件

事件名："dfuEvent"

回调参数类型为map类型，其中key-value如下
key1: "type" ----  value1: "升级状态"
key2: "value" ---- value2: 升级进度，类型为int
key3: "msg" ---- value3: "提示信息"

type升级状态具体内容如下：
升级开始："startingDfuProcess"
升级中："dfuUpdating"
升级成功："dfuCompleted"
升级失败： "dfuUpdateError"

package

1、Package.json中配置了iOS插件所需信息

2、将ios文件夹拖到项目的Dcloud-dfu目录下，ios文件夹中是iOS插件与其依赖库

3、本插件只支持iOS真机设备，不支持模拟器

iOS全限制问题

iOS主工程需要配置蓝牙权限，教程：iOS开发 info.plist访问权限配置