极光推送 JPush 简介 集成

Posted 白乾涛

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了极光推送 JPush 简介 集成相关的知识,希望对你有一定的参考价值。

Markdown版本笔记 我的GitHub首页 我的博客 我的微信 我的邮箱
MyAndroidBlogs baiqiantao baiqiantao bqt20094 baiqiantao@sina.com

目录

JPush产品简介

Demo地址
控制台

极光推送是一个端到端的推送服务,使得服务器端消息能够及时地推送到终端用户手机上,让开发者积极地保持与用户的连接,从而提高用户活跃度、提高应用的留存率。

主要功能:

  • 保持与服务器的长连接,以便消息能够即时推送到达客户端
  • 接收通知与自定义消息,并向开发者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、快速开始

  • 到极光推送官方网站注册开发者帐号
  • 登录进入管理控制台,创建应用程序,得到 Appkey(SDK与服务器端通过Appkey互相识别);
  • 下载SDK 集成到 App 里。

2、三 分钟快速使用
文档地址

创建应用
使用注册账号登陆,进入极光控制台后,点击“创建应用”按钮。创建帐号进入极光推送后,首先显示的是创建应用的界面。填上你的应用程序的名称,以及 Android包名这二项就可以了。

下载Demo,导入AS,运行
点击 ”下载Demo“,你将下载到一个 .zip 压缩文件。解压后,即看到一个同名目录。这个目录下,是一个 Android 项目里的所有文件。
在 Android Studio 中,新建一个项目。 通过 import module 导入 JPush Example
导入 module 后在 Android studio 内运行到指定设备上

Portal上推送通知和消息
在上述步骤安装 JPush Example 的手机上,你就可以收到推送的通知和消息了。

FAQ

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

以上是关于极光推送 JPush 简介 集成的主要内容,如果未能解决你的问题,请参考以下文章

AndroidStudio离线打包MUI集成JPush极光推送并在java后端管理推送

1Android Studio集成极光推送(Jpush) 报错 java.lang.UnsatisfiedLinkError: cn.jpush.android.service.PushProtoc

IOS JPush 集成步骤(极光远程推送解决方案,支持android和iOS两个平台)

极光推送

极光推送-java消息推送app

Flutter 专题63 图解 Flutter 集成极光 JPush 小结 #yyds干货盘点#