Why is my test device showing an 'Unknown Platform' and the QR code registration is failing?

An "Unknown Platform" test device, or a QR scan that never registers anything, almost always comes from the auto-configuration deep link not reaching the SDK — not from the SDK version alone. Work through the checks below.

1. Declare the deep link in the app

The QR code encodes a deep link that the Pushwoosh SDK parses to register the device. The app must be able to receive it:

• Android — add the deep link scheme to AndroidManifest.xml.
• iOS — add it to Info.plist.

Without this the link opens and nothing happens, and the entry can appear with no platform information.

2. Open the link in the native browser

Many QR readers open scanned links inside their own in-app webview, which cannot hand the deep link to your app. Use the reader's "Open in Browser" action so the link is handled by the system browser.

3. Make sure the device is already registered

Launch the app once with the Pushwoosh SDK integrated so a /registerDevice call succeeds, then scan the code. Auto-configuration by QR is supported for iOS and Android only.

4. Update the SDK

Older SDK builds can omit platform information during test-device registration. Update to a current release — Android SDK 6.10.0 or later, iOS SDK 7.2.0 or later, and the matching version of your cross-platform plugin.

5. Fall back to manual registration

If the QR flow still fails, add the device by hand:

1. Take the device HWID from a successful /registerDevice API call.
2. Go to Settings > Test Devices and click Add Device > Push.
3. Fill in Device Name and Device HWID, and explicitly select the correct Device Type (iOS, Android, Web). Setting it here resolves the "Unknown Platform" display.