OPPO push notification failures

Follow these steps to diagnose and resolve OPPO push notification delivery failures in mPaaS.

1. Confirm that OPPO Push integration is complete. Follow the steps in Integrate OPPO Push. A complete integration includes:

   1. Download and import the OPPO Push SDK library.

   2. Add the Push - OPPO component.

   3. Configure the AndroidManifest.xml file.

   4. Integrate MpaaSNcActivity.

      Note

      • For setup details, see the OPPO Push Platform User Guide. Create an account on the OPPO Open Platform and request access to the push service.

      • mPaaS does not include the OPPO Push SDK library (mcssdk-2.xx.jar). Download it from the OPPO SDK documentation and add it to your main project.

2. Verify that the imported mcssdk-2.xx.jar matches the required SDK version for your mPaaS baseline:

   • mPaaS baseline 10.1.68.29 or later requires OPPO Push SDK V2.1.0 (mcssdk-2.1.0.jar).

   • mPaaS baseline earlier than 10.1.68.29 requires OPPO Push SDK V2.0.2 (mcssdk-2.0.2.jar).

3. Verify that the service classes in AndroidManifest.xml match your SDK version. Each SDK version requires different service class names.

   • For OPPO Push SDK V2.0.2 (mPaaS baseline earlier than 10.1.68.29), declare com.heytap.mcssdk.PushService and com.heytap.mcssdk.AppPushService:

     <uses-permission android:name="com.coloros.mcs.permission.RECIEVE_MCS_MESSAGE" />
     <uses-permission android:name="com.heytap.mcs.permission.RECIEVE_MCS_MESSAGE"/>
     <application>
     <!-- Add Service for V2.0.2 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>
     <!-- Add Service for V2.0.2 END-->
     <meta-data
        android:name="com.oppo.push.app_key"
        android:value="Get from OPPO Open Platform"
        />
     <meta-data
        android:name="com.oppo.push.app_secret"
        android:value="Get from OPPO Open Platform"
        />
     </application>

   • For OPPO Push SDK V2.1.0 (mPaaS baseline 10.1.68.29 or later), declare com.heytap.msp.push.service.CompatibleDataMessageCallbackService and com.heytap.msp.push.service.DataMessageCallbackService:

     <uses-permission android:name="com.coloros.mcs.permission.RECIEVE_MCS_MESSAGE" />
     <uses-permission android:name="com.heytap.mcs.permission.RECIEVE_MCS_MESSAGE"/>
     <application>
     <!-- Add Service for V2.1.0 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>
     <!-- Add Service for V2.1.0 END-->
     <meta-data
        android:name="com.oppo.push.app_key"
        android:value="Get from OPPO Open Platform"
        />
     <meta-data
        android:name="com.oppo.push.app_secret"
        android:value="Get from OPPO Open Platform"
        />
     </application>