JPush推送（极光推送）推送消息

2017-03-20 本文已影响2382人 fengcz

jpush推送

其正常工作的必要条件是：JPush SDK 与 JPush Server 的网络保持着连接。请参考这篇文章来做进一步的理解：极光推送技术原理：移动无线网络长连接。

推送流程

开发者集成 JPush Android SDK 到其应用里，JPush Android SDK 创建到 JPush Cloud 的长连接，为 App 提供永远在线的能力。
当开发者想要及时地推送消息到达 App 时，只需要调用 JPush API 推送，或者使用其他方便的智能推送工具，即可轻松与用户交流。
图中红色部分，是 JPush 与 App 开发者的接触点。手机客户端侧，App 需要集成 JPush SDK；服务器端部分，开发者调用 JPush REST API 来进行推送。

Android SDK 服务
JPush Android SDK 是作为 Android Service 长期运行在后台的，从而创建并保持长连接，保持永远在线的能力。
JPush可推送的内容如下

可推送的类型

其中红包需要集成第三方SDK
区别通知于自定义消息
通知即指在手机的通知栏（状态栏）上会显示的一条通知信息。
自定义消息是极光推送自己的概念。
自定义消息不是通知，所以不会被SDK展示到通知栏上。其内容完全由开发者自己定义。
自定义消息主要用于应用的内部业务逻辑。一条自定义消息推送过来，有可能没有任何界面显示

使用Jcenter自动集成说明

使用jcenter自动集成的开发者，不需要在项目中添加jar和so，jcenter会自动完成依赖；在AndroidManifest.xml中不需要添加任何JPush SDK 相关的配置，jcenter会自动导入。
如果开发者需要修改组件属性，可以在本地的 AndroidManifest 中定义同名的组件并配置想要的属性，然后用 xmlns:tools 来控制本地组件覆盖 jcenter 上的组件。

集成步骤

当然先要注册开发者账号
下载对应平台的SDK(android/ios/windowsphone/...)
配置
开发
测试推送

来一波最easy的demo

以android项目为例，使用Android Studio自动集（jcenter）成极光推送

创建AS项目
在JPUSH平台创建应用，获取appkey,创建时需提供项目的包名
在module:app下的build.gradle中添加依赖
compile 'cn.jiguang.sdk:jpush:3.0.3' // 此处以JPush 3.0.3 版本为例。 compile 'cn.jiguang.sdk:jcore:1.1.1' // 此处以JCore 1.1.1 版本为例。
module:app下的build.gradle>defaultConfig{}中添加以下代码

 ndk {
            //选择要添加的对应cpu类型的.so库。
            abiFilters 'armeabi', 'armeabi-v7a', 'armeabi-v8a'
            // 还可以添加 'x86', 'x86_64', 'mips', 'mips64'
        }
 manifestPlaceholders = [
                JPUSH_PKGNAME : applicationId,
                JPUSH_APPKEY : "eabbe4d26af31ef9b397c3a7", //JPush上注册的包名对应的appkey.
                JPUSH_CHANNEL : "developer-default", //暂时填写默认值即可.
        ]

配置完毕了，点击一下如图按钮，as自动集成所需，不报错就可以进行下一项了

同步一下

在项目的Application中进行初始化JPUSH的SDK

@Override
    public void onCreate() {
        super.onCreate();
        //初始化
        JPushInterface.init(this);
        //开启调试
        JPushInterface.setDebugMode(true);
    }

在JPUSH控制台进行推送测试

测试结果提示：

按以上操作就简单集成了，后台推送的消息也能准确接收到
在系统通知栏可以看见图标为android中经典的icon(机器人图标)
发送通知和富媒体消息下的URL消息可准确收到
自定义消息后台显示成功，通知栏不显示（这个属于正常情况，需显示还需要自己操作）
富媒体消息下的模板后台显示发送成功，手机上未收到消息

针对以上出现问题的(使用jcenter集成)解决方案

如何设置推送显示项目所需的图标？

官方文档特别说明
说明：若没有res/drawable-xxxx/jpush_notification_icon这个资源默认使用应用图标作为通知icon，在5.0以上系统将应用图标作为statusbar icon可能显示不正常，用户可定义没有阴影和渐变色的icon替换这个文件，文件名不要变。
尝试：将自己的图片改名为jpush_notification_icon放到res/drawable-xxxx文件夹，重新运行仍然显示默认icon

终极方案

基于上面出现的问题，如何才能接收到富媒体消息？

原因：未配置PushActivity组件
必须将压缩包 res 中的资源放到我们自己的项目的对应文件夹，并按照官方示例 AndroidManifest.xml配置 PushActivity 组件
终极方案

基于上面出现的问题，如何才能接收到自定义消息并显示到所发送的消息？

自定义消息：SDK 不会把自定义消息展示到通知栏。
调试时，需要到日志里才可以看到服务器端推送的自定义消息。自定义消息一定要由开发者写接收推送消息来处理收到的消息

自定义广播接收器MyReceiver(采用静态注册方式)
AndroidManifest.xml注册广播配置,这里添加所有action具体项目可根据实际情况配置

 <receiver android:name=".MyReceiver"
            android:enabled="true"
            >
            <intent-filter>
                <action android:name="cn.jpush.android.intent.REGISTRATION" />
                <action android:name="cn.jpush.android.intent.MESSAGE_RECEIVED" />
                <action android:name="cn.jpush.android.intent.NOTIFICATION_RECEIVED" />
                <action android:name="cn.jpush.android.intent.NOTIFICATION_OPENED" />
                <action android:name="cn.jpush.android.intent.NOTIFICATION_CLICK_ACTION" />
                <action android:name="cn.jpush.android.intent.CONNECTION" />
                <category android:name="com.pushdemo" />
            </intent-filter>
        </receiver>

广播中的每个action详情功能说明，请查看官方文档API-接收推送消息Receiver

附上项目完整MyReceiver

public class MyReceiver extends BroadcastReceiver {
    @Override
    public void onReceive(Context context, Intent intent) {
        Bundle bundle = intent.getExtras();
        Log.d(TAG, "onReceive - " + intent.getAction());

        if (JPushInterface.ACTION_REGISTRATION_ID.equals(intent.getAction())) {
        } else if (JPushInterface.ACTION_MESSAGE_RECEIVED.equals(intent.getAction())) {
            // 自定义消息不会展示在通知栏，完全要开发者写代码去处理
            String content = bundle.getString(JPushInterface.EXTRA_MESSAGE);
            String extra = bundle.getString(JPushInterface.EXTRA_EXTRA);
            Toast.makeText(context, "自定义消息" + content + "\nextra" + extra, Toast.LENGTH_SHORT).show();
           
            //TODO 可推送json过来，接收到再解析

                    } else if (JPushInterface.ACTION_NOTIFICATION_RECEIVED.equals(intent.getAction())) {
            System.out.println("收到了通知");
            // 在这里可以做些统计，或者做些其他工作
        } else if (JPushInterface.ACTION_NOTIFICATION_OPENED.equals(intent
                .getAction())) {
            System.out.println("用户点击打开了通知");
            // 在这里可以自己写代码去定义用户点击后的行为
            Intent i = new Intent(context, MainActivity.class); // 自定义打开的界面
            i.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
            context.startActivity(i);
        } else {
            Log.d(TAG, "Unhandled intent - " + intent.getAction());
        }
    }
}

持续更新中.......