Android 阿里推送正常推送以及辅助通道走过的坑

it2024-08-14 59

android开发中 app的保活和推送到达都是个绕不过去的坎他俩相辅相成

目前阿里推送的辅助推送通道可以进一步的帮助实现这个推送的到达率

https://help.aliyun.com/document_detail/30067.html?spm=a2c4g.11186623.6.590.598b7fa8XmiUlS#h2-7-

小米/华为/FCM/OPPO/VIVO/魅族系统推送支持

1. 相关概念2. 配置应用3. 下载扩展包4. Proguard配置5. 在应用中初始化辅助通道6. 在日志中查看初始化情况7. 辅助弹窗 7.1 客户端7.2 服务端7.3 场景解析场景1：普通推送打开App + 辅助弹窗场景2：普通推送打开Activity + 辅助弹窗

1. 相关概念

辅助通道：移动推送针对小米、华为、VIVO、OPPO、魅族等设备管控较严的情况，分别接入了相应的设备厂商推送辅助通道以提高这些设备上的到达率。移动推送优先选择自有通道进行推送消息下发，只有在自有通道断连时才会选择辅助通道下发消息。当辅助通道通过华为、小米等各设备厂商推送服务下发透传消息，消息到达应用后，会经移动推送SDK处理触发onNotification,onMessage回调。设备厂商推送服务在下发透传消息时并不保证会拉起被杀死进程（相关机制可参考小米、华为等各设备厂商推送服务官网），所以辅助通道在进程被杀死情况下无法保证消息一定到达。FCM辅助通道主要可实现在海外网络不可达时，通过该通道进行消息送达，在应用进程被杀死的情况下，无法保证消息一定到达。辅助弹窗：辅助弹窗通过系统通道下发通知,可以在进程被杀死情况下推送成功。由于辅助弹窗通过对应设备上的推送通知实现，因而通过辅助弹窗下发的通知不会触发onNotification回调。当前移动推送已接入小米、华为、OPPO、VIVO、魅族辅助弹窗。其中华为弹窗到达率统计只覆盖用户点击华为弹窗推送通知的场景，未点击部分暂未覆盖;小米弹窗到达率统计覆盖所有场景。

2. 配置应用

在小米开放平台注册你的App, 得到相应的小米AppID，小米AppKey，小米AppSecert。在控制台应用配置设置你的小米AppSecert。（注意：最新的小米开放平台是分开 push 功能的，需要在 push 功能区开通/启用推送功能）

在华为开发者联盟注册 App，应用审核通过后，能够得到华为的AppID和AppSecert。在控制台应用配置中设置你的应用 AppID 和 AppSecert。（注意：最新的华为开放平台是分开push功能的，需要在push功能区开通/启用推送功能），华为后台添加消息回执回调地址，https://agoo-ack.m.taobao.com/hw/

https 证书填入以下内容：

在 FCM推送平台创建项目（注：Google已将GCM推送迁移至firebase，改称FCM）。接入前提手机必须安装google play services, 否则注册不成功, 大部分国内的手机是谷歌服务被剥离了:

在Firebase控制台需要先创建一个项目，然后再在项目下新增App下载对应App的google-services.json文件, 我们只需要这个json文件中的”project_number”, “mobilesdk_app_id”这两个key对应的value, 分别记录为sendId/applicationId, 下面注册过程中需要用到：

在Firebase控制台获取服务器密钥，并将其设置在移动推送控制台中的GCM/FCM服务器密钥域内。

在OPPO开放平台注册OPPO企业开发者账号，添加应用并开通oppo推送服务，目前应用需满足：1.在oppo市场上架，2.评级为A，才能使用推送服务，具体政策可咨询oppo客服，最终以oppo要求为准。同样需要在控制台应用配置设置你的OppoAppkey和OppoMasterSecret。

在 VIVO开放平台注册账号及创建应用(注：vivo需要企业开发者账号)，审核通过后，能够得到应用的AppID、AppKey和AppSecret。在控制台应用配置中设置你的VIVO应用AppID、AppKey以及AppSecret。

