NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev, #973 most downloaded on pub.dev
OneSignal is a free push notification service for mobile apps. This plugin makes it easy to integrate your flutter app with OneSignal
Latest stable
5.8.0
Last release 12 days ago
10 Nov 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 59 of the last 60 stable releases
1 version withdrawn
withdrawn after publishing
7 years old
111 releases · first in 2019
Drag across the ruler to compare, or tap a release to open it.
Fix clearTriggers on Android in https://github.com/OneSignal/OneSignal-Flutter-SDK/pull/771
Full Changelog: https://github.com/OneSignal/OneSignal-Flutter-SDK/compare/5.0.3...5.0.4
Updated included Android SDK to 5.0.3
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Full Changelog: https://github.com/OneSignal/OneSignal-Flutter-SDK/compare/5.0.2...5.0.3
Fix crash when using action buttons in Android in https://github.com/OneSignal/OneSignal-Flutter-SDK/pull/743
🐛 Bug Fixes
OneSignal.Notifications.canRequest() to Android in https://github.com/OneSignal/OneSignal-Flutter-SDK/pull/753🔧 Maintenance
optedIn boolean returns in https://github.com/OneSignal/OneSignal-Flutter-SDK/pull/744Full Changelog: https://github.com/OneSignal/OneSignal-Flutter-SDK/compare/5.0.1...5.0.2
Fix permission not updating during a session #735
🐛 Bug Fixes
permission not updating during a session #735Android Native SDK Changes
Full Changelog: https://github.com/OneSignal/OneSignal-Flutter-SDK/compare/5.0.0...5.0.1
⚠️ This is a major release which contains breaking API changes. In this major version release for the OneSignal Flutter SDK, we are making a significa
⚠️ This is a major release which contains breaking API changes. In this major version release for the OneSignal Flutter SDK, we are making a significant shift from a device-centered model to a user-centered model. A user-centered model allows for more powerful omni-channel integrations within the OneSignal platform.
For information please see the migration guide.
Note that Identity Verification has not yet been enabled in this version and will be released in a later version
Full Changelog since beta 2: https://github.com/OneSignal/OneSignal-Flutter-SDK/compare/5.0.0-beta2...5.0.0
We have made significant, breaking changes to our functions. Please see the updated migration guide for the most up to date signatures.
🚧 Beta release. Please test thoroughly prior to production use. 🚧
OneSignal Flutter 5.0.0-beta2 In this major version beta release for the OneSignal SDK, we are making a significant shift from a device-centered model to a user-centered model. A user-centered model allows for more powerful omni-channel integrations within the OneSignal platform.
For information please see the migration guide.
We have made significant, breaking changes to our functions. Please see the updated migration guide for the most up to date signatures.
Updated included Android SDK to 5.0.0-beta4 Updated included iOS SDK to 5.0.0-beta-04
Full Changelog: https://github.com/OneSignal/OneSignal-Android-SDK/compare/5.0.0-beta1...5.0.0-beta2
🚧 Beta release. Please test thoroughly prior to production use. 🚧
🚧 Beta release. Please test thoroughly prior to production use. 🚧
OneSignal Flutter 5.0.0-beta1 In this major version beta release for the OneSignal SDK, we are making a significant shift from a device-centered model to a user-centered model. A user-centered model allows for more powerful omni-channel integrations within the OneSignal platform.
For information please see the migration guide.
Updated included Android SDK to 5.0.0-beta2 Updated included iOS SDK to 5.0.0-beta-02
Replace deprecated openURL method preventing launch URLs #1493
Channels: Legacy
⚠️ Please update to this release to ensure launch URLs continue to work on iOS 18 devices ⚠️
🐛 Bug Fixes
🔧 Maintenance
✨ Improvements
Updated included Android SDK from 4.8.7 to 4.8.8
Added the namespace property in build.gradle to support AGP 8 https://github.com/OneSignal/OneSignal-Flutter-SDK/pull/765
🔧 Maintenance
namespace property in build.gradle to support AGP 8 https://github.com/OneSignal/OneSignal-Flutter-SDK/pull/765Native iOS SDK Update
Bump native iOS SDK version from 3.12.4 to 3.12.7: See release notes
Native Android SDK Update
Bump native Android SDK version from 4.8.5 to 4.8.7: See release notes
Full Changelog: https://github.com/OneSignal/OneSignal-Flutter-SDK/compare/3.5.1...3.5.2
Bump native iOS SDK version from 3.12.3 to 3.12.4
Bump native iOS SDK version from 3.12.3 to 3.12.4
Bump native Android SDK version from 4.8.2 to 4.8.5
[Feature] Add iOS Live Activities support in https://github.com/OneSignal/OneSignal-Flutter-SDK/pull/621 that include 2 methods for associating and de
OneSignal.shared.enterLiveActivity("your_activity_id", "your_token").then((v) {
print("Successfully enter live activity");
}).catchError((error) {
print("Failed to enter live activity with error: $error");
});
OneSignal.shared.exitLiveActivity("your_activity_id").then((v) {
print("Successfully exit live activity");
}).catchError((error) {
print("Failed to exit live activity: $error");
});
4.8.3, the SDK stays on 4.8.2Full Changelog: https://github.com/OneSignal/OneSignal-Flutter-SDK/compare/3.4.2...3.5.0
Update to OneSignal-iOS-SDK 3.11.4
Full Changelog: https://github.com/OneSignal/OneSignal-Flutter-SDK/compare/3.4.1...3.4.2
Update to OneSignal-Android-SDK 4.8.2
[Feature] Add support for Android 13 Push Permission Prompting in https://github.com/OneSignal/OneSignal-Flutter-SDK/pull/578 The existing promptUserF
promptUserForPushNotificationPermission() method now works for both iOS and Android. In order to utilize this method in Android make sure that your compile and target SDK versions are set to API 33[Feature] Add callbacks to the setLanguage method in https://github.com/OneSignal/OneSignal-Flutter-SDK/pull/568 `dart OneSignal.shared.setLanguage("f
setLanguage method in https://github.com/OneSignal/OneSignal-Flutter-SDK/pull/568 OneSignal.shared.setLanguage("fr").then((response) { // Example of setting the language to French.
print("Successfully set language with response: $response");
}).catchError((error) {
print("Failed to set language with error: $error");
});
Full Changelog: https://github.com/OneSignal/OneSignal-Flutter-SDK/compare/3.3.1...3.3.2
Update to OneSignal-Android-SDK 4.7.3
Use ActivityAware to get the Activity context which fixes an issue where the app is sensed incorrectly as in the background by @nan-li in https://gith
ActivityAware to get the Activity context which fixes an issue where the app is sensed incorrectly as in the background by @nan-li in https://github.com/OneSignal/OneSignal-Flutter-SDK/pull/534fallbackToSettings argument on native iOS side by @slawekkrol in https://github.com/OneSignal/OneSignal-Flutter-SDK/pull/523setLaunchURLsInApp function by @nan-li in https://github.com/OneSignal/OneSignal-Flutter-SDK/pull/542Full Changelog: https://github.com/OneSignal/OneSignal-Flutter-SDK/compare/3.2.8...3.3.0
Remove dependency on jcenter by @jkasten2 in https://github.com/OneSignal/OneSignal-Flutter-SDK/pull/518
Full Changelog: https://github.com/OneSignal/OneSignal-Flutter-SDK/compare/3.2.7...3.2.8
This fix release adds back arm64 simulator and maccatalyst architectures the OneSignalXCFramework
## Native SDK Versions Update * Android Version 4.6.3 * iOS Version 3.9.0
Fix outside package target activities (Launch URL) not opening when notification is tapped on.
work-runtime version to [2.1.0, 2.7.99], 2.7.0 is required for apps with targetSdkVersion 31 (Android 12)MissingWebViewPackageException)See OneSignal-Android-SDK 4.6.2 for more details
Android plugin API updated to support v2 Embedding #486
## Native SDK Versions Update * iOS Version 3.7.0
Fixing OSDeviceState using wrong json keys for pushDisabled and subscribed #468
pushDisabled and subscribed #468Fixing OSSubscriptionObserver not firing #463
Re-expose notificationPermissionStatus #450
Added new didReceiveNotificationExtensionRequest method, deprecate old one https://github.com/OneSignal/OneSignal-iOS-SDK/pull/934
See the full list of changes along with step-by-step guides to upgrade.
See the full list of changes along with step-by-step guides to upgrade.
⚠️ This is a major beta release that contains breaking API changes. See the full list of changes along with step-by-step guides to upgrade. https://do
⚠️ This is a major beta release that contains breaking API changes. See the full list of changes along with step-by-step guides to upgrade. https://documentation.onesignal.com/docs/mobile-2020-api-migration-guide
❓ Please provide feedback and bug reports with the beta version included in the title to this repo's issue tracker. https://github.com/OneSignal/OneSignal-Flutter-SDK/issues
⚠️ This is a major beta release that contains breaking API changes. See the full list of changes along with step-by-step guides to upgrade. https://do
⚠️ This is a major beta release that contains breaking API changes. See the full list of changes along with step-by-step guides to upgrade. https://documentation.onesignal.com/docs/mobile-2020-api-migration-guide
❓ Please provide feedback and bug reports with the beta version included in the title to this repo's issue tracker. https://github.com/OneSignal/OneSignal-Flutter-SDK/issues
⚠️ This is a major beta release that contains breaking API changes. See the full list of changes along with step-by-step guides to upgrade. https://do
⚠️ This is a major beta release that contains breaking API changes. See the full list of changes along with step-by-step guides to upgrade. https://documentation.onesignal.com/docs/mobile-2020-api-migration-guide
❓ Please provide feedback and bug reports with the beta version included in the title to this repo's issue tracker. https://github.com/OneSignal/OneSignal-Flutter-SDK/issues
⚠️ This is a major beta release which contains breaking API changes. See the full list of changes along with step-by-step guides to upgrade. https://d
⚠️ This is a major beta release which contains breaking API changes. See the full list of changes along with step-by-step guides to upgrade. https://documentation.onesignal.com/docs/mobile-2020-api-migration-guide
❓ Please provide feedback and bug reports with the beta version included in the title to this repo's issue tracker. https://github.com/OneSignal/OneSignal-Flutter-SDK/issues
Updated to native OneSignal-Android-SDK 3.16.0
Failed resolution of: Lcom/google/firebase/iid/FirebaseInstanceId; error.Android Native SDK Update 3.15.7
3.15.7) and iOS (2.16.2) SDKs3.15.7
2.16.1
OneSignal supports a higher security method known as *Identity Verification*. This helps prevent users from impersonating one another by generating a
Highly Recommended
OneSignal supports a higher security method known as Identity Verification. This helps prevent users from impersonating one another by generating a user-specific token on your server, if you have one.
Enabling Identity Verification applies to:
3.15.6) and iOS (2.16.1) SDKs3.15.6
2.16.1
Android Native SDK Update 3.15.3
3.15.3) and iOS (2.15.2) SDKs3.15.3
2.15.2
Android Native SDK Update 3.15.1
3.15.1) and iOS (2.14.3) SDKs3.15.1
2.14.3
Android Native SDK Update 3.14.1
3.14.1) and iOS (2.14.2) SDKs3.14.1
2.14.2
Android Native SDK Update 3.13.2
3.13.23.13.2
Android Native SDK Update 3.13.1
3.13.1 and iOS 2.13.1 Native SDK3.13.1
2.13.1
Android Native SDK Update 3.12.7
3.12.7
Android Native SDK Update 3.12.6
3.12.6
2.12.6
## Updated Native Android (3.12.5), Updated Native iOS (2.12.5), Minor Bug Fixes * Native Android SDK Updates: - Release Notes 3.12.4 - Release Notes
## iOS SDK Native Updated * iOS SDK native updates - OneSignal-iOS-SDK 2.12.2
## iOS - Outcomes & Received Receipts * New Outcomes feature * New Received Receipts * iOS SDK native updates - OneSignal-iOS-SDK 2.12.0 - OneSignal-i
New Received Receipts (details coming soon)
Hanging awaits are now fixed for various methods for Android and iOS
presentApplicationSettings related to #129Fixed deviceToken format error with iOS 13 Beta 2+ which was preventing the device from subscribing to OneSignal.
setRequiresUserPrivacyConsent(true) is setFixed missing android.support.annotation when project is using AndroidX
android.support.annotation when project is using AndroidX
Renamed "onesignal" to "onesignal_flutter"
use_frameworks! 🎉com.onesignal.PrivacyConsent AndroidManifest.xml check when using newest init method.
pubspec.yaml file and update onesignal: ^1.1.0 to onesignal_flutter: ^2.0.0.flutter packages get.dart files.
import 'package:onesignal/onesignal.dart'import 'package:onesignal_flutter/onesignal_flutter.dart'One column per quarter.