更新记录
1.5(2024-10-26)
解决targetSdkVersion适配问题
1.4(2024-05-07)
优化部分机型适配问题
1.3(2023-12-04)
优化通知
查看更多平台兼容性
Android | Android CPU类型 | iOS |
---|---|---|
适用版本区间:4.4 - 14.0 | armeabi-v7a:支持,arm64-v8a:支持,x86:支持 | × |
原生插件通用使用流程:
- 购买插件,选择该插件绑定的项目。
- 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
- 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
- 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
- 开发完毕后正式云打包
付费原生插件目前不支持离线打包。
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原生插件配置”->”云端插件“列表中删除该插件重新选择
安卓保活套装(通用保活、常驻通知、电池优化、自启管理等) Ba-KeepAliveSuit
简介
Ba-KeepAliveSuit 是一款android原生保活套装插件,支持市面上大部分机型,Android4.4到Android13.0 (注意:不保证支持所有机型和场景,建议先试用测试完整后,再购买)。
可解决定位、推送、websocket、定时任务、蓝牙、聊天等保活问题。
Ba-KeepAliveSuit在Ba-KeepAlive的基础上,新增了忽略电池优化、自启管理、常驻通知等等。
有建议和需要,请联系QQ:2579546054
也可关注博客,实时更新最新插件:
使用方法
在 script
中引入组件
const keepAlive = uni.requireNativePlugin('Ba-KeepAliveSuit')
在 script
中调用
methods: {
onKeep() { //通用保活
keepAlive.onKeep({
//channelId: "Ba-KeepAlive",
//channelName: "Ba-KeepAlive",
title: "测试",
content: "常驻通知描述",
},
(res) => {
console.log(res);
uni.showToast({
title: res.msg,
icon: "none",
duration: 3000
})
});
},
onAutoStart() { //去设置自启动、后台运行
keepAlive.onAutoStart(
(res) => {
console.log(res);
uni.showToast({
title: res.msg,
icon: "none",
duration: 3000
})
});
},
requestIgnoreBattery() { //申请加入电池优化白名单
keepAlive.requestIgnoreBattery(
res => {
console.log(res);
uni.showToast({
title: res.msg,
icon: "none",
duration: 3000
})
});
},
goIgnoreBattery() { //跳转到电池优化设置页
keepAlive.goIgnoreBattery(
res => {
console.log(res);
uni.showToast({
title: res.msg,
icon: "none",
duration: 3000
})
});
},
isIgnoringBattery() { //是否加入电池优化白名单
keepAlive.isIgnoringBattery(
res => {
console.log(res);
// if (res.data) {
// this.msgList.unshift(JSON.stringify(res.data))
// this.msgList.unshift(dateUtil.now())
// }
uni.showToast({
title: res.msg,
icon: "none",
duration: 3000
})
});
},
onShowNotify() { //常驻通知保活
keepAlive.onShowNotify({
//channelId: "Ba-KeepAlive",
//channelName: "Ba-KeepAlive",
//ID:99
//title: "测试",
//content: "常驻通知描述",
},
(res) => {
console.log(res);
uni.showToast({
title: res.msg,
icon: "none",
duration: 3000
})
});
},
onCancelNotify() { //取消常驻通知保活
keepAlive.onCancelNotify({
//channelId: "Ba-KeepAlive",
//channelName: "Ba-KeepAlive",
//ID:99
//title: "测试",
//content: "常驻通知描述",
},
(res) => {
console.log(res);
uni.showToast({
title: res.msg,
icon: "none",
duration: 3000
})
});
},
}
UI 图标设置
注意:更改后需要重新制作基座才能生效,建议提前配置。
- 通知小图标:默认通知图标是Android的图标,如果需要使用自己的,在项目的 “nativeplugins\Ba-KeepAliveSuit\android\res\mipmap-xxhdpi” 目录下(没有就新建),添加 “ba_keepalive_icon.png” 图片文件即可。
方法清单
名称 | 说明 |
---|---|
onKeep | 开启通用保活 |
onAutoStart | 去设置自启动、后台运行 |
requestIgnoreBattery | 申请加入电池优化白名单 |
goIgnoreBattery | 跳转到电池优化设置页 |
isIgnoringBattery | 是否加入电池优化白名单 |
onShowNotify | 常驻通知保活 |
onCancelNotify | 取消常驻通知保活 |
onKeep 方法参数
开启通用保活
属性名 | 类型 | 必填 | 默认值 | 说明 |
---|---|---|---|---|
title | String | 建议 | 'Ba-KeepAlive' | 通知栏标题,建议用户修改,非必传 |
content | String | 建议 | 'Ba-KeepAlive is running' | 通知栏内容,建议用户修改,非必传 |
isRogue | Boolean | false | false | 是否开启流氓模式,相对耗电 |
onShowNotify 方法参数
常驻通知保活
属性名 | 类型 | 必填 | 默认值 | 说明 |
---|---|---|---|---|
channelId | String | false | 'Ba-KeepAlive' | 渠道Id,建议用户修改,非必传 |
channelName | String | false | 'Ba-KeepAlive' | 渠道名,用于设置里通知渠道展示,建议用户修改,非必传 |
ID | String | false | 99 | 通知id |
title | String | 建议 | 'Ba-KeepAlive' | 通知栏标题,建议用户修改,非必传 |
content | String | 建议 | 'Ba-KeepAlive is running' | 通知栏内容,建议用户修改,非必传 |
onCancelNotify 方法参数
取消常驻通知保活
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
channelID | String | "1" | 渠道Id |
channelName | String | "默认" | 渠道名称 |
ID | Number | 99 | 通知id |
系列插件
应用消息通知插件(多种样式,新增支持常驻通知模式) Ba-Notify(文档)
自定义通知(耳机电量)插件 Ba-NotifyEarphone(文档)
应用未读角标插件 Ba-Shortcut-Badge (文档)
扫码原生插件(毫秒级、支持多码)Ba-Scanner-G(文档)
扫码原生插件 - 新(可任意自定义界面版本;支持连续扫码;支持设置扫码格式)Ba-Scanner(文档)
动态修改状态栏、导航栏背景色、字体颜色插件 Ba-AppBar(文档)
安卓保活插件(采用多种主流技术) Ba-KeepAlive(文档)
安卓快捷方式(桌面长按app图标) Ba-Shortcut(文档)
自定义图片水印(任意位置) Ba-Watermark(文档)
最接近微信的图片压缩插件 Ba-ImageCompressor(文档)
视频压缩、视频剪辑插件 Ba-VideoCompressor(文档)
动态切换应用图标、名称(如新年、国庆等) Ba-ChangeIcon(文档)
原生Toast弹窗提示(穿透所有界面、穿透原生;自定义颜色、图标 ) Ba-Toast(文档)
websocket原生服务(自动重连、心跳检测) Ba-Websocket(文档)
智能安装(自动升级) Ba-SmartUpgrade(文档)
监听通知栏消息(支持白名单、黑名单、过滤) Ba-NotifyListener(文档)
全局置灰、哀悼置灰(可动态、同时支持nvue、vue) Ba-Gray(文档)
获取设备唯一标识(OAID、AAID、IMEI等) Ba-IdCode(文档)
实时定位(系统、后台运行、支持息屏)插件 Ba-Location(文档)
实时定位(高德、后台运行、支持息屏、坐标转换、距离计算) Ba-LocationAMap(文档)
窗口小工具、桌面小部件、微件 Ba-AppWidget(文档)
窗口小工具、桌面小部件、微件(日历、时间) Ba-AwCalendarS(文档)
悬浮窗(在其他应用上层显示) Ba-FloatWindow(文档)
悬浮窗(应用内、无需授权) Ba-FloatWindow2(文档)
悬浮窗(悬浮球、动态菜单、在其他应用上层显示) Ba-FloatBall(文档)