更新记录

0.9.0（2026-11-12）

Android：持续定位、BLE 通信、前台任务管理、有界缓存、统一事件；附经典 RFCOMM 客户端预览源码。
iOS 14+：持续定位、BLE 通信、标准电量监测、当前耳机音频路由观察和组合启动源码。
提供 Vue 2 / Vue 3 示例。双 Vue 原生基座、真实外设及设备稳定性待验收。

平台兼容性

uni-app(5.26)

Vue2	Vue2插件版本	Vue3	Vue3插件版本	Chrome	Safari	app-vue	app-vue插件版本	app-nvue	Android	Android插件版本	iOS	iOS插件版本	鸿蒙
√	0.9.0	√	0.9.0	×	×	√	0.9.0	×	14.0	0.9.0	14	0.9.0	×

微信小程序	支付宝小程序	抖音小程序	百度小程序	快手小程序	京东小程序	鸿蒙元服务	QQ小程序	飞书小程序	小红书小程序	快应用-华为	快应用-联盟
×	×	×	×	×	×	×	×	×	×	×	×

keeplive 持续定位与 BLE

0.9.0 源码预览版，尚未完成原生基座及真机验收。 面向 uni-app Vue 2 / Vue 3 的 App 项目。Android 8.0（API 26）和 iOS 14.0 是源码最低目标；Web、小程序、鸿蒙不提供这些功能，uni-app x 不在本次交付范围。

能力	Android	iOS
持续定位	原生定位、质量过滤、内存缓存、共享前台服务	Core Location，前台主动启动后可在系统允许时继续采集
BLE	扫描、单连接、服务发现、读写、订阅、MTU、有限重连	同类通信入口；使用 Peripheral UUID，不能主动协商 MTU；后台扫描需要服务 UUID 过滤
配套	统一事件、缓存确认、组合启动；经典 RFCOMM 源码待 SPP 外设验证	统一事件、缓存确认、组合启动、标准 BAS 电量与低电提醒；耳机仅观察当前音频路由；无通用 RFCOMM

位置以 WGS-84 返回，采样频率和精度受系统与环境影响。系统暂停、用户强制关闭 App 或权限撤销会影响任务，不承诺永久保活。写入成功的完成层级由接口返回，设备协议 ACK 由宿主处理。设备私有协议不包含在插件中。

接入

将本模块放入宿主项目的 uni_modules/zhaoyx-keeplive，在 HBuilderX 中以独立的 uni-app 项目打开。工具基线为 HBuilderX 5.26，原生代码或权限配置变化后重新制作自定义调试基座。
Android 核对合并后的 Manifest、前台服务类型及通知配置。iOS 配置有效签名，核对定位/蓝牙用途说明及 location、bluetooth-central 后台模式。宿主按实际业务修改用途说明。
在可见页面分步执行初始化、权限申请与开始；等待系统授权弹窗结束并返回前台。切页时注销页面订阅，用户结束任务时调用对应停止 API 或 stop。

import {
  initialize, requestLocationPermission, startLocation, stop
} from '@/uni_modules/zhaoyx-keeplive'

// 按钮依次调用，检查每一步回调的 result.ok / result.error。
initialize({ notificationTitle: '路线记录', notificationContent: '定位任务运行中' }, showResult)
requestLocationPermission({ precise: true }, showResult)
startLocation({ intervalMs: 1000, minDistanceMeters: 0, accuracy: 'high' }, showResult)
// 用户点击“停止全部”时调用：
stop(showResult)

showResult 由宿主实现。BLE 接入顺序：requestBlePermissions → startBleScan → getBleScanResults → connectBle → getBleServices，再按实际服务和特征调用读、写或订阅。参数类型见随包 utssdk/interface.uts，完整 API 与双 Vue 示例在项目仓库。

数据和权限

插件不含广告，没有上传服务器。用户开启功能后，位置、设备标识、通信数据和可用电量等在本机处理；业务缓存位于内存。Android 保存必要运行配置、运行意愿及脱敏诊断。Android 使用定位、蓝牙/附近设备、通知、相应前台服务及音频设置权限；iOS 使用“使用 App 期间”定位、蓝牙和低电提醒所需通知授权。宿主应说明实际用途，并独立披露自身的数据处理行为。

当前 Android 与 iOS 均缺少双 Vue 原生基座及完整真机验收。iOS 尚无 Apple SDK 编译证据。联合编译、模拟器、H5 或 UTS 转换记录不能替代这些检查。