文档

荣耀推送

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

  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. 如需使用混淆,则要添加相关混淆配置:

测试荣耀推送

重要

请注意,荣耀 Magic OS 8.0 以下(不含 8.0)版本会继续使用华为推送适配层。

  1. 接入荣耀推送后,您可以在荣耀手机上启动应用并确保调用了初始化方法(参见 快速开始),推送 SDK 获取荣耀推送的厂商 token 并上报。

  2. 您可以在杀掉应用进程的情况下推送测试消息:

    • 如果仍然能收到消息,说明您的应用成功接入荣耀推送。

    • 如果不能收到消息,请按照下文进行问题排查。

排查问题

  1. 检查荣耀配置和参数是否和荣耀推送后台一致,检查 AndroidManifest.xml 中相关配置是否添加,com.hihonor.push.app_id 是否和荣耀推送后台一致。

  1. 检查 mcs-services.json 文件是否存在,存放位置是否正确。

  2. 检查 mPaaS 控制台是否开启了荣耀通道(参见 配置荣耀推送渠道),以及相关配置是否和荣耀推送后台一致。

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

  • 本页导读 (0)
文档反馈