在 Flyme 开放平台注册账号及创建应用，审核通过后，能够得到应用的AppID和AppSecret。在控制台应用配置中设置你的应用AppID和AppSecret，同时一定要在Flyme控制台上设置回执地址为：http://agoo-ack.m.taobao.com/mz/ 及 https://agoo-ack.m.taobao.com/mz/ ，否则可能会收不到推送消息。

3. 下载扩展包

3.1 手动集成

建议使用maven集成。

将辅助通道扩展包下载解压后拷贝到你项目的Lib目录下，下载地址。如果使用辅助通道扩展包v3.2.0及以上版本，需要将推送SDK升级到v3.2.0及以上版本。新版辅助通道扩展包以aar形式透出，省却manifest文件配置，减少出错概率。

将辅助通道扩展包放置到app module的libs路径下，并在app module的build.gradle文件中添加如下配置:

repositories {flatDir {dirs 'libs' //this way we can find the .aar file in libs folder}}...dependencies {......compile(name: 'alicloud-android-third-push-3.1.0', ext: 'aar')}

3.2 Maven集成

项目顶层build.gradle中添加Maven仓库地址：

allprojects {repositories {maven {url 'http://maven.aliyun.com/nexus/content/repositories/releases/'}}} gradle添加依赖：

dependencies {compile 'com.aliyun.ams:alicloud-android-third-push:3.2.0'}

OPPO、魅族、VIVO 通道需使用 v3.0.10 或以上版本，另外每个平台对应用接入的要求不同，请查看各平台官网说明。

注意：如果只添加alicloud-android-third-push，而不添加华为通道依赖时，会报错找不到一些文件和值，比如@string/error_over_original_size @string/error_over_original_count @style/upsdkDlDialog，如要使用华为通道，请看下文华为依赖，添加上即可，如不使用通道，您自行写上这些值即可。

3.3 Firebase依赖

如需配置GCM/GCM通道还需要添加Firebase SDK依赖：

dependencies {......compile ('com.google.firebase:firebase-messaging:17.6.0')}

3.4 Huawei依赖

如需配置华为通道还需要添加华为推送SDK依赖：

dependencies {......compile 'com.aliyun.ams:huawei-push:2.6.3.305'compile 'com.aliyun.ams:huawei-push-base:2.6.3.305'}

同时在AndroidManifest文件中添加如下配置：

3.5 魅族依赖

如需配置魅族通道还需要添加魅族推送SDK依赖：

dependencies {......compile 'com.aliyun.ams:meizu-push:3.8.7.1'}

3.6 VIVO依赖

如需配置VIVO通道还需要添加VIVO推送SDK依赖：

dependencies {......compile 'com.aliyun.ams:third_vivopush:2.9.0.1'}

在AndroidManifest文件中添加如下配置：

4. Proguard配置

如果集成推送SDK的工程开启代码混淆，在Proguard配置的基础上，需要添加以下辅助通道的Proguard配置。

# 小米通道-keep class com.xiaomi.** {*;}-dontwarn com.xiaomi.**# 华为通道-keep class com.huawei.** {*;}-dontwarn com.huawei.**# GCM/FCM通道-keep class com.google.firebase.**{*;}-dontwarn com.google.firebase.**# OPPO通道-keep public class * extends android.app.Service# VIVO通道-keep class com.vivo.** {*;}-dontwarn com.vivo.**# 魅族通道-keep class com.meizu.cloud.** {*;}-dontwarn com.meizu.cloud.**

5. 在应用中初始化辅助通道

将以下代码加入你application.onCreate()方法中初始通道。注意：辅助通道注册务必在Application中执行且放在推送SDK初始化代码之后，否则可能导致辅助通道注册失败

// 注册方法会自动判断是否支持小米系统推送，如不支持会跳过注册。MiPushRegister.register(applicationContext, "小米AppID", "小米AppKey");// 注册方法会自动判断是否支持华为系统推送，如不支持会跳过注册。HuaWeiRegister.register(application);//GCM/FCM辅助通道注册GcmRegister.register(this, sendId, applicationId); //sendId/applicationId为步骤获得的参数// OPPO通道注册OppoRegister.register(applicationContext, appKey, appSecret); // appKey/appSecret在OPPO开发者平台获取// 魅族通道注册MeizuRegister.register(applicationContext, "appId", "appkey"); // appId/appkey在魅族开发者平台获取// VIVO通道注册VivoRegister.register(applicationContext);

本方法会自动判断是否支持小米系统推送，如不支持会跳过注册。

6. 在日志中查看初始化情况

华为通道初始化成功，可以看到以下日志：（如不成功，检查是否在华为控制台配置SHA256指纹证书，目前华为需要配置）

小米通道初始化成功，可以看到以下日志：

GCM/FCM通道初始化成功，可以看到以下日志：

05-19 19:18:44.530 19153-19177/com.xxx D/MPS:GcmRegister: token from register:eWIXLYCNP0Q:APA91bFUAgxj6XYf5okyoCBnRPw1UwITndzXrvPDgbdI2N44PYm17hFEBiNXNQJrJ8bOG_xjw3c3UPDAhzNMTLNjlAKcjUanKyLA6E3k4wEmgZuhgUT02UMmMvH2LVA1L2Z4-l-cT_Ug

OPPO通道是否注册成功, 可以通过过滤MPS:oppo关键字查看, 注册成功会打印onRegister regid=****相关日志, 否则检查参数是否正确填入；

VIVO通道是否注册成功, 可以通过过滤MPS:vivo关键字查看, 注册成功会打印getRegId regId:****相关日志, 否则检查参数是否正确填入；

魅族通道初始化成功，可以看到以下日志：

收到小米通道下行的消息：(需要将sdk日志等级设置到DEBUG)

12-09 22:24:34.065 19566-25042/com.xxx D/MPS:MiPushReceiver: onReceiveMessage,msg=[{"f":262,"b":"{\"content\"\ ... ... ,"i":"f__-rnje3_OH74gE|VG0g3kwMnGADAGrXZku1FFW5"}]

收到GCM/FCM通道下发的消息：

05-19 19:20:04.900 19153-20391/com.alibaba.push2 D/MPS:GcmRegister: onReceiveMessage payload msg:[......]

若小米通道注册失败(未看到小米注册成功日志)，请查看系统日志（logcat设置NoFilters），以PushService|BroadcastQueue为正则式进行过滤，示例如下图：

MiPushBroadcastReceiver未配置：

MIPUSH_RECEIVE权限未配置：

注1：如果控制台配置了小米/华为的信息，app需要加对应的jar包依赖，不然会有crash的风险。

客户端接入完毕，服务端推送时如果设备无法收到推送，可先查看移动推送Android SDK:Android辅助通道和弹窗排查步骤

7. 辅助弹窗

当前部分国产品牌设备管控严格，接入推送功能的App进程在后台被清理后，收不到推送通知；接入辅助弹窗后，可以借助对应品牌的系统通道，保证App后台被清理后，仍能收到推送通知；当前辅助弹窗已接入小米、华为、OPPO、VIVO、魅族（小米辅助弹窗：v2.3.0及以上支持；华为辅助弹窗：v3.0.8及以上支持；OPPO辅助弹窗：v3.1.4及以上支持）；当前华为辅助弹窗仅支持Emotion UI(华为定制ROM)4.1级以上版本的设备；

7.1 客户端

该功能的使用需要接入推送辅助通道，确保使用最新的辅助通道扩展包，具体参考上文；辅助弹窗送达的通知展示效果，和普通通知相同；服务端指定辅助弹窗通道推送时，一定要指定通知点击后要打开的Activity，该Activity需继承自抽象类AndroidPopupActivity（MiPushSystemNotificationActivity已废弃，小米、华为、OPPO等厂商通道弹窗统一继承AndroidPopupActivity），否则无法获取到通知的相关信息，并且会影响通知到达率的统计；AndroidPopupActivity中提供抽象方法onSysNoticeOpened()，实现该方法后可获取到辅助弹窗通知的标题、内容和额外参数，在通知点击时触发，原本的通知回调onNotification()和onNotificationOpened()不适用于辅助弹窗；

指定打开的托管弹窗Activity在AndroidManifest.xml中注册时需要声明属性:android:exported=true

接入如下所示：

import com.alibaba.sdk.android.push.AndroidPopupActivity;public class PopupPushActivity extends AndroidPopupActivity {static final String TAG = "PopupPushActivity";@Overrideprotected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);}/*** 实现通知打开回调方法，获取通知相关信息* @param title 标题* @param summary 内容* @param extMap 额外参数*/@Overrideprotected void onSysNoticeOpened(String title, String summary, Map<String, String> extMap) {Log.d("OnMiPushSysNoticeOpened, title: " + title + ", content: " + summary + ", extMap: " + extMap);}}

7.2 服务端

OpenAPI 2.0的推送高级接口提供了AndroidPopupActivity、AndroidPopupTitle和AndroidPopupBody三个参数，分别用于设置辅助弹窗通知打开时跳转的Activity、通知标题以及通知内容（注意：StoreOffline参数也需要设置为true）；辅助弹窗仅对后台进程被清理的小米/华为/VIVO/OPPO/魅族设备生效，对非接入厂商通道设备和在线的设备不生效；当辅助弹窗生效时，推送接口的Title、Body、AndroidActivity以及额外参数设置中的功能性设置（如声音、震动等）都不起作用；

PushRequest pushRequest = new PushRequest();// 其余设置省略// 通知pushRequest.setPushType("NOTICE");// 标题pushRequest.setTitle(dateFormat.format(new Date()));// 内容pushRequest.setBody("PushRequest body");// 额外参数pushRequest.setAndroidExtParameters("{\"k1\":\"android\",\"k2\":\"v2\"}");// 设置辅助弹窗打开ActivitypushRequest.setAndroidPopupActivity("*****");// 设置辅助弹窗通知标题pushRequest.setAndroidPopupTitle("*****");// 设置辅助弹窗通知内容pushRequest.setAndroidPopupBody("*****");

7.3 场景解析

以下几种普通推送结合辅助弹窗推送的场景，帮助您快速理解辅助弹窗功能的配置。

客户端配置

客户端有Main、Second两个Activity，MainActivity为App打开主页面，SecondActivity extends AndroidPopupActivity；

普通通知回调配置：

public class MyMessageReceiver extends MessageReceiver {/*** 推送通知的回调方法* @param context* @param title* @param summary* @param extraMap*/@Overridepublic void onNotification(Context context, String title, String summary, Map<String, String> extraMap) {Log.d(TAG, "Receive notification, title: " + title + ", content: " + summary + ", extraMap: " + extraMap);}} MainActivity定义：

package com.alibaba.push.testdemo;public class MainActivity extends Activity {@Overrideprotected void onCreate(Bundle savedInstanceState) {Log.d(TAG, "Main");}} SecondActivity定义：

package com.alibaba.push.testdemo;import com.alibaba.sdk.android.push.AndroidPopupActivity;public class SecondActivity extends AndroidPopupActivity {/*** 辅助弹窗指定打开Activity回调* @param title 标题* @param content 内容* @param extraMap 额外参数*/@Overrideprotected void onSysNoticeOpened(String title, String content, Map<String, String> extraMap) {Log.d(TAG, "Receive XiaoMi notification, title: " + title + ", content: " + content + ", extraMap: " + extraMap);}}

场景1：普通推送打开App + 辅助弹窗

服务端配置如下：

PushRequest pushRequest = new PushRequest();// 其余设置省略// 通知pushRequest.setPushType("NOTICE");// 标题pushRequest.setTitle("hello");// 内容pushRequest.setBody("PushRequest body");// 点击通知后动作 "APPLICATION" : 打开应用 "ACTIVITY" : 打开AndroidActivity "URL" : 打开URL "NONE" : 无跳转pushRequest.setAndroidOpenType("APPLICATION");// 设置辅助弹窗打开ActivitypushRequest.setAndroidPopupActivity("com.alibaba.push.testdemo.SecondActivity");// 设置辅助弹窗通知标题pushRequest.setAndroidPopupTitle("hello2");// 设置辅助弹窗通知内容pushRequest.setAndroidPopupBody("PushRequest body2");// 设定android类型设备通知的扩展属性pushRequest.setAndroidExtParameters("{\"k1\":\"android\",\"k2\":\"v2\"}");

推送结果：

非小米、华为等厂商通道设备和在线设备

收到普通推送通道弹出的通知，点击后打开App，进入首页MainActivity，如果设备在前台，保持当前界面不变；onNotification()回调输出Receive notification, title: hello, content: PushRequest body, extraMap: {k1=android, k2=v2}；

清理进程后的小米、华为等厂商通道设备

辅助弹窗通道弹出通知，点击后跳转到SecondActivity；onSysNoticeOpened()回调输出Receive XiaoMi notification, title: hello2, content: PushRequest body2, extraMap: {k1=android, k2=v2}；

场景2：普通推送打开Activity + 辅助弹窗

服务端配置如下：

PushRequest pushRequest = new PushRequest();// 其余设置省略// 通知pushRequest.setPushType("NOTICE");// 标题pushRequest.setTitle("hello");// 内容pushRequest.setBody("PushRequest body");// 点击通知后动作 "APPLICATION" : 打开应用 "ACTIVITY" : 打开AndroidActivity "URL" : 打开URL "NONE" : 无跳转pushRequest.setAndroidOpenType("ACTIVITY");// 指定普通推送要打开的ActivitypushRequest.setAndroidActivity("com.alibaba.push.testdemo.SecondActivity");// 设置辅助弹窗打开ActivitypushRequest.setAndroidPopupActivity("com.alibaba.push.testdemo.SecondActivity");// 设置辅助弹窗通知标题pushRequest.setAndroidPopupTitle("hello2");// 设置辅助弹窗通知内容pushRequest.setAndroidPopupBody("PushRequest body2");// 设定android类型设备通知的扩展属性pushRequest.setAndroidExtParameters("{\"k1\":\"android\",\"k2\":\"v2\"}");

推送结果：

非小米、华为等厂商通道设备和在线设备

收到普通推送通道弹出的通知，点击后跳转到SecondActivity；onNotification()回调输出Receive notification, title: hello, content: PushRequest body, extraMap: {k1=android, k2=v2}；

清理进程后的小米、华为等厂商通道设备

其它坑说明:

阿里文档地址:https://help.aliyun.com/document_detail/184150.html?spm=a2c4g.11186623.6.576.326d237864PENI

https://emas.console.aliyun.com/?spm=5176.13194971.0.0.4ff3cb3coyVKHq#/product/3619196/push/25233908/2

服务端需要配置通知chinalId

1.华为地址：https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides-V5/android-intelligent-classification-0000001050040120-V5?spm=a2c4g.11186623.2.26.779f708fmtlOup 通知chinalId =HIGH

2.VIVO https://dev.vivo.com.cn/documentCenter/doc/359?spm=a2c4g.11186623.2.25.779f708fmtlOup VIVO通知chinalId =1

3.小米通知chinalId =pre54

PopupPushActivity(接收辅助通道的act) 在xml里面一定要设置，这个包名路径要传给后台，后台也得设置一下

1.json文件，这个我们直接在阿里云的应用配置里面下载就可以了（有个下载配置文件）

2.动态形式来获取需要配置的参数

//阿里推送动态注册AppKey,AppSecret if (BuildConfig.APPLICATION_ID.equals("xxxxxx")) { mPushService.register(applicationContext, "xxxxxx", "xxxxxxx", mPushRegisterCallback); } else if (BuildConfig.APPLICATION_ID.equals("com.xxxxxx.xxx.debug")) { mPushService.register(applicationContext, "xxxx", "xxxx", mPushRegisterCallback); } //动态获取华为和vivo的值 ApplicationInfo appInfo = null; // String value=null; try { appInfo = mContext.getPackageManager().getApplicationInfo( mContext.getPackageName(), PackageManager.GET_META_DATA); // appInfo.metaData.putString("com.huawei.hms.client.appid", "appid=xxxxx"); // value = appInfo.metaData.getString("com.huawei.hms.client.appid"); } catch (PackageManager.NameNotFoundException e) { e.printStackTrace(); } //辅助通道动态注册 if (BuildConfig.APPLICATION_ID.equals("com.xxxxx")) { //小米 MiPushRegister.register(applicationContext, "xx", "xx"); //魅族 MeizuRegister.register(applicationContext, "xx", "xx"); //oppo OppoRegister.register(applicationContext, "xx", "xx"); //vivo appInfo.metaData.putString("com.vivo.push.api_key", "xx"); appInfo.metaData.putString("com.vivo.push.app_id", "xx"); //华为 appInfo.metaData.putString("com.huawei.hms.client.appid", "appid=xx"); } else if (BuildConfig.APPLICATION_ID.equals("com.xxxx.xxxx")) { //小米 MiPushRegister.register(applicationContext, "xxxx", "xxxxxx"); //魅族 MeizuRegister.register(applicationContext, "xxxxx", "xxxx"); //oppo OppoRegister.register(applicationContext, "xxxx", "xxxxx"); //vivo appInfo.metaData.putString("com.vivo.push.api_key", "xxxx"); appInfo.metaData.putString("com.vivo.push.app_id", "xxxxx"); //华为 appInfo.metaData.putString("com.huawei.hms.client.appid", "appid=xxxxx"); }

3.各种机型的小坑

说明：一定要在各大平台注册，将应用加入

1.0PPO

oppo阿里AppKey 对应的是key，但是MasterSecret 对应的是oppo平台的appserversecret ，不是appsecret，切记，在APPlication里面填写的是appsecret,OPPO有时候会接收不到消息，请打开设置，在进入应用管理，找到当前的应用，强制停止，这样就离线了，在辅助通道推送就有通知了

2.Xiaomi

Android 8+适配

自Android 8.0（API Level 26）起，Android推出了NotificationChannel机制，旨在对通知进行分类管理。如果用户App的targetSdkVersion大于等于26，且并未设置NotificaitonChannel，那么创建的通知是不会弹出显示。

请参见Android 8.0以上设备接收不到推送通知进行适配。必须配置NotificaitonChannel,否则收不到通知，可以在小米推送平台申请,有个通知类别，在里面申请，有很多选择

re84即时通讯（IM）消息（如聊天、加好友等）申请pre61个人状态变化（如会员升级、登录下线等）申请pre72个人资源变化（如钱包、积分等）申请pre213个人关注的内容更新提醒（如关注的教学任务更新、主动设置的书籍更新提醒等用户主动订阅的提醒）申请pre102个人日程相关提醒（如登机、酒店入住提醒等）申请pre233个人交易提醒（如银行、股票的交易提醒等）申请pre54个人家庭IoT类提醒（如摄像机监控区域有变化的提醒、扫地机器人清扫完成的通知等）撤销pre96个人订单状态变化（如购物发货、退款等）

3.华为基本没遇到什么坑（appid配置在bulid里面,动态配置也行

）

4.魅族

设置消息回执

在魅族推送平台的应用列表，单击打开应用，进入配置管理>回执管理页面。

设置回执地址为：http://amspush-ack.aliyuncs.com/mz/ 及 https://amspush-ack.aliyuncs.com/mz/ 否则可能会收不到推送消息。

一定要填写回执，否则收不到通知

5.Vivo

可以在VIVO添加regId进行测试，一定要将当前版本发布上线才可以收到推送。6.目前阿里不支持推送消息

vivo要应用发布上线才可以收到通知，以后可能会改变

最新回复(0)