极光推送功能的实现
2015-08-25 12:40
239 查看
android 版激光推送功能的实现(免费版本):
贮备: 我不是做极光广告的,只是记录一下自己感觉神器的地方。
这几天xmpp问题搞的我一头雾水,,,没办法,中午时间几分钟做了一个激光推送功能,主要也是按照官网上的实现的。。。。也是给自己一个记录,以前总是觉的这些功能都很高大上,好难,做出来了,就会发现,其实just so so....
第一步: https://www.jpush.cn 官网上注册账号。
第二部: 填写android应用的名称以及包名。(提交之后就可以看到有一个测试版本,可以提前下载下来感受一下推送的魅力。)
感受步骤: 把测试版本安装到手机上,联网之后->在推送-> 发送通知里面填写信息,然后发送,这个时候手机端就可以看到了,是不是很强大。。。
第三部: 进入文档,,,android SDK集成指南,按照需求,一步步完成就可以了。
主要是修改应用包名和应用申请时候添加的ley,,,主要修改这些问题。。。测试时候,如果发现问题就按照问题在做修改就是了。。。
其实这个我一次性就成功了,也不知道还会不会遇到什么问题,,,我也是文字搬家,主要是觉的以前很高大上的东西,当自己实现的时候,这样的感觉挺好。。。
本文是 Android SDK 标准的集成指南文档。
匹配的 SDK 版本为:r1.8.0及以后版本。
本文随SDK压缩包分发。在你看到本文时,可能当前的版本与本文已经不是很适配。所以建议关注在线文档:
3 分钟快速 Demo(Android):如果您想要快速地测试、感受下极光推送的效果,请参考本文在几分钟内跑通Demo。
极光推送文档网站上,有极光推送相关的所有指南、API、教程等全部的文档。包括本文档的更新版本,都会及时地发布到该网站上。
极光推送问答网站:大家除了文档之外,还有问题与疑问,会到这里来提问题,以及时地得到解答。
如果您看到本文档,但还未下载Android SDK,请访问SDK下载页面下载。
极光推送(JPush)是一个端到端的推送服务,使得服务器端消息能够及时地推送到终端用户手机上,让开发者积极地保持与用户的连接,从而提高用户活跃度、提高应用的留存率。极光推送客户端支持 Android, iOS 两个平台。
本 Android SDK 方便开发者基于 JPush 来快捷地为 Android App 增加推送功能。
保持与服务器的长连接,以便消息能够即时推送到达客户端
接收通知与自定义消息,并向开发者App 传递相关信息
客户端维持连接占用资源少、耗电低
SDK丰富的接口,可定制通知栏提示样式
服务器大容量、稳定
AndoridManifest.xml
客户端嵌入SDK参考的配置文件
libs/jpush-sdk-release1.x.y.jar
SDK Java 开发包
libs/armeabi/libjpush.so
SDK native 开发包
res
集成SDK必须添加的资源文件
example
是一个完整的 Android 项目,通过这个演示了 JPush SDK 的基本用法,可以用来做参考。
目前SDK只支持Android 2.1或以上版本的手机系统。富媒体信息流功能则需Android3.0或以上版本的系统。
解压缩 jpush-sdk_v1.x.y.zip 集成压缩包
复制 libs/jpush-sdk-release1.x.y.jar 到工程 libs/ 目录下
复制 libs/armeabi/libjpush1xy.so 到工程 libs/armeabi 目录下
复制 libs/armeabi-v7a/libjpush.so 到工程 libs/armeabi-v7a 目录下
如果您的项目有 libs/armeabi-v7a 这个目录,请把 libs/armeabi-v7a下的so文件 也复制一份到这个目录。
复制 res/drawable-hdpi 中的资源文件到工程的 res/drawable-hdpi/ 目录下
复制 res/layout 中的布局文件到工程的 res/layout/ 目录下
根据 SDK 压缩包里的 AndroidManifest.xml 样例文件,来配置应用程序项目的 AndroidManifest.xml 。
主要步骤为:
复制备注为 "Required" 的部分
将备注为替换包名的部分,替换为当前应用程序的包名
将AppKey替换为在Portal上注册该应用的的Key,例如(9fed5bcb7b9b87413678c407)
JPush SDK 提供的 API 接口,都主要集中在 cn.jpush.android.api.JPushInterface 类里。
init 初始化SDK
setDebugMode 设置调试模式
参考文档: 统计分析 API
init 只需要在应用程序启动时调用一次该 API 即可。
以下代码定制一个本应用程序 Application 类。需要在 AndoridManifest.xml 里配置。请参考上面 AndroidManifest.xml 片断,或者 example 项目。
确认所需的权限都已经添加。如果必须的权限未添加,日志会提示错误。
确认 AppKey(在Portal上生成的)已经正确的写入 Androidmanifest.xml 。
确认在程序启动时候调用了init(context) 接口
确认测试手机(或者模拟器)已成功连入网络 + 客户端调用 init 后不久,如果一切正常,应有登录成功的日志信息
启动应用程序,在 Portal 上向应用程序发送自定义消息或者通知栏提示。详情请参考管理Portal。
在几秒内,客户端应可收到下发的通知或者正定义消息 如果 SDK 工作正常,则日志信息会如下图所示:
如图所示,客户端启动分为 4 步:
检查 metadata 的 appKey 和 channel ,如果不存在,则启动失败
初始化 JPush SDK,检查 JNI 等库文件的有效性,如果库文件无效,则启动失败
检查 Androidmanifest.xml,如果有 Required 的权限不存在,则启动失败
连接服务器登录,如果存在网络问题,则登陆失败,或者前面三步有问题,不会启动JPush SDK
贮备: 我不是做极光广告的,只是记录一下自己感觉神器的地方。
这几天xmpp问题搞的我一头雾水,,,没办法,中午时间几分钟做了一个激光推送功能,主要也是按照官网上的实现的。。。。也是给自己一个记录,以前总是觉的这些功能都很高大上,好难,做出来了,就会发现,其实just so so....
第一步: https://www.jpush.cn 官网上注册账号。
第二部: 填写android应用的名称以及包名。(提交之后就可以看到有一个测试版本,可以提前下载下来感受一下推送的魅力。)
感受步骤: 把测试版本安装到手机上,联网之后->在推送-> 发送通知里面填写信息,然后发送,这个时候手机端就可以看到了,是不是很强大。。。
第三部: 进入文档,,,android SDK集成指南,按照需求,一步步完成就可以了。
主要是修改应用包名和应用申请时候添加的ley,,,主要修改这些问题。。。测试时候,如果发现问题就按照问题在做修改就是了。。。
其实这个我一次性就成功了,也不知道还会不会遇到什么问题,,,我也是文字搬家,主要是觉的以前很高大上的东西,当自己实现的时候,这样的感觉挺好。。。
Android SDK 集成指南
使用提示
本文是 Android SDK 标准的集成指南文档。匹配的 SDK 版本为:r1.8.0及以后版本。
本文随SDK压缩包分发。在你看到本文时,可能当前的版本与本文已经不是很适配。所以建议关注在线文档:
3 分钟快速 Demo(Android):如果您想要快速地测试、感受下极光推送的效果,请参考本文在几分钟内跑通Demo。
极光推送文档网站上,有极光推送相关的所有指南、API、教程等全部的文档。包括本文档的更新版本,都会及时地发布到该网站上。
极光推送问答网站:大家除了文档之外,还有问题与疑问,会到这里来提问题,以及时地得到解答。
如果您看到本文档,但还未下载Android SDK,请访问SDK下载页面下载。
产品功能说明
极光推送(JPush)是一个端到端的推送服务,使得服务器端消息能够及时地推送到终端用户手机上,让开发者积极地保持与用户的连接,从而提高用户活跃度、提高应用的留存率。极光推送客户端支持 Android, iOS 两个平台。本 Android SDK 方便开发者基于 JPush 来快捷地为 Android App 增加推送功能。
主要功能
保持与服务器的长连接,以便消息能够即时推送到达客户端接收通知与自定义消息,并向开发者App 传递相关信息
主要特点
客户端维持连接占用资源少、耗电低SDK丰富的接口,可定制通知栏提示样式
服务器大容量、稳定
jpush-sdk_v1.x.y.zip 集成压缩包内容
AndoridManifest.xml客户端嵌入SDK参考的配置文件
libs/jpush-sdk-release1.x.y.jar
SDK Java 开发包
libs/armeabi/libjpush.so
SDK native 开发包
res
集成SDK必须添加的资源文件
example
是一个完整的 Android 项目,通过这个演示了 JPush SDK 的基本用法,可以用来做参考。
Android SDK 版本
目前SDK只支持Android 2.1或以上版本的手机系统。富媒体信息流功能则需Android3.0或以上版本的系统。
SDK集成步骤
1、导入 SDK 开发包到你自己的应用程序项目
解压缩 jpush-sdk_v1.x.y.zip 集成压缩包复制 libs/jpush-sdk-release1.x.y.jar 到工程 libs/ 目录下
复制 libs/armeabi/libjpush1xy.so 到工程 libs/armeabi 目录下
复制 libs/armeabi-v7a/libjpush.so 到工程 libs/armeabi-v7a 目录下
如果您的项目有 libs/armeabi-v7a 这个目录,请把 libs/armeabi-v7a下的so文件 也复制一份到这个目录。
复制 res/drawable-hdpi 中的资源文件到工程的 res/drawable-hdpi/ 目录下
复制 res/layout 中的布局文件到工程的 res/layout/ 目录下
2、配置 AndroidManifest.xml
根据 SDK 压缩包里的 AndroidManifest.xml 样例文件,来配置应用程序项目的 AndroidManifest.xml 。主要步骤为:
复制备注为 "Required" 的部分
将备注为替换包名的部分,替换为当前应用程序的包名
将AppKey替换为在Portal上注册该应用的的Key,例如(9fed5bcb7b9b87413678c407)
[code]AndroidManifest.xml权限配置: <?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" > <uses-sdk android:minSdkVersion="11" android:targetSdkVersion="17" /> <!-- Required --> <permission android:name="Your 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" /> <uses-permission android:name="android.permission.WRITE_SETTINGS" /> <!-- Optional. Required for location feature --> <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /> <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" /> 应用包名及appkey替换: <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 SDK 核心功能--> <!-- since 1.8.0 --> <service android:name="cn.jpush.android.service.DaemonService" android:enabled="true" android:exported="true"> <intent-filter > <action android:name="cn.jpush.android.intent.DaemonService" /> <category android:name="Your Package"/> </intent-filter> </service> <!-- Required --> <receiver android:name="cn.jpush.android.service.PushReceiver" android:enabled="true" > <intent-filter android:priority="1000"> <action android:name="cn.jpush.android.intent.NOTIFICATION_RECEIVED_PROXY" /> <category android:name="Your Package"/> </intent-filter> <intent-filter> <action android:name="android.intent.action.USER_PRESENT" /> <action android:name="android.net.conn.CONNECTIVITY_CHANGE" /> </intent-filter> <!-- Optional --> <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:configChanges="orientation|keyboardHidden" android:exported="false" > <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" /> <!-- User defined. 用户自定义的广播***--> <receiver android:name="您自己定义的Receiver" android:enabled="true"> <intent-filter> <!--Required 用户注册SDK的intent--> <action android:name="cn.jpush.android.intent.REGISTRATION" /> <action android:name="cn.jpush.android.intent.UNREGISTRATION" /> <!--Required 用户接收SDK消息的intent--> <action android:name="cn.jpush.android.intent.MESSAGE_RECEIVED" /> <!--Required 用户接收SDK通知栏信息的intent--> <action android:name="cn.jpush.android.intent.NOTIFICATION_RECEIVED" /> <!--Required 用户打开自定义通知栏的intent--> <action android:name="cn.jpush.android.intent.NOTIFICATION_OPENED" /> <!--Optional 用户接受Rich Push Javascript 回调函数的intent--> <action android:name="cn.jpush.android.intent.ACTION_RICHPUSH_CALLBACK" /> <!-- 接收网络变化 连接/断开 since 1.6.3 --> <action android:name="cn.jpush.android.intent.CONNECTION" /> <category android:name="您应用的包名" /> </intent-filter> </receiver> <!-- 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>
3、必须权限说明
权限 | 用途 |
---|---|
You Package.permission.JPUSH_MESSAGE | 官方定义的权限,允许应用接收JPUSH内部代码发送的广播消息。 |
RECEIVE_USER_PRESENT | 允许应用可以接收点亮屏幕或解锁广播。 |
INTERNET | 允许应用可以访问网络。 |
WAKE_LOCK | 允许应用在手机屏幕关闭后后台进程仍然运行 |
READ_PHONE_STATE | 允许应用访问手机状态。 |
WRITE_EXTERNAL_STORAGE | 允许应用写入外部存储。 |
READ_EXTERNAL_STORAGE | 允许应用读取外部存储。 |
WRITE_SETTINGS | 允许应用读写系统设置项。 |
VIBRATE | 允许应用震动。 |
MOUNT_UNMOUNT_FILESYSTEMS | 允许应用挂载/卸载 外部文件系统。 |
ACCESS_NETWORK_STATE | 允许应用获取网络信息状态,如当前的网络连接是否有效。 |
SYSTEM_ALERT_WINDOW | 允许应用显示系统窗口,位于显示的顶层。 |
4、添加代码
JPush SDK 提供的 API 接口,都主要集中在 cn.jpush.android.api.JPushInterface 类里。
基础API
init 初始化SDK[code]public static void init(Context context)
setDebugMode 设置调试模式
[code]// You can enable debug mode in developing state. You should close debug mode when release. public static void setDebugMode(boolean debugEnalbed)
添加统计代码
参考文档: 统计分析 API
调用示例代码(参考 example 项目)
init 只需要在应用程序启动时调用一次该 API 即可。以下代码定制一个本应用程序 Application 类。需要在 AndoridManifest.xml 里配置。请参考上面 AndroidManifest.xml 片断,或者 example 项目。
[code]public class ExampleApplication extends Application { @Override public void onCreate() { super.onCreate(); JPushInterface.setDebugMode(true); JPushInterface.init(this); } }
5、测试确认
确认所需的权限都已经添加。如果必须的权限未添加,日志会提示错误。确认 AppKey(在Portal上生成的)已经正确的写入 Androidmanifest.xml 。
确认在程序启动时候调用了init(context) 接口
确认测试手机(或者模拟器)已成功连入网络 + 客户端调用 init 后不久,如果一切正常,应有登录成功的日志信息
启动应用程序,在 Portal 上向应用程序发送自定义消息或者通知栏提示。详情请参考管理Portal。
在几秒内,客户端应可收到下发的通知或者正定义消息 如果 SDK 工作正常,则日志信息会如下图所示:
如图所示,客户端启动分为 4 步:
检查 metadata 的 appKey 和 channel ,如果不存在,则启动失败
初始化 JPush SDK,检查 JNI 等库文件的有效性,如果库文件无效,则启动失败
检查 Androidmanifest.xml,如果有 Required 的权限不存在,则启动失败
连接服务器登录,如果存在网络问题,则登陆失败,或者前面三步有问题,不会启动JPush SDK
相关文章推荐
- Linux命令行文本处理工具
- 编译告警处理:dereferencing type-punned pointer will break strict-aliasing rules
- shell的集合运算
- IOS 多线程(3) --线程安全
- wg_listToTree小插件 用 javascript 将List数组转换为Tree
- Linux用户基础
- Android开发中字符串比较,新手容易出错
- android context 问题记录
- linux 学习之命令总结(一)
- Java开发中的23种设计模式详解
- Jenkins里邮件触发器配置Send to Developers
- google通过者面试经历
- httpd详解(三)
- 与智者同行,你会不同凡响;与高人为伍,你能登上巅峰
- PAT 1057. Stack (30)
- php 解决和避免form表单重复提交的方法
- HDU1669 Jamie's Contact Groups (二分+二分图的多重匹配+一对多的匹配)
- qt多点触控
- jquery实现动画菜单的左右滚动、渐变及图形背景滚动等效果
- 快讯:微软安卓版个人助理(Cortana)在美国境内进行公测