JPush极光推送Java服务器端API
2013-12-06 17:21
579 查看
产品功能说明
极光推送(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 开发包
example
是一个完整的 Android 项目,通过这个演示了 JPush SDK 的基本用法,可以用来做参考。
Android SDK 版本
目前SDK只支持Android 2.1或以上版本的手机系统。
SDK集成步骤
1、导入 SDK 开发包到你自己的应用程序项目
解压缩 jpush-sdk_v1.x.y.zip 集成压缩包复制 libs/jpush-sdk-release1.x.y.jar 到工程 libs/ 目录下
复制 libs/armeabi/libjpush.so 到工程 libs/armeabi 目录下
如果您的项目有 libs/armeabi-v7a 这个目录,请把 libjpush.so 也复制一份到这个目录。 |
2、配置 AndroidManifest.xml
根据 SDK 压缩包里的 AndroidManifest.xml 样例文件,来配置应用程序项目的 AndroidManifest.xml 。主要步骤为:
复制备注为 "Required" 的部分
将备注为替换包名的部分,替换为当前应用程序的包名
将AppKey替换为在Portal上注册该应用的的Key,例如(9fed5bcb7b9b87413678c407)
3、添加代码
JPush SDK 提供的 API 接口,都主要集中在 cn.jpush.android.api.JPushInterface 类里。
基础 API
init 初始化SDK
调用示例代码(参考 example 项目)
init 只需要在应用程序启动时调用一次该 API 即可。以下代码定制一个本应用程序 Application 类。需要在 AndoridManifest.xml 里配置。请参考上面 AndroidManifest.xml 片断,或者 example 项目。
4、测试确认
确认所需的权限都已经添加。如果必须的权限未添加,日志会提示错误。确认 AppKey(在Portal上生成的)已经正确的写入 Androidmanifest.xml 。
确认在程序启动时候调用了init(context) 接口
确认测试手机(或者模拟器)已成功连入网络
客户端调用 init 后不久,如果一切正常,应有登录成功的日志信息
启动应用程序,在 Portal 上向应用程序发送自定义消息或者通知栏提示。详情请参考管理Portal。
在几秒内,客户端应可收到下发的通知或者正定义消息
如果 SDK 工作正常,则日志信息会如下图所示:
如图所示,客户端启动分为 4 步:
检查 metadata 的 appKey 和 channel ,如果不存在,则启动失败
初始化 JPush SDK,检查 JNI 等库文件的有效性,如果库文件无效,则启动失败
检查 Androidmanifest.xml,如果有 Required 的权限不存在,则启动失败
连接服务器登录,如果存在网络问题,则登陆失败,或者前面三步有问题,不会启动JPush SD
AppKey的获取
进入极光的官方网站,登录注册,建立一个应用,创建成功后,点击该应用进入详情页面就可以获取appkey了
https://www.jpush.cn
相关文章推荐
- Java线程笔记
- Java内部类
- eclipse构建maven的web项目
- java中类的加载,及执行顺序
- SPRING 整合STRUTS2
- Java EJB、CORBA、Webservices分布式通信基本原理及特点
- eclipse maven plugin 插件 安装 和 配置
- 使用clone( )和Cloneable接口
- [转]Struts2.3 + Spring3.2 整合
- 用eclipse运行和部署myeclipse项目
- java 执行jar 包里面 main class
- Struts2中拦截器的使用与配置
- 利用eclipse构建和部署maven工程
- MyEclipse中配置struts.xml自动提示
- 最详细易懂的 java 正则表达式
- java之操作mysql常用方法
- SpringMVC特别的实现类
- ubuntu 安装java
- 基于图的深度优先搜索和广度优先搜索java实现
- Struts2结合DisplayTag、DbUtils实现查询分页、导出Excel