vivo 推送

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

  1. 注册 vivo 推送

  2. 接入 vivo 推送

  3. 测试 vivo 推送

注册 vivo 推送

参考 vivo 推送平台使用指南,在 vivo 开放平台 上注册账号,并申请接入推送服务。

接入 vivo 推送

  1. 添加 推送 - vivo 组件,方式与添加推送 SDK 相同,参见 添加 SDK推送 - vivo 组件仅包含适配代码,不包含 vivo Push SDK。

  2. 前往 vivo SDK 文档 下载 SDK 并集成到主工程中。 当前适配版本为 v2.3.4,如需使用更高版本,可根据需求修改,通常来说厂商 SDK 都会向下兼容,如不兼容可加入钉钉群 41708565 反馈适配新版的需求。

  3. 配置 AndroidManifest.xml (组件化方式在 Portal 工程中添加),并替换其中的 com.vivo.push.api_keycom.vivo.push.app_id 的值。

     <application>
         <service
             android:name="com.vivo.push.sdk.service.CommandClientService"
             android:process=":push"
             android:exported="true" />
         <activity
             android:name="com.vivo.push.sdk.LinkProxyClientActivity"
             android:exported="false"
             android:process=":push"
             android:screenOrientation="portrait"
             android:theme="@android:style/Theme.Translucent.NoTitleBar" />
         <meta-data
             android:name="com.vivo.push.api_key"
             android:value="VIVO开放平台提供" />
         <meta-data
             android:name="com.vivo.push.app_id"
             android:value="VIVO开放平台提供" />
     </application>
  4. 如需使用混淆,则要添加相关混淆配置:

测试 vivo 推送

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

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

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

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

排查问题

  1. 检查 AndroidManifest.xml 配置是否添加,以及其中 com.vivo.push.api_keycom.vivo.push.app_id 的值是否和 vivo 开放平台一致。

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

  3. 查看 logcat 日志进行排查:

    1. 选择 push 进程,过滤 mPush.PushProxyFactory,检查是否存在以下日志:

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

      若无,说明添加 推送 - vivo 组件可能存在问题,请确认是否正确添加。

    2. 选择 push 进程,过滤 mVIVO,检查是否获取到了 vivo 推送的厂商 token,如出现日志“fail to turn on vivo push”:说明 vivo 推送注册失败,错误码(state)参见 vivo 推送错误码

    3. 选择主进程,过滤 report channel token, 检查上报 vivo 厂商 token 是否成功,如出现以下日志:

      report channel token error: xxxx

      说明上报厂商 token 失败,请检查 mPaaS 配置文件base64Code 是否有值,以及获取配置文件时上传的 apk 签名和当前应用是否一致。

常见问题

vivo 推送支持哪些机型和系统版本

目前,SDK 支持的机型和最低系统版本如下表所示。有关 vivo 推送的其它相关问题,请参见 vivo 推送常见问题汇总

vivo supported list