All Products
Search
Document Center

Access vivo Push

Last Updated: Aug 03, 2021

This guide mainly introduces the process of accessing vivo Push. The process falls into three steps:

  1. Register vivo Push
  2. Access vivo Push
  3. Test vivo Push

Register vivo Push

Register an account on the vivo Developers Platform and request to access the push service with reference to vivo Push Platform Operation Guide.

Access vivo Push

  1. Add Push - vivo component in the IDE plugin. The steps are roughly the same as adding MPS SDK, see Add SDK.
    The component only contains adaptive codes, without vivo Push SDK. You can add the vivo Push SDK dependencies separately by following the steps below.
  2. Download vivo Push SDK from Android PUSH SDK Integration Guide and integrate the SDK to the main project.
    The current adaptable version is V2.3.4. If you need to use a higher version, you can change it by yourself. Generally, the vendor’s SDK is downward compatible. If it is not compatible, you can submit a ticket about the adaption issue.
  3. Configure AndroidManifest.xml, and replace the values of com.vivo.push.api_key and com.vivo.push.app_id. If you access the vivo Push SDK through Portal & Bundle projects, please configure the AndroidManifest.xml in the Portal project.
       
    1. <application>
    2. <service
    3. android:name="com.vivo.push.sdk.service.CommandClientService"
    4. android:process=":push"
    5. android:exported="true" />
    6. <activity
    7. android:name="com.vivo.push.sdk.LinkProxyClientActivity"
    8. android:exported="false"
    9. android:process=":push"
    10. android:screenOrientation="portrait"
    11. android:theme="@android:style/Theme.Translucent.NoTitleBar" />
    12. <meta-data
    13. android:name="com.vivo.push.api_key"
    14. android:value="Provided by vivo Developers Platform" />
    15. <meta-data
    16. android:name="com.vivo.push.app_id"
    17. android:value="Provided by vivo Developers Platform" />
    18. </application>
  4. To use obfuscation, you need to add the related obfuscation configurations.

Test vivo Push

  1. After accessing vivo Push, you can start the app on your vivo phone, and the MPS SDK will automatically get the OPPO Push token and report it. Before you start the app, make sure that you have called the initialization method, see Message push initialization.
  2. Push test messages when the app process is killed:
    • If you can still receive the messages, it means that the app has successfully accessed vivo Push.
    • If you cannot receive the messages, you can follow the steps below for troubleshooting.

Troubleshooting

  1. Check if AndroidManifest.xml has related configurations added, and check if the values of com.vivo.push.api_key and com.vivo.push.app_id are the same as that on vivo Developers Platform.
  2. Check if vivo Push is enabled in the mPaaS console (see Configure vivo Push), and the relevant configurations are consistent with that on vivo Developers Platform.
  3. View the logs in Logcat to troubleshoot:

    1. Select the push process, filter mPush.PushProxyFactory, and check if the following log exists:
           
      1. D/mPush.PushProxyFactory: found proxy com.mpaas.push.external.vivo.Creator
      If not, it means that there may be a problem with the Push - vivo component. Check if the component has been correctly added.
    2. Select the push process, filter mVIVO, and check if the channel token of vivo Push has been obtained. If the following log (“fail to turn on vivo push”) appears:
      check vivo token
      It means the vivo Push registration failed, see vivo Push Error Codes.

    3. Select the main process, filter report channel token, check if the channel token of vivo Push has been successfully reported. If the following log appears:

           
      1. report channel token error: xxxx

      It means the channel token reporting failed, you need to check if the base64Code in the mPaaS configuration file has a value, and check if the apk signature that you uploaded when obtaining the configuration file is consistent with the app.

  4. If the above steps do not resolve the issue, you can submit a ticket or contact the mPaaS support staff.

FAQ

Models and OS versions supported by vivo Push

The models and earlier system versions supported by vivo Push are listed in the following table. For other questions on vivo Push, see vivo Push FAQs.

1