We recommend updating to the versions listed below or higher if available.

iOS SDK 5.1.3

When you call the jsonRepresentation method of OSPushSubscriptionState, if a property is null, the value will now be "" instead of the string literal "nil" in #1373

Rename internal method that was called setSharedInstance to workaround false App Store flagging in #1375
Improve Swift concurrency safety to address crash reports in production #1376
For our server: Add OneSignal-Subscription-Id to Create User request which improves last_active data in #1372

Android (Google) SDK 5.1.6

Make ServiceBuilder.getService thread safe (#2012)
- Will fix some null Context crashes from initWithContext
- Addresses issues; #1990 & #1917
4.x.x migration: Missing onesignalId during initWithContext (#2009)
- Address issues; #1995 & #1839

[Internal only] Upgraded compileSdkVersion to 34 (#1994)
- Apps can still use Android compile SDK 33, target SDK version unaffected
[Internal only] Added nested JSONObject support to JSONObject.toMap() (#2004)
[Internal only] Upgrade tests to JUnit5 and Kotest to 5.8.0 (#2006)

Add setting to prefer HMS over FCM #1984
- Add under your tag if you like to use this setting.
- See OneSignal's Prefer HMS over FCM documentation page for more details.

Attempt retrying OutOfMemoryError errors when starting threads. #2027
- Make sure your app doesn't have any memory leaks and is handling onTrimMemory so the
SDK can move on once memory is free
Fix rare null crash with taskQueueWaitingForInit.poll() #2026
Fix rare null crash with timeFocusedAtMs #2025

Changed
- Updated included Android SDK to 5.1.6
- Updated included iOS SDK to 5.1.3

Add getter for onesignalId and externalId and a UserState Observer to be notified of changes in [#1627]
- See the User Namespace API Reference in the Migration Guide for usage
Add asynchronous getter methods for Notifications permission and Push Subscription token, id, optedIn in [#1649]
- 🛑 Deprecated methods 🛑
  - Notifications.hasPermission, User.pushSubscription.id, User.pushSubscription.token, and User.pushSubscription.optedIn are now deprecated but non-breaking.
See the Push Subscription Namespace API Reference and Notifications Namespace API Reference in the Migration Guide for usage of new methods getPermissionAsync, getIdAsync, getTokenAsync, and getOptedInAsync.

API update for PushSubscriptionState: the Push Subscription observer will now be passed nullable properties. Please account for the possibility of the push subscription token and id being null.

Update Android SDK from 5.1.2 to 5.1.6
- Which include an improvement to banner-style IAMS: link, a dependency update for firebase-messaging and play-services-basement
- Also includes fix for null pointer exceptions from calling getAppContext when the SDK is initializing: link
- For full changes, see the native release notes
Update iOS SDK from 5.1.0 to 5.1.3
- Includes fix to improve Swift concurrency safety to address crash reports in production: link

Add getter for onesignalId and externalId and a UserState Observer to be notified of changes in [#959]
- See the User Namespace API Reference in the Migration Guide for usage
Add asynchronous getter methods for Notifications permission and Push Subscription token, id, optedIn in [#977]
- ⚠️ Previous methods Notifications.hasPermission, User.pushSubscription.id, User.pushSubscription.token, and User.pushSubscription.optedIn are now deprecated but non-breaking. ⚠️
- See the Push Subscription Namespace API Reference and Notifications Namespace API Reference in the Migration Guide for usage of new methods getPermissionAsync, getIdAsync, getTokenAsync, and getOptedInAsync.

This release includes new native SDK versions that resolve multiple crashes and issues.