Test APNs Remote Notifications

After completing the APNs integration steps, you can directly test whether the push notification integration is successful.

Prepare the Test App

Installation Method	Distribution Method	Profile Type	Push to APNs Sandbox Environment	Push to APNs Production Environment
Xcode run (Simulator)	/	/	/	/
Xcode run (Real Device)	/	Development	Supported, must use RC's development environment App Key and APNs configuration.	Not supported
IPA File	Development	Development	Supported, must use RC's development environment App Key and APNs configuration.	Not supported
Third-party App Platform (e.g., Pgyer)	Ad Hoc	Ad Hoc Distribution	Not supported	Recommended to use RC's production environment App Key and APNs configuration.
Third-party App Platform (e.g., Pgyer)	Enterprise	Enterprise Distribution	Not supported	Recommended to use RC's production environment App Key and APNs configuration.
TestFlight	App Store Connect	App Store Distribution	Not supported	Supported, but must use RC's production environment APNs configuration.
App Store	App Store Connect	App Store Distribution	Not supported	Supported, but must use RC's production environment App Key and APNs configuration.

Prepare the Push Test Environment

RC applications distinguish between development and production environments, using different App Keys. When the RC server sends push requests to APNs, there may be various combinations.

Prerequisites:

• Use a real device: Please use a real device for testing, as simulators cannot receive remote push notifications.
• Use a non-jailbroken device: Do not use a jailbroken device, as jailbroken devices may not receive remote push notifications.
• Confirm that the BundleID does not contain wildcards: Apps using wildcard BundleIDs cannot use remote push notifications.

Packaging Guidelines:

• When running on a real device via Xcode, use the development environment App Key of the RC application. In the development environment, if using P8 or P12 certificates, the RC server will only push to the APNs Sandbox environment. If using a P12 universal certificate, it should be configured to push to the APNs Sandbox environment.

• When packaging via the Development method, use the development environment App Key of the RC application. In the development environment, if using P8 or P12 certificates, the RC server will only push to the APNs Sandbox environment. If using a P12 universal certificate, it should be configured to push to the APNs Sandbox environment.

• When packaging via Ad-Hoc/TestFlight/AppStore, it is recommended to use the production environment App Key of the RC application (requires applying for production in the RC Console). As long as it is the production environment App Key, the RC server will only push to the APNs Production environment.

  Exception: In the development environment of the RC application, if using a P12 universal certificate, it is allowed to configure it to push to the APNs Production environment to meet testing needs.

If you have any questions, you can refer to the Xcode documentation:

• Xcode Documentation: Distribute to registered devices (iOS, tvOS, watchOS).
• Xcode Documentation: Distribute an app using TestFlight (iOS, tvOS, watchOS).

Test Receiving Push Notifications

It is recommended to first test push notifications using a simple one-to-one chat scenario. The steps are as follows:

1. After the app successfully connects to RC, kill the app process.
2. Visit the IM Server API Debugging page in the Console, locate Messages > Message Service > Send One-to-One Message, and directly send a one-to-one message to the current app user.
3. Check if the phone receives the push notification.

Troubleshooting

If you do not receive the push notification, please first check the following items:

• If the client disconnects and sets to not allow push notifications, such as calling the logout method, it will completely log out the login information on the RC server. The RC server will only record offline messages but will not trigger the push service.
• If the app user is already online on the Web/PC, RC considers the user online and will not send push notifications to the mobile end by default. If needed, you can adjust the Web/PC Online Mobile End Receives Push switch setting on the Basic Features page in the Console.
• If the app user uses multiple mobile devices, the RC server will only send push notifications to the last logged-in device.