本章節介紹如何集成移動推送提供的魅族輔助通道SDK。
準備工作
已經按照Android SDK接入完成了移動推送SDK的接入。
已經在魅族開放平臺注冊了您的應用,如未注冊請登錄魅族開放平臺,在魅族消息推送服務中注冊您的應用。在應用信息中獲取AppID和AppSecret。
已經設置消息回執,如未設置請在魅族推送平臺的應用列表,單擊打開應用,進入配置管理>回執管理頁面。
重要設置回執地址為:http://amspush-ack.aliyuncs.com/mz/ 及 https://amspush-ack.aliyuncs.com/mz/ 否則可能會收不到推送消息。
未設置消息回執,將不會使用魅族通道推送。
已經在EMAS控制臺配置了魅族推送密鑰(AppID和AppSecret),如未配置,請登錄移動推送控制臺,設置您的魅族推送密鑰(AppID和AppSecret),設置方法參見配置廠商通道密鑰。
第一步:將SDK添加到您的應用
我們提供了Maven依賴和本地依賴兩種集成方式,方便您根據需要將SDK添加到您的應用中。
建議開發者采用Maven依賴方式進行集成,配置簡單,不容易出問題,后續更新方便。
3.2.0及以上版輔助通道擴展包以aar形式透出,省去manifest文件配置,減少出錯概率。
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-meizu: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-meizu-x.x.x', ext: 'aar')
implementation(name: 'meizu-push-x.x.x', ext: 'aar')
}
第二步:配置使用SDK
1 SDK初始化
SDK初始化務必在Application中執行且放在推送SDK初始化代碼之后,否則可能導致輔助通道注冊失敗。
通過如下方式進行初始化:
// 魅族通道注冊
// appId/appkey在魅族開發者平臺獲取
MeizuRegister.register(applicationContext, "appId", "appkey")
// 魅族通道注冊
// appId/appkey在魅族開發者平臺獲取
MeizuRegister.register(applicationContext, "appId", "appkey");
注冊方法會自動判斷是否支持魅族系統推送,如不支持會跳過注冊。
2 混淆配置
如果集成推送SDK的工程開啟了代碼混淆,需要添加以下輔助通道的Proguard配置。
# 魅族通道
-keep class com.meizu.cloud.** {*;}
-dontwarn com.meizu.cloud.**
第三步:接入驗證
1 打開SDK日志
val pushService = PushServiceFactory.getCloudPushService()
//僅適用于Debug包,正式包不需要此行
pushService.setLogLevel(CloudPushService.LOG_DEBUG)
CloudPushService pushService = PushServiceFactory.getCloudPushService();
//僅適用于Debug包,正式包不需要此行
pushService.setLogLevel(CloudPushService.LOG_DEBUG);
2 確認成功方法
魅族通道初始化成功,可以看到以下日志:
后續步驟
您已經可以通過EMAS后臺將推送通知通過輔助通道推送到手機通知欄,但是要處理點擊通知后的邏輯,只能通過輔助彈窗來接收推送數據,詳情請參見輔助彈窗接入。
使用移動推送進行廠商通道推送時(使用移動推送控制臺或者OpenAPI進行推送時),服務端請必須參考輔助彈窗文檔進行服務端配置,服務端參數不設置,不會給廠商通道進行推送。
輔助通道常見問題
未設置消息回執,將不會使用魅族通道推送。
Android端阿里云移動推送與其他注冊廠商如何同時獲取regId