Releases
7.0.1
- [Android]: Fixes an issue that was introduced in v6.0.0 (Fixes #528).
7.0.0
[iOS]: BREAKING CHANGE: Notifee now handles response events (PRESSED, ACTION_PRESSED, DISMISSED) for remote notifications on iOS (PR #236).
- This allows quick actions from remote notifications to be supported without the need of a NSE [Learn More]
onNotificationOpenedAppandgetInitialNotificationfromRNFB Messagingwill no longer trigger as notifee will handle the event. Should not require any code changes to theseRNFBevent handlers, as events on Android will continue to work as normal
6.0.0
- [Android] BREAKING CHANGE: Added support for requesting permission on Android 13 via
requestPermission, the minimum compileSdkVersion required has increased to 33. And, to support this feature, the targetSdkVersion must also be increased to 33.
5.7.0
- [iOS]: Adds new
interruptionLevelproperty toNotificationIOSwhich provides the option to display time-sensitive notifications (Fixes #287).
5.6.0
- [Android]: Adds new
loopSoundandflagsproperties toNotificationAndroidto support custom flags and to loop the sound when a push notification is displayed (Fixes #454).
5.5.0
- [Android]: Fixes a compile issue for monorepos where sometimes
app.notifee:core:+cannot be found (Fixes #350). - [iOS]: Adds new
listandbanneroptions toIOSForegroundPresentationOptionson iOS. These new options should be used as a replacement for thealertoption which is now deprecated in notifee; notifee will fallback to using Apple'sUNNotificationPresentationOptionAlertoption for iOS 13 when eitherbannerorlistis set to true. There are no breaking changes, but we encourage you to update your project as soon as you can if you set customIOSForegroundPresentationOptions. To learn more, view the Foreground Notifications documentation (Enhancement #382).
5.4.1
- [Android]: Fixes an issue when creating a one-time trigger notifications with AlarmManager (Fixes #445).
5.4.0
- [Android]: Fixes an issue when recreating the trigger notifications after a reboot with AlarmManager (Fixes #422).
- [Android]: Fixes an issue around displaying a heads-up notification on Xiaomi devices by adding the permission
ACCESS_NOTIFICATION_POLICYto theAndroidManifest(Fixes #296).
5.3.0
- [Android]: Elimates the need to add the local maven repository manually to your project (PR #414).
- [Android]: Implements support to light up the screen when a notification is displayed. Introduces a new property
lightUpScreenon theNotificationAndroidinterface (PR #403).
5.2.2
- [Android]: Allows
repeatFrequencyto be set to -1 when creating notifications (Fixes #384). - [Android]: Fixes an issue with rescheduling notifications with alarm manager (Fixes #384).
5.2.1
- [Android]: Fixes a build issue introduced in version 5.2.0 (PR #384).
5.2.0
- [Android]: Fixes a compiling issue for some project configurations with error message "Project with path ':app' could not be found in project ':notifee_react-native'" (Fixes #288).
- [Android]: Fixes an issue where the current version of Notifee does not build when using an expo managed app with the expo plugin (Fixes #314).
- [Web]: Basic support for react-native-web - notifications do not work on web yet, but the package is now compatible with web (PR #369)
5.1.0
- [Android]: Introduces new APIs to help manage Android 12 limitations when creating trigger notifications:
canScheduleExactAlarmsopenAlarmPermissionSettings
And, the ability to check if your app has permissions to create trigger notifications by calling getNotificationSettings().
To learn more, see Triggers documentation for Android.
5.0.3
- [Android]: Fixes an issue when canceling trigger notifications created via AlarmManager to prevent "Maximum limit of concurrent alarms 500 reached for uid" error being thrown (Fixes #349).
5.0.2
- [iOS]: Fixes an issue with
NotificationSettingsreturning the wrong property name forauthorizationStatuson iOS (Fixes #333).
5.0.1
- [Android]: Fixes an issue where quick actions always opens the app on Android 12 (Fixes #315).
- [Android]: Fixes an issue where a quick action with an id of
defaultfailed to open the app.
5.0.0
- [Android/iOS] BREAKING CHANGE: Added support for checking permissions on Android which introduces a breaking change to
requestPermissionandgetNotificationSettingsAPIs.
Both APIs have been updated to return an object of type NotificationSettings, in replace of NotificationSettingsIOS.
NotificationSettings consists of two properties authorizationStatus and ios, where ios is a nested object of type NotificationSettingsIOS.
To learn more, see Permissions documentation for iOS, and Android.
4.1.0
- [Android]: Add support to set
largeIconforAndroidStyle.BIGPICTUREto null (Fixes #270) - [Android]: Fixes an issue with Android 12 when tapping on a notification (Fixes #250)
- [Android]: Fixes an issue when an action is pressed where the notification drawer would remain open with the notification (Fixes #268)
4.0.1
- [Android]: Fixes an issue with repeating trigger notifications where the next notification was scheduled at the incorrect time, causing the notification to infinitely display (Fixes #252).
4.0.0
- [Android]: BREAKING CHANGE : the minimum compileSdkVersion required has increased to 31, to fix an issue with Android 12 where the app will crash due to a missing Intent immutability flag (Fixes #238). You do not need to alter targetSdkVersion or anything else - but you must increase compileSdkVersion to 31. Please note, JDK11 is strongly recommended when using compile or target sdk 31. Please note, we do not correctly handle the new "exact alarm" Android 12 restrictions so we recommend staying on targetSdkVersion 30 for now.
3.0.4
- [Android]: Fixes an issue with buildtools to support gradle plugin 4.2+ (Fixes #211)
- [iOS]: Fixes an issue that was introduced in the previous patch when calling
setBadgeCountwith 0 (Fixes #212)
3.0.3
- [iOS]: Fix iOS API availability guards, and all compile warnings (Fixes #204)
3.0.2
- [Android]: Include support for expo managed projects [Learn More]]
- [Android]: Adds support for Android 12
3.0.1
- [Android]: Fixes an issue where the wrong quick action was triggered when fired in quick succession (Fixes #121)
- [Android]: Fixes an issue where notifications created by FCM were not being removed from the notification tray when cancelled (Fixes #120)
- [iOS]: Compiled module no longer depends on a XCFramework, as part of the migration to fully open source the library. [Learn More]
3.0.0
- [Android]: BREAKING CHANGE - the minimum SDK version has been updated from 16 to 20, providing backwards notification compatibility up to Android 4.4W.
- [Android]: Fixes an issue with
getDisplayedNotificationswhere the id returned is not the original notification id. (Fixes #381) - [Android]: Fixes an issue with displaying a notification with
android.tag(Fixes #382) - [Android]: Introduces support to cancel a notification with a
tag - Removed licensing validation and related code - Notifee is now free and fully open source. [Learn More]
2.0.0
- [Android]: BREAKING CHANGE - you must add a new maven local repository to your
android/build.gradlefile. (Fixes #151). See step #2 in the installation guide
1.11.0
- [Android]: Fixes an issue where
getInitialNotificationwas sometimes throwing an error leading to a crash if activity was null. (Fixes #374)
1.11.0
- [Android]: Fixes an issue where the initial notification wasn't being populated for full-screen actions.
- [iOS]: Introduces a new method signature for
NotifeeExtensionHelper.populateNotificationContentwhere therequestis passed down as well as thebestAttemptContent. View the Remote Notification Support documentation for more information. - [iOS]: Adds a note in the reference documentation that
getInitialNotification()for iOS is deprecated in favour ofonForegroundEvent.
1.10.1
- [Android]: Fixes an issue on Android to prevent
cancelDisplayedNotificationscancelling trigger notifications. (Fixes #349)
1.10.0
- [Android/iOS]: Introduces the following APIs:
getDisplayedNotificationsgetTriggerNotificationsisChannelBlockedisChannelCreatedcancelAllNotifications(ids)cancelDisplayedNotifications(ids)cancelTriggerNotifications(ids)
- BREAKING: Fixes an issue when setting a custom sound on a notification channel (Fixes #341). Sounds now must be specified without the file extension, previously it was optional. If you were using custom sounds on Android>7 prior to this, you will need to create a new notification channel or the reference to your custom sound on the channel will likely not survive app updates. We apologize for the inconvenience
1.9.2
- [Android]: Fixes an issue where an error is thrown when the intent was null in rare cases for foreground service events.
1.9.1
- [Android]: Fixes an issue where an error is thrown when using trigger notifications with AlarmManager on Android 8 & 7
1.9.0
- [Android]: Support Alarm Manager for trigger notifications.
- [iOS]: Xcode 12.4 and above is now supported
1.8.1
- [Android/iOS]: Fix npm bundle to exclude example app
1.8.0
- [Android/iOS]: Include support for jest tests by including a
jest-mock.jsfile. - [Android]: Add an extra safety check to prevent app from crashing if a
launchActivityproperty is set to an invalid activity class.
1.7.0
- [Android/iOS]: Allows title, body, and subtitle to be set to undefined in addition to string values to prevent an empty space on Android.
- [Android/iOS]: Updated validation to only throw an error for platform-specific properties if the app is running the same platform (Feature enhancement #297).
- [iOS]: Xcode 12.5 is required on iOS.
1.6.0
- [Android]: Fixed an issue with jwt gradle build dependency.
1.5.0
- [Android]: Implemented support for
notifee.hideNotificationDrawer(Feature enhancement #200).
1.4.0
- [Android]: Added support for
fullScreenActiononNotificationAndroid(Feature enhancement #45).
1.3.1
- [Android]: Fixed an issue where sometimes the app would throw an exception when the user changes the notification blocked state for either a channel or the entire application (Fixes #237).
1.3.0
- [Android]: Fixed an issue where sometimes the foreground service failed to stop when calling
resolvedue to an issue with hot reloading. It can be stopped bynotifee.stopForegroundService(). To learn more, view the Foreground Service documentation.
1.2.1
- [Android]: Fixed an issue with Notifee's build script where sometimes an error would occur that the target variant task already existed.
1.2.0
- [iOS]: Includes a Notification Service Extension Helper to take advantage of Notifee with remote notifications. To learn more, view the Remote Notification Support documentation.
1.1.2
- [iOS]: Enforce v1.10+ of CocoaPods (Fixes #230).
1.1.1
- [Android]: Includes a solution to fix an error due to a potential race condition that occurs when the user changes the notification blocked state for either a channel or the entire application (Fixes #237).
1.1.0
- [Android]: Implemented support for
circularLargeIcononNotificationAndroid(Feature enhancement #199). - [iOS]: Prevent badge count from clearing notifications from the tray when it reaches 0 (Fixes #214).
1.0.0
- NOTE: Version bump.
0.16.0
- [Android]: Fixed an issue with license validation on Android 6 (Fixes #87)
- [iOS]: Added support for Apple Silicon (arm64) and Mac Catalyst builds (Fixes #162, #215)
0.15.2
- [Android]: Added additional logs to help with debugging license validation issues.
- [Android/iOS]: Fixed an issue where sometimes the
NotifeeApiModulewould fail to resolvethis.nativedue to the context changing.
0.15.1
- [Android]: Fixed an issue where sometimes the
largeIconwouldn't show when the app is closed. - [Android/iOS]: Fixed an issue to show a more descriptive warning if the background event handler isn't set via
onBackgroundEvent.
0.15.0
- [Android]: Implemented additional support to help with background restrictions on Android, includes two new methods
getPowerManagerInfoandopenPowerManagerSettings. - [Android]: Fixed an issue with subtitle where the default value was causing two dots on some devices.
- [Android/iOS]: Added support to cancel either a displayed or a trigger notification.
0.14.0
- [Android]: Fixed an issue where
isBatteryOptimizationEnabledwas returning the result as an object instead of a boolean. - [Android]: Fixed an issue where
openBatteryOptimizationSettingswas sometimes throwing an exception for Samsung and Oppo phones on Android versions 6.0. - [iOS]: Fixed an issue when a notification is pressed while the app is in the background on iOS 14, which sometimes would cause the app to crash.
0.13.2
- [Android]: Fixed an issue where trigger notifications created with v0.12.x and below would cause the app to crash when upgrading to v0.13.x.
0.13.1
- [iOS]: Added support to handle remote urls for Attachments.
- [iOS]: Added iOS support for
repeatFrequencyonTimestampTrigger. See Triggers.
0.13.0
- [Android]: Added support for
repeatFrequencyonTimestampTriggerto be able to create hourly, daily or weekly trigger notifications. See Triggers. - [Android]: Implemented support to help with background restrictions on Android, includes two methods
isBatteryOptimizationEnabledandopenBatteryOptimizationSettings. See Background Restrictions. - [Android]: Fixed an issue when creating a trigger notification, where sometimes the input data would reach the maximum number of bytes allowed.
0.12.3
- [Android]: Fixed an issue where
pressActionwith thedefaultid failed to open the app when the notification was pressed. - [Android]: Fixed an issue with gradle plugin 4.1 and
Build.VERSION_NAMEwhich prevented the app from building.
0.12.2
- [iOS]: Fixed an issue where the
DELIVEREDforeground event wasn't being sent for trigger notifications. - [iOS]: Fixed an issue with the iOS module that sent events before the JS bundle was ready.
0.12.1
- [iOS]: Fixed an issue with the iOS module that prevented the library from compiling.
0.12.0
- [Android]:
lightColorandsoundare now returned when callinggetChannelorgetChannels. - BREAKING:
TimeTriggerhas been removed, in favour ofTimestampTriggerandIntervalTrigger. - [iOS]: Trigger Notifications are now supported on
iOS. See Triggers.
0.11.1
- [Android]: Fixed an issue with
cancelNotificationfor trigger notifications. - [Android]: Fixed an issue with remote verification on devices <= 20
- [iOS]: Call original delegate when intercepting notification response on iOS
0.11.0
- [Android]: Add support for Trigger Notifications on Android. See Triggers.
- [Android]: Fixed an issue with
getChannelsandgetChannelGroupswhere the methods were throwing an error - [iOS]: Fixed an issue with iOS 14 where sometimes the app would freeze briefly when receiving an push notification
0.10.0
- [Android]: Fixed an issue with sounds for Android versions < 8.0 (API level 26)
- [Android]: Fixed an issue with
notifee.config.jsonwhere sometimes the script could not find the 'app' gradle project automatically.
0.9.0
- [iOS]: Add support for iOS
onBackgroundEvent. - [iOS]: Pool JS events until RN Bridge is ready.
- [Android]: Allow multiple
onBackgroundEventobservers when inside a foreground service task.
0.8.0
- [iOS]: Add support for iOS notification attachments. See iOS Attachments.
0.7.2
- [iOS]: Fixed an issue where notifications would sometimes not appear in the foreground.
0.7.1
- [Android]: Fixed an issue where the Headless task key was incorrect for the foreground service task.update
0.7.0
- [Android]: Implemented support for
launchActivityFlags- allowing you to customise the launch behaviour of your activities.- See
AndroidLaunchActivityFlagfor supported flags.
- See
0.6.1
- [Android]: Fixed an issue with Android proguard rules that may have prevented the library from being used when minified.
0.6.0
- [Android]:
notifee.config.jsonnow supports specifying options for build flavours & types.- See this comment comment for an example.
- [TypeScript]: Reworked type definitions to fix minor definition issues.
- BREAKING:
Importancehas now been renamed toAndroidImportanceand is no longer supported oniOS(replaced withforegroundPresentationOptions). - [iOS]: Implemented support for
ios.foregroundPresentationOptionsto control foreground notification behaviour on iOS- See the iOS appearance guide for more information.
- [Android]: Fixed an issue where creating multiple
channelorchannelGroupswould fail to create. - [Android]:
requestPermissionnow correctly resolves a dummy instance ofIOSNotificationSettings(previouslynullon Android) for cross-platform compatibility. - [Android]:
largeIcon&picture(from big picture style) now supports React Native asset loading, e.g.largeIcon: require('./image.png').
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 3.0 License and code samples are licensed under the Apache 2.0 License.
All product names, logos, and brands are property of their respective owners. All company, product and service names used in this website are for identification purposes only. Use of these names, logos, and brands does not imply endorsement.