OPPO輔助通道集成
本章節(jié)介紹如何集成移動推送提供的OPPO輔助通道SDK。
準備工作
已經(jīng)按照Android SDK接入完成了移動推送SDK的接入。
已經(jīng)在OPPO開放平臺注冊了您的應用，如未注冊請登錄OPPO開放平臺，在推送服務中注冊您的應用。在配置管理>應用配置中獲取AppKey、AppSecret和MasterSecret。
已經(jīng)在EMAS控制臺配置了OPPO推送密鑰（AppKey和MasterSecret），如未配置，請登錄EMAS移動推送控制臺，設置您的OPPO推送密鑰（AppKey和MasterSecret），設置方法參見配置廠商通道密鑰。
第一步：將SDK添加到您的應用
我們提供了Maven依賴和本地依賴兩種集成方式，方便您根據(jù)需要將SDK添加到您的應用中。
建議開發(fā)者采用Maven依賴方式進行集成，配置簡單，不容易出問題，后續(xù)更新方便。
3.2.0及以上版輔助通道擴展包以aar形式透出，省去manifest文件配置，減少出錯概率。
3.2.2版本之前，OPPO通道依賴包已內置在alicloud-android-third-push-oppo中，無需單獨添加。
1 Maven依賴方式
在您的模塊（應用級）Gradle 文件（通常是<project>/<app-module>/build.gradl）中，在dependencies中添加SDK依賴。
請閱讀Android SDK版本說明，下載對應版本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'
}2 本地依賴方式
2.1 下載SDK
參考下載和集成SDK，選擇移動推送進行下載，將SDK包內所有文件拷貝至您的模塊（應用級）的<project>/<app-module>/libs目錄下。
2.2 添加SDK依賴
2.2.1 配置本地SDK目錄
在您的模塊（應用級）Gradle 文件（通常是<project>/<app-module>/build.gradle）中，添加本地SDK文件目錄地址。
repositories {
flatDir {
dirs 'libs'
}
}2.2.2 添加SDK依賴
在您的模塊（應用級）Gradle 文件（通常是<project>/<app-module>/build.gradle）中，的dependencies中添加SDK依賴。
dependencies {
implementation(name: 'alicloud-android-third-push-x.x.x', ext: 'aar')
implementation(name: 'alicloud-android-third-push-oppo-x.x.x', ext: 'aar')
implementation(name: 'opush-x.x.x', ext: 'aar')
}第二步：配置使用SDK
1 SDK初始化
SDK初始化務必在Application中執(zhí)行且放在推送SDK初始化代碼之后，否則可能導致輔助通道注冊失敗。
通過如下方式進行初始化：
// OPPO通道注冊
// appKey/appSecret在OPPO開發(fā)者平臺獲取
OppoRegister.register(applicationContext, appKey, appSecret)// OPPO通道注冊
// appKey/appSecret在OPPO開發(fā)者平臺獲取
OppoRegister.register(applicationContext, appKey, appSecret);注冊方法會自動判斷是否支持OPPO系統(tǒng)推送，如不支持會跳過注冊。
2 混淆配置
如果集成推送SDK的工程開啟了代碼混淆，需要添加以下輔助通道的Proguard配置。
# OPPO通道
-keep public class * extends android.app.Service第三步：接入驗證
1 打開SDK日志
val pushService = PushServiceFactory.getCloudPushService()
//僅適用于Debug包，正式包不需要此行
pushService.setLogLevel(CloudPushService.LOG_DEBUG)CloudPushService pushService = PushServiceFactory.getCloudPushService();
//僅適用于Debug包，正式包不需要此行
pushService.setLogLevel(CloudPushService.LOG_DEBUG); 2 確認成功方法
OPPO通道是否注冊成功，可以通過過濾MPS:OPush關鍵字查看，注冊成功會打印onRegister regid=**相關日志，否則檢查參數(shù)是否正確填入。
后續(xù)步驟
您已經(jīng)可以通過EMAS后臺將推送通知通過輔助通道推送到手機通知欄，但是要處理點擊通知后的邏輯，只能通過輔助彈窗來接收推送數(shù)據(jù)，詳情請參見輔助彈窗接入。
使用移動推送進行廠商通道推送時（使用移動推送控制臺或者OpenAPI進行推送時），服務端請必須參考輔助彈窗文檔進行服務端配置，服務端參數(shù)不設置，不會給廠商通道進行推送。
輔助通道常見問題
Android端阿里云移動推送與其他注冊廠商如何同時獲取regId
Android端輔助通道收到推送通知后單擊通知無法打開相應Activity