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

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）的版本繼續使用華為的廠商推送渠道。