极光小课堂 | 极光推送集成解决方案

1. 极光推送集成背景

最近在研究推送和长连接，调研了市场上的几家平台，综合考虑选择了极光推送。长连接保活一直是一个大问题，尤其是 Android 方面。在最近谷歌公司的几次更新之后，Android 应用保活越来越难做，Android 方面的推送的到达率更是惨不忍睹，而国内 Android 大环境大都以云端和客户端保持长连接的方式实现。

本文主要分享极光推送普通集成和极光推送厂商通道的集成。

2. 推送普通集成方案

创建项目（见极光文档：

https://docs.jiguang.cn//jpush/guideline/intro/ ）

①添加依赖

Project 根目录的主 gradle 中配置了 jcenter 支持

implementation 'cn.jiguang.sdk:jpush:3.5.4'
implementation 'cn.jiguang.sdk:jcore:2.2.4'

②配置代码

配置极光的key，app 的 gradle 文件中配置极光的 key

ndk {
            abiFilters "armeabi", "armeabi-v7a", "x86", "arm64-v8a", "x86_64",'mips', 'mips64'


        }
        manifestPlaceholders = [
                JPUSH_PKGNAME : applicationId,
JPUSH_APPKEY : "JPUSH KEY", //JPush 上注册的包名对应的 Appkey.
                JPUSH_CHANNEL : "developer-default", //暂时填写默认值即可.

权限配置

服务和广播配置 

这里需要自定义一个消息接收器 JPushReceiver

/**
 * 消息处理，配合服务端实现具体的逻辑
 */
public class JPushReceiver extends JPushMessageReceiver {
    @Override
    public void onMessage(Context context, CustomMessage customMessage) {
        super.onMessage(context, customMessage);
        //消息到达 可指定类型，指定操作
        NotificationBar.showNotifiBar(context,"我是消息","我是消息内容");
        Log.d("jpush", "onMessage: "+customMessage.message+"/"+customMessage.extra);
    }


    @Override
    public void onNotifyMessageArrived(Context context, NotificationMessage notificationMessage) {
        super.onNotifyMessageArrived(context, notificationMessage);
        // 通知到达
        Log.d("jpush", "onNotifyMessageArrived: "+notificationMessage.notificationExtras);
    }


    @Override
    public void onNotifyMessageOpened(Context context, NotificationMessage notificationMessage) {
        super.onNotifyMessageOpened(context, notificationMessage);
        // 点击通知栏消息 可指定类型，指定操作
        Log.d("jpush", "onNotifyMessageOpened: "+notificationMessage.notificationExtras);


    }


    @Override
    public void onRegister(Context context, String s) {
        super.onRegister(context, s);
        // 保存极光id
        Log.d("jpush", "onRegister: id="+s);


    }


    @Override
    public void onConnected(Context context, boolean b) {
        super.onConnected(context, b);
        Log.d("jpush", "onConnected: "+b);
        if (b) {
            // 链接监听 保存极光id
            String registrationID = JPushInterface.getRegistrationID(context.getApplicationContext());
            Log.d("jpush", "onConnected: 连接成功获取id="+registrationID);
        }
    }

‍

③ 初始化

这里关于初始化方案这里分享两种：

i.  极光方案，在 Application 的 onCreate 中初始化，也就是在应用启动时初始化极光，优点快速准确；但会影响 app 启动速度。

ii.  在启动页初始化，优点 app 启动速度快。我个人觉得第二方案更好一点，在优化 app 启动时,会有一些帮助。

RegistrationID 的获取，也有两个方案：

i. 在初始化以后，获取极光id 极光id 是异步返回的，此处不一定获取成功。

String registrationID = JPushInterface.getRegistrationID(getApplicationContext());

ii. JPushReceiver 中获取，这里获取更为安全，能确保你一定可以拿到 id，建议采用该种方案

 @Override
    public void onRegister(Context context, String s) {
        super.onRegister(context, s);
        // 保存极光id
        Log.d("jpush", "onRegister: 注册成功后返回极光id="+s);


    }


    @Override
    public void onConnected(Context context, boolean b) {
        super.onConnected(context, b);
        Log.d("jpush", "onConnected: "+b);
        if (b) {
            // 链接监听 保存极光id
            String registrationID = JPushInterface.getRegistrationID(context.getApplicationContext());
            Log.d("jpush", "onConnected: 连接成功获取id="+registrationID);
        }

到此处，极光推送的基本集成就完成了，可以在极光的管理中心，开始测试推送了。

在普通集成的基础上，我们开始集成厂商通道。

3. 厂商通道的集成

厂商通道，直白点说就是系统级推送，和 iOS 一样；推送至手机系统平台，由系统平台作为系统通知展示，到达率得到了很大的保证。

目前极光支持 小米 华为 魅族 oppo vivo FCM 这几个平台的厂商通道；原理见下图：

①申请平台项目（小米，华为创建项目，审核通过后申请项目的推送服务）

以小米为例：

https://dev.mi.com/console/appservice/push.html

先在小米开放平台创建项目并填写各种资料，审核通过后，就可以开始申请小米推送服务，并在极光后台配置 id 即可；配置好以后，开始进行代码配置。同时，Project 根目录的主 gradle 中配置了华为支持。

allprojects {
    repositories {


        google()
 
        maven { url "https://jitpack.io" }
        maven {url'http://developer.huawei.com/repo/'}
    }
}

implementation 'cn.jiguang.sdk.plugin:huawei:3.3.4'
    implementation 'cn.jiguang.sdk.plugin:xiaomi:3.3.4'
    implementation 'cn.jiguang.sdk.plugin:meizu:3.3.4'
    implementation 'cn.jiguang.sdk.plugin:oppo:3.3.4'
    implementation 'cn.jiguang.sdk.plugin:vivo:3.3.4'

在 app 的 gradle 配置厂商平台申请好的 id 和 key

 

备注：这里使用的是各平台项目的推送服务 id，各平台项目的推送服务 id，各平台项目的推送服务 id！！！

manifestPlaceholders = [
                JPUSH_PKGNAME : applicationId,
                JPUSH_APPKEY  : "JPUSHKEY", //JPush上注册的包名对应的appkey.
                JPUSH_CHANNEL : "developer-default", //暂时填写默认值即可.
                HUAWEI_APPID  : "100574375",//华为平台注册的appid


                XIAOMI_APPKEY : "MI-KEY",//小米平台注册的appkey
                XIAOMI_APPID  : "MI-IS",//小米平台注册的appid


                MEIZU_APPKEY  : "MZ-KEY",//魅族平台注册的appkey
                MEIZU_APPID   : "MZ-ID",//魅族平台注册的appid


                OPPO_APPKEY   : "OP-KEY", // OPPO平台注册的appkey
                OPPO_APPID    : "OP-ID", // OPPO平台注册的appid
                OPPO_APPSECRET: "OP-SECRET"
                // vivo
                VIVO_APPKEY : "KEY",
                VIVO_APPID : "ID"


        ]

到此处就完成了。

关于厂商通道的测试方法，去各大平台的推送服务里的项目中，进行手动推送测试。以小米为例，小米开放平台 --- 应用服务 -- 消息推送 -- 全部应用 --- 你的应用 -- 创建推送，即可开始测试。

测试方法：

①保持长链接时，手动推送，是否收到推送消息

②断开长链接时，手动推送，是否收到推送消息

③断开长链接时，手动推送，打开应用后是否收到推送消息

关于极光

极光（Aurora Mobile，纳斯达克股票代码：JG）成立于2011年，是中国领先的开发者服务提供商。极光专注于为移动应用开发者提供稳定高效的消息推送、即时通讯、统计分析、极光分享、短信、一键认证、深度链接等开发者服务。截止到2019年12月份，极光已经为超过50万移动开发者和145.2万款移动应用提供服务，其开发工具包（SDK）安装量累计336亿，月度独立活跃设备13.6亿部。同时，极光持续赋能开发者和传统行业客户，推出精准营销、金融风控、市场洞察、商业地理服务产品，致力于为社会和各行各业提高运营效率，优化决策制定。