Android 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 quick start or basic integration guide of Pushwoosh SDK.

Run the project

1. Uninstall the application from the test device.
2. Clean the project in Android Studio: Build > Clean Project
3. Build and run the app on a test device
4. Filter the logs by applying package:mine filter in the Logcat window

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

Log level: INFO
[RequestPermissionHelper] Requesting permissions
Pushwoosh SDK initialized successfully
HWID: __HWID_OF_YOUR_DEVICE__
APP_CODE: __YOUR_PUSHWOOSH_APP_ID__
PUSHWOOSH_SDK_VERSION: __PUSHWOOSH_SDK_VERSION_INSTALLED__
FIREBASE_PROJECT_ID: __YOUR_FIREBASE_PROJECT_ID__
PUSH_TOKEN: (null)
User ID "__USER_ID_OF_THE_DEVICE__" successfully set

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

6. The device will register with Pushwoosh and receive a push token, which in turn will be printed to the device logs:

[NotificationManager] Registered for push notifications: __DEVICE_PUSH_TOKEN__

Verify the device registration

1. Go to "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 the device to view it's 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 entry should be printed to the logs:

[FcmHelper] Received message: {header=__TITLE_OF_THE_MESSAGE__, pw_msg=1, p=__MESSAGE_HASH__, s=default, pri=0, title=__CONTENT_OF_THE_PUSH__"} from: __YOUR_FIREBASE_PROJECT_ID__
[PushwooshRepository] Sending MessageDeliveredRequest, hash: __MESSAGE_HASH__

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 a specific step where the process fails.
2. Export the complete device logs from the Logcat.

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

Use this guide to contact our support team.