Android消息推送 SDK 集成指南

最新推荐文章于 2023-03-23 14:13:16 发布
最新推荐文章于 2023-03-23 14:13:16 发布
阅读量199 收藏
点赞数
文章标签： 开发工具 javascript ui ViewUI
原文链接：http://www.cnblogs.com/jpush88/p/4683405.html
版权

使用提示

本文是 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）
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

    public static void init(Context context)

  • setDebugMode 设置调试模式

    // 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 项目。

    public class ExampleApplication extends Application { @Override public void onCreate() { super.onCreate(); JPushInterface.setDebugMode(true); JPushInterface.init(this); } }

5、测试确认

  1. 确认所需的权限都已经添加。如果必须的权限未添加，日志会提示错误。
  2. 确认 AppKey（在Portal上生成的）已经正确的写入 Androidmanifest.xml 。
  3. 确认在程序启动时候调用了init(context) 接口
  4. 确认测试手机（或者模拟器）已成功连入网络 ＋ 客户端调用 init 后不久，如果一切正常，应有登录成功的日志信息
  5. 启动应用程序，在 Portal 上向应用程序发送自定义消息推送或者通知栏提示。详情请参考管理Portal。
    • 在几秒内，客户端应可收到下发的通知或者正定义消息 如果 SDK 工作正常，则日志信息会如下图所示：

如图所示，客户端启动分为 4 步：

  1. 检查 metadata 的 appKey 和 channel ，如果不存在，则启动失败
  2. 初始化 JPush SDK，检查 JNI 等库文件的有效性，如果库文件无效，则启动失败
  3. 检查 Androidmanifest.xml，如果有 Required 的权限不存在，则启动失败
  4. 连接服务器登录，如果存在网络问题，则登陆失败,或者前面三步有问题，不会启动JPush SDK

从Eclipse工程导入到Android Studio

JPush Demo 是极光推送随压缩包提供的用法示例Demo，原本适用于Eclipse工程。本教程将指导JPush用户用最简单的方法将极光推送Demo导入Android Studio。

6.1 快速集成JPush

参考3 分钟快速 Demo（Android），把JPush跑起来。之后你在Eclipse包浏览器中有可运行的项目。

6.2 右键点击demo工程，选择Export

6.3 选择导出目标位Gradle build文件，并确认

6.4 从文件浏览器中检查

在Eclipse的workspace中，该Demo工程的文件夹中，生成了Gradle相关配置文件.

6.5 打开你的Android Studio工程，选择 File->Import Module

在Android Studio中，一次只能打开一个Project，它相当于Eclipse中的一个workspace。而我们从Eclipse中导出的一个Project，则相当于Android Studio中的一个Module。

6.6 选择Eclipse workspace下的Demo工程，并确认

6.7 查看导入的Module，并且gradle会自动生成编译选项

现在就可以将极光推送Demo作为Android Studio的Module运行在真机或虚拟机上，并调试了

转载于:https://www.cnblogs.com/jpush88/p/4683405.html

