如何集成移动推送提供的OPPO厂商通道SDK_移动研发平台(EMAS)-阿里云帮助中心

准备工作

已经按照Android SDK接入完成了移动推送SDK的接入。
已经在OPPO开放平台注册了您的应用，如未注册请登录OPPO开放平台，在推送服务中注册您的应用。在配置管理>应用配置中获取AppKey、AppSecret和MasterSecret。
已经在EMAS控制台配置了OPPO推送密钥（AppKey和MasterSecret），如未配置，请登录EMAS移动推送控制台，设置您的OPPO推送密钥（AppKey和MasterSecret），设置方法参见配置厂商通道密钥。

第一步：将SDK添加到您的应用

在您的模块（应用级）Gradle 文件（通常是<project>/<app-module>/build.gradle）中，在dependencies中添加SDK依赖。

重要

请阅读Android SDK版本说明，依赖对应版本SDK。

dependencies {
    implementation 'com.aliyun.ams:alicloud-android-third-push:x.x.x'
    implementation 'com.aliyun.ams:alicloud-android-third-push-oppo:x.x.x'
}

说明

移动推送厂商通道SDK只支持maven方式依赖。

第二步：配置使用SDK

1 SDK初始化

重要

SDK初始化务必在Application中执行且放在推送SDK初始化代码之后，否则可能导致厂商通道注册失败。

通过如下方式进行初始化：

Kotlin

Java

Kotlin

        
// OPPO通道注册
// appKey/appSecret在OPPO开发者平台获取
OppoRegister.register(applicationContext, appKey, appSecret)

Java

        
// OPPO通道注册
// appKey/appSecret在OPPO开发者平台获取
OppoRegister.register(applicationContext, appKey, appSecret);

说明

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

2 混淆配置

如果集成推送SDK的工程开启了代码混淆，需要添加以下厂商通道的ProGuard配置。

# OPPO通道
-keep public class * extends android.app.Service

第三步：接入验证

1 打开SDK日志

Kotlin

Java

Kotlin

        
val pushService = PushServiceFactory.getCloudPushService()
//仅适用于Debug包，正式包不需要此行
pushService.setLogLevel(CloudPushService.LOG_DEBUG)

Java

        
CloudPushService pushService = PushServiceFactory.getCloudPushService();
//仅适用于Debug包，正式包不需要此行
pushService.setLogLevel(CloudPushService.LOG_DEBUG);

2 确认成功方法

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

后续步骤

您已经可以通过EMAS后台将推送通知通过厂商通道推送到手机通知栏，但是要处理点击通知后的逻辑，只能通过辅助弹窗来接收推送数据，详情请参见辅助弹窗接入。

重要

使用移动推送进行厂商通道推送时（使用移动推送控制台或者OpenAPI进行推送时），服务端必须参考辅助弹窗文档进行服务端配置，若服务端参数不设置，将不会给厂商通道进行推送。

厂商通道常见问题

Android端厂商通道和弹窗问题的排查步骤

Android端厂商通道SDK与其他厂商SDK冲突

Android端厂商通道收到推送通知后单击通知无法打开相应Activity

Android端辅助弹窗启动报解析body异常

在集成移动推送厂商通道后显示"register not in main process，return"

OPPO平台推送常见问题汇总