极光推送 JPush 简介 集成 MD
| Markdown版本笔记 | 我的GitHub首页 | 我的博客 | 我的微信 | 我的邮箱 |
|---|---|---|---|---|
| MyAndroidBlogs | baiqiantao | baiqiantao | bqt20094 | baiqiantao@sina.com |
目录
JPush产品简介
极光推送是一个端到端的推送服务，使得服务器端消息能够及时地推送到终端用户手机上，让开发者积极地保持与用户的连接，从而提高用户活跃度、提高应用的留存率。
主要功能：
- 保持与服务器的长连接，以便消息能够即时推送到达客户端
- 接收通知与自定义消息，并向开发者App传递相关信息
主要特点：
- 客户端维持连接占用资源少、耗电低
- SDK丰富的接口，可定制通知栏提示样式
- 服务器大容量、稳定
原理：JPush Android SDK 是作为 Android Service 长期运行在后台的，从而创建并保持长连接，保持永远在线的能力。
JPush是经过考验的大规模APP推送平台，每天推送消息数超过5亿条。 开发者集成SDK后，可以通过调用API推送消息。同时，JPush提供可视化的web端控制台发送通知，统计分析推送效果。 JPush全面支持 Android, iOS, Winphone 三大手机平台。
消息形式
JPush提供四种消息形式：通知，自定义消息，富媒体和本地通知。
1、通知
或者说 Push Notification，即指在手机的通知栏（状态栏）上会显示的一条通知信息。 通知主要用于提示用户的目的，应用于新闻内容、促销活动、产品信息、版本更新提醒、订单状态提醒等多种场景
开发者参考文档：Push API v3 notification
2、自定义消息
自定义消息不是通知，所以不会被SDK展示到通知栏上。其内容完全由开发者自己定义。 自定义消息主要用于应用的内部业务逻辑。一条自定义消息推送过来，有可能没有任何界面显示。
开发者参考文档：Push API v3 message
3、富媒体
JPush支持开发者发送图文并茂的通知，从而更好的传达信息，带来更丰富的用户互动。 JPush提供了5种模板，开发者可以通过填充模板的内容，发送landing page、弹窗、信息流形式的富媒体通知。 开发者还可以直接通过URL发送预先编辑好的页面。 富媒体当前支持Android平台，为更好的使用富媒体的功能，建议更新当前SDK版本至v2.1.8及以上。 暂时只能通过极光推送的控制台发送，不支持API形式。
Android 开发者参考文档：Rich Push开发指南
4、本地通知
本地通知API不依赖于网络，无网条件下依旧可以触发；本地通知的定时时间是自发送时算起的，不受中间关机等操作的影响。 本地通知与网络推送的通知是相互独立的，不受保留最近通知条数上限的限制。 本地通知适用于在特定时间发出的通知，如一些Todo和闹钟类的应用，在每周、每月固定时间提醒用户回到应用查看任务。
Android 开发者参考文档：Android 本地通知
推送目标
通过使用标签，别名，Registration ID 和用户分群，开发者可以向特定的一个或多个用户推送消息。
1、标签
为安装了应用程序的用户打上标签，其目的主要是方便开发者根据标签，来批量下发 Push 消息。 可为每个用户打多个标签。 举例： game, old_page, women
2、别名
每个用户只能指定一个别名（意思是说，一个别名可以有多个用户）。 同一个应用程序内，对不同的用户，建议取不同的别名。这样，尽可能根据别名来唯一确定用户。
Android 开发者参考文档：Android 标签和别名，使用别名和标签推送请参考文档：Push API v3 Audience
3、Registration ID
客户端初始化 JPush 成功后，JPush 服务端会分配一个 Registration ID，作为此设备的标识（同一个手机不同 APP 的 Registration ID 是不同的）。开发者可以通过指定具体的 Registration ID 来进行对单一设备的推送。
4、用户分群
用户分群的筛选条件有：标签、地理位置、系统版本、注册时间、活跃用户和在线用户。 比如，开发者可以设置这样的用户分群：位于北京、上海、广州和深圳，并且最近7天在线的用户。 开发者可以通过在控制台设置好用户分群之后，在控制台推送时指定该分群的名称或使用API调用该分群的id发送。
用户分群控制台使用指南：用户分群
5、统计分析
JPush支持推送数量、用户打开次数、用户使用时长、新增用户、活跃用户等数据的统计。 Android开发者需要实现了相关的统计API，才可以进行用户相关的统计。 iOS的开发者不需要实现统计API，可以直接在【控制台】-【统计】页面查看相关数据。
Android 开发者参考文档：统计分析API
集成步骤
1、快速开始
2、三 分钟快速使用
文档地址
创建应用
使用注册账号登陆，进入极光控制台后，点击“创建应用”按钮。创建帐号进入极光推送后，首先显示的是创建应用的界面。填上你的应用程序的名称，以及 Android包名这二项就可以了。
下载Demo，导入AS，运行
点击 ”下载Demo“，你将下载到一个 .zip 压缩文件。解压后，即看到一个同名目录。这个目录下，是一个 Android 项目里的所有文件。
在 Android Studio 中，新建一个项目。 通过 import module 导入 JPush Example
导入 module 后在 Android studio 内运行到指定设备上
Portal上推送通知和消息
在上述步骤安装 JPush Example 的手机上，你就可以收到推送的通知和消息了。
FAQ
怎么样保证推送消息的安全？
我们建议开发者不要推送保密的信息，就像QQ建议你不要在聊天时发送保密的信息一样。
如果开发者的确有保密的信息，需要送达到用户，则可以考虑这样做：
先通过 JPush 推送一条消息，这条消息触发客户端App去与开发者服务器交互保密信息。
极光推送后台使用什么技术实现的？是 XMPP 协议么？
后台主要使用纯 C 语言实现。
使用自定义的二进制协议，以尽可能节约流量。
可以推送多媒体文件到客户端么？
推送消息本身是限定长度的文本。
不直接支持文件的推送，但可以通过推送 url 来实现。
即先推送文件下载 url，到客户端触发逻辑来通过 url 下载文件。
为什么应用程序无法收到 Push 消息（Android）？
确认 appKey（在Portal上生成的）已经正确的写入 Androidmanifest.xml
确认测试手机（或者模拟器）已成功连入网络
确认有客户端 "Login succeed" 日志
日志：Java.lang.UnsatisfiedLinkError
此错误是由于没有正确的加载libjpush.so文件，请检查libjpush.so是否在正确的位置(libs–>armeabi–>libjpush.so)
JPush SDK 迁移到 Android Studio 需要添加 .SO 文件打包到APK的lib文件夹中，可以编辑 build.gradle 脚本，自定义 .so 目录。
日志：The permission should be defined
此错误是没有正确的定义permision，请添加权限：
<permission android:name="您应用的包名.permission.JPUSH_MESSAGE" android:protectionLevel="signature" ></permission>
<uses-permission android:name="您应用的包名.permission.JPUSH_MESSAGE" ></uses>推送成功了，为什么有部分客户端收不到推送？
请检查收不到通知的手机：
请在logcat查看日志，确定客户端的jpush是否集成成功，网络是否有问题
请看日志或使用接口 isPushStopped来检查是否调用了stoppush
检查手机的JPush高级设置中是否设置了“允许推送时间”
手机的应用中是否勾选了“显示通知”
Tag、Alias、Registrationid需要每次初始化时都重新设置吗，会变化吗？
tag、alias可以参考别名与标签 API进行设置，每次设置是覆盖设置，而不是增量设置。Tag和alias一经设置成功，除非取消或覆盖，是不会变化的。设置好的tag、alias与客户端的对应关系保存在JPush服务器，目前没有从JPush服务器查询这个对应关系的接口，所以需要客户将对应关系保存在APP应用服务器。
Registrationid是客户端SDK第一次成功连接到Jpush服务器时，Jpush服务器给分配的。可以通过获取 RegistrationID API来获取Registrationid进行推送。Registrationid对应一个应用的一个客户端。
appkey是怎么对应的？
android 的包名和 appkey 需对应。
简洁版自定义消息推送Demo
自定义消息又叫应用内消息，或者称作透传消息。此部分内容不会展示到通知栏上，JPush SDK 收到消息内容后透传给 App，需要 App 自行处理。
| 关键字 | 类型 | 选项 | 含义 |
|---|---|---|---|
| msg_content | string | 必填 | 消息内容本身 |
| title | string | 可选 | 消息标题 |
| content_type | string | 可选 | 消息内容类型 |
| extras | JSON Object | 可选 | JSON 格式的可选参数 |
在适当的时候初始化
private void initJPush() {
JPushInterface.setDebugMode(true); // 设置开启日志,发布时请关闭日志
JPushInterface.init(this); // 初始化 JPush
}Activity
public class JPushTestActivity extends ListActivity {
public static boolean isForeground = false;
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
TextView tv = new TextView(this);
tv.setTextColor(Color.BLUE);
String string = "AppKey: " + PushUtil.getAppKey(this) + "\n" +
"IMEI: " + PushUtil.getImei(this, "") + "\n" +
"RegId:" + JPushInterface.getRegistrationID(this) + "\n" +
"PackageName: " + getPackageName() + "\n" +
"deviceId:" + PushUtil.getDeviceId(this) + "\n" +
"Version: " + PushUtil.GetVersionName(this);
tv.setText(string);
getListView().addHeaderView(tv);
String[] array = {"initPush", "stopPush", "resumePush",};
setListAdapter(new ArrayAdapter<>(this, android.R.layout.simple_list_item_1, new ArrayList<>(Arrays.asList(array))));
EventBus.getDefault().register(this);
}
@Override
protected void onListItemClick(ListView l, View v, int position, long id) {
switch (position - 1) {
case 0:
JPushInterface.init(this);// 初始化 JPush。如果已经初始化，但没有登录成功，则执行重新登录。
break;
case 1:
JPushInterface.stopPush(this);
break;
case 2:
JPushInterface.resumePush(this);
break;
}
}
@Override
protected void onResume() {
isForeground = true;
super.onResume();
}
@Override
protected void onPause() {
isForeground = false;
super.onPause();
}
@Override
protected void onDestroy() {
super.onDestroy();
EventBus.getDefault().unregister(this);
}
@Subscribe(threadMode = ThreadMode.MAIN)
public void onPushEvent(BasePushBean bean) {
TextView tv = new TextView(this);
tv.setTextColor(Color.BLUE);
tv.setText(bean.msg);
getListView().addFooterView(tv);
}
}Receiver
/**
* 自定义接收器。如果不定义这个 Receiver，则默认用户会打开主界面，接收不到自定义消息
*/
public class JPushReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
if (intent == null || intent.getAction() == null) return;
Bundle bundle = intent.getExtras();
Log.i("bqt", "【JPushReceiver】Action：" + intent.getAction() + "\nextras：" + printBundle(bundle));
switch (intent.getAction()) {
case JPushInterface.ACTION_MESSAGE_RECEIVED://将自定义消息转发到需要的地方
Log.i("bqt", "【JPushReceiver】接收到推送下来的自定义消息");
if (bundle != null) {
PushMsgReceiverHelper.getInstance().onJPushMsgReceiver(bundle);
}
break;
case JPushInterface.ACTION_REGISTRATION_ID:
String regId = bundle == null ? "" : bundle.getString(JPushInterface.EXTRA_REGISTRATION_ID);
Log.i("bqt", "【JPushReceiver】接收Registration Id : " + regId);
break;
case JPushInterface.ACTION_NOTIFICATION_RECEIVED:
Log.i("bqt", "【JPushReceiver】接收到推送下来的通知");
int notifactionId = bundle == null ? -1 : bundle.getInt(JPushInterface.EXTRA_NOTIFICATION_ID);
Log.i("bqt", "【JPushReceiver】接收到推送下来的通知的ID: " + notifactionId);
break;
case JPushInterface.ACTION_NOTIFICATION_OPENED:
Log.i("bqt", "【JPushReceiver】用户点击打开了通知");
break;
case JPushInterface.ACTION_RICHPUSH_CALLBACK: // 根据 JPushInterface.EXTRA_EXTRA 的内容处理代码
String extra = bundle == null ? "" : bundle.getString(JPushInterface.EXTRA_EXTRA);
Log.i("bqt", "【JPushReceiver】用户收到到RICH PUSH CALLBACK: " + extra);
break;
case JPushInterface.ACTION_CONNECTION_CHANGE:
boolean connected = intent.getBooleanExtra(JPushInterface.EXTRA_CONNECTION_CHANGE, false);
Log.i("bqt", "【JPushReceiver】" + intent.getAction() + " connected state change to " + connected);
break;
default:
Log.i("bqt", "【JPushReceiver】Unhandled intent - " + intent.getAction());
break;
}
}
// 打印所有的 intent extra 数据
private static String printBundle(Bundle bundle) {
if (bundle == null) return "";
StringBuilder sb = new StringBuilder();
for (String key : bundle.keySet()) {
switch (key) {
case JPushInterface.EXTRA_NOTIFICATION_ID:
sb.append("\nkey:").append(key).append(", value:").append(bundle.getInt(key));
break;
case JPushInterface.EXTRA_CONNECTION_CHANGE:
sb.append("\nkey:").append(key).append(", value:").append(bundle.getBoolean(key));
break;
case JPushInterface.EXTRA_EXTRA:
if (TextUtils.isEmpty(bundle.getString(JPushInterface.EXTRA_EXTRA))) {
Log.i("bqt", "This message has no Extra data");
continue;
}
try {
JSONObject json = new JSONObject(bundle.getString(JPushInterface.EXTRA_EXTRA));
Iterator<String> it = json.keys();
while (it.hasNext()) {
String myKey = it.next();
sb.append("\nkey:").append(key)
.append(", value: [").append(myKey)
.append(" - ").append(json.optString(myKey)).append("]");
}
} catch (JSONException e) {
e.printStackTrace();
}
break;
default:
sb.append("\nkey:").append(key).append(", value:").append(bundle.getString(key));
break;
}
}
return sb.toString();
}
}消息处理类
/**
* 处理推送SDK推过来的自定义消息（又叫应用内消息，或者透传消息）
*/
public class PushMsgReceiverHelper {
private static PushMsgReceiverHelper instance = new PushMsgReceiverHelper();
private PushMsgReceiverHelper() {
}
public static PushMsgReceiverHelper getInstance() {
return instance;
}
/**
* 处理极光推送推过来的自定义消息
*/
public void onJPushMsgReceiver(Bundle bundle) {
String message = bundle.getString(JPushInterface.EXTRA_MESSAGE);//必填，消息内容本身
String title = bundle.getString(JPushInterface.EXTRA_TITLE);//可选，消息标题
String type = bundle.getString(JPushInterface.EXTRA_CONTENT_TYPE);//可选，消息内容类型
String extra = bundle.getString(JPushInterface.EXTRA_EXTRA);//可选，JSON 格式的可选参数
String content = "msg:" + message + "\t title:" + title + "\t type:" + type + "\t extra:" + extra;
Log.i("bqt", "【极光推送】" + content);
if (JPushTestActivity.isForeground) {
EventBus.getDefault().post(new BasePushBean(content, BasePushBean.TYPE_STRING));
}
}
/**
* 处理小米推送推过来的自定义消息
*/
public void onMiPushMsgReceiver(MiPushMessage message) {
}
/**
* 处理华为光推送推过来的自定义消息
*/
public void onHuaweiPushMsgReceiver(String message) {
}
/**
* 处理魅族推送推过来的自定义消息
*/
public void onMeiZhuPushMsgReceiver(String message) {
}
}Bean
public class BasePushBean {
public static final int TYPE_STRING = 1;
public static final int TYPE_JSONOBJ = 2;
public String msg;
public int type;
public BasePushBean(String msg, int type) {
this.msg = msg;
this.type = type;
}
}配置文件
build.gradle
implementation files('libs/jcore-android-1.2.0.jar')
implementation files('libs/jpush-android-3.1.2.jar')
implementation 'org.greenrobot:eventbus:3.1.1'混淆文件：proguard-android.txt
-dontoptimize
-dontpreverify
-dontwarn cn.jpush.**
-keep class cn.jpush.** { *; }
#v2.0.5 及以上的版本由于引入了protobuf ，在上面基础之上增加排除混淆的配置。
#==================gson==========================
-dontwarn com.google.**
-keep class com.google.gson.** {*;}
#==================protobuf======================
-dontwarn com.google.**
-keep class com.google.protobuf.** {*;}AndroidManifest.xml
<!--====================== 推送SDK需要定义的权限【需要更改包名】 =====================-->
<!--极光-->
<permission
android:name="com.bqt.push.permission.JPUSH_MESSAGE"
android:protectionLevel="signature"/>
<uses-permission android:name="com.bqt.push.permission.JPUSH_MESSAGE"/>
<!--小米-->
<!--华为-->
<!--魅族--><!--========================= 极光推送需要注册的组件 start =========================-->
<!-- User defined. 用户自定义的广播接收器-->
<receiver
android:name="com.bqt.push.receiver.JPushReceiver"
android:enabled="true"
android:exported="false">
<intent-filter>
<action android:name="cn.jpush.android.intent.REGISTRATION"/> <!--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 用户接收SDK通知栏信息的intent-->
<action android:name="cn.jpush.android.intent.NOTIFICATION_OPENED"/> <!--Required 用户打开自定义通知栏的intent-->
<action android:name="cn.jpush.android.intent.CONNECTION"/><!-- 接收网络变化 连接/断开 since 1.6.3 -->
<category android:name="com.bqt.push"/>
</intent-filter>
</receiver>
<activity
android:name="cn.jpush.android.ui.PopWinActivity"
android:exported="false"
android:theme="@style/MyDialogStyle">
</activity>
<activity
android:name="cn.jpush.android.ui.PushActivity"
android:configChanges="orientation|keyboardHidden"
android:exported="false"
android:theme="@android:style/Theme.NoTitleBar">
<intent-filter>
<action android:name="cn.jpush.android.ui.PushActivity"/>
<category android:name="android.intent.category.DEFAULT"/>
<category android:name="com.bqt.push"/>
</intent-filter>
</activity>
<service
android:name="cn.jpush.android.service.PushService"
android:exported="false"
android:process=":mult">
<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>
<provider
android:name="cn.jpush.android.service.DataProvider"
android:authorities="com.bqt.push.DataProvider"
android:exported="false"/>
<!-- 可选项。用于同一设备中不同应用的JPush服务相互拉起的功能。 -->
<!-- 若不启用该功能可删除该组件，将不拉起其他应用也不能被其他应用拉起 -->
<service
android:name="cn.jpush.android.service.DaemonService"
android:enabled="true"
android:exported="true"
tools:ignore="ExportedService">
<intent-filter>
<action android:name="cn.jpush.android.intent.DaemonService"/>
<category android:name="com.bqt.push"/>
</intent-filter>
</service>
<provider
android:name="cn.jpush.android.service.DownloadProvider"
android:authorities="com.bqt.push.DownloadProvider"
android:exported="true"
tools:ignore="ExportedContentProvider"/>
<receiver
android:name="cn.jpush.android.service.PushReceiver"
android:enabled="true"
android:exported="false">
<intent-filter android:priority="1000">
<action android:name="cn.jpush.android.intent.NOTIFICATION_RECEIVED_PROXY"/> <!--Required 显示通知栏 -->
<category android:name="com.bqt.push"/>
</intent-filter>
<intent-filter>
<action android:name="android.intent.action.USER_PRESENT"/>
<action
android:name="android.net.conn.CONNECTIVITY_CHANGE"
tools:ignore="BatteryLife"/>
</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>
<receiver
android:name="cn.jpush.android.service.AlarmReceiver"
android:exported="false"/>
<!-- Enable it you can get statistics data with channel -->
<meta-data
android:name="JPUSH_CHANNEL"
android:value="developer-default"/>
<meta-data
android:name="JPUSH_APPKEY"
android:value="7ced56a29466cb706362bb82"/> <!-- 值来自开发者平台取得的AppKey-->
<!--========================= 极光推送需要注册的组件 end =========================-->2018-4-9