weixin_30263073
关注
Android开发笔记（一百零四）消息推送SDK
aqi00的博客
06-06 8691
推送的集成 常用概念 推送：从服务器把消息实时发到客户端app上，这就是推送，推送可用于发送系统通知、发送推荐信息、发送聊天消息等等。 别名：用于给移动设备取个好记的名字，比如电脑有计算机名，可以把别名理解为开发者给移送设备起的外号。不过，多个移动设备可以起一样的别名，这几个设备就会收到该别名的所有消息。 标记：用于给移动设备打标签，可以理解为分类，比如说超市里的泰国大米既可以打上“粮食制
消息推送Android sdk集成指南
freerocker的专栏
07-28 853
3 分钟快速 Demo（Android）：如果您想要快速地测试、感受下极光推送的效果，请参考本文在几分钟内跑通Demo。
推送sdk_Android 推送 SDK（精简版）发布|五月汇报
weixin_39598796的博客
12-10 274
产品动态7 月 1 日起即时通讯和推送 REST API 将开启请求频率限制2019 年 7 月 1 日起，我们将对推送和即时通讯服务中调用 REST API 进行消息操作开启频率限制(请注意，客户端通过 LeanCloud SDK 产生的行为不受此限制的约束)，以此来提升服务质量和鼓励用户更合理的使用服务。在限制正式生效之后，单位时间内超限的 REST API 请求会被云端拒绝，并返回...
Android 推送 SDK（精简版）发布|五月汇报
LeanCloud通讯
06-10 428
产品动态7 月 1 日起即时通讯和推送 REST API 将开启请求频率限制2019 年 7 月 1 日起，我们将对推送和即时通讯服务中调用 REST API 进行消息操...
友盟消息推送SDK集成
magical_code的博客
04-09 1092
1.创建应用 在友盟有账号的情况下（没有的请自行创建），创建应用之前需要去苹果开发者网站申请一个App ID和配置一个用于推送的APNs证书，下载并安装APNs推送证书后，打开钥匙串从这个证书导出一个.P12的证书文件并保存下来用于创建应用。对APNs证书不了解的可以参考宏创学院提供的证书设置指南： 证书配置      友盟官网 首先在友盟消息推送功能中创建一个应用，上传我们的证
android消息推送书,OnePush一个可拓展的Android消息推送SDK（使用介绍）
weixin_35426202的博客
05-29 482
logo一、为啥会有OnePush消息推送，在国内，要么自己做，要么集成第三方的sdk，现在第三方推送的sdk，有很多可以选择，友盟，极光，小米等，我们在选择消息推送的时候，肯定是需要一个能及时把消息推送给用户的sdk，那么问题来了，很多国产手机厂商都各自根据android修改的UI系统，各种的进程清理，导致消息推送的后台无法存活，特别是小米、华为的手机上，只要用户清理，基本上推送后台服务就死绝了...
android百度推送demo,百度消息推送SDK探究（并附上最简推送Demo）
weixin_36315722的博客
05-28 333
上一篇《百度消息推送REST API探究》中了解了如何使用REST API推送消息，这一篇我们来看一下百度消息推送为我们提供的SDK. 我们先来看一下服务端SDK 下载解压后的目录结构 还是前面提到的那句话，先看samplepackage test;import com.baidu.yun.channel.auth.ChannelKeyPair;import com.baidu.yun.chann...
android极光推送 小米,极光推送 - 小米厂商通道集成指南 - 极光文档
weixin_39656513的博客
05-29 1611
JPush SDK 小米通道集成指南概述在国内 Android 生态中，推送通道都是由终端与云端之间的长链接来维持，严重依赖于应用进程的存活状态。如今一些手机厂家会在自家 rom 中做系统级别的推送通道，再由系统分发给各个 app，以此提高在自家 rom 上的推送送达率。JPush SDK 为了尽可能提高开发者在各类 rom 上的推送送达率，对使用 MIUI 的设备推送，自动切换到小米通道。同时，...
android 集成魅族推送,魅族推送通道集成指南
weixin_39929721的博客
05-28 898
1. 魅族推送通道集成指南魅族推送通道是由魅族官方提供的系统级推送通道。在魅族手机上，推送消息能够通过魅族的系统通道抵达终端，并且无需打开应用就能够收到推送。使用此功能必须先集成信鸽 3.2.1-beta 以上版本。[注意事项]魅族推送通道通知标题不超过32字符，通知内容不超过100字符魅族推送通道不支持透传消息1.1. 获取魅族推送密钥2.注册/登录开发者账号。(如果您是新注册账号，进行实名认证...
个推消息推送SDK通知栏铃声功能解析及使用攻略
个推技术学院
02-25 3559
本文为大家分享个推消息推送SDK【通知栏铃声】功能的使用窍门，帮助开发者用简单10行代码，即可以声传意，轻松收获用户喜爱。 一、功能介绍 众所周知，消息推送是App和用户之间交互的桥梁。App通过通知栏消息，低成本、高效率地向用户告知产品功能更新、运营活动上线、日常新闻动态等重要消息。 为了使用户不错过重要通知，个推SDK还支持App开发者自定义个性化的通知栏铃声（区别于系统提示音），通过声音的方式，更加有效地提醒用户及时查阅关键消息。比如个推某生活服务类App客户使用该功能，将自制的温馨提示
android studio集成极光推送的操作步骤
01-20
在Android Studio中集成极光推送服务，需要遵循一系列步骤，以确保应用程序能够成功接收和处理来自极光推送服务器的消息。以下是一份详细的集成指南： 1. **极光平台配置**： 在极光推送官网创建一个新的应用，并...
MobPush，专业和免费的消息推送SDK
最新发布
apkkkk的博客
03-23 261
作为一名移动应用开发者，你是否遇到过这样的问题：你想给用户发送推送消息，提高用户活跃度和留存率，但是你发现市面上的推送平台要么收费高昂，要么效果不佳，要么集成复杂？相信我，一旦你使用了MobPush，你就会爱上它！MobPush是一款专业免费的推送SDK，由MobTech提供，可以帮助开发者实现智能化的推送服务。一次集成多个厂商推送，包括华为、小米、魅族、OPPO、vivo等主流品牌，让你无需重复集成各个平台的SDK。推送到达率高达99%，毫秒级触达用户，让你的推送消息不会被遗漏或延迟。
百度消息推送SDK探究（并附上最简推送Demo）
Stefan_liu的专栏
10-23 610
上一篇《百度消息推送REST API探究》中了解了如何使用REST API推送消息，这一篇我们来看一下百度消息推送为我们提供的SDK. 帮助文档：http://developer.baidu.com/wiki/index.php?title=docs/cplat/push/api 我们先来看一下服务端SDK 下载解压后的目录结构 还是前面提到的那句话，先看sampl
android SDK核心功能 -- 消息传递与界面刷新
天下无双
01-08 1556
今天来分享一下 项目中view刷新相关的核心功能。 android里线程之间消息的传递都是借助Handler来实现的 用到的场景主要是是Activity、Fragment、Application 、Service、Thread之间的消息互相传递 此实现必须借助抽象类来实现即 BaseActivity  BaseFragment PhoebeApp (现在不讨论Ser
Android开发-在Android应用里集成友盟消息推送SDK的实现（兼容小米、华为、魅族机型离线推送）
_彼岸雨敲窗_的博客
09-30 4646
前 言 最近由于项目的功能需求的需要，需要在Android应用集成消息推送的功能，而目前市面上的第三方消息推送除了友盟推送外，还有极光推送、小米推送、个推以及信鸽（腾讯）推送等。当时本人对比各大第三方的消息推送进行了测试，觉得友盟消息推送集成简单，推送消息的送达率比较高以及即时。而且支持深度优化过的Android系统的国产手机（小米、华为、魅族）应用的进程被“杀死”的情况下能及时送达推送。 集...
个推消息推送SDK后效分析功能，支持推送全流程数据查看
个推技术学院
02-14 775
本文介绍APP推送需要关注的数据指标类型以及提升消息推送到达率、点击率的技巧。 推送全流程数据查看，让你更清楚推送效果 一条推送消息分为5个流程：可下发—成功下发—到达—展示—点击。 而这几个推送环节的数据个推是这么定义的： 可下发数：与个推服务器在90天内有过请求的客户端，即被判定为可下发客户端数量 成功下发数：消息实际下发到.
Android之极光推送SDK集成和基础功能的实现
热门推荐
叶已初秋的博客
02-12 2万+
Android之极光推送SDK集成和基础功能的实现
什么是sdk信息推送服务器,APP消息推送sdk是什么意思，如何更好的推送消息？
weixin_39781323的博客
08-10 772
如今我们身处网络智能时代，手机肯定离不开我们的视线，每天手机里都会出现某些购物APP的推送信息，这些推送都是我们之前关注或浏览过的东西，当看到这些推送信息的时候，会忍不住点开，查看详情。经过数据分析得知，如果用户打开了一款应用的消息推送功能，那么有62%的用户会在几个月之后再次使用这款应用。这可以刺激用户频繁使用APP。那么如何实现更有效的信息推送，不会让用户反感呢？对于APP运营者们来说，PUS...
极光推送(iOS)SDK集成指南
JPush的iOS SDK集成指南为开发者提供了一条快速且高效的路径，帮助他们将推送通知服务无缝地融入到iOS应用中，提高用户体验和应用价值。遵循这个指南，开发者可以减少很多繁琐的工作，更专注于应用的核心功能开发。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值