极光推送集成解决方案
1. 极光推送集成背景
最近深入探究了推送服务与长连接技术。经过一番调研与分析发现,在现有解决方案中尚未找到完全匹配的理想方案。其中长连接的保活问题尤为突出。特别是针对Android系统而言,在经历了近期Google公司对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'
AI助手
②配置代码
配置极光的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", //暂时填写默认值即可.
]
AI助手
权限配置
<permission
android:name="com.nade.nadejpush.permission.JPUSH_MESSAGE"
android:protectionLevel="signature" />
<!-- Required -->
<uses-permission android:name="android.permission.RECEIVE_USER_PRESENT" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<!-- Optional. Required for location feature -->
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" /> <!-- 用于开启 debug 版本的应用在 6.0 系统上的层叠窗口权限 -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS" />
<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
<uses-permission android:name="android.permission.GET_TASKS" />
<uses-permission android:name="android.permission.VIBRATE" />
AI助手
服务和广播配置
<!-- Since JCore2.0.0 Required SDK核心功能-->
<!-- 可配置android:process参数将Service放在其他进程中;android:enabled属性不能是false -->
<!-- 这个是自定义Service,要继承极光JCommonService,可以在更多手机平台上使得推送通道保持的更稳定 -->
<service android:name=".service.JPushService"
android:enabled="true"
android:exported="false"
android:process=":pushcore">
<intent-filter>
<action android:name="cn.jiguang.user.service.action" />
</intent-filter>
</service>
<service
android:name="cn.jpush.android.service.PushService"
android:enabled="true"
android:exported="false" >
<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>
<service
android:name="cn.jpush.android.service.DaemonService"
android:enabled="true"
android:exported="true">
<intent-filter >
<action android:name="cn.jpush.android.intent.DaemonService" />
<category android:name="com.nade.nadejpush"/>
</intent-filter>
</service>
<!-- Required since 3.0.7 -->
<!-- 新的 tag/alias 接口结果返回需要开发者配置一个自定的广播 -->
<!-- 3.3.0开始所有事件将通过该类回调 -->
<!-- 该广播需要继承 JPush 提供的 JPushMessageReceiver 类, 并如下新增一个 Intent-Filter -->
<receiver
android:name=".receiver.JPushReceiver"
android:enabled="true"
android:exported="false" >
<intent-filter>
<action android:name="cn.jpush.android.intent.RECEIVE_MESSAGE" />
<category android:name="com.nade.nadejpush" />
</intent-filter>
</receiver>
<receiver
android:name="cn.jpush.android.service.PushReceiver"
android:enabled="true" >
<intent-filter android:priority="1000">
<action android:name="cn.jpush.android.intent.NOTIFICATION_RECEIVED_PROXY" />
<category android:name="com.nade.nadejpush"/>
</intent-filter>
<intent-filter>
<action android:name="android.intent.action.USER_PRESENT" />
<action android:name="android.net.conn.CONNECTIVITY_CHANGE" />
</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>
AI助手
这里需要自定义一个消息接收器 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);
}
}
}
AI助手
③ 初始化
这里关于初始化方案这里分享两种:
i. 极光方案用于Application的onCreate事件处理,在应用启动时自动执行极光相关操作。其优势在于快速响应并确保操作准确性;然而这种做法可能会对应用的整体启动速度产生一定影响。
ii. 在启动页进行初始化能够显著提升应用的启动速度。个人认为第二种方案(在优化app启动时)更为合适,并且会对优化过程产生一定的帮助。
Registration ID 的产生有两种方案:
i. 在初始化完成后,在极光中查找其对应的 ID 是一个异步操作;在此过程中,并非总是能够成功地找到该极光 ID。
String registrationID = JPushInterface.getRegistrationID(getApplicationContext());
AI助手
ii. 通过JPushReceiver实现id的获取方式,在这种情况下能够确保你一定能获得对应的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);
}
}
AI助手
目前阶段已完成核心功能模块的调试工作;可在该平台的管理界面进行功能验证。
在普通集成的基础上,我们开始集成厂商通道;
3. 厂商通道的集成
厂商通道即为系统级推送机制与iOS相似实现方式,在手机操作系统平台上完成通知展示;该通知通过手机系统平台作为通知展示方进行传递能达到较高的显示效果;目前极光已支持包括小米、华为等主流品牌的厂商通道接入;具体工作原理可通过下图了解:

以小米为例,在其开放平台创建一个项目,并填写必要的信息资料。待审核通过后,正式申请推送服务,随后前往极光后台系统,完成Push ID的配置并完成相关设置.配置完成后,开始进行代码开发,其中在GradsYSN框架下的主 Gradle文件中添加了华为支持.
allprojects {
repositories {
google()
maven { url "https://jitpack.io" }
maven {url'http://developer.huawei.com/repo/'}
}
}
AI助手
在app的gradle添加厂商通道sdk依赖,这个使用的极光的
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'
AI助手
在App的Gradle配置中,请确保已获取各平台项目的推送服务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"
]
AI助手
测试工作至此已完成。具体操作流程如下:首先,在各大平台的推送服务项目列表中找到对应的厂商通道项目;接着,在该项目的相关配置选项中选择进行手动推送功能的开启;最后,在小米开放平台 --- 应用服务 -- 消息推送 -- 全部应用 --- 你的应用 -- 创建推送 即可开始测试
测试方法:
①当保持长链接状态时,在手动推送操作后是否接收到推送通知。
②在断开长链接的情况下,在手动推送操作后是否接收到相应的推送通知。
③当断开长链接并打开应用后,在手动推送操作中是否接收到相应的通知。
