phonegap push-消息推送代码
最近一直在研究各种推送,ios的由于是apns,比较容易实现,但是andriod的就比较麻烦。后来看了很多解决方案,gcm明显是不行的,其他的方案更是一头雾水,而且需要做第二次开发,太麻烦,后来就选择用第三方的服务来实现推送。
目前国内做的比较好的有个推和极光。
个推最优但是需要付费。对于我们这样的小app,根本应付不了,然后果断选择极光。
以下是我对phonegap 与极光sdk的整合过程。
1.注册极光的开发者账户,并注册应用信息。
创建帐号进入极光推送平台后,首先显示的是创建应用的界面。填上你的应用程序的名称,以及 Android包名这二顶就可以了。
用创建成功,即进入“应用详情”显示界面。这个界面右下角,你可以看到 “appkey" 后面会用到。
2,下载 sdk包。就行整合
具体的流程可以看以下文档,当然phonegap的整合和这个有些不同。
http://docs.jpush.cn/pages/viewpage.action?pageId=557214
3.SDK集成步骤
1、导入 SDK 开发包到你自己的应用程序项目
解压缩 jpush-sdk_v1.x.y.zip 集成压缩包 复制 libs/jpush-sdk-release1.x.y.jar 到工程 libs/ 目录下 复制 libs/armeabi/libsys1.x.y.so 到工程 libs/armeabi 目录下(如果你的项目有libs/armeabi-v7a这个目录,请把libsys1.x.y.so也复制一份到这个目录)
这里需求注意的是:包导入进去之后一定要把包configuer building path。 2、配置 AndroidManifest.xml
根据 SDK 压缩包里的 AndroidManifest.xml 样例文件,来配置应用程序项目的 AndroidManifest.xml 。
主要步骤为:
复制备注为 "Required" 的部分 将备注为替换包名的部分,替换为当前应用程序的包名 将AppKey替换为在Portal上注册该应用的的Key,例如(9fed5bcb7b9b87413678c407)
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="Your Package"
android:versionCode="100"
android:versionName="1.0.0"
>
<!-- Required -->
<permission android:name="You Package.permission.JPUSH_MESSAGE" android:protectionLevel="signature" />
<!-- Required -->
<uses-permission android:name="You Package.permission.JPUSH_MESSAGE" />
<uses-permission android:name="android.permission.RECEIVE_USER_PRESENT" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.VIBRATE" />
<uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<!-- Optional. Required for location feature -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_UPDATES" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS" />
<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
<application
android:icon="@drawable/ic_launcher"
android:label="@string/app_name"
android:name="Your Application">
<!-- Required -->
<service
android:name="cn.jpush.android.service.PushService"
android:enabled="true"
android:exported="false" >
<intent-filter>
<action android:name="cn.jpush.android.intent.REGISTER" />
<action android:name="cn.jpush.android.intent.REPORT" />
<action android:name="cn.jpush.android.intent.PushService" />
<action android:name="cn.jpush.android.intent.PUSH_TIME" />
</intent-filter>
</service>
<!-- Required -->
<receiver
android:name="cn.jpush.android.service.PushReceiver"
android:enabled="true" >
<intent-filter>
<action android:name="android.intent.action.USER_PRESENT" />
<action android:name="android.net.conn.CONNECTIVITY_CHANGE" />
</intent-filter>
<intent-filter>
<action android:name="android.intent.action.PACKAGE_ADDED" />
<action android:name="android.intent.action.PACKAGE_REMOVED" />
<data android:scheme="package" />
</intent-filter>
</receiver>
<!-- Required SDK核心功能-->
<activity
android:name="cn.jpush.android.ui.PushActivity"
android:theme="@android:style/Theme.Translucent.NoTitleBar"
android:configChanges="orientation|keyboardHidden" >
<intent-filter>
<action android:name="cn.jpush.android.ui.PushActivity" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="Your Package" />
</intent-filter>
</activity>
<!-- Required SDK核心功能-->
<service
android:name="cn.jpush.android.service.DownloadService"
android:enabled="true"
android:exported="false" >
</service>
<!-- Required SDK核心功能-->
<receiver android:name="cn.jpush.android.service.AlarmReceiver" />
<!-- Required. For publish channel feature -->
<!-- JPUSH_CHANNEL 是为了方便开发者统计APK分发渠道。-->
<!-- 例如: -->
<!-- 发到 Google Play 的APK可以设置为 google-play; ->
<!-- 发到其他市场的 APK 可以设置为 xxx-market。 -->
<!-- 目前这个渠道统计功能的报表还未开放。-->
<meta-data android:name="JPUSH_CHANNEL" android:value="developer-default"/>
<!-- Required. AppKey copied from Portal -->
<meta-data android:name="JPUSH_APPKEY" android:value="Your AppKey"/>
</application>
</manifest>
这里需要注意的是:之前已经加过的一些xml信息,这时候要一一对照把这里面的信息 一条一条添加进去。
注意顺序:
3、添加代码
JPush SDK 提供的 API 接口,都主要集中在 cn.jpush.android.api.JPushInterface 类里。
按照下面的方法来修改:
4、测试确认
确认所需的权限都已经添加。如果必须的权限未添加,日志会提示错误。 确认 AppKey(在Portal上生成的)已经正确的写入 Androidmanifest.xml 。 确认在程序启动时候调用了init(context) 接口 确认测试手机(或者模拟器)已成功连入网络 客户端调用 init 后不久,如果一切正常,应有登录成功的日志信息 启动应用程序,在 Portal 上向应用程序发送自定义消息或者通知栏提示。详情请参考管理Portal。 在几秒内,客户端应可收到下发的通知或者正定义消息
如果 SDK 工作正常,则日志信息会如下图所示:
如图所示,客户端启动分为 4 步:
检查 metadata 的 appKey 和 channel ,如果不存在,则启动失败 初始化 JPush SDK,检查 JNI 等库文件的有效性,如果库文件无效,则启动失败 检查 Androidmanifest.xml,如果有 Required 的权限不存在,则启动失败 连接服务器登录,如果存在网络问题,则登陆失败,或者前面三步有问题,不会启动JPush SDK
只要测试成功,ok,你可以去管理Portal,去发送信息了。没有意外的话,就能收到信息。
当然这个仅仅是简单的推送消息功能,具体的一些应用,可以再参考官方的api文档来自己开发。
|