All Products
Search
Document Center

Mobile Platform as a Service:Message push through OPPO Push failed

Last Updated:Feb 02, 2024

In case of OPPO channel message push failure, refer to the following steps for troubleshooting:

  1. Make sure that you have successfully integrated OPPO PUSH by following the instructions in Access OPPO Push. The main steps include:

    1. Download the library of OPPO Push SDK and import it to project;

    2. Add the Push - OPPO component;

    3. Configure AndroidManifest.xml in the project;

    4. Integrate the MpaaSNcActivity class.

      Note
  2. Check if the SDK version corresponding to OPPO PUSH mcssdk-2.xx.jar is correct.

    • For mPaaS baseline 10.1.68.29 or later versions, please use OPPO PUSH SDK V2.1.0 (mcssdk-2.1.0.jar).

    • For mPaaS baseline earlier than 10.1.68.29, please use OPPO PUSH SDK V2.0.2 (mcssdk-2.0.2.jar).

  3. Check if the service classes in AndroidManifest.xml are correctly configured. The service classes required vary with the SDK version.

    • For OPPO PUSH SDK V2.0.2 (mPaaS baseline earlier than 10.1.68.29), the corresponding service classes are com.heytap.mcssdk.PushService and com.heytap.mcssdk.AppPushService. The configuration is as follows:

      <uses-permission android:name="com.coloros.mcs.permission.RECIEVE_MCS_MESSAGE" />
      <uses-permission android:name="com.heytap.mcs.permission.RECIEVE_MCS_MESSAGE"/>
      <application>
      <!-- V2.0.2 Add Service START-->
      <service
         android:name="com.heytap.mcssdk.PushService"
         android:permission="com.coloros.mcs.permission.SEND_MCS_MESSAGE"
         android:process=":push">
         <intent-filter>
             <action android:name="com.coloros.mcs.action.RECEIVE_MCS_MESSAGE"/>
         </intent-filter>
      </service>
      <service
         android:name="com.heytap.mcssdk.AppPushService"
         android:permission="com.heytap.mcs.permission.SEND_MCS_MESSAGE"
         android:process=":push">
         <intent-filter>
             <action android:name="com.heytap.mcs.action.RECEIVE_MCS_MESSAGE"/>
         </intent-filter>
      </service>
      <!-- V2.0.2 Add Service END-->
      <meta-data
         android:name="com.oppo.push.app_key"
         android:value="Obtain from OPPO Developer Platform"
         />
      <meta-data
         android:name="com.oppo.push.app_secret"
         android:value="Obtain from OPPO Developer Platform"
         />
      </application>
    • For OPPO PUSH SDK V2.1.0 (mPaaS baseline is 10.1.68.29 or later version), the corresponding service classes are com.heytap.msp.push.service.CompatibleDataMessageCallbackService and com.heytap.msp.push.service.DataMessageCallbackService. The configuration is as follows:

      <uses-permission android:name="com.coloros.mcs.permission.RECIEVE_MCS_MESSAGE" />
      <uses-permission android:name="com.heytap.mcs.permission.RECIEVE_MCS_MESSAGE"/>
      <application>
      <!-- V2.1.0 Add Service START-->
      <service
         android:name="com.heytap.msp.push.service.CompatibleDataMessageCallbackService"
         android:permission="com.coloros.mcs.permission.SEND_MCS_MESSAGE"
         android:process=":push">
         <intent-filter>
             <action android:name="com.coloros.mcs.action.RECEIVE_MCS_MESSAGE"/>
         </intent-filter>
      </service>
      <service
         android:name="com.heytap.msp.push.service.DataMessageCallbackService"
         android:permission="com.heytap.mcs.permission.SEND_PUSH_MESSAGE"
         android:process=":push">
         <intent-filter>
             <action android:name="com.heytap.mcs.action.RECEIVE_MCS_MESSAGE"/>
             <action android:name="com.heytap.msp.push.RECEIVE_MCS_MESSAGE"/>
         </intent-filter>
      </service>
      <!-- V2.1.0 Add Service END-->
      <meta-data
         android:name="com.oppo.push.app_key"
         android:value=" Obtain from OPPO Developer Platform"
         />
      <meta-data
         android:name="com.oppo.push.app_secret"
         android:value=" Obtain from OPPO Developer Platform "
         />
      </application>