背景

近日接到榮耀官方通知，榮耀品牌近期發(fā)布的新機以及 2024 年發(fā)布的新機都只支持榮耀推送，存量設備計劃在 2024 年 Q1 完成推送服務升級，屆時存量設備只支持榮耀推送，不再支持華為推送。為了保障接入 mPaaS 推送服務的 App 后續(xù)可繼續(xù)通過廠商通道推送到榮耀設備，建議您按照以下指南，盡快完成榮耀推送的適配與升級工作。

客戶端升級相關事項

• 如當前使用 10.2.3 基線，請升級到 10.2.3.38 或以上版本。

• 如當前使用其他定制基線，請聯(lián)系 mPaaS 支持人員確認。

mPaaS 榮耀推送適配安卓端接入

下面介紹榮耀推送的接入流程，主要包括以下三個步驟。

1. 注冊榮耀推送

2. 接入榮耀推送

3. 測試榮耀推送

注冊榮耀推送

登錄榮耀開發(fā)官網，注冊賬號并且開啟推送服務。詳情請參見 榮耀推送開啟步驟。

接入榮耀推送

1. 添加 推送 > HONOR 組件，方式與添加推送 SDK 相同，參考 添加推送 SDK 。

   說明

   推送 > HONOR 組件僅包含適配代碼，不包含榮耀推送 SDK，請按照下文單獨添加榮耀推送 SDK 依賴。

   請引入相應版本的基線版本（10.2.3.38 或以上版本），并添加榮耀推送適配的依賴 SDK，示例代碼如下：

   implementation platform("com.mpaas.android:mpaas-baseline:10.2.3-38")
   implementation 'com.mpaas.android:push-honor'

2. 開發(fā)環(huán)境準備。開發(fā)環(huán)境需要符合榮耀推送集成的環(huán)境，具體可以參考 開發(fā)準備 > 環(huán)境信息。

3. 添加配置文件。 在 榮耀開發(fā)者服務平臺 中下載 mcs-services.json 配置文件，具體參考 添加應用配置文件。

4. 配置 SDK 的倉庫地址。具體參考官方鏈接文檔 配置 SDK 的 Maven 倉庫地址。

5. 添加依賴配置。在應用級的 build.gradle 文件中，在 dependencies 中添加如下編譯依賴。具體請參考 添加依賴配置。

   dependencies {
       // 添加如下配置
       implementation 'com.hihonor.mcs:push:7.0.61.302'
   }

   • 如果需要更新版本，可參考 版本信息。

   • mPaaS 當前適配的版本為 7.0.61.302，如需使用更高版本，可根據需求修改，通常來說廠商 SDK 都會向下兼容。

6. 如需使用混淆，則要添加相關混淆配置：

   • 所有接入方式均需要添加 榮耀推送混淆腳本。

   • 如采用的是 AAR 接入方式，還需要 添加混淆規(guī)則。

測試榮耀推送

1. 接入榮耀推送后，您可以在榮耀手機上啟動應用并確保調用了初始化方法（參見 快速開始），推送 SDK 動獲取榮耀推送的廠商 token 并上報。

2. 您可以在 App 啟動后一段時間手動退出 App，然后推送測試消息：

   • 如果仍然能收到消息，說明您的應用成功接入榮耀推送。

   • 如果不能收到消息，請按照下文進行問題排查。

客戶端排查問題

1. 檢查榮耀配置和參數是否和榮耀推送后臺一致，檢查 AndroidManifest.xml 中相關配置是否添加，com.hihonor.push.app_id 是否和榮耀推送后臺一致。

2. 檢查 mcs-services.json 文件是否存在，存放位置是否正確。

3. 檢查 mPaaS 控制臺是否開啟了榮耀通道（參見 配置榮耀推送渠道），以及相關配置是否和榮耀推送后臺一致。

4. 查看 logcat 日志進行排查：

   1. 選擇 push 進程，過濾 mPush.PushProxyFactory，檢查是否存在以下日志：

      D/mPush.PushProxyFactory: found proxy com.mpaas.push.external.honor.Creator

   2. 選擇主進程，過濾 mHonor，檢查是否獲取到了榮耀推送的廠商 token，如出現日志 get token failed 則說明獲取榮耀廠商 token 失敗，錯誤碼參見 榮耀推送錯誤碼。

   3. 選擇主進程，過濾 report channel token, 檢查上報榮耀廠商 token 是否成功，如出現以下日志：

      report channel token error: xxxx

      說明上報廠商 token 失敗，請檢查 將配置文件添加到項目中 的 base64Code 是否有值，以及獲取配置文件時上傳的 apk 簽名和當前應用是否一致。

      若無，說明添加 推送 > HONOR 組件可能存在問題，請確認是否正確添加。

服務端升級相關事項

配置榮耀推送渠道

1. 從左側導航欄進入 消息推送 > 設置 > 通道配置 標簽頁。

2. 單擊 榮耀推送通道 配置區(qū)域右上角的 配置，頁面上展示配置入口。

3. 可登錄 榮耀開發(fā)者聯(lián)盟 官網，進入 管理中心 > 我的產品 > 移動應用詳情 頁面中獲取應用包名、應用 App ID 和密鑰。

4. 單擊 確定 按鈕，保存配置。

驗證榮耀廠商通道推送功能

使用 Magic OS 8.0 及以上版本榮耀手機，并安裝集成新版 mPaaS 推送 SDK 后的 App，App 啟動后一段時間手動退出 App，在 mPaaS 消息推送控制臺使用 極簡消息推送 > 優(yōu)先廠商通道策略，對目標設備進行推送下發(fā)，若榮耀終端設備可以成功收到通知欄消息，則證明榮耀廠商通道集成成功。