更新记录

1.0.0（2026-02-26）

初始化 安卓版本，后续增加ios 和鸿蒙

平台兼容性

uni-app(4.26)

uni-app x(4.32)

其他

xtf-jpush

注意事项

1.android 端需要在您的项目 下添加nativeResources 文件夹 内添加android文件夹 并创建文件manifestPlaceholders.json

即 项目根目录/nativeResources/android/manifestPlaceholders.json

manifestPlaceholders.json内容复制下方

{
                     "JPUSH_APPKEY" : "你的极光appkey",
                    "JPUSH_CHANNEL": "default_developer",
                    "MEIZU_APPKEY":"MZ-魅族的APPKEY",
                    "MEIZU_APPID":"MZ-魅族的APPID",
                    "XIAOMI_APPID":"MI-小米的APPID",
                    "XIAOMI_APPKEY":"MI-小米的APPKEY",
                    "OPPO_APPKEY":"OP-oppo的APPKEY",
                    "OPPO_APPID":"OP-oppo的APPID",
                    "OPPO_APPSECRET":"OP-oppo的APPSECRET",
                    "VIVO_APPKEY":"vivo的APPKEY",
                    "VIVO_APPID":"vivo的APPID",
                    "HONOR_APPID":"honor的APPID",
                    "NIO_APPID":"nio的APPID"
}

2.修改manifestPlaceholders.json 内容需要重新打基座

3.android 端 若需要应用内消息功能 需要解压插件目录安卓端 res.zip 文件

4.Android端若不需要厂家推送 可以删除插件目录下 除(jcore-android-5.3.1.aar jpush-android-6.0.1.jar)下的其它所有aar

插件测试使用方法(安卓试用请看注意事项，否则打包可能报错)

1. 选择试用，绑定要试用的项目appid，

2. 选择后下载到对应的本地项目

3. 按照文档 -》把插件引入项目（即

   import { JPushHelper,MessageListener } from "@/uni_modules/xtf-jpush"

   需要先引入），

4. 发布-》云打包-》选择制作基座-》打包等基座制作完成

5. 运行 -》 运行到手机或模拟器-》运行到Androidapp基座-》选择使用自定义基座运行-》选择手机-》运行

6. 若之前手机安装过基座需要先卸载之前的基座

插件方法介绍

引入

import { JPushHelper,MessageListener } from "@/uni_modules/xtf-jpush"

初始化

JPushHelper.init(false);// false是否开启调试

监听极光推送消息

uniappx

JPushHelper.onListenerJpushMessage({
    // 成功注册到极光，一般只有首次初始化会回调
    onRegister:function(id:string){
        console.log("onRegister",id)
    },

    // 是否成功链接到极光服务 // state 未true 表示链接成功
    onServerConnect:function(state:boolean){
        console.log(state)
    },
    // 通知的 MultiAction 回调
    multiActionClicked(msg:string) {
        console.log(msg)
    },
    //自定义消息回调  同时是应用内提醒回调。
    messageListener(msg:string) {
        console.log(msg)
    },
    // 点击通知回调
    notityMessageOpened(msg:string) {
        console.log("notityMessageOpened",msg)
    },
    // 清除通知回调
    notifyMessageDismiss(msg:string) {
        console.log(msg)
    },
    // 收到通知回调
    notifyMessageArrived(msg:string){
        console.log(msg)
    },
    // 交互事件回调
    commandResult(msg:string) {
        console.log(msg)
    },
} as MessageListener)

uniapp

JPushHelper.onListenerJpushMessage({
    // 成功注册到极光，一般只有首次初始化会回调
    onRegister:function(id){
        console.log("onRegister",id)
    },

    // 是否成功链接到极光服务 // state 未true 表示链接成功
    onServerConnect:function(state){
        console.log(state)
    },
    // 通知的 MultiAction 回调
    multiActionClicked(msg) {
        console.log(msg)
    },
    //自定义消息回调  同时是应用内提醒回调。
    messageListener(msg) {
        console.log(msg)
    },
    // 点击通知回调
    notityMessageOpened(msg) {
        console.log("notityMessageOpened",msg)
    },
    // 清除通知回调
    notifyMessageDismiss(msg) {
        console.log(msg)
    },
    // 收到通知回调
    notifyMessageArrived(msg){
        console.log(msg)
    },
    // 交互事件回调
    commandResult(msg) {
        console.log(msg)
    },
})

