更新记录

2.0.3（2026-08-11）

• 整包接入 keeplive-framework（Fw）
• KeepLive API 对齐市场保活插件用法
• 本地 Java11 兼容 AAR，规避 Jetifier Java21 失败
• compliant / fw / experimental 三档 profile

平台兼容性

uni-app

uni-app x(4.27)

x-keepalive

uni-app x Android 后台守护插件。自 2.0.0 起整包接入 KeepLiveService / Fw，并提供接近 DCloud #20316 android-keeplive 的 KeepLive API。

保活不是“不死”。系统内存回收、Doze、厂商策略和用户强制停止都拥有最终决定权。整包 Fw 会合并大量权限、组件与 Native so，上架前请自行裁剪与说明。

平台

• Android 7.0+（API 24+，与 Fw 一致）
• iOS / Web / Harmony：不支持（stub 返回 9050003）
• 依赖或原生代码变更后必须重新制作自定义调试基座

依赖

Fw 使用本地 AAR（勿删）：

uni_modules/x-keepalive/utssdk/app-android/libs/keeplive-framework-2.0.1.aar

官方 Maven 包为 Java 21，会触发 HBuilderX Jetifier Unsupported class file major version 65；本地包已降为 Java 11 兼容字节码。详见 THIRD_PARTY.md。

KeepLive（推荐，对齐 #20316 用法）

// #ifdef APP-ANDROID
import { KeepLive } from '@/uni_modules/x-keepalive'

const keep = new KeepLive()
keep.setTitle('保活中')
keep.setContent('后台任务运行中')
keep.setChannelId('x_keepalive_fw')
keep.setChannelName('后台任务')
keep.setBackgroundMusicEnabled(true)
keep.register()

console.log(keep.isRunning())
console.log(keep.getLiveStr())

keep.goKeepLiveSetting()
keep.startHighBattery()
keep.unregister()
// #endif

可用 Compat 回调：

• onOpenNotificationSettingCompat
• onAddBackgroundCallbackCompat
• onAddScrrenListenerCallbackCompat（兼容官方拼写）
• onAddNotificationClickListenerCompat

函数式诊断 API

import {
  start,
  stop,
  KeepAliveStartOptions,
  KeepAliveStatus
} from '@/uni_modules/x-keepalive'

start({
  profile: 'fw',
  notificationTitle: '设备监控',
  notificationContent: '监控服务正在运行',
  fw: {
    enableNativeDaemon: true,
    enableForceStopResistance: false
  },
  success: (status : KeepAliveStatus) => {
    console.log(status.state, status.engine)
  }
} as KeepAliveStartOptions)

模式

API 一览

函数式：start / stop / restart / getStatus / checkHealth / getCapabilities / openBatterySettings / openAutoStartSettings / requestNotificationPermission / onStatusChange / offStatusChange / isSupported / getPluginVersion

KeepLive：register / unregister / restart / isRunning / getLiveTime / getLiveStr / 通知与渠道设置 / WakeLock / WifiLock / 厂商与电池设置 / Compat 监听

全量 Fw 开关见 KeepAliveFwOptions（interface.uts）。

Demo

pages/keepalive/keepalive — KeepLive + 函数式 API + 策略诊断。

风险与边界

1. AAR 合并权限含蓝牙、NFC、账户同步、精确闹钟、存储、联系人、短信、悬浮窗等；按商店政策裁剪。
2. VPN / DeviceAdmin / 防强停默认关闭，需显式打开。
3. 用户「强制停止」后不应宣称自动复活。
4. Google Play 对 FGS type / 特殊权限审核严格；国内商店策略因厂商而异。
5. 研究文档：RESEARCH.md

错误码