Other FAQs

Last updated: 2020-04-22 15:14:11


Q: If the push can be received in the developer environment on iOS, why cannot it be received in the production environment after packaging?

1. Check whether the “archived-expanded-entitlements.xcent” file is in the package.
If not, an error may occur:

No valid 'aps-environment' entitlement string found for application 'com.xxx.xxx': (null).

Solution: Go to TARGET -> Build Setting -> Code Signing Identity -> Code Signing Entitlements
 Check whether there is the aps-environment field; if not, add it. 
<plist version="1.0">

Q: Why can't the push be received in the production environment?

A: Testing of the production environment must meet the following conditions: The app is ad-hoc package/App Store version (with the release certificate "Production"), and the release certificate is uploaded and successfully verified.

Q: Why is iOS token invalid?


(1) The system is logged out or the app is uninstalled

(2) The user installs the app on a new device

(3) The user restores the device from a backup

(4) The user re-installs the OS

(5) Events defined by other systems (1. After calling the unregisterNotification API, register the notification again and clear device data and settings)

Q: Why can device that has integrated the Mi channel only display one push message?

A: According to the documentation on Xiaomi's official website, the notification panel by default only displays one push message. If you want to display multiple messages in the notification panel, you need to set different notify_id for different messages (notification panel messages with the same notify_id will override previous ones). The TPNS official parameter is n_id.

Q: Is there a limit to the number of messages displayed in the device notification panel? Why is the message not displayed after arriving at the device?

There is no limit to the number of notification panel messages a phone can receive and display. If not displayed, the reasons may be:

(1) The notification panel on a Mi phone by default displays the latest message. If you want all messages to be displayed, you need to set the n_id.

(2) The message broadcast is blocked by a phone manager app.

(3) A Meizu phone has a message box, and not commonly used messages will go directly to the message box, where they can be viewed.

Q: How to set a custom ringtone?


  1. Set in the console: Go to Push Notification > Advanced Settings > Reminder Mode > Sound > Customize. For Android, select the ringtone file in the raw directory, which does not need an extension such as xg_ring. For iOS, select the ringtone file in the bundle directory, which requires an extension such as xg_ring.wav.
  2. Set in Rest API V3: For Android, set ring=1 in the push message body, and set ring_raw as the name of the ringtone file in the raw directory of the specified Android project, without any extension. For iOS, set the sound of the push message body as the ringtone file name in the bundle directory of the specified project, with the extension.

    Note: If the client has integrated a vendor channel, custom ringtone file may not be available and the system sound will be used by default.

Q: How do I customize the icon in the status bar?

A: ROMs in native Android 5.0 and above will process the app icon whose target SDK is greater or equal to 21, adding a layer of color and turning it into grey. If you want an icon with color, set target SDK to a value below 21. If you need the target SDK to be no smaller than 21, rename an image with a clear background and in png format to notification_icon.png and place it in drawable. Thus, the icon will be in gray and has a shape.

Q: Can an app still receive push messages after it is closed or its process has ended?


(1) TPNS channel mainly relies on the TPNS service to send and receive messages. If a process ends, the TPNS service will also end, and push messages will only be received after the service is reactivated or the app is restarted. If another app that is connected to TPNS is opened in the mobile phone, you can use other app’s service to receive messages, but the shared service channel is subject to the restriction of the mobile phone’s ROM, and cannot guarantee a 100% success rate.

(2) The vendor channel supports receiving push messages after the process ends.

Q: What if Android v4.4.4 reports a compiling error where XGPushProvider and MidProvider cannot be found?

A: As the number of loading methods in the project exceeds 65K, please create sub-packages for the project.

Q: Why can't device registration receive the callback information?


(1) The vendor channel’s callback is returned by the vendor’s server.

(2) Check whether security software has blocked the broadcast.

Q: If an account is logged into on device A and then on device B, what will happen when a message is sent to this account?

A: Device B can receive the push, but device A cannot. Only the last device bound to the account can receive the push.

Q: What if I cannot redirect to another page when opening a specified activity page?

A: On some phones, redirection from a notification panel to another page may incur permission issues.
Solution: In AndroidManifest.xml, add android:exported="true" to the activity you want to open.

Q: When the user goes back online, what is the order in which multiple push messages are received?

A: Incremental according to the message ID. The client also receives messages according to this rule. Thus, the order in which messages are received is the same as that in which they are sent.

Q: If the scheduled push selects a time in the past, will the push be sent?

A: If the time selected is in the past, the system will send the push immediately.

Q: Can the registration method be created in the thread? Can it be created in APPLICATON onCreate?

A: The registration method can be called anywhere, but applicationContext needs to be passed in.

Q: Limits on pushing notifications of all channels?

  • Self-built Channel: Full push messages with the same content can only be sent once an hour, and there is no limit to the frequency and number of send times for other push targets.

  • Vivo Push Limits
    The daily limit of single push and group push is calculated based on the number of SDK subscriptions. When < 10000, it is counted as 10000; when > 10000, it is equal to the number of SDK subscriptions. One push can be sent daily by default. For details, see vivo official document

  • OPPO Push Limits
    When the cumulative number of users < 50,000, the push limit is 100,000; when >= 50,000, the push limit is 2 * the cumulative number of users.
    The cumulative number of users can be queried at OPPO Push Operation Platform, and will be refreshed daily.

  • MEIZU Platform Limits

    1. There is a rate limit for the push of a single application. The default value is 500 messages per second.
    2. There is a limit to the number of pushes per day for a single application. The default value is 1000 times per day.
    3. No more than 100 tags for a single application subscription
    4. When messages sent to a device for a single application >= 4, they will be collapsed. The messages may be stored in the upper right corner without clicking for several times.
    5. Subscription will be cancelled after a device is inactive for 1 month.
    6. There is a limit on the number of API requests for one IP address per hour. MEIZU has not given a specific number yet.
    7. There is a limit to the accumulated number of API requests for a single application per day. MEIZU has not given a specific number yet.
    8. There is a limit to the total number of messages that a single application can push per day. MEIZU has not given a specific number yet.
  • HUAWEI Platform Limits

    1. Push number limit: The number of messages sent to a single device can not exceed 3,000 per day. After exceeding the limit, the rate will be limited for 24 hours. When more than 100,000 pieces are pushed to a single device within a day, the push authorization will be stopped. You should rectify and provide a rectification plan to HUAWEI to get push authorizations again.
    2. Push speed limit: HUAWEI Push allocates the push speed mainly based on two factors: monthly activity of the application on HUAWEI channels and app type when the application is launched in the HUAWEI App Store.
  • MI Platform Limits
    XIAOMI Push Service does not set any limits to the push frequency. The data size of one notification should be smaller than 4 KB.

 Guide of Usage Excess If the amount of notifications pushed through the platform channel exceeds the limit of the day, the push task after the excess will be reissued through the self-built channel.

Was this page helpful?

Was this page helpful?

  • Not at all
  • Not very helpful
  • Somewhat helpful
  • Very helpful
  • Extremely helpful
Send Feedback