Android 阿里推送正常推送以及辅助通道走过的坑，字节跳动+阿里+华为+腾讯等大厂Android面试题

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

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

<meta-data
android:name="com.vivo.push.api_key"
android:value="请填写vivo平台上注册应用的appKey" />
<meta-data
android:name="com.vivo.push.app_id"
android:value="请填写vivo平台上注册应用的appID" />

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";
@Override
**protected** **void** onCreate(Bundle savedInstanceState) {
**super**.onCreate(savedInstanceState);
}
/**
* 实现通知打开回调方法，获取通知相关信息
* @param title 标题
* @param summary 内容
* @param extMap 额外参数
*/
@Override
**protected** **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以及额外参数设置中的功能性设置（如声音、震动等）都不起作用；
1. PushRequest pushRequest = **new** PushRequest();

// 其余设置省略
// 通知
pushRequest.setPushType("NOTICE");
// 标题
pushRequest.setTitle(dateFormat.format(**new** Date()));
// 内容
pushRequest.setBody("PushRequest body");
// 额外参数
pushRequest.setAndroidExtParameters("{\"k1\":\"android\",\"k2\":\"v2\"}");
// 设置辅助弹窗打开Activity
pushRequest.setAndroidPopupActivity("*****");
![](https://www.hualigs.cn/image/61dba891ed8ee.jpg) // 设置辅助弹窗通知标题
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
*/
@Override
**public** **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 {
@Override
**protected** **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 额外参数
*/
@Override
**protected** **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");
// 设置辅助弹窗打开Activity
pushRequest.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");
// 指定普通推送要打开的Activity
pushRequest.setAndroidActivity("com.alibaba.push.testdemo.SecondActivity");
// 设置辅助弹窗打开Activity
pushRequest.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}；
清理进程后的小米、华为等厂商通道设备
辅助弹窗通道弹出通知，点击后跳转到SecondActivity；
onSysNoticeOpened()回调输出Receive XiaoMi notification, title: hello2, content: PushRequest body2, extraMap: {k1=android, k2=v2}；

其它坑说明:

阿里文档地址:https://help.aliyun.com/knowledge_detail/57105.html

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

4.OPPO 通道id=1

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”);