Mobile Platform as a Service：榮耀推送

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

1. 註冊榮耀推送

2. 接入榮耀推送

3. 測試榮耀推送

註冊榮耀推送

登入榮耀開發官網，註冊帳號並且開啟推送服務。詳情請參見 榮耀推送開啟步驟。

接入榮耀推送

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

   說明

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

2. 開發環境準備，開發環境需要符合榮耀推送整合的環境，具體可以參考 開發準備-環境資訊。

3. 添加設定檔。 在 榮耀開發人員服務平台 中下載 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 接入方式，還需要 添加混淆規則。

測試榮耀推送

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

2. 您可以在殺掉應用進程的情況下推送測試訊息：

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

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

排查問題

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 失敗，請檢查 步驟 3 將設定檔添加到專案中 的 base64Code 是否有值，以及擷取設定檔時上傳的 apk 簽名和當前應用是否一致。

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

其他問題

推送支援哪些機型和系統版本

當前榮耀的廠商推送渠道支援 Magic OS 8.0 及以上版本系統的榮耀手機，Magic OS 8.0 版本以下（不含 8.0）的版本繼續使用華為的廠商推送渠道。