tencent cloud

PrevNext

Feedback

search by keyword

Recent Pages

Documentation
Tencent Push Notification Service
    Documentation
    Download PDF

    Troubleshooting Vendor Channel Registration Failures

    Last updated: 2024-01-16 17:39:39
    Download PDF

      Problem Description

      If your application is connected to a vendor channel, but a log similar to the following one is found in the application operation logs: 
      [OtherPushClient] handleUpdateToken other push token is :  other push type: huawei
      Then it means that your application failed to register with the vendor channel. You can locate and troubleshoot the problem by getting the return code for vendor channel registration failure.

      Troubleshooting Directions

      Getting the return code for vendor channel registration

      Tencent Push Notification Service SDK for Android provides the following ways to get the return code for vendor channel registration:
      Filter application operation logs by the keyword OtherPush to find logs similar to the following ones and locate the return code for vendor channel registration:
      // Huawei channel
      // If filtering by the keyword `OtherPush` cannot find the return code, you can try the keyword `HMSSDK` and find the return code after `onResult` or `onConnect`
      [OtherPushHuaWeiImpl] other push huawei onConnect code:907135702
      
      n// Mi channel
      [OtherPush_XG_MI] register failed, errorCode: 22022, reason: Invalid package name: com.xxx.xxx
      
      // Meizu channel
      [OtherPush_XG_MZ] onRegisterStatus BasicPushStatus{code='110000', message='Invalid appId'}
      
      // OPPO channel
      [OtherPushOppoImpl] OppoPush Register failed, code=14, msg=INVALID_APP_KEY
      
      // vivo channel
      [OtherPushVivoImpl] vivoPush Register or UnRegister fail, code = 10003

      Troubleshooting by return code

      You can refer to the official push documentation of each vendor to get the specific descriptions of return codes and troubleshoot accordingly. The table below lists some common error codes:
      Vendor Channel
      Return Code
      Description
      Suggested Solution
      Link
      Huawei
      1001
      Make sure that the "HMS" or "HMS-Core" application is installed in the phone, which is required for Huawei Push
      Go to Huawei AppGallery to download and install the "HMS-Core" application
      6003
      The application APK is not signed or contains signing information that doesn't match that registered on the Huawei Developer platform; however, it must be correctly signed for Huawei Push
      Sign the APK file or check whether the signing information is correct Configuring the signature certificate fingerprint for the Huawei channel
      907135000
      The appId is invalid
      Check whether the value of the appId field in the Huawei Push configuration file agconnect-services.json matches the application package name
      Check whether the configuration file is in the root directory of the project's app module (at the same level as the build.gradle file of the application)
      907135702
      The SHA256 value of the signature file is different from that configured on the Huawei Push platform
      Check whether the entered SHA256 value of the signature file is the same as the one configured on the Huawei Push platform (multiple ones can be added)
      907135003
      
      The apiclient object is invalid
      Check whether the phone can access the internet normally or reconnect it to the network
      This problem is most probably caused by version incompatibility of the HMS-Core application on Huawei phones. You can try searching for HMS-Core or Huawei Mobile Service in Huawei AppGallery, check whether the latest version is installed, and if not, upgrade it
      HONOR
      8001000
      The device does not support HONOR push
      Use HONOR devices for testing
      Update the version of the Magic UI that includes the push service
      8001003
      Failed to obtain the application certificate fingerprint
      Configure your certificate fingerprint
      Mi
      22006
      The application ID is invalid
      Check whether the application package name, appId, and appKey match each other on the Mi Push platform
      22007
      The application key is invalid
      Check whether the application package name, appId, and appKey match each other on the Mi Push platform
      22022
      The application package name is invalid
      Check whether the application package name, appId, and appKey match each other on the Mi Push platform
      Meizu
      110000
      The appId is invalid
      Check whether the application package name, appId, and appKey match each other on the Meizu Push platform. Check the application information on the Flyme Push platform
      110001
      The appKey is invalid
      Check whether the application package name, appId, and appKey match each other on the Meizu Push platform
      OPPO
      14
      The AppKey parameter is invalid
      
      Please note that OPPO's AppKey instead of AppId should be entered for setOppoPushAppId, while OPPO's AppSecret instead of AppKey should be entered for setOppoPushAppKey
      15
      The AppKey parameter is missing
      Enter the AppKey parameter
      vivo
      10003
      The application package name does not match the configured one
      Check whether the application package name, appId, and appKey match each other on the vivo Push platform
      10004
      The appKey is incorrect
      Check whether the application package name, appId, and appKey match each other on the vivo Push platform
      10005
      The appId is incorrect
      Check whether the application package name, appId, and appKey match each other on the vivo Push platform

      Troubleshooting other issues

      For Huawei Push, the push service needs to be enabled on the Huawei Push platform If you cannot get the Huawei token on your Huawei device, and the return code for vendor push channel registration is 0, then please go to the Huawei Push platform, check whether the push service is enabled for the application on the Development -> Push Service page and whether Push Kit and App Messaging are enabled on the Development -> Project Settings -> API Management page.
      For Mi Push, the push service needs to be enabled on the Mi Push platform If you cannot find the return code for Mi channel registration, please check whether the application's message push service is enabled on Mi Open Platform -> Push Platform.
      For OPPO Push, the push feature needs to be enabled first before messages can be pushed On the push service page on OPPO Open Platform, you can view applications with the service enabled and those not enabled. Among those not enabled, click the one for which you want to apply for push permission to enter the push service page and apply for enablement accordingly.
      For vivo Push, the push feature needs to be enabled first before messages can be pushed Go to vivo Open Platform -> Push Platform -> Message Push -> **All Applications, click Application Name to select the target application among all the created applications, and click Submit Application.
      Note:
      For some vendors, the push service will take effect around 5 minutes after it is enabled. If registration still fails after the push service is enabled, please wait a while and try again.
      The HMS version is too low Search for the keyword "HMSSDK" in the logs, and if a log similar to the following one is found, that is, connect versionCode is lower than connect minVersion, then it means that the system application "HMS" or "HMS_Core" is too old. Please retry registering after upgrading the application.
       I/HMSSDK_HuaweiApiClientImpl: ====== HMSSDK version: 20601301 ======
       I/HMSSDK_HuaweiApiClientImpl: Enter connect, Connection Status: 1
       E/HMSSDK_Util: In getHmsVersion, Failed to read meta data for the       HMS VERSION.
       I/HMSSDK_HuaweiApiClientImpl: connect minVersion:20600000
       I/HMSSDK_HuaweiMobileServicesUtil: connect versionCode:20301306
       D/HMSAgent: connect end:-1001
      Some vivo models do not support the push service vivo Push is supported only on certain newer models and corresponding OS versions. For more information, please see here.
      Contact Us

      Contact our sales team or business advisors to help your business.

      Contact Us
      Technical Support

      Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

      Submit a Ticket
      7x24 Phone Support
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      Privacy PolicyLegalCookie Policy