Mobile SDKs API Migration Guides
Major SDK Versions Summary
We've refined our SDKs' API to be more straightforward for common use cases while providing more flexibility for advanced ones. Better defaults and removing deprecated APIs means less code is required to set up notifications and a more focused set of options to look through.
Dependency changes including switching to AndroidX means better compatibility with projects.
Based on user feedback, we’ve added a new notificationWillShowInForeground
API enabling you to decide if the specific notification you’re about to show should be when your app is in the foreground. It’s really useful to not interrupt your users while they are in the middle of an intense battle in your game, or for a chat app, to not display a notification when the user is a already in the chat. See "Android - Foreground Notification Control" and "iOS - Foreground Notification Control" for more details on this new API.
Released SDKs
Step-by-Step Migration Guides
Just required changes to get upgraded to the major versions quickly!
- Android Native 3.x to 4.0.0 Upgrade Guide
- iOS Native 2.x to 3.0.0 Upgrade Guide
- React Native 3.x to 4.0.0 Upgrade Guide
- Flutter 2.x to 3.0.0 Upgrade Guide
- Cordova 2.x to 3.0.0 Upgrade Guide
Full API Changes References
- Android Native 3.x to 4.x API Changes
- iOS Native 2.x to 3.x Changes
- React Native - 4.0 API Reference
- Flutter - 3.0 API Reference
- Cordova - 3.0 API Reference
New App Setup guide
If you are adding the OneSignal SDK to the app for the first time.
- Setting up the Android 4.0.0 SDK
- Setting up the iOS 3.0.0 SDK
- Setting up the React Native 4.0.0 Beta SDK
- Setting up the Flutter 3.0.0 Beta SDK
Beta SDKs

Give them a try and provide feedback via our Github repos on the specific SDK you're trying out!
See our Mobile Push Quickstart if you would like to use the main line SDKs.
Step-by-Step Migration Guides
Just required changes to get upgraded to the major versions quickly!
- Unity and Xamarin coming soon
Full API Changes References
- Unity and Xamarin others coming soon
New App Setup guide
If you are adding the OneSignal SDK to the app for the first time.
- Unity and Xamarin others coming soon
Updated almost 2 years ago