一、什么是极光推送
-
极光推送
通过极光发送各个移动平台的系统通知,网址:https://www.jiguang.cn/push?source=bdjj#B_vid=12785778959110824941
二、cordova插件的安装
-
Install
-
通过 Cordova Plugins 安装,要求 Cordova CLI 5.0+:
cordova plugin add jpush-phonegap-plugin --variable APP_KEY=your_jpush_appkey
-
或直接通过 url 安装:
cordova plugin add https://github.com/jpush/jpush-phonegap-plugin.git --variable APP_KEY=your_jpush_appkey
-
或下载到本地安装:
cordova plugin add Your_Plugin_Path --variable APP_KEY=your_jpush_appkey
-
说明
- 在使用 Xcode 8 调试 iOS 项目时,需要先在项目配置界面的 Capabilities 中打开 Push Notifications 开关。
- variable APP_KEY=your_jpush_appkey ,举例:variable APP_KEY=354fb5c3dd4249ec11bc545d
- 官方网址,https://github.com/jpush/jpush-phonegap-plugin/blob/master/doc/Common_detail_api.md
-
三、插件的使用
1、通用API
-
初始化,获取集成日志
//初始化一般放在页面初始的JS中,例如app.js //启动极光推送服务; window.plugins.jPushPlugin.init(); //调试模式; window.plugins.jPushPlugin.setDebugMode(true);
-
获取设备号
//res就是设备号 window.plugins.jPushPlugin.getRegistrationID(function(res){}
-
关闭推送服务
window.plugins.jPushPlugin.stopPush();
-
重启推送服务
window.plugins.jPushPlugin.resumePush();
-
判断服务状态
window.plugins.jPushPlugin.isPushStopped(function (result) { if (result == 0) { // 开启 } else { // 关闭 } })
2、IOS API
-
ios角标设置与清零
if (ionic.Platform.isIOS()) { if (window.plugins.jPushPlugin) { window.plugins.jPushPlugin.setApplicationIconBadgeNumber(0); window.plugins.jPushPlugin.resetBadge(); } }
-
点击消息事件监听
if(ionic.Platform.isIOS()){ if (window.plugins.jPushPlugin) { document.addEventListener("jpush.openNotification", function(event){ // var alertContent = event.aps.alert // alert("open notification:" + alertContent); window.plugins.jPushPlugin.setApplicationIconBadgeNumber(0); window.plugins.jPushPlugin.resetBadge(); }, false); } }
备注: 官方网址,https://github.com/jpush/jpush-phonegap-plugin/blob/master/doc/iOS_API.md
3、android API
**备注:** 安卓无法获取角标值。具体的api 参考官方文档。https://github.com/jpush/jpush-phonegap-plugin/blob/master/doc/Android_detail_api.md
三、2018年3月13日更新
最近,极光推送进行了更新。导致安卓平台要求在7.0以上才可以。我目前所用的平台是android@6.1.2。所以要在安装插件的时候控制版本。
-
安装jcore
cordova plugin add cordova-plugin-jcore@1.1.12
-
安装jpush
cordova plugin add jpush-phonegap-plugin@3.3.2 --variable APP_KEY=xxxx