更新记录

1.0.1（2026-11-07）

无

1.0.0（2026-11-07）

• 使用 UTS 与 Kotlin、Swift 混编直接调用点阵笔厂商 SDK，移除旧原生插件桥接依赖。
• 提供 Wi-Fi 名称、设备扫描和配网结果回调，以及配网超时和资源释放处理。
• 补齐 HBuilderX 5.34 插件清单、平台兼容性及权限说明。

当前已完成本地资源编译与原生代码检查，完整云打包和真机配网仍待验证。

平台兼容性

uni-app(5.21)

uni-app x(5.21)

其他

点阵笔蓝牙配网 UTS 插件

适用于现有 uni-app App 项目，通过 UTS 与 Kotlin、Swift 混编直接访问厂商配网 SDK。无需 nativeplugins/UW-BluetoothPlugin 或 uni.requireNativePlugin。

调用

import * as bluetoothModule from '@/uni_modules/uw-bluetooth';

bluetoothModule.penResultCallback(result => {
  uni.hideLoading();
  uni.showToast({ title: result.result, icon: result.code === 0 ? 'success' : 'none' });
});
bluetoothModule.penNameCallback(name => { /* 保存搜索到的设备名称 */ });
bluetoothModule.wifiNameCallback(ssid => { /* 保存真实 SSID，空字符串表示读取失败 */ });

连接接口为 startTransmitWith({ wifiName, pwd, ip, port, path, timeout })。port 和 timeout 为字符串；页面卸载时调用 release()。先注册设备及结果回调，再注册 Wi-Fi 回调以启动初始化。错误通过结果回调返回，保留历史 resurlt 与 result 字段，统一数字 code。

原生依赖和权限

• Android：utssdk/app-android/libs/afpensdk-wifiset-release.aar，由 UTS 自动收集。不要将本地文件路径填入 config.json.dependencies。不再包含旧 uniplugin_afpen-release.aar。
• iOS：utssdk/app-ios/Frameworks/AFPenSDK_Wifiset.framework；不再包含旧 UWBluetoothPlugin.framework。原始 SDK 缺少公开头文件及 module map，当前仅为已核对的配网 API 补充声明，后续更换 SDK 时需与厂商头文件核对。
• Android 需定位以及 Android 12+ 蓝牙扫描、连接权限；iOS 需蓝牙、定位授权及 Wi-Fi Information entitlement。Info.plist、UTS.entitlements 均在插件内提供。
• iOS 描述文件必须包含 com.apple.developer.networking.wifi-info。系统无法读取 SSID 时显示真实失败原因，页面可手动输入 Wi-Fi 名称。

修改原生插件后，需要重新制作自定义基座或打完整安装包。WGT 无法安装新增的原生 SDK。厂商 iOS 库目前仅有 arm64 真机架构，不能用于 iOS 模拟器。

验证时需分别检查 UTS 转译和原生编译，并在真机检查授权、搜索、配网成功和错误回调。