iOS SDK troubleshooting guide

By following these steps, you'll be able to find exactly where your integration might be failing and collect the necessary information to get help from our team.

Prerequisites

At this point you should have completed the integration of the Pushwoosh iOS SDK. For SDK 7.0 and newer (modular SDK) use the iOS SDK 7.0+ quick start or the 7.0+ basic integration guide. For earlier versions see the quick start or basic integration guide.

Run the project

1. Uninstall the application from the test device.
2. Clean the project in Xcode: Product > Clean Build Folder.
3. Build and run the app on a test device.

After the app has finished startup and the Pushwoosh SDK completed its initialization, you should see the following log entry:

Pushwoosh: Initializing application runtime
[PW] BUNDLE ID: __YOUR_BUNDLE_ID__
[PW] APP CODE: __YOUR_APP_CODE__
[PW] PUSHWOOSH SDK VERSION: __PUSHWOOSH_SDK_VERSION_INSTALLED__
[PW] HWID: __YOUR_HWID__
[PW] PUSH TOKEN: (null)
[PW] [INFO] [PWInAppMessagesManager]
User "__USER_ID_OF_THE_DEVICE__" was successfully registered

4. The notification permission prompt should be displayed at the point in your app where you call Pushwoosh.sharedInstance().registerForPushNotifications(). Grant permission for push notifications to register the device:

5. The device will register with Pushwoosh and receive a push token, which is printed to the device logs:

[PW] [INFO] [PWNotificationManagerCompatiOS10]
NotificationCenter authorization granted: 1
[PW] [INFO] [PWPushNotificationsManager]

Registered for push notifications
Device ID: __DEVICE_PUSH_TOKEN__
HWID: __YOUR_HWID__

Verify the device registration

1. Go to the "User Explorer" tab of the Pushwoosh Control Panel (Audience > User Explorer).
2. Enter the HWID or User ID of your device into the search field.
3. Locate your test device in the search results and open it to view its details.
4. Make sure the device has a push token:

Send a push notification

1. Go to the Pushwoosh Control Panel and send a push notification.
2. Your device should display the notification and the following entries should be printed to the logs after the notification is opened:

onMessageReceived:  [AnyHashable("pw_msg"): 1, AnyHashable("p"): __MESSAGE_HASH__, AnyHashable("aps"): {
    alert = "__CONTENT_OF_THE_PUSH__";
    "mutable-content" = 1;
    sound = default;
}]
[PW] [INFO] [PWPushNotificationsManager]
Method 'pushwoosh:onMessageReceived:' was called with payload: { ... }
onMessageOpened:  [AnyHashable("p"): __MESSAGE_HASH__, AnyHashable("actionIdentifier"): com.apple.UNNotificationDefaultActionIdentifier, ... ]
[PW] [INFO] [PWDataManager]
sendStats executed with parameters: { ... }

3. Verify that your test device still has a push token in the "User Explorer" tab of the Pushwoosh Control Panel.

Getting support

If your integration isn't working as expected, please:
1. Note the specific step where the process fails.
2. Export the complete device logs.

Make sure to include all of the collected data when composing a support request.

Use this guide to contact our support team.