阿里云首页 移动开发平台 mPaaS

OPPO 消息推送失败

若出现 OPPO 渠道消息推送失败的情况,请参考以下步骤进行问题排查:

  1. 确保已按照 OPPO 推送接入 说明成功接入 OPPO 推送。接入步骤包括:

    1. 下载 OPPO Push SDK 的库并引入;
    2. 添加 推送 - OPPO 组件
    3. 配置 AndroidManifest.xml
    4. 接入 MpaaSNcActivity
      说明
  2. 检查引入的 OPPO 推送 mcssdk-2.xx.jar 文件对应的 SDK 版本是否正确。

    • 当 mPaaS 基线为 10.1.68.29 及以上版本时,支持 OPPO Push SDK V2.1.0(mcssdk-2.1.0.jar)。
    • 当 mPaaS 基线版本低于 10.1.68.29 时,仅支持 OPPO Push SDK V2.0.2(mcssdk-2.0.2.jar)。
  3. 检查 AndroidManifest.xml 配置文件中 service 是否配置正确。不同版本 SDK,需要添加的 service 类不同。

    • 采用 OPPO Push SDK V2.0.2 版本(mPaaS 基线版本小于 10.1.68.29)时,对应的 service 类为 com.heytap.mcssdk.PushServicecom.heytap.mcssdk.AppPushService,配置如下:
      1. <uses-permission android:name="com.coloros.mcs.permission.RECIEVE_MCS_MESSAGE" />
      2. <uses-permission android:name="com.heytap.mcs.permission.RECIEVE_MCS_MESSAGE"/>
      3. <application>
      4. <!-- V2.0.2 添加 Service START-->
      5. <service
      6. android:name="com.heytap.mcssdk.PushService"
      7. android:permission="com.coloros.mcs.permission.SEND_MCS_MESSAGE"
      8. android:process=":push">
      9. <intent-filter>
      10. <action android:name="com.coloros.mcs.action.RECEIVE_MCS_MESSAGE"/>
      11. </intent-filter>
      12. </service>
      13. <service
      14. android:name="com.heytap.mcssdk.AppPushService"
      15. android:permission="com.heytap.mcs.permission.SEND_MCS_MESSAGE"
      16. android:process=":push">
      17. <intent-filter>
      18. <action android:name="com.heytap.mcs.action.RECEIVE_MCS_MESSAGE"/>
      19. </intent-filter>
      20. </service>
      21. <!-- V2.0.2 添加 Service END-->
      22. <meta-data
      23. android:name="com.oppo.push.app_key"
      24. android:value="OPPO开放平台获取"
      25. />
      26. <meta-data
      27. android:name="com.oppo.push.app_secret"
      28. android:value="OPPO开放平台获取"
      29. />
      30. </application>
    • 采用 OPPO Push SDK V2.1.0 版本(基线版本大于等于 10.1.68.29)时,对应的 service 类为com.heytap.msp.push.service.CompatibleDataMessageCallbackServicecom.heytap.msp.push.service.DataMessageCallbackService,配置如下:
      1. <uses-permission android:name="com.coloros.mcs.permission.RECIEVE_MCS_MESSAGE" />
      2. <uses-permission android:name="com.heytap.mcs.permission.RECIEVE_MCS_MESSAGE"/>
      3. <application>
      4. <!-- V2.1.0 添加 Service START-->
      5. <service
      6. android:name="com.heytap.msp.push.service.CompatibleDataMessageCallbackService"
      7. android:permission="com.coloros.mcs.permission.SEND_MCS_MESSAGE"
      8. android:process=":push">
      9. <intent-filter>
      10. <action android:name="com.coloros.mcs.action.RECEIVE_MCS_MESSAGE"/>
      11. </intent-filter>
      12. </service>
      13. <service
      14. android:name="com.heytap.msp.push.service.DataMessageCallbackService"
      15. android:permission="com.heytap.mcs.permission.SEND_PUSH_MESSAGE"
      16. android:process=":push">
      17. <intent-filter>
      18. <action android:name="com.heytap.mcs.action.RECEIVE_MCS_MESSAGE"/>
      19. <action android:name="com.heytap.msp.push.RECEIVE_MCS_MESSAGE"/>
      20. </intent-filter>
      21. </service>
      22. <!-- V2.1.0 添加 Service END-->
      23. <meta-data
      24. android:name="com.oppo.push.app_key"
      25. android:value="OPPO开放平台获取"
      26. />
      27. <meta-data
      28. android:name="com.oppo.push.app_secret"
      29. android:value="OPPO开放平台获取"
      30. />
      31. </application>