移动开发平台mPaaS：荣耀推送

本文介绍荣耀推送的接入流程，主要包括以下三个步骤。

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）的版本继续使用华为的厂商推送渠道。