检测通知栏是否开启

var b=JPushHelper.isNotificationEnabled();

打开通知栏设置

JPushHelper.goToAppNotificationSettings();

获取注册id

var id=JPushHelper.getRegistrationID();// 需要注册到极光成功后才行

设置别名。

需要理解的是，这个接口是覆盖逻辑，而不是增量逻辑。即新的调用会覆盖之前的设置。 uniappx

JPushHelper.setAlias(0,"xtf",function(msg:string){

});//  参数1  0 为操作序列号 建议随机  参数2  xtf 为别名   参数3 为设置回调

uniapp

JPushHelper.setAlias(0,"xtf",function(msg){

});//  参数1  0 为操作序列号 建议随机  参数2  xtf 为别名   参数3 为设置回调

删除别名

uniappx

JPushHelper.deleteAlias(0,function(msg:string){

});//  参数1  0 为操作序列号 建议随机   参数2 为设置回调

uniappx

JPushHelper.deleteAlias(0,function(msg){

});//  参数1  0 为操作序列号 建议随机   参数2 为设置回调

设置标签

调用此 API 来设置标签。

需要理解的是，这个接口是覆盖逻辑，而不是增量逻辑。即新的调用会覆盖之前的设置。 uniappx

JPushHelper.setTags(0,["xtf"] as string[],function(b:string){
    console.log(b);
})  //参数1  0 为操作序列号 建议随机   参数2  tag 标签数组  参数3 为回调

uniapp

JPushHelper.setTags(0,["xtf"],function(b){
    console.log(b);
})  //参数1  0 为操作序列号 建议随机   参数2  tag 标签数组  参数3 为回调

设置标签

uniappx

JPushHelper.addTags(0,["xtf"] as string[],function(b:string){
    console.log(b);
})  //参数1  0 为操作序列号 建议随机   参数2  tag 标签数组  参数3 为回调

uniapp

JPushHelper.addTags(0,["xtf"],function(b){
    console.log(b);
})  //参数1  0 为操作序列号 建议随机   参数2  tag 标签数组  参数3 为回调

删除标签

uniappx

JPushHelper.deleteTags(0,["xtf"] as string[],function(b:string){
    console.log(b);
})  //参数1  0 为操作序列号 建议随机   参数2  tag 标签数组  参数3 为回调

uniapp

JPushHelper.deleteTags(0,["xtf"],function(b){
    console.log(b);
})  //参数1  0 为操作序列号 建议随机   参数2  tag 标签数组  参数3 为回调

清除所有标签

uniappx

JPushHelper.cleanTags(0,function(b:string){
    console.log(b);
})  //参数1  0 为操作序列号 建议随机   参数2 为回调

uniapp

JPushHelper.cleanTags(0,function(b){
    console.log(b);
})  //参数1  0 为操作序列号 建议随机   参数2   为回调

查询所有标签

uniappx

JPushHelper.getAllTags(0,function(b:string){
    console.log(b);
})  //参数1  0 为操作序列号 建议随机   参数2 为回调

uniapp

JPushHelper.getAllTags(0,function(b){
    console.log(b);
})  //参数1  0 为操作序列号 建议随机   参数2   为回调

查询指定标签的绑定状态

uniappx

JPushHelper.checkTagBindState(0,"xtf",function(b:string){
    console.log(b);
})  //参数1  0 为操作序列号 建议随机   参数2  为需要查询的标签  参数3为回调

uniapp

JPushHelper.checkTagBindState(0,"xtf",function(b){
    console.log(b);
})  //参数1  0 为操作序列号 建议随机   参数2  为需要查询的标签  参数3为回调

设置手机号

uniappx

JPushHelper.setMobileNumber(0,"12345678901",function(b:string){
    console.log(b);
}) //参数1  0 为操作序列号 建议随机  参数2 为手机号  参数3 为回调

uniapp

JPushHelper.setMobileNumber(0,"12345678901",function(b){
    console.log(b);
}) //参数1  0 为操作序列号 建议随机  参数2 为手机号  参数3 为回调

开发文档

UTS 语法 UTS API插件 UTS uni-app兼容模式组件 UTS 标准模式组件 Hello UTS