说一下写这篇文章的初衷。以前作过一个APP用到了消息推送,最近这个项目又用到了推送。可是因为两个项目间隔4个多月,推送集成、使用方式等都忘了,因此当时又去看了之前项目的源码和一些推送相关的博客,寻找那些蛛丝马迹。忽然以为这样很浪费时间,为什么本身不写篇文章总结一下呢,之后确定还会用到推送的,下次用的时候再看看这篇文章,思路应该会比较直观。后来再想一想,嗯,对的,写吧!html
PS:这篇文章讲是基于cordova环境下的消息推送,若是没有cordova环境的,请先装好该环境。
cordova create myAPP com.muzi.test
建立一个文件名为myAPP
,APP包名为com.muzi.test
的项目cordova platforms add android
将建立的项目加入到Android平台中
具体的一些cordova操做能够看我以前写的一篇博客 从这里飞过去android
APP_KEY
(我消息推送一直用的极光推送)APP_KEY
须要先在极光推送官网注册,具体流程很少说。https://www.jiguang.cn/accoun...git
这里填入的包名(填入保存以后不能再修改)就是开始cordova建立项目是的包名,两处包名必须相同,否则不能推送,保存以后能够下载集成好极光推送的demo,也能够下载打包好的测试app进行推送测试。(由于公司产品特殊,只面相Android用户,因此对其余平台的推送使用不是那么熟悉,这里就只介绍Android端的使用)github
jpush-phonegap-plugin
进入到刚开始cordova建立的项目文件根目录,安装插件,一共有3中方式:json
cordova plugin add jpush-phonegap-plugin --variable APP_KEY=your_jpush_appkey
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
segmentfault
安装插件的时候,注意Jpush和jcore的版本,有些版本不能初始化推送
api
your_jpush_appkey
:在极光推送建立应用时生成的APP_KEY数组
JPush
App启动时,在deviceready
事件回调中调用window.JPush.init()
方法初始化,能够调用window.JPush.stopPush()
结束推送app
document.addEventListener("deviceready",function(){ //插件初始化 window.JPush.init(); }, false );
registration ID
这个registration ID
是惟一的,项目中接收到这个ID后能够存储起来,而后发送给服务端,服务端能够根据这个registration ID
向指定客户端(手机)发送推送消息函数
window.JPush.getRegistrationID(function(rId) { console.log(rId); });
设备标签(Tag)
window.JPush.setTags({ sequence: 1, tags: ['tag1', 'tag2'] }, (result) => { var sequence = result.sequence var tags = result.tags // 数组类型 }, (error) => { var sequence = error.sequence var errorCode = error.code })
参数说明sequence
: number。用户自定义的操做序列号, 同操做结果一块儿返回,用来标识一次操做的惟一性。tags
: Array,标签数组。
调用这个方法后,会向极光的服务端发送设置的Tag
,设置后,会触发相应的回调函数
设备别名(Alias)
window.JPush.setAlias({ sequence: 1, alias: 'your_alias' }, (result) => { var sequence = result.sequence var alias = result.alias }, (error) => { var sequence = error.sequence var errorCode = error.code })
参数说明sequence
: number。用户自定义的操做序列号, 同操做结果一块儿返回,用来标识一次操做的惟一性。tags
: string
当客户端接收到推送消息时,会触发这个方法,会返回一个json
结构的数据包,在里面能够取到须要的数据
// 接收到推送消息回调 window.plugins.jPushPlugin.receiveNotificationInAndroidCallback = function( data ) { try { console.log( "JPushPlugin:receiveNotificationInAndroidCallback:", data ); } catch (exception) { console.log("JPushPlugin:pushCallback ", exception); } };
点击通知栏的消息时,会触发这个方法,并返回包含具体推送内容的json
数据,能够根据里面的内容,来作相应的事件处理,好比说须要点击通知栏消息,跳转到相应页面作处理
//点击通知栏的回调,在这里编写特定逻辑 window.plugins.jPushPlugin.openNotificationInAndroidCallback = function( data ) { try { // location.href = 'index.html'; console.log(data); } catch (error) {} };
在初始化极光推送window.JPush.init()
后,当第一次运行APP时会生成了registration ID
,或者成功设置了标签(Tag)
,别名(Alias)
,能够在极光推送的官网上,进行消息推送测试,以下图:
当推送初消息后,一下子就会在手机上接收到推送信息(有时可能会有几秒到10多秒的延迟,通常状况下是秒到)
以上就是我使用jpush-phonegap-plugin
插件推送的一些经验,但愿可以帮助到须要的道友。若是有错误或不足的地方,欢迎各位道友指出,若是各位以为满意,欢迎点赞和收藏。