android jpush sdk 集成文档

使⽤提⽰

本⽂是 Android SDK 标准的集成指南⽂档。

匹配的 SDK 版本为：v2.0.5 及以后版本。

本⽂随SDK压缩包分发。在你看到本⽂时，可能当前的版本的集成⽂档已有更新，所以请关注在线⽂档：

3 分钟快速 Demo (Android )：如果您想要快速地测试、感受下极光推送的效果，请参考本⽂在⼏分钟内跑通

Demo。

极光推送⽂档⺴站上，有极光推送相关的所有指南、API 、教程等全部的⽂档。包括本⽂档的更新版本，都会及

JPUSH_CHANNEL时地发布到该⺴站上。

极光推送问答⺴站：⼤家除了⽂档之外，还有问题与疑问，会到这⾥来提问题，以及时地得到解答。

如果您看到本⽂档，但还未下载Android SDK ，请访问SDK下载⻚⾯下载。

产品功能说明

极光推送(JPush)是⼀个端到端的推送服务，使得服务器端消息能够及时地推送到终端⽤户⼿机上，让开发者积极地保

持与⽤户的连接，从⽽提⾼⽤户活跃度、提⾼应⽤的留存率。极光推送客户端⽀持 Android, iOS 两个平台。

本 Android SDK ⽅便开发者基于 JPush 来快捷地为 Android App 增加推送功能。

主要功能

保持与服务器的⻓连接，以便消息能够即时推送到达客户端

接收通知与⾃定义消息，并向开发者App 传递相关信息

主要特点

客户端维持连接占⽤资源少、耗电低

SDK丰富的接⼝，可定制通知栏提⽰样式

服务器⼤容量、稳定

集成压缩包内容

AndroidManifest_AS_Example.xml / AndroidManifest_Eclipse_Example.xml

客户端嵌⼊SDK参考的配置⽂件。分别对应AndroidStudio 和 Eclipse

libs/jpush-sdk-release2.x.y.jar

SDK Java 开发包

libs/armeabi (或 armeabi-v7a/arm64-v8a )/libjpush2xy.so

SDK native 开发包。分别对应arm, armv7a,armv8a(64位) 的.so⽂件。

res/

集成SDK 必须添加的资源⽂件

example

是⼀个完整的 Android 项⺫，通过这个演⽰了 JPush SDK 的基本⽤法，可以⽤来做参考。

Android SDK 版本

⺫前SDK只⽀持Android 2.3 及以上版本的⼿机系统。

富媒体信息流功能则需Android3.0或以上版本的系统。

SDK集成步骤

1、导⼊ SDK 开发包到你⾃⼰的应⽤程序项⺫

解压缩 jpush-sdk_v2.x.y.zip 集成压缩包

复制 libs/jpush-sdk-release2.x.y.jar 到⼯程 libs/ ⺫录下

复制 libs/armeabi(和 armeabi-v7a/arm64-v8a)/ 中so⽂件到⼯程libs/下对应的CPU ⺫录下

在AndroidStudio 中使⽤，在build.gradle的sourceSets.main节点下指定jniLibs 的路径。

sourceSets{

main {

jniLibs .srcDirs = ['libs'] //

}

}

复制 res/drawable-hdpi 中的资源⽂件到⼯程的 res/drawable-hdpi/ ⺫录下

复制 res/layout 中的布局⽂件到⼯程的 res/layout/ ⺫录下

2 、配置 AndroidManifest.xml

根据 SDK 压缩包⾥的 AndroidManifest.xml 样例⽂件，来配置应⽤程序项⺫的 AndroidManifest.xml 。

主要步骤为：

1. 复制备注为 "Required" 的部分

2. Eclipse的AndroidManifest 中将备注为"您应⽤的包名"的部分，替换为当前应⽤程序的包名; AndroidStudio 的

AndroidManifest 中引⽤的是所在Module的applicat