准备做极光推送,先留着.

原文地址:https://zhangxing.blog.csdn.net/article/details/103757112

1. 极光推送集成背景

      最近在研究推送和长连接,研究了几家这方面的平台之后,最后综合考虑选择了极光推送。长连接保活一直是一个大问题,尤其的android方面,最近谷歌公司的几次更新,android应用保活是越来越难做,android方面的推送的到达率更是惨不忍睹。国内android大环境大都以云端和客户端保持长连接的方式实现的。本文主要是说一下极光推送普通集成和极光推送厂商通道的集成。

2. 推送普通集成方案


创建项目(见极光文档:https://docs.jiguang.cn//jpush/guideline/intro/ )

①添加依赖

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

 
  1. implementation 'cn.jiguang.sdk:jpush:3.5.4'

  2. implementation 'cn.jiguang.sdk:jcore:2.2.4'

②配置代码

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

 
  1. ndk {

  2.             abiFilters "armeabi", "armeabi-v7a", "x86", "arm64-v8a", "x86_64",'mips', 'mips64'

  3.  
  4.         }

  5.         manifestPlaceholders = [

  6.                 JPUSH_PKGNAME : applicationId,

  7.                 JPUSH_APPKEY : "JPUSH KEY", //JPush 上注册的包名对应的 Appkey.

  8.                 JPUSH_CHANNEL : "developer-default", //暂时填写默认值即可.

  9.         ]

权限配置

 
  1.  <permission

  2.         android:name="com.nade.nadejpush.permission.JPUSH_MESSAGE"

  3.         android:protectionLevel="signature" />

  4.  
  5.     <!-- Required -->

  6.  
  7.     <uses-permission android:name="android.permission.RECEIVE_USER_PRESENT" />

  8.     <uses-permission android:name="android.permission.INTERNET" />

  9.     <uses-permission android:name="android.permission.READ_PHONE_STATE" />

  10.     <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

  11.     <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

  12.     <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS" />

  13.     <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

  14.     <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />

  15.  
  16.     <!-- Optional. Required for location feature -->

  17.     <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />

  18.     <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" /> <!-- 用于开启 debug 版本的应用在 6.0 系统上的层叠窗口权限 -->

  19.     <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

  20.     <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />

  21.     <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

  22.     <uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS" />

  23.     <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />

  24.     <uses-permission android:name="android.permission.GET_TASKS" />

  25.     <uses-permission android:name="android.permission.VIBRATE" />

服务和广播配置 

 
  1. <!-- Since JCore2.0.0 Required SDK核心功能-->

  2.         <!-- 可配置android:process参数将Service放在其他进程中;android:enabled属性不能是false -->

  3.         <!-- 这个是自定义Service,要继承极光JCommonService,可以在更多手机平台上使得推送通道保持的更稳定 -->

  4.         <service android:name=".service.JPushService"

  5.             android:enabled="true"

  6.             android:exported="false"

  7.             android:process=":pushcore">

  8.             <intent-filter>

  9.                 <action android:name="cn.jiguang.user.service.action" />

  10.             </intent-filter>

  11.         </service>

  12.         <service

  13.             android:name="cn.jpush.android.service.PushService"

  14.             android:enabled="true"

  15.             android:exported="false" >

  16.             <intent-filter>

  17.                 <action android:name="cn.jpush.android.intent.REGISTER" />

  18.                 <action android:name="cn.jpush.android.intent.REPORT" />

  19.                 <action android:name="cn.jpush.android.intent.PushService" />

  20.                 <action android:name="cn.jpush.android.intent.PUSH_TIME" />

  21.             </intent-filter>

  22.         </service>

  23.         <service

  24.             android:name="cn.jpush.android.service.DaemonService"

  25.             android:enabled="true"

  26.             android:exported="true">

  27.             <intent-filter >

  28.                 <action android:name="cn.jpush.android.intent.DaemonService" />

  29.                 <category android:name="com.nade.nadejpush"/>

  30.             </intent-filter>

  31.         </service>

  32.         <!-- Required since 3.0.7 -->

  33.         <!-- 新的 tag/alias 接口结果返回需要开发者配置一个自定的广播 -->

  34.         <!-- 3.3.0开始所有事件将通过该类回调 -->

  35.         <!-- 该广播需要继承 JPush 提供的 JPushMessageReceiver 类, 并如下新增一个 Intent-Filter -->

  36.         <receiver

  37.             android:name=".receiver.JPushReceiver"

  38.             android:enabled="true"

  39.             android:exported="false" >

  40.             <intent-filter>

  41.                 <action android:name="cn.jpush.android.intent.RECEIVE_MESSAGE" />

  42.                 <category android:name="com.nade.nadejpush" />

  43.             </intent-filter>

  44.         </receiver>

  45.  
  46.         <receiver

  47.             android:name="cn.jpush.android.service.PushReceiver"

  48.             android:enabled="true" >

  49.             <intent-filter android:priority="1000">

  50.                 <action android:name="cn.jpush.android.intent.NOTIFICATION_RECEIVED_PROXY" />

  51.                 <category android:name="com.nade.nadejpush"/>

  52.             </intent-filter>

  53.             <intent-filter>

  54.                 <action android:name="android.intent.action.USER_PRESENT" />

  55.                 <action android:name="android.net.conn.CONNECTIVITY_CHANGE" />

  56.             </intent-filter>

  57.             <!-- Optional -->

  58.             <intent-filter>

  59.                 <action android:name="android.intent.action.PACKAGE_ADDED" />

  60.                 <action android:name="android.intent.action.PACKAGE_REMOVED" />

  61.                 <data android:scheme="package" />

  62.             </intent-filter>

  63.         </receiver>


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

 
  1. /**

  2.  * 消息处理,配合服务端实现具体的逻辑

  3.  */

  4. public class JPushReceiver extends JPushMessageReceiver {

  5.     @Override

  6.     public void onMessage(Context context, CustomMessage customMessage) {

  7.         super.onMessage(context, customMessage);

  8.         //消息到达 可指定类型,指定操作

  9.         NotificationBar.showNotifiBar(context,"我是消息","我是消息内容");

  10.         Log.d("jpush", "onMessage: "+customMessage.message+"/"+customMessage.extra);

  11.     }

  12.  
  13.     @Override

  14.     public void onNotifyMessageArrived(Context context, NotificationMessage notificationMessage) {

  15.         super.onNotifyMessageArrived(context, notificationMessage);

  16.         // 通知到达

  17.         Log.d("jpush", "onNotifyMessageArrived: "+notificationMessage.notificationExtras);

  18.     }

  19.  
  20.     @Override

  21.     public void onNotifyMessageOpened(Context context, NotificationMessage notificationMessage) {

  22.         super.onNotifyMessageOpened(context, notificationMessage);

  23.         // 点击通知栏消息 可指定类型,指定操作

  24.         Log.d("jpush", "onNotifyMessageOpened: "+notificationMessage.notificationExtras);

  25.  
  26.     }

  27.  
  28.     @Override

  29.     public void onRegister(Context context, String s) {

  30.         super.onRegister(context, s);

  31.         // 保存极光id

  32.         Log.d("jpush", "onRegister: id="+s);

  33.  
  34.     }

  35.  
  36.     @Override

  37.     public void onConnected(Context context, boolean b) {

  38.         super.onConnected(context, b);

  39.         Log.d("jpush", "onConnected: "+b);

  40.         if (b) {

  41.             // 链接监听 保存极光id

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

  43.             Log.d("jpush", "onConnected: 连接成功获取id="+registrationID);

  44.         }

  45.     }

  46. }

③ 初始化

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

i.  极光方案,在Application的onCreate中初始化,也就是在应用启动时初始化极光,优点快速准确;但会影响app启动速度。
ii.  在启动页初始化,优点app启动速度快。我个人觉得第二方案更好一点,在优化app启动时,会有一些帮助。

RegistrationID的获取,也有两个方案
i. 在初始化以后,获取极光id 极光id是异步返回的,此处不一定获取成功。

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

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

 
  1.  @Override

  2.     public void onRegister(Context context, String s) {

  3.         super.onRegister(context, s);

  4.         // 保存极光id

  5.         Log.d("jpush", "onRegister: 注册成功后返回极光id="+s);

  6.  
  7.     }

  8.  
  9.     @Override

  10.     public void onConnected(Context context, boolean b) {

  11.         super.onConnected(context, b);

  12.         Log.d("jpush", "onConnected: "+b);

  13.         if (b) {

  14.             // 链接监听 保存极光id

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

  16.             Log.d("jpush", "onConnected: 连接成功获取id="+registrationID);

  17.         }

  18.     }

到此处,极光推送的基本集成就完成了;届时可以在极光的管理中心,去测试推送了。

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

3. 厂商通道的集成

     厂商通道,直白点说就是系统级推送,和 ios一样;推送至手机系统平台,由系统平台作为系统通知展示。到达率得到了很大的保证;目前极光支持 小米 华为 魅族 oppo vivo FCM这几个平台的厂商通道;原理见下图:


①申请平台项目(小米,华为创建项目,审核通过后申请项目的推送服务)
以小米为例
https://dev.mi.com/console/appservice/push.html
先在小米开放平台创建项目 填写各种资料,审核通过后,就开始申请小米推送服务。审核通过后,去极光后台配置id 和即可;配置好以后 ,开始进行代码配置,Project 根目录的主 gradle 中配置了华为支持

 
  1. allprojects {

  2.     repositories {

  3.  
  4.         google()

  5.  

  6.         maven { url "https://jitpack.io" }

  7.         maven {url'http://developer.huawei.com/repo/'}

  8.     }

  9. }

在app的gradle添加厂商通道sdk依赖,这个使用的极光的
 

 
  1.  implementation 'cn.jiguang.sdk.plugin:huawei:3.3.4'

  2.     implementation 'cn.jiguang.sdk.plugin:xiaomi:3.3.4'

  3.     implementation 'cn.jiguang.sdk.plugin:meizu:3.3.4'

  4.     implementation 'cn.jiguang.sdk.plugin:oppo:3.3.4'

  5.     implementation 'cn.jiguang.sdk.plugin:vivo:3.3.4'

  6.  

在app的gradle 配置厂商平台申请好的 id 和 key
 备注:这里使用的是各平台项目的推送服务id, 各平台项目的推送服务id,各平台项目的推送服务id!!! 

 
  1. manifestPlaceholders = [

  2.                 JPUSH_PKGNAME : applicationId,

  3.                 JPUSH_APPKEY  : "JPUSHKEY", //JPush上注册的包名对应的appkey.

  4.                 JPUSH_CHANNEL : "developer-default", //暂时填写默认值即可.

  5.                 HUAWEI_APPID  : "100574375",//华为平台注册的appid

  6.  
  7.                 XIAOMI_APPKEY : "MI-KEY",//小米平台注册的appkey

  8.                 XIAOMI_APPID  : "MI-IS",//小米平台注册的appid

  9.  
  10.                 MEIZU_APPKEY  : "MZ-KEY",//魅族平台注册的appkey

  11.                 MEIZU_APPID   : "MZ-ID",//魅族平台注册的appid

  12.  
  13.                 OPPO_APPKEY   : "OP-KEY", // OPPO平台注册的appkey

  14.                 OPPO_APPID    : "OP-ID", // OPPO平台注册的appid

  15.                 OPPO_APPSECRET: "OP-SECRET"

  16.                 // vivo

  17.                 VIVO_APPKEY : "KEY",

  18.                 VIVO_APPID : "ID"

  19.  
  20.         ]

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

测试方法:
①保持长链接时,手动推送,是否收到推送消息
②断开长链接时,手动推送,是否收到推送消息
③断开长链接时,手动推送,打开应用后是否收到推送消息