flutter_local_notifications 14.1.5 flutter_local_notifications: ^14.1.5 copied to clipboard
A cross platform plugin for displaying and scheduling local notifications for Flutter applications with the ability to customise for each platform.
[14.1.5] #
- [Android] fixed issue 2136 where notifications on scheduled using older versions of the plugin (likely before the
androidAllowWhileIdle
flag was added) could fail to work. This issue started occuring in 14.0 where support for inexact notifications was added using theScheduleMode
enum that was added and resulted in the deprecation ofandroidAllowWhileIdle
. A mechanism was added to help "migrate" old notifications that wouldn't have this flag so that it results in a notification scheduled with exact timing as per the old behaviour. Thanks to the PR from Ruchi Purohit
[14.1.4] #
- [Android] fixed issue 2106 where calling
getNotificationChannels()
reports the wrong importance level or result in an exception if the importance level was unspecified. This hotfix has been taken from the 16.0.0-dev.3 prerelease
[14.1.3+1] #
- Removed duplicate changelog entry on example app being updated
[14.1.3] #
- [Android] fixed issue an issue similar to 2033 that was addressed in 15.0.1 where notifications on scheduled using older version of the plugin via the
periodicallyShow()
method would fail to have the next subsequent ones scheduled. This issue started occuring in 14.0 where support for inexact notifications was added using theScheduleMode
enum that was added and resulted in the deprecation ofandroidAllowWhileIdle
. A mechanism was added to help "migrate" old notifications that hadandroidAllowWhileIdle
specified but didn't account for how there are recurring notifications that were scheduled using older versions of the plugin prior toandroidAllowWhile
being added. This hotfix has been taken from the 16.0.0-dev.2 prerelease - Updated example app so that the Android side specifies minimum SDK version version that aligns with what's specified by the Flutter SDK. This has been taken from the 16.0.0-dev.2 prerelease to allow the example app to build using recent versions where the minimum Android SDK version has changed from 16 to 19
[14.1.2] #
- [Android] Fixed issue 2033 where notifications on scheduled using older version of the plugin would fail to have the next subsequent ones scheduled. This issue started occuring in 14.0 where support for inexact notifications was added using the
ScheduleMode
enum that was added and resulted in the deprecation ofandroidAllowWhileIdle
. A mechanism was added to help "migrate" old notifications that hadandroidAllowWhileIdle
specified but didn't account for how there are recurring notifications that were scheduled using older versions of the plugin prior toandroidAllowWhile
being added
[14.1.1] #
- Fixed typo in API docs for the deprecated
showDailyAtTime()
method. Thanks to the PR from Yuichiro Kawano - [Android] removed a call to standard output via
System.out.println()
[14.1.0] #
- [Android] added
alarmClock
as one of theAndroidScheduleMode
options. This is useful for cases where a notification functions as an alarm and may show an alarm icon on the status bar depending on the device Thanks to the PR from Muhammed Ballan
[14.0.1] #
- [Android] fixed issue 1991 where tapping on a notification action with
showUserInterface
set to true whilst app is terminated wouldn't dismiss/cancel notification - [Android] updated logic when trying to show a scheduled notification so that receiver would remove a corrupt notification to avoid exceptions from occurring over and over again. An message will be written to error log when this occurs as well. Thanks to the PR from []
- Fixed example app on iOS and macOS so it would play the custom sound as this step was missed in previous released where the iOS and macOS side was recreated
[14.0.0+2] #
- Bumped maximum Dart SDK constraint
- Recreated iOS and macOS side of the example app so they would build and run with Flutter 3.10 having landed on stable channel
[14.0.0+1] #
- Updated cavaet on scheduling Android notifications where a link to https://dontkillmyapp.com has been added as it contains instructions on how to configure various devices to bypass the battery optimisations that prevent background processes from working e.g. scheduled notifications
- Added missing note to the 14.0.0 release notes on a breaking change the
AndroidFlutterLocalNotificationsPlugin
APIs around scheduling notifications where theallowWhileIdle
has been removed and replaced by ascheduleMode
parameter that allows for scheduling inexact notifications - Updated docs to explain that if a notification was scheduled on Android with exact timing via the
AndroidScheduleMode
enum but the exact alarm permissions had been revoked, an error log message will be written and notification will no longer be scheduled. This means recurring notifications would no longer be scheduled as well given the permission had been revoked
[14.0.0] #
- Breaking change the
id
property of theActiveNotification
class is now nullable to help indicate that the notification may not have been created by the plugin e.g. it was from Firebase Cloud Messaging. Thanks to the PR from frankvollebregt - Breaking change the following classes are now enums
AndroidNotificationCategory
AndroidServiceForegroundType
AndroidServiceStartType
AudioAttributesUsage
Day
InterruptionLevel
LinuxNotificationCategory
LinuxNotificationUrgency
Priority
- [Android] added support for scheduling inexact notifications. The corresponding APIs for scheduling notifications now have a new
AndroidScheduleMode
to allow for configuring this if required. TheandroidAllowWhileIdle
argument is now deprecated when using the APIs available for scheduling notifications via theFlutterLocalNotificationsPlugin
APIs and will be removed in the future. Thanks to the PR from Joachim Böhmer. Note that if if a notification was scheduled with exact timing via theAndroidScheduleMode
but the exact alarm permissions had been revoked, an error log message will be written and notification will no longer be scheduled. Do note that theandroidScheduleMode
parameter has a default value ofAndroidScheduleMode.exact
to align with what was the default value ofandroidAllowWhileIdle
before (i.e.false
) where that meant exact timing was to be used but the device being a low-powered idle may cause it to be delayed. When theandroidAllowWhileIdle
parameter is removed in the future,androidScheduleMode
will become a required named parameter to ensure developers explicitly specify the value they want- [Android] Breaking change related to this is whilst
androidAllowWhileIdle
is deprecated via theFlutterLocalNotificationsPlugin
APIs,allowWhileIdle
has been removed and completely replaced by ascheduleMode
parameter when whe directly using theAndroidFlutterLocalNotificationsPlugin
APIs
- [Android] Breaking change related to this is whilst
- [Android] adds a namespace for compatibility with AGP (Android Gradle plugin) 8.0. Thanks to the PR from asaarnak
- [iOS][macOS] fixed issue 1950 where plugin would crash when calling
zonedSchedule()
with a date/time value that is exactly when daylight savings occurs and the APIs from Apple weren't able to resolve what the actual date/time is meant to be - [Android] updated
AndroidServiceForegroundType
values to align with new additions that are part of Android 14. Thanks to the PR from Rexios - [macOS] fixed issue 1858 where macOS app builds were showing deprecation warnings. Thanks to the PR from Steve Kohls
- Bumped
mockito
dev dependency - Align Dart SDK constraint with minimum Flutter version (i.e. 3.0)
- Fixed readme that was reference old classes with
IOS
as part of the name instead of the newer classes that have theDarwin
prefix - Removed dead link that had archived official documentation around guidance on creating the appropriate Android icons that would help with creating notification icons. Now replaced with a link to using Image Asset Studio to create notification icons
[13.0.0] #
- [Android] Bumped Android Gradle plugin to 7.3.1. Thanks to the PR from Rexios
-
- Updated minimum Flutter version to 3.0.0. Note that technically this was already a requirement by
flutter_local_notifications_linux
2.0.0 asffi
2.0.0 requires Dart 2.17 at a minimum and that shipped with Flutter 3.0.0
- Updated minimum Flutter version to 3.0.0. Note that technically this was already a requirement by
- Added explicit
ffi
dependency that Linux implementation of the plugin was already using - Updated site used by example app to display dummy/placeholder images
- Updated readme to warn developers that choose not to follow the official Android guidance around notification icons that using the
@mipmap/ic_launcher
resource requires additional release build configuration. Thanks to the PR from Daniel Arndt - Updated readme to add note about how Flutter has an issue with apps running with desugaring on Android 12L and above. Thanks to the PR from Mirek Mazel See https://github.com/flutter/flutter/issues/110658. One potential fix added to the readme is for apps to add the WindowManager library as a dependency:
dependencies {
implementation 'androidx.window:window:1.0.0'
implementation 'androidx.window:window-java:1.0.0'
...
}
[12.0.4] #
- Fixed issue 1796 where a
java.lang.ClassCastException
may be thrown on some Android devices when theonDidReceiveBackgroundNotificationResponse
has been specified when callinginitialize()
[12.0.3+1] #
- Updated Kotlin version used in example app
- Updated code snippets in readme to add missing import statements around the iOS setup related to notification actions. Thanks to PR from som-R91
[12.0.3] #
[12.0.2] #
- [Android] changed callback lookup for notification actions to take place after Flutter engine to ensure callback cache has been initialised to find the callback. This is a follow-up to changes done in 12.0.1 in trying to address issue 1721
- [Android] updated plugin to clean up resources after it is detached from Flutter engine. Thanks to PR from Simon Ser
[12.0.1+1] #
- Updated readme to indicate that the
timezone
package should be added as a direct dependency according to this official lint rule - Bumped dependency constraints on
flutter_local_notification_linux
that was meant to be done in 12.0.0
[12.0.1] #
- [Android][iOS] fixed issue 1721 where a crash occurs upon tapping on a notification action fbut the
onDidReceiveBackgroundNotificationResponse
optional callback hasn't been specified. - [iOS] suppressed deprecation warnings where plugin was Apple's old notification APIs to support older iOS devices
[12.0.0] #
- Bumped
dbus
dependency viaflutter_local_notifications_linux
[11.0.1] #
- [Android] fixed crash when using notification actions with a foreground service. Thanks to the PR from Arnold Laishram
- [Android] Suppressed deprecation warning on calling the
getParcelableExtra
Intent API - Fixed typo in readme around Darwin (iOS/macOS) initialisation settings
- Added a link to an issue with using Flutter apps with desugaring enabled where crashes could occur on foldable Android devices. Link to this is https://github.com/flutter/flutter/issues/110658 so those experience the problem can follow the issue and try out the solutions there as this isn't specific to the plugin
- Replaced usage of rxDart in example app use
StreamController
instead to minimise use of dependencies and removed unusedshared_preferences
dependency
[11.0.0] #
- Bumped
timezone
dependency. To err on the safe when it comes to dependency version conflicts, this is being published as major release as the updatedtimezone
package was published as a major release. Thanks to the PR from Joachim Nohl
[10.0.0] #
- Breaking change [Android]
zonedSchedule()
's implementation has switched to using desugaring instead of the ThreeTen Android Backport library. This required the plugin to update to using Android Gradle plugin 4.2.2 and applications may need to bump their Android Gradle plugin dependency to at least 4.2.2 as a result. Added a "Gradle setup" section underneath "Android setup" with details on the extra setup needed - [Android] Breaking change the following error codes included in
PlatformException
s that can occur on Android have been updatedINVALID_ICON
->invalid_icon
INVALID_LARGE_ICON
->invalid_large_icon
INVALID_BIG_PICTURE
->invalid_big_picture
INVALID_SOUND
->invalid_sound
INVALID_LED_DETAILS
->invalid_led_details
GET_ACTIVE_NOTIFICATIONS_ERROR_CODE
->unsupported_os_version
GET_NOTIFICATION_CHANNELS_ERROR_CODE
->getNotificationChannelsError
GET_ACTIVE_NOTIFICATION_MESSAGING_STYLE_ERROR_CODE
->getActiveNotificationMessagingStyle
PERMISSION_REQUEST_IN_PROGRESS
->permissionRequestInProgress
- [Android] Breaking change the
category
of theAndroidNotificationDetails
now requires an instance of the newly addedAndroidNotificationCategory
class instead of a string. This was to improve the discoverability of the APIs and improve the semantics as the category can specified in a similar fashion to using an enum value - Breaking change callbacks have now been reworked. There are now the following callbacks and both will pass an instance of the
NotificationResponse
classonDidReceiveNotificationResponse
: invoked only when the app is running. This works for when a user has selected a notification or notification action. This replaces theonSelectNotification
callback that existed before. For notification actions, the action needs to be configured to indicate the the app or user interface should be shown on invoking the action for this callback to be invoked i.e. by specifying theDarwinNotificationActionOption.foreground
option on iOS and theshowsUserInterface
property on Android. On macOS and Linux, as there's no support for background isolates it will always invoke this callbackonDidReceiveBackgroundNotificationResponse
: invoked on a background isolate for when a user has selected a notification action. This replaces theonSelectNotificationAction
callback
- Breaking change the
NotificationAppLaunchDetails
has been updated to contain an instanceNotificationResponse
class with thepayload
belonging to theNotificationResponse
class. This is to allow knowing more details about what caused the app to launch e.g. if a notification action was used to do so - [iOS][macOS] Breaking changes iOS and macOS classes have been renamed and refactored as they are based on the same operating system and share the same notification APIs. Rather than having a prefix of either
IOS
orMacOS
, these are now replaced by classes with aDarwin
prefix. For example,IOSInitializationSettings
can be replaced withDarwinInitializationSettings
- [macOS] Breaking change the
requestPermissions()
method of theMacOSFlutterLocalNotificationsPlugin
class now only accepts non-nullable parameters that default tofalse
. This makes it consistent with the iOS implementation of the plugin - Added support for notification actions. Massive thanks to Sebastian Roth, Pieter van Loon and Yaroslav Pronin for their work on this. Note that on Apple's platforms, notification actions are only supported on iOS 10 or newer and macOS 10.14 or newer
- [Linux] Breaking change the linux notification categories defined by
LinuxNotificationCategory
no longer has factory constructors but has static constant fields instead to make the semantics more similar to access enum values - [Android] Updated how scheduled notifications are saved to shared preferences so it is done in the background. This is to fix issue 1378 where
pendingNotificationRequests
method may not report the correct number of scheduled notifications if it is invoked before the data had been saved to shared preferences - [Android] fixed issue 1702 by handling deprecation warnings using specific Android Intent APIs on Android 13 (API level 33) or newer
- [iOS]
getActiveNotifications()
is now supported for iOS versions 10.0 or newer - [macOS]
getActiveNotifications()
is now supported for macOS versions 10.14 or newer - [iOS][macOS] thanks to the PR from maprohu, the following features are now available
- the ability to request permissions to show critical notifications
- the ability to specify the interruption level of a notification. This is only applicable to iOS 15.0 and macOS 12.0 or newer.
- Updated minimum Flutter version to 2.8 as that aligns with the minimum Dart SDK version of 2.1.5 required by one of
flutter_local_notifications_linux
's dependencies (dbus
) - Example app has been updated so that each notification has its own notification ID. Previously, they were all given a notification ID of
0
- Updated Android setup docs to mention setting up
compileSdkVersion
[9.9.1] #
- [Android] plugin has been updated to minimise clashing with other plugins that handle permission requests. Thanks to the PR from Tiernan
[9.9.0] #
- [Android] added the ability to specify audio attributes of a notification channel via the
audioAttributesUsage
property belonging to theAndroidNotificationChannel
andAndroidNotificationDetails
classes. Thanks to the PR from Jonas Bornold
[9.8.0+1] #
- Added more details to 9.8.0 changelog entry to mention that apps will need to change
compileSdkVersion
to 33 and also updated readme to mention this
[9.8.0] #
- [Android] added
requestPermission
method to theAndroidFlutterLocalNotificationsPlugin
class. This make use of the new feature added to Android 13 where an app can request permissions to show notifications. As the plugin's APIs don't have breaking changes, this is released a minor release. It does however, require the Android 13 SDK to be install installed and for apps to change thecompileSdkVersion
in their app'sbuild.gradle
to 33 as the plugin'scompileSdkVersion
is now 33. Only apps targeting Android 13 can request the permission as well. The latter can be done by updating thetargetSdkVersion
in an app'sbuild.gradle
file to33
. Thanks to the PR from Bartek Pacia. Note: the ability to request the permission as part of callinginitialize
will be added later on
[9.7.1] #
- [Android] updated how launch intent is read on Android for the
getNotificationAppLaunchDetails
method
[9.7.0] #
- [Android] added support to specify notification count via the
number
property that has been added to theAndroidNotificationDetails
class. Thanks to the PR from Katsuya Kato - Updated readme so that link to icon design guidance points to the archived version as the original link is now returning 404 not found. Thanks to the PR from Zaldy Pagaduan Jr.
[9.6.1] #
- [macOS] fixed issue 1623 where calling
zonedSchedule
withmatchDateTimeComponents
set todayOfMonthAndTime
ordateAndTime
led to an error
[9.6.0] #
- [Linux] Bumped dependency on
flutter_local_notifications_linux
to^0.5.0+1
where support for icons to be specified via a file path was added by Yaroslav Pronin
[9.5.3+1] #
- Updated example app with to use updated Proguard rules for GSON
- Update readme about GSON's Proguard rules to recommend referring to the rules on GSON's repository
- Move note in readme about how
onSelectNotification
won't be called when an app is launched by a notification so it's more visible
[9.5.3] #
- [Android] bumped gson dependency to 2.8.9 that fixes CVE-2022-25647
[9.5.2] #
- [macOS] fixed issue 1585 where plugin causes a crash when a remote/push notification (e.g. via FCM) occurs
[9.5.1] #
- [Android] fixed issue when calling
getActiveNotificationMessagingStyle()
to get messaging style information for a notification with a tag. Thanks to PR from Simon Ser
[9.5.0] #
- [Android] added
getActiveNotificationMessagingStyle()
method to theAndroidFlutterLocalNotificationsPlugin
class. This allows for getting the messaging style information of an active notification e.g. to append a message to an existing notification. Thanks to the PR from Simon Ser - Updated readme to fix an issue where clicking on the Android setup and iOS setup sections from table of contents wouldn't go the appropriate section. Thanks to the PR from HendrikF
[9.4.1] #
- Calling
initialize()
on a platform with passing the appropriate initialisation settings for it will now throw anArgumentError
. Whilst this may be technically a breaking change, it's been done as a minor change as the call was already throwing an unhandled exception in these scenarios. This change is to help provide more information on why it fails. Documentation has also been updated to provide more on information on this as the intialisation settings for each platform are nullable so developers aren't forced to provide settings for platforms they don't target. Thanks to the PR from Zlati Pehlivanov - Updated docs to fix typos, adjust heading levels and use the term "daylight saving time" instead of "daylight savings". Thanks to the PR from Ross Llewallyn
[9.4.0] #
- [Android] Added
tag
toActiveNotification
that would allow for finding the notification's tag. Thanks to the PR from Simon Ser
[9.3.3] #
- [macOS] Fixed issue 1507 where calling the
requestPermissions()
method of theMacOSFlutterLocalNotificationsPlugin
class led to a crash. This will be coalesced to assume that theboolean
parameters around the requested permissions default tofalse
to be consistent with the iOS implementation. Note that in 10.0.0 the method will have a breaking change so that these parameters are non-nullable
[9.3.2] #
- Fix issue 1485 where the addition of
colorized
property caused backwards compatibility issues with previously scheduled notifications as this would be null when deserialised from shared preferences
[9.3.0] #
- [Android] Updated how scheduled notifications are saved to shared preferences so it is done in the background. This is to fix issue 1378 where
pendingNotificationRequests
method may not report the correct number of scheduled notifications if it is invoked before the data had been saved to shared preferences - [Android] Added
colorized
property toAndroidNotificationDetails
class. This can be used to apply a background colour to the notification but for most styles, this only works if a foreground service was used. Example app has been updated to demonstrate its usage. Thanks to the PR from benechiu
[9.2.0] #
- [Android] Added
areNotificationsEnabled()
method toAndroidFlutterLocalNotificationsPlugin
. This allows querying if notifications are enabled for the app calling the method. Thanks to the PR from Konstantin Pelz - [Linux] Fix
initialize()
returning null all the time instead of returning an appropriate boolean value to indicate if plugin has been initialised
[9.1.5] #
- Bumped
flutter_local_notifications_linux
dependency
[9.1.4] #
- [Android] Reverted change in 9.1.0 that added the
groupKey
toActiveNotification
as this was a potentially breaking change. This will instead be part of a major release
[9.1.3] #
- [Android] Reverts Android changes done in 9.1.2 and 9.1.1 due to reported stability issues. Ths means issue 1378 may still occur though is a rare occurrence and may require a different solution and assistance from the community with regards to testing
[9.1.2+1] #
- BAD [Android] some minor code clean up from 9.1.2 changes
- Fixed a grammar issue in readme. Thanks to the PR from Clément Besnier
[9.1.2] #
- [Android] Fix NPE issue 1378 from change introduced in 9.1.1 in updating how notifications were written to shared preferences
[9.1.1] #
- BAD [Android] updated APIs the plugin uses to write to shared preferences in the background
- [Android] fix where there was a the
Future
for scheduling a notification could be completed prior to saving information on the scheduled notification to shared preferences. In this case the notification would still be scheduled but if the plugin was used to query the pending notifications quick enough, the plugin may have returned the incorrect number of pending notifications
[9.1.0] #
[9.0.3] #
- [Android] Fixed issue 1362 so that the plugin refer to Android sound resources by the resource name instead of the resource id as the resource id could change over time e.g. if new resources are added. Note that this is a fix that can't be applied retroactively
[9.0.2] #
- [Android] Fixed issue 1357 where some details of a notification with formatted content weren't being returned
- Bumped dependencies used by example app
- Fixed grammar issue in readme in the
Scheduled Android notifications
section. Thanks to Yousef Akiba for the PR - Updated example app and readme code around importing the
timezone
dependency so it uses theall
variant of the IANA database that contains all timezones including those that are deprecated or may link to other timezones
[9.0.1] #
- Fixed issue 1346 where an exception is thrown when
onSelectNotification
callback isn't specified
[9.0.0] #
- Breaking change the
SelectNotificationCallback
andDidReceiveLocalNotificationCallback
typedefs now map to functions that returnsvoid
instead of aFuture<dynamic>
. This change was done to better communicate the plugin doesn't actually await any asynchronous computation and is similar to how button pressed callbacks work for Flutter where they are typically useVoidCallback
- Updated example app to show how to display notification where a byte array is used to specify the icon on Linux
- Breaking change the
value
property of theImportance
class is now non-nullable - Breaking change the
FlutterLocalNotificationsPlugin.private()
constructor that was visible for testing purposes has been removed. The plugin now uses thedefaultTargetPlatform
property from the Flutter framework to determine the platform an application running on. This removes the need for depending on theplatform
package. To write tests that require a platform-specific implementation of the plugin, the debugDefaultTargetPlatformOverride property can be used to do so - Breaking change fixed issue 1306 where an Android notification channel description should have been optional. This means the
description
property of theAndroidNotificationChannel
class and thechannelDescription
property of theAndroidNotificationDetails
class are now named parameters - Breaking change the
AndroidIcon
class is now a generic class i.e.AndroidIcon<T>
and it'sicon
property has been renamed todata
. With this change, the type of theicon
property that belongs to thePerson
class has changed fromAndroidIcon?
toAndroidIcon<Object>?
- [Android] Added the
ByteArrayAndroidIcon
class that implements theAndroidIcon<T>
class. This allows using a byte array to use as the icon for a person in a message style notification. AByteArrayAndroidIcon.fromBase64String()
named constructor is also available that will enable this using a base-64 encoded string. Thanks to the PR from Alexander Petermann - [Android] Android 12 support
- Restored Linux support
- Fixed grammatical errors in readme. Thanks to PR from Aneesh Rao
- Plugin now uses the
clock
package for internal logic that relies on geting the current time, such as validating that the date for a scheduled notification is set in the future
[8.2.0] #
- Added
dayOfMonthAndTime
anddateAndTime
values to theDateTimeComponents
enum. These allow for creating monthly and yearly notifications respectively. Thanks to the PR from Denis Shakinov
[8.1.1+1] #
- Updated API docs for the
initialize()
to mention that thegetNotificationAppLaunchDetails()
method should be used to handle when a notification launches an application
[8.1.1] #
[8.1.0] #
- [Android] added the
startForegroundService()
andstopForegroundService()
methods to theAndroidFlutterLocalNotificationsPlugin
class. This can be used to start and stop a foreground service that shows a foreground service respectively. Refer to the API docs for more details on how to use this. The example app has been updated to demonstrate their usage. Thanks to the PR from EPNW
[8.0.0] #
- Breaking change the
AndroidBitmap
class is now a generic class i.e.AndroidBitmap<T>
. This has resulted in the following changes - the type of the
largeIcon
property that belongs to theAndroidNotificationDetails
class has changed fromAndroidBitmap
toAndroidBitmap<Object>
- the type of the
largeIcon
andbigPicture
properties that belongs to theBigPictureStyleInformation
class has changed fromAndroidBitmap
toAndroidBitmap<Object>
- [Android] Added the
ByteArrayAndroidBitmap
class that implements theAndroidBitmap<T>
class. This allows using a byte array to use as the large icon for a notification or as big picture if the big picture style has been applied. AByteArrayAndroidBitmap.fromBase64String()
named constructor is also available that will enable this using a base-64 encoded string. Thanks to the PR from Alexander Petermann
[7.0.0] #
- Breaking change Removed support for Linux. This is because adding Linux made use of a plugin that was causing apps targeting the web to fail to build
- Note: as this is more an urgent release to resolve the aforementioned issue that results in a breaking change, please note this release does not include the Android 12 support changes that were in the prereleases. This is to err on the side of caution as Android 12 hasn't reached platform stability yet
[6.1.1] #
- Breaking change Removed support for Linux. This is because adding Linux made use of a plugin that was causing apps targeting the web to fail to build. This is identical to the 7.0.0 release but also done as a minor increment as 6.1.1 to fix build issues as developers would most likely use caret versioning
[6.1.0] #
- Added initial support to Linux. Thanks to the PR from Yaroslav Pronin
- Prevent crashing on the web by adding guard clauses within the plugin to check if the plugin is being used within a web app due to an issue with getting the operating system via the platform package, which in turn relies on
dart:io
'sPlatform
APIs
[6.0.0] #
- Updated Flutter SDK constraint. To err on the safe side, this is why there's a major version bump for this release as the minimum version supported is 2.2
- Updated Dart SDK constraint
- Bumped mockito dependency
- Addressed deprecation warnings that were appearing for Android builds
- Updated API docs around the
tag
property associated with theAndroidNotificationDetails
class
[5.0.0+4] #
- Fixed example app to re-add attributes to the Android app's
AndroidManifest.xml
to allow full-screen intent notifications to work
[5.0.0+3] #
- Updated readme on how to get the local timezone
- Added link to location of example app to the readme
[5.0.0+2] #
- Updated example app to use the flutter_native_timezone plugin to get the timezone
- Updated readme to mention effect of using same notification id
- Fixed wording and typo in full-screen intent notifications section of the readme. Thanks to PR from Siddhartha Joshi
[5.0.0+1] #
- Add link to explanation of the
onDidReceiveLocalNotification
callback to the initialisation section of the readme - Updated testing section to clarify behaviour on platforms that aren't supported
- Updated
timezone
dependency
[5.0.0] #
- Breaking change migrated to null safety. Some arguments that were formerly null (e.g. some boolean values) are now non-nullable with a default value that should retain the old behaviour
[4.0.1+2] #
- [iOS/macOS] fixed issue where not requesting any permissions (i.e. all the boolean flags were set to false) would still cause a permissions prompt to appear. Thanks to the PR from Andrey Parvatkin
[4.0.1+1] #
- Fixed typo in readme around the note relating to version 4.0 of the plugin where
onSelectNotification
will not be triggered when an app is launched by tapping on a notification.
[4.0.1] #
- [Android] added the
getNotificationChannels
method to theAndroidFlutterLocalNotificationsPlugin
class. This can be used to a get list of all the notification channels on devices with Android 8.0 or newer. Thanks to the PR from Shapovalova Vera
[4.0.0] #
- Breaking change calling
initialize
will no longer trigger theonSelectNotification
if a notification was tapped on prior to callinginitialize
. This was done as thegetNotificationAppLaunchDetails
method already provided a way to handle when an application was launched by a notification. Furthermore, callinginitialize
multiple times (e.g. on different pages) would have previously caused theonSelectNotification
callback multiples times as well. This potentially results in the same notification being processed again - Breaking change the
matchDateComponents
parameter has been renamed tomatchDateTimeComponents
- Dates in the past can now be used with
zonedSchedule
when a value for thematchDateTimeComponents
parameter has been specified to create recurring notifications. Thanks to the PR from Erlend for implementing this and the previous change - [Android] notification data is now saved to shared preferences in a background thread to minimise jank. Thanks to the PR from davidlepilote
- [Android] the
tag
property has been added to theAndroidNotificationDetails
class. This allows notifications on Android to be uniquely identifier through the use of the value of thetag
and theid
passed to the method for show/schedule the notification - [Android] the optional
tag
argument has been added to thecancel
method for theFlutterLocalNotificationsPlugin
andAndroidFlutterLocalNotificationsPlugin
classes. This can be used to cancel notifications where thetag
has been specified - [iOS][macOS] the
threadIdentifier
property has been added to theIOSNotificationDetails
andMacOSNotificationDetails
classes. This can be used to group notifications on iOS 10.0 or newer, and macOS 10.14 or newer. Thanks to the PR from Marcin Chudy for adding this and thetag
property for Android notifications - The Android and iOS example applications have been recreated in Kotlin and Swift respectively
- Updated example application's dev dependency on the deprecated
e2e
for integration tests to useintegration_test
instead - Bumped Flutter dependencies
- Example app cleanup including updating Proguard rules as specifying the rules for Flutter were no longer needed
[3.0.3] #
- [Android] added support for showing subtext in the notification. Thanks to the PR from sidlatau
[3.0.2] #
- [Android] added support for showing the notification timestamp as a stopwatch instead via the
usesChronometer
argument added to the constructor of theAndroidNotificationDetails
class. Thanks to the PR from andymstone - Updated readme to add more clarity on the compatibility with
firebase_messaging
plugin and iOS setup sections - Updated changelog entry for the 2.0.0 release around support for full-screen intents to clarify that the
fullScreenIntent
was added to the constructor of theAndroidNotificationDetails
class.
[3.0.1+7] #
- [Android] fixed issue 935 where scheduling a notification on Android devices running Android versions older than 4.4 (API 19) could cause a crash from using an API that isn't available
[3.0.1+6] #
- [Android] change how the intent that associated with the notification is determined so that the plugin. This is to allow the plugin to work with applications that use activity aliases as per issue 92. Thanks the PR from crazecoder
- Fixed issue 924, where example app will now use https URLs for downloading placeholder images. These images were used when displaying some of the notifications. Thanks to the PR from Fareez
[3.0.1+5] #
- Fixed links in table of contents in the readme. Thanks to the PR from Dihak
- Added a note in the readme to indicate changes were done in version 3.0.1+4 to reduce the setup to ensure readers have updated their application to use the latest version of the plugin
- Added a note around setting the application badge with a link to a plugin that supports this functionality
[3.0.1+4] #
- [Android] made changes so that the plugin will now register the receivers and permissions needed. This reduces the amount of setup needed as developers will no longer need to update their AndroidManifest.xml to do so. The section of the readme on the Android setup for scheduled notifications has been removed as a result
- [Android] fixed an issue where notifications may not appear after rebooting
- [Android] made changes so that the plugin itself specifies which classes should be kept when minified. This means developers should no longer need to add a rule for this plugin in their application's Proguard rules file. Note that rules for GSON will still be needed. The release build configuration section related to the Android setup has been updated to reflect this change
- Bump dependency on
flutter_local_notifications_platform_interface
- Updated API docs
[3.0.1+3] #
- [Android] Fixed issue 898 around duplicate pending notifications
- Updated example app to more clearly indicate which button will demonstrate an Android notification with a different coloured icon and LED
[3.0.1+2] #
- [Android] additional fix for issue 871 by switching the implementation of
deleteNotificationChannel
to use theNotificationManager
APIs instead of theNotificationManagerCompat
APIs
[3.0.1+1] #
- Updated API docs for the
UriAndroidNotificationSound
class to further clarify that developers may need to write code that makes use of platform channels - [Android] fix issue 881 where recurring notifications may fail to schedule the next occurrence on older Android versions as the ThreeTen Android Backport library hadn't been initialised yet
- [Android] switched implementation of
createNotificationChannelGroup
anddeleteNotificationChannelGroup
methods to use theNotificationManager
APIs instead of theNotificationManagerCompat
APIs. If you had issues with 3.0.1 then this should fix the issue (e.g. as reported in issue 871) as the the APIs that were previously being called would've required apps to use more recent versions of the AndroidX libraries
[3.0.1] #
- [Android] Added the
createNotificationChannelGroup
anddeleteNotificationChannelGroup
methods to theAndroidFluttterLocalNotificationsPlugin
class that can be used to create and delete notification channel groups. The optionalgroupId
parameter has been added to theAndroidNotificationChannel
class that can be used to associated notification channels to a particular group. Example app has been updated to include code snippets for this.
[3.0.0+1] #
- [iOS] Fixed issue 865 where notifications with no title weren't behaving properly
- Updated API docs and readme around handling when full-screen intent notifications occur
- Updated API docs around notification channel management
[3.0.0] #
- Breaking change The
scheduledNotificationRepeatFrequency
parameter of thezonedSchedule
method has been removed. This has been replaced bymatchDateTimeComponents
parameter that can be used to schedule a recurring notification. This was done to better indicate that this is used to schedule recurring daily of weekly notifications based on the specified date components. This is more inline with how the calendar trigger works for notifications for iOS and macOS. Given a date (e.g. Monday 2020-10-19 10:00 AM), specifying to match on the time component of would result in a notification occurring daily at the same time (10:00 AM). Specifying to match on the day of the week and time allows for a weekly notification to occur (Monday 10:00 AM), The deprecation warnings for theshowDailyAtTime()
andshowWeeklyAtDayAndTime()
methods have been updated to give a brief description along the same lines.
[2.0.2] #
- [iOS][macOS] fixed issue 860 where notifications may fail to be scheduled to an error parsing the specified date that could occur for some users depending on their locale and if they had turned off the setting for showing 24 hour time on their device. Thanks to the PR from Eugene Alitz
[2.0.1+1] #
- Updated example application to demonstrate how to use the schedule notifications to occur on particular weekday using
zonedSchedule
method - Added a note on migrating away from the deprecated methods for scheduling daily/weekly notifications
[2.0.1] #
- [Android] updated plugin and steps in the readme to ensure notifications remain scheduled after a HTC device restarts. Thanks to the PR from Le Liam
[2.0.0+1] #
- Fixed code snippet in readme around initialisation and configuring the
onDidReceiveLocalNotification
callback specific to iOS. Thanks to the PR from Mike Truso
[2.0.0] #
- Added macOS implementation of the plugin
- The
schedule
,showDailyAtTime
andshowWeeklyAtDayAndTime
methods has been marked as a deprecated due to problems with time zones, particularly when it comes to daylight savings. - Added the
zonedSchedule
method to the plugin that allows for scheduling notifications to occur on a specific date and time relative a specific time zone. This can be used to schedule daily and weekly notifications as well. The example app has been updated to demonstrate its usage. Applications will need to retrieve the device's local IANA timezone ID via native code or a plugin (e.g.flutter_native_timezone
). Note that to support time zone-based scheduling, the plugin now depends on thetimezone
package so that an instance of theTZDateTime
class is required to the specify the time the notification should occur. This should work in most cases as it is IANA-based and native platforms have time zones that are IANA-based as well. To support time zone aware dates on older versions of Android (which use older Java APIs), the plugin depends on the ThreeTen Android Backport library. Once Flutter's support for Android Studio 4.0 and Android Gradle plugin 4.0 has stabilised, the plugin will be updated to make use of desugaring instead of relying on the ThreeTen Android Backport library. - [Android] Fixed issue [670] where
getNotificationAppLaunchDetails()
behaved inconsistently depending on if it was called before or afterinitialize()
- [Android] Added the
getActiveNotifications()
method to theAndroidFlutterLocalNotificationsPlugin
class thanks to the PR from Vincent Kammerer. This can be used to query the active notifications and is only applicable to Android 6.0 or newer - [Android] Fixed an issue where the error message for an invalid source resource wasn't formatted correctly to include the name of the specified resource
- [Android] Added
androidAllowWhileIdle
boolean argument to theperiodicallyShow
method. When set to true, this changes how recurring notifications are shown so that the AndroidAlarmManager
API is used to schedule a notification with exact timing. When the notification appears, the next one is scheduled after that. This is get around the limitations where theAlarmManager
APIs don't provide a way for work to be repeated with precising timing regardless of the power mode. The example app has been updated to include these changes so that it can be used as a reference as well - [Android] Added support for full-screen notifications via the
fullScreenIntent
argument that has been added to the constructor of theAndroidNotificationDetails
class. Thanks to the PR from Nadav Fima - [Android] Bumped compile SDK to 30 (Android 11)
- [Android] Added ability to specify shortcut id that can be used for conversations. See https://developer.android.com/guide/topics/ui/conversations for more info. Note the plugin doesn't provide the ability to publish shortcuts so developers will likely need to look into writing their own code to do so and save the shortcut id so that it can be linked to notifications
- [iOS] Updated the details in the plugin's podspec file
- [iOS] Added ability to specify a subtitle for a notification via the
subtitle
property of theIOSNotificationDetails
class. This property is only application to iOS versions 10 or newer - Breaking change The
InitializationSettings
andNotificationDetails
classes no longer have positional parameters but now have named parameters calledandroid
andiOS
for passing in data specific to Android and iOS. TheremacOS
named parameter has also been added for passing data specific to macOS - Breaking change The
toMap
method that was used internally to transfer data over platform channels is no longer publicly accessible - Breaking change All enum values have been renamed to follow lower camel case convention. This affects the following enums
Day
AndroidNotificationChannelAction
Importance
(note: asdefault
is a keyword, what use to beDefault
is nowdefaultImportance
)Priority
(note: asdefault
is a keyword, what use to beDefault
is nowdefaultPriority
)GroupAlertBehavior
NotificationVisibility
RepeatInterval
- Breaking change assertions have been added to the
IOSInitializationSettings
constructor to prevent null values being passed in - Updated example app so that code for demonstrating functionality that is specific to a platform are only visible when running on the appropriate platform
- Bumped Android dependencies
- Updated example app's Proguard rules file to match latest configuration required by GSON
- Bumped lower bound of Dart SDK dependency to 2.6
- Updated and fixed wording in API docs
- Readme now has a table of contents. Thanks to the PR from Ascênio
This was incorrectly published in the 1.5.0 update
[1.5.0+1] #
- Revert the breaking 1.5.0 update as that should have been published with the major version incremented
[1.5.0] #
-
BAD This was a breaking change that was published as a minor version update. This has been reverted by [1.5.0+1]
-
Added macOS implementation of the plugin
-
The
schedule
,showDailyAtTime
andshowWeeklyAtDayAndTime
methods has been marked as a deprecated due to problems with time zones, particularly when it comes to daylight savings. -
Added the
zonedSchedule
method to the plugin that allows for scheduling notifications to occur on a specific date and time relative a specific time zone. This can be used to schedule daily and weekly notifications as well. The example app has been updated to demonstrate its usage. Note that to support time zone-based scheduling, the plugin now depends on thetimezone
package so that an instance of theTZDateTime
class is required to the specify the time the notification should occur. This should work in most cases as it is IANA-based and native platforms have time zones that are IANA-based as well. To support time zone aware dates on older versions of Android (which use older Java APIs), the plugin depends on the ThreeTen Android Backport library. Once Flutter's support for Android Studio 4.0 and Android Gradle plugin 4.0 has stabilised, the plugin will be updated to make use of desugaring instead of relying on the ThreeTen Android Backport library. -
[Android] Fixed issue [670] where
getNotificationAppLaunchDetails()
behaved inconsistently depending on if it was called before or afterinitialize()
-
[Android] Added the
getActiveNotifications()
method to theAndroidFlutterLocalNotificationsPlugin
class thanks to the PR from Vincent Kammerer. This can be used to query the active notifications and is only applicable to Android 6.0 or newer -
[Android] Fixed an issue where the error message for an invalid source resource wasn't formatted correctly to include the name of the specified resource
-
[Android] Added
androidAllowWhileIdle
boolean argument to theperiodicallyShow
method. When set to true, this changes how recurring notifications are shown so that the AndroidAlarmManager
API is used to schedule a notification with exact timing. When the notification appears, the next one is scheduled after that. This is get around the limitations where theAlarmManager
APIs don't provide a way for work to be repeated with precising timing regardless of the power mode. The example app has been updated to include these changes so that it can be used as a reference as well -
[Android] Added support for full-screen notifications via the
fullScreenIntent
argument that has been added to theAndroidNotificationDetails
class. Thanks to the PR from Nadav Fima -
[Android] Bumped compile SDK to 30 (Android 11)
-
[Android] Added ability to specify shortcut id that can be used for conversations. See https://developer.android.com/guide/topics/ui/conversations for more info. Note the plugin doesn't provide the ability to publish shortcuts so developers will likely need to look into writing their own code to do so and save the shortcut id so that it can be linked to notifications
-
[iOS] Updated the details in the plugin's podspec file
-
[iOS] Added ability to specify a subtitle for a notification via the
subtitle
property of theIOSNotificationDetails
class. This property is only application to iOS versions 10 or newer -
Breaking change The
InitializationSettings
andNotificationDetails
classes no longer have positional parameters but now have named parameters calledandroid
andiOS
for passing in data specific to Android and iOS. TheremacOS
named parameter has also been added for passing data specific to macOS -
Breaking change The
toMap
method that was used internally to transfer data over platform channels is no longer publicly accessible -
Breaking change All enum values have been renamed to follow lower camel case convention. This affects the following enums
Day
AndroidNotificationChannelAction
Importance
(note: asdefault
is a keyword, what use to beDefault
is nowdefaultImportance
)Priority
(note: asdefault
is a keyword, what use to beDefault
is nowdefaultPriority
)GroupAlertBehavior
NotificationVisibility
RepeatInterval
-
Breaking change assertions have been added to the
IOSInitializationSettings
constructor to prevent null values being passed in -
Updated example app so that code for demonstrating functionality that is specific to a platform are only visible when running on the appropriate platform
-
Bumped Android dependencies
-
Updated example app's Proguard rules file to match latest configuration required by GSON
-
Bumped lower bound of Dart SDK dependency to 2.6
-
Updated and fixed wording in API docs
-
Readme now has a table of contents. Thanks to the PR from Ascênio
[1.4.4+5] #
- Updated the
platform
package version range constraint so that 3.x null safety releases could be used (currently used in Flutter 1.22 stable)
[1.4.4+4] #
- [Android] Fix issue 759 by guarding code on getting the intent from the activity in case there isn't an activity that could cause
initialize()
andgetNotificationAppLaunchDetails()
to fail when called from the background
[1.4.4+3] #
- [Android] Fix issue 751 where the
onSelectNotification
callback could be called again after the user has tapped on a notification, sent the application to the background and returned to the app via the Recents screen. This issue could have previously calledgetNotificationAppLaunchDetails()
to mistakenly report that a notification launched the app when it's called again as part of the application being resumed
[1.4.4+2] #
- [Android] Updated readme and plugin to fix issue 689 where plugin needs to ensure notifications stay scheduled after an application update
- Removed
e2e
dependency
[1.4.4+1] #
- Added details that platform-specific implementations can be obtained to the Caveats and limitations section
- Added a note on restrictions imposed by the OS by Android OEMs that may be prevent scheduled notifications appearing
- Release configurations section of the readme renamed to Release build configuration
[1.4.4] #
- [iOS] Fixes to ensure that the native completion handlers were called appropriately. If you had some issues using this plugin combined with push notifications (e.g. via
firebase_messaging
) when the app was in the foreground then I would recommend updating to this version. Thanks to Paweł Szot for picking up the gap in the code in handling the nativewillPresentNotification
call - The readme has been been touched up and had some sections rearranged. Thanks to the PR from psyanite
- Bumped lower bound of Dart SDK dependency to 2.0
[1.4.3] #
- [Android] added the ability to specify additional flags for the notification. For example, this could be used to allow the audio to repeat. See the API docs and update example app for more details. Thanks to the PR from andylei
- Minor cleanup of API docs
[1.4.2] #
- [Android] added the ability to specify the timestamp shown in the notification (issue 596). Thanks to the PR from Nicolas Schneider.
- Fixed API docs for
showWeeklyAtDayAndTime
[1.4.1] #
- [Android] added the ability to create notification channels before a notification is shown. This can be done by calling the
createNotificationChannel
within theAndroidFlutterLocalNotificationsPlugin
class. This allows applications to create notification channels before a notification is shown. Thanks to the PR from Vladimir Gerashchenko. - [Android] added the ability to delete notification channels. This can be done by calling
deleteNotificationChannel
withinAndroidFlutterLocalNotificationsPlugin
class.
[1.4.0] #
Please note that there are a number of breaking changes in this release to improve the developer experience when using the plugin APIs. The changes should hopefully be straightforward but please through the changelog carefully just in case. The steps migrate your code has been covered below but the Git history of the example application's main.dart
file can also be used as reference.
-
[Android] Breaking change The
style
property of theAndroidNotificationDetails
class has been removed as it was redundant. No changes are needed unless your application was displaying media notifications (i.e.style
was set toAndroidNotificationStyle.Media
). If this is the case, you can migrate your code by setting thestyleInformation
property of theAndroidNotificationDetails
to an instance of theMediaNotificationStyleInformation
class. This class is a new addition in this release -
[Android] Breaking change The
AndroidNotificationSound
abstract class has been introduced to represent Android notification sounds. Thesound
property of theAndroidNotificationDetails
class has changed from being aString
type to anAndroidNotificationSound
type. In this release, theAndroidNotificationSound
has the following subclasses-
RawResourceAndroidNotificationSound
: use this when the sound is raw resource associated with the Android application. Previously, this was the only type of sound supported so applications using the plugin prior to 1.4.0 can migrate their application by using this class. For example, if your previous code wasvar androidPlatformChannelSpecifics = AndroidNotificationDetails( 'your other channel id', 'your other channel name', 'your other channel description', sound: 'slow_spring_board');
Replace it with
var androidPlatformChannelSpecifics = AndroidNotificationDetails( 'your other channel id', 'your other channel name', 'your other channel description', sound: RawResourceAndroidNotificationSound('slow_spring_board');
-
UriAndroidNotificationSound
: use this when a URI refers to the sound on the Android device. This is a new feature being supported as part of this release. Developers may need to write their code to access native Android APIs (e.g. theRingtoneManager
APIs) to obtain the URIs they need.
-
-
[Android] Breaking change The
BitmapSource
enum has been replaced by the newlyAndroidBitmap
abstract class and its subclasses. This removes the need to specify the name/path of the bitmap and the source of the bitmap as two separate properties (e.g. thelargeIcon
andlargeIconBitmapSource
properties of theAndroidNotificationDetails
class). This change affects the following classesAndroidNotificationDetails
: thelargeIcon
is now anAndroidBitmap
type instead of aString
and thelargeIconBitmapSource
property has been removedBigPictureStyleInformation
: thelargeIcon
is now anAndroidBitmap
type instead of aString
and thelargeIconBitmapSource
property has been removed. ThebigPicture
is now aAndroidBitmap
type instead of aString
and thebigPictureBitmapSource
property has been removed
The following describes how each
BitmapSource
value maps to theAndroidBitmap
subclassesBitmapSource.Drawable
->DrawableResourceAndroidBitmap
BitmapSource.FilePath
->FilePathAndroidBitmap
Each of these subclasses has a constructor that an argument referring to the bitmap itself. For example, if you previously had the following code
var androidPlatformChannelSpecifics = AndroidNotificationDetails( 'your other channel id', 'your other channel name', 'your other channel description', largeIcon: 'sample_large_icon', largeIconBitmapSource: BitmapSource.Drawable, )
This would now be replaced with
var androidPlatformChannelSpecifics = AndroidNotificationDetails( 'your other channel id', 'your other channel name', 'your other channel description', largeIcon: DrawableResourceAndroidBitmap('sample_large_icon'), )
-
[Android] Breaking change The
IconSource
enum has been replaced by the newly addedAndroidIcon
abstract class and its subclasses. This change was done for similar reasons in replacing theBitmapSource
enum. This only affects thePerson
class, which is used when displaying each person in a messaging-style notification. Here theicon
property is now anAndroidIcon
type instead of aString
and theiconSource
property has been removed.The following describes how each
IconSource
value maps to theAndroidIcon
subclassesIconSource.Drawable
->DrawableResourceAndroidIcon
IconSource.FilePath
->BitmapFilePathAndroidIcon
IconSource.ContentUri
->ContentUriAndroidIcon
Each of these subclasses has a constructor that accepts an argument referring to the icon itself. For example, if you previously had the following code
Person( icon: 'me', iconSource: IconSource.Drawable, )
This would now be replaced with
Person( icon: DrawableResourceAndroidIcon('me'), )
The
AndroidIcon
also has aBitmapAssetAndroidIcon
subclass to enables the usage of bitmap icons that have been registered as a Flutter asset via thepubspec.yaml
file. -
[Android] Breaking change All properties in the
AndroidNotificationDetails
,DefaultStyleInformation
andInboxStyleInformation
classes have been madefinal
-
The
DefaultStyleInformation
class now implements theStyleInformation
class instead of extending it -
Where possible, classes in the plugins have been updated to provide
const
constructors -
Updates to API docs and readme
-
Bump Android dependencies
-
Fixed a grammar issue 0.9.1 changelog entry
[1.3.0] #
- [iOS] Breaking change Plugin will now throw a
PlatformException
if there was an error returned upon calling the nativeaddNotificationRequest
method. Previously the error was logged on the native side the usingNSLog
function. - [iOS] Added ability to associate notifications with attachments. Only applicable to iOS 10+ where the UserNotification APIs are used. Thanks to the PR from Pavel Sipaylo
- Updated readme on using
firebase_messaging
together withflutter_local_notifications
to let the community thatfirebase_messaging
6.0.13 can be used to resolve compatibility issues around callbacks when both plugins are used together
[1.2.2] #
- [Android] Added ability to specify if the timestamp for when a notification occurred should be displayed. Thanks to the PR from mojtabaghiasi
[1.2.1] #
- [Android] Fixed issue 512 where calling
getNotificationAppLaunchDetails()
within theonSelectNotification
callback could indicating that the app was launched by tapping on a notification when it wasn't the case - Update example app to indicate if a notification launched the app and include the launch notification payload
[1.2.0+4] #
- Title at the top of the readme is now the same name as the plugin
- Updated readme to add subsections under the Android and iOS integration guide
- Added links in the readme under the Android release build configuration section that point to the configuration files used by the example app
[1.2.0+3] #
- Updated API docs for
resolvePlatformSpecificImplementation()
method
[1.2.0+2] #
- Make the static
values
propeerty of thePriority
class returnList<Priority>
instead of being dynamic and added API docs for the property.
[1.2.0+1] #
- The static
values
properties for theDay
andImportance
classes now returnList<Day>
andList<Importance>
respectively instead of being dynamic - Added more public API documentation
- Updated readme to move issues and contributions section to the readme within the repository
- Added screenshots to readme
- Updated how breaking changes are highlighted in changelog to all the letters aren't capitalised
[1.2.0] #
- Added the
resolvePlatformSpecificImplementation()
method to theFlutterLocalNotificationsPlugin
class. This can be used to resolve the underlying platform implementation in order to access platform-specific APIs. - Breaking change the static
instance
properties in theIOSFlutterLocalNotificationsPlugin
andAndroidFlutterLocalNotificationsPlugin
classes have been removed due to addition of theresolvePlatformSpecificImplementation()
- Updated readme to remove use of
new
keyword in code snippets - Bumped e2e dependency
- Bumped example app dependencies
- Make the pedantic dev_dependency explicit
[1.1.7+1] #
- Minor update to readme on description around requesting notification permissions
- Add link to forked
firebase_messaging
plugin to readme for those that want to use it whilst the PR to fix the compatibility issues with this plugin is waiting to be reviewed
[1.1.7] #
- [iOS] Added
requestPermissions()
method toIOSFlutterLocalNotificationsPlugin
class. This can be used to request notification permissions separately from plugin initialisation. To facilitate this theIOSFlutterLocalNotificationsPlugin
andAndroidFlutterLocalNotificationsPlugin
now expose a staticinstance
property that can be used obtain the platform-specific implementation of the plugin so that platform-specific methods can be used. Thanks to the PR from Dariusz Łuksza - Updated documentation to clarify that
getNotificationAppLaunchDetails()
is intended to be used more on if a notification from this plugin triggered launch an application - Updated API docs for consistency and to better follow the guidelines on effective Dart documentation
[1.1.6] #
- [iOS] Added ability to set badge number. Thanks to PR from FelixYew
- Fixed a spelling mistake in the 1.1.5+1 changelog entry
[1.1.5+1] #
- No functional changes. Fixed a reported formatting issue
- Mention removal of named constructor argument in 1.1.0 changelog entry
- Add API docs to
FlutterLocalNotificationsPlugin.private()
on how it could be used for testing - Update notes on testing to mention that the
FlutterLocalNotificationsPlugin.private()
named constructor may be of use
[1.1.5] #
- [Android] minor optimisation on scheduling related code so that
Gson
instance is reused instead of being rebuilt each time - Changed plugin to require 1.12.3+hotfix.5 or greater since pub has issues resolving 1.12.3+hotfix.6
- Updated changelog entry for version 1.1.4 to mention removal of upper bound constraint on Flutter SDK requirement
[1.1.4] #
- Support v2 Android embedding. Note that there is currently a known issue in the Flutter SDK that will cause
onSelectNotification
to fire twice on Android. The fix is in the master channel but hasn't rolled out to other channels. Subscribe to the issue for updates. - Require Flutter SDK 1.12.3+hotfix.6 or greater. Maximum SDK restraint has also been removed
[1.1.3] #
- Expose
NotificationAppLaunchDetails
via main plugin - Retroactively updated changelog for 1.1.0 to indicate breaking change on moving to using platform interface
- Made plugin methods be a no-op to fix issue with version 1.1.0 where test code involving the plugin would fail when running on an environment that is neither Android or iOS
[1.1.2] #
- Passing a null notification id now throws an
ArgumentError
. Thanks to PR from talmor_guy - Slight tweak to message displayed with by
ArgumentError
when notification id is not within range of a 32-bit integer
[1.1.1] #
- [Android] Added ability to specify timeout duration of notification
- [Android] Added ability to specify the notification category
[1.1.0] #
- Breaking change Updated plugin to make use of
flutter_local_notifications_platform_interface
version 1.0.1. This allows for platform-specific implementations of the platform interface to now be accessible. Note that the plugin will check which platform the plugin is running on. Note: this may have inadvertently broke some tests for users as the plugin now checks which platform the plugin is executing code on and would throw anUnimplementedError
since neither iOS or Android can be detected. Another issue is thatNotificationAppLaunchDetails
was no longer exposed via the main plugin. Please upgrade to 1.1.3 to have both of these issues fixed - Breaking change Plugin callbacks are no longer publicly accessible
- Breaking change [iOS] Local notifications that launched the app should now only be processed by the plugin if they were created by the plugin.
- Breaking change
MethodChannel
argument has been removed from the named constructor that was visible for testing purposes
[1.0.0] #
- Breaking change [iOS] Added checks to ensure callbacks are only invoked for notifications originating from the plugin to improve compatibility with other notification plugins.
- [Android] Bump Gradle plugin to 3.5.3
[0.9.1+3] #
- Include notes in getting started section to emphasise that the steps in the integration guide for each platform needs to be done.
- Move information in the readme on configuring resources to keep on Android.
[0.9.1+2] #
- Update link to repository due to restructuring.
[0.9.1+1] #
- Update readme with Swift example code on cancelling local notifications using the deprecated
UILocalNotification
iOS APIs when trying to prevent local notifications from appearing in the scenario where user has uninstalled the app whilst there are pending notification requests, reinstalled the app and ran it again.
[0.9.1] #
- Added support for media notifications. This currently only supports showing the specified image as album artwork. Thanks to the PR by gianlucaparadise
[0.9.0+1] #
- Fix readme where Objective-C was written twice
[0.9.0] #
- [Android] Add ability to customise visibility of a notification on the lockscreen. Thanks to PR by gianlucaparadise
- [Android] Bumped compile and target SDK to 29
- Breaking change [iOS] Plugin no longer registers as a
UNUserNotificationCenterDelegate
. This is to enable compatibility with other plugins that display notifications. Developers must now do this themselves. Refer to the updated iOS integration section for more info on this - Updated info about configuring Proguard configuration rules and included a file that could be used for reference in the example app
- Removed dependency on the
meta
package - Breaking change Now requires Flutter SDK 1.10.0 or greater
- Migrate the plugin to the pubspec platforms manifest
[0.8.4+3] #
- Update example to fix issue 372 around app not firing
onSelectNotification
having switched to using streams and initialising the app in themain
function.
[0.8.4+2] #
- Add note to readme that plugin initialisation be done as part of showing the first page of the app.
[0.8.4+1] #
- Fix typo in readme. Thanks to PR submitted by Michael Arndt
- Updated API docs and example around initializing the plugin to make it clearer that
initialize
should only be called once on app startup.
[0.8.4] #
- [iOS] Fix issue 336 where a native crash occurred after creating a notification with a null body
[0.8.3] #
- [Android] Changed intents to use the
FLAG_UPDATE_CURRENT
flag instead ofFLAG_CANCEL_CURRENT
as alarms weren't being cleared out properly when updating or cancel a notification. Thanks to WJQ for submitting the PR to address the cancellation issue
[0.8.2+1] #
- Remove
ScheduledAndroidNotificationPrecision
enum that wasn't being used - Update readme around approach used to develop the plugin
[0.8.2] #
- [iOS] Fix issue 295 where
onSelectNotification
callback wasn't trigger when a notification had been tapped on whilst the app was terminated
[0.8.1+1] #
- Update comment in example around grouped notifications to clarify that the summary notification ia required for all versions of Android
- Update email address in pubspec.yaml
[0.8.1] #
- [iOS] Accepted PR from Josh Burton that improves ability for plugin to work in multiple isolate by moving state to instance variables
- [iOS] Add a guard to prevent a scenario from happening where it may still be possible for the
onDidReceiveLocalNotification
callback to trigger on iOS 10+ - Minor update to readme on raising issues and correction on payload information
[0.8.0] #
- Added an optional parameter named
androidAllowWhileIdle
toschedule
method. This will allow notifications to still display at the specified time when the Android device is in an low-power idle mode. - Breaking change Bump minimum Flutter version to 1.5.0
- Breaking change Update Flutter dependencies
[0.7.1+3] #
- Fix build status badge
[0.7.1+2] #
- Started adding Cirrus CI configuration and include CI status badge as part of readme
[0.7.1+1] #
- Updated readme to include information about OS limits related to scheduled notifications
[0.7.1] #
- [Android] Added ability to specify the "ticker" text. Thanks to PR submitted by Zhang Jing
- Spelling mistake fixes in readme. Thanks to PR submitted by Wanbok (Wayne) Choi
[0.7.0] #
- Breaking change [Android] Updated to Gradle 5.1.1 and Android Gradle plugin has been updated to 3.4.0 (aligns with Android Studio 3.4 release). Example app has also been updated to Gradle 5.1.1. Apps will need to update to use the plugin. Please see here for more information if you need help on updating
- [Android] Add ability to specify the LED colour of the notification. Updated example app to show this can be done. Note that for Android 8.0+ (i.e. API 26+) that this is tied to the notification channel
[0.6.1] #
- [Android/iOS] Added
pendingNotificationRequests
method. This will return a list of pending notification requests that have been scheduled to be shown in the future. Updated example app to include sample code for calling the method - [Android] Fix an issue where scheduling a notification (recurring or otherwise) with the same id as another notification that was scheduled with the same id would result in both being stored in shared preferences. The shared preferences were used to reschedule notifications on reboot and shouldn't affect the functionality of displaying the notifications
- Updated plugin methods to return
Future<void>
instead ofFuture
as per Dart guidelines - Updated readme to mention known issue with scheduling notifications and daylight savings
- Refactored widgets in example app
[0.6.0] #
- Breaking change [Android] Updated Gradle plugin to 3.3.2
- Breaking change [Android] Changed to store the name of drawable specified as the small icon to be used for Android notifications instead of the resource ID. This should fix the scenario where an app could be updated and the resource IDs got change and cause scheduled notifications to not appear. Believe this fix should retroactively apply for notifications scheduled with an icon specified but won't apply to those that were scheduled to use the default icon specified via the
initialize
method. This is due to the fact the name of the default icon wasn't being cached in previous ones but this has now changed so it's cached in shared preferences from this version onwards
[0.5.2] #
- Fix for when multiple isolates use the plugin. Thanks to PR submitted by xtelinco
- Added the
channelAction
field to theAndroidNotificationDetails
class. This provides options for managing notification channels on Android. Default behaviour is to create the notification channel if it doesn't exist (which was what it it use to do). Another option is to update the details of the notification channel. Example app has been updated to demonstrate how to update a notification channel when sending a notification
[0.5.1+2] #
- Highlight note on migrating to AndroidX more in readme
[0.5.1+1] #
- Readme corrections and add information on migrating to AndroidX
[0.5.1] #
- Updated Gradle plugin of example app to 3.3.1
- Added support for messaging style notifications on Android as requested in issue 159. See example app for some sample code
[0.5.0] #
- Breaking change Migrated to use AndroidX as the Android support libraries are deprecated. There shouldn't be any functional changes. Developers may require migrating their apps to support this following this guide. This addresses issue 162. Thanks to Jeff Scaturro for submitting the PR for this work. Note that if you don't want to migrate your app to use AndroidX yet then you may need to pin dependencies to a specific version
[0.4.5] #
- Fix issue 160 so that notifications created with the
schedule
on Android will appear at the exact date and time they are scheduled
[0.4.4+2] #
- Fix changelog
[0.4.4+1] #
- Breaking change Fix naming of
onDidReceiveLocalNotification
property in theIOSInitializationSettings
class (was previously namedonDidReceiveLocalNotificationCallback
by accident)
[0.4.4] #
- Breaking change removed
registerUNNotificationCenterDelegate
argument for theIOSInitializationSettings
class as it wasn't actually used. - Plugin can now handle
didReceiveLocalNotification
delegate method in iOS and allow developers to handle the associated callback in Flutter. Added aonDidReceiveLocalNotificationCallback
argument to theIOSInitializationSettings
class to enable this and updated the sample code to demonstrate the usage. This should resolve issue 14.
[0.4.3] #
- Merged PR from Aine LLC (ganessaa) to fix issue 140 where scheduled notifications were shown immediately on iOS versions before 10. Note that this issue is likely related to an known issue in the Flutter engine that may require switching channels to be addressed as the fix isn't on the stable channel yet.
- [Android] Provide a way to hide the large icon when showing an expanded big picture notification via the
hideExpandedLargeIcon
flag within thrBigPictureStyleInformation
class. This provides a solution for issue 136. Updated the example to demonstrate - Merged PR from (riccardoratta) so that sample code is coloured in GitHub to improve readability.
[0.4.2+1] #
- Update changelog to indicate when
MessageHandler
typedef got renamed (in 0.4.1) as raised in issue 132
[0.4.2] #
- Breaking change Fix issue 127 by changing plugin to Android Support Library version 27.1.1, compile and target SDK version to 27 due to issues Flutter has with API 28.
[0.4.1+1] #
- Remove unused code in example app
[0.4.1] #
- Breaking change renamed the
selectNotification
callback exposed by theinitialize
function toonSelectNotification
- Breaking change renamed the
MessageHandler
typedef toSelectNotificationCallback
- Breaking change updated plugin to Android Support Library version 28.0, compile and target SDK version to 28
- Address issue 115 by adding validation to the notification ID values. This ensure they're within the range of a 32-bit integer as notification IDs on Android need to be within that range. Note that an
ArgumentError
is thrown when a value is out of range. - Updated the Android Integration section around registering receivers via the Android manifest as per the suggestion in 116
- Updated version of the http dependency for used by the example app
[0.3.9] #
- [Android] Added ability to show progress notifications and updated example app to demonstrate how to display them
[0.3.8] #
- Added
getNotificationAppLaunchDetails()
method that could be used to determine if the app was launched via notification (raised in issue 99) - Added documentation around ProGuard configuration to Android Integration section of the readme
[0.3.7] #
- [Android] Fix issue 88 where cancelled notifications could reappear on reboot.
[0.3.6] #
- [Android] Add mapping to the setOnlyAlertOnce method 83. Allows the sound, vibrate and ticker to be played if the notification is not already showing
- [Android] Add mapping to setShowBadge for notification channels that controls if notifications posted to channel can appear as application icon badges in a Launcher
[0.3.5] #
- [Android] Will now throw a PlatformException with a more friendly error message on the Flutter side when a specified resource hasn't been found e.g. when specifying the icon for the notification
- Fix overflow rendering issue in the example app
[0.3.4] #
- [Android] Fix issue 71 where the wrong time on when the notification occurred is being displayed. Breaking change this involves changing it the receiver for displaying a scheduled notification will only build the notification prior to displaying it. There is a fix applied to existing scheduled notifications in this release that will be eventually be removed as going forward all scheduled notifications will work as just described
- [Android] Fix an issue with serialising and deserialising the notifications so that additional style types (big picture and inbox) would be recognised. This affected scheduled notifications where upon rebooting the device, the plugin would need to reschedule the notifications using information saved in shared preferences.
[0.3.3] #
- [iOS] Fixes issue 61 where the
showDailyAtTime
andshowWeeklyAtDayAndTime
methods may not show notifications that should appear the next day. Thanks to Jeff Scaturro for submitting the PR to fix this.
[0.3.2] #
- No functional changes. Updated the readme around raising issues, recurring Android notifications on Android and a fix in the getting started section (thanks to ebeem for spotting that).
[0.3.1] #
- No functional changes in this release but removed a class that is no longer used due to changes in 0.3.0
- Updated readme information the example app and configuring Android notification icons
- changelog is now in reverse chronological order so details about the most recent release are at the top
- Additional comments in the example's main.dart file to refer to downloading the complete example app project from GitHub
[0.3.0] #
-
BREAKING CHANGES restructured code so that only a single import statement is now needed to use the plugin. Classes that had the platform (Android/iOS) as a suffix are now prefixes to improve readability of code and follow the recommendations for writing Dart code i.e. write code that reads more like a sentence. The following have been renamed
- InitializationSettingsAndroid -> AndroidInitializationSettings
- InitializationSettingsIOS -> IOSInitializationSettings
- NotificationDetailsAndroid -> AndroidNotificationDetails
- NotificationStyleAndroid -> AndroidNotificationStyle
- NotificationDetailsIOS -> IOSNotificationDetails
-
[Android] Ability to set the large icon used for each notification. See example app for sample code
-
[Android] Ability to create a notification with the big picture style. See example app for sample code
-
Correct license text
[0.2.9] #
- Fix error in calling initialize error on iOS versions < 9
[0.2.8] #
- Update dev dependencies required for flutter test to run. This is due to a breaking change in Flutter. See https://github.com/flutter/flutter/wiki/changelog
[0.2.7] #
- [Android] Fix issue with showDailyAtTime and showWeeklyAtDayAndTime where time occurred in the past and caused notification to trigger instantly
[0.2.6] #
- [Android] Fix bug with applying ongoing and autoCancel properties
[0.2.5] #
- [Android] Bug fix for previous release
[0.2.4] #
- [Android] Add ability to set the colour.
[0.2.3] #
- [Android/iOS] Add ability to have a notification shown daily at a specified time. Credits to Javier Lecuona for submitting the PR for this.
- [Android/iOS] Add ability to have a notification shown weekly on a specific day and time.
[0.2.2] #
- [Android/iOS] Fix RepeatInterval not being mapped to the correct values on the native side. Thanks to Thibault Deckers for spotting the issue.
[0.2.1] #
- [Android/iOS] Add ability to set a notification to be periodically displayed
- [Android] Fix a bug where the small icon could not be be found when loading scheduled notifications from shared preferences to reschedule them on a device reboot
- [Android] Fix example app manifest file
[0.2.0] #
- [Android] Add ability to specify if notifications should automatically be dismissed upon touching them
- [Android] Add ability to specify in notifications are ongoing
- [Android] Fix bug in cancelling all notifications
[0.1.9] #
- [Android/iOS] Add ability to cancel/remove all notifications
[0.1.8] #
- [Android] Bug fix for grouping notifications
[0.1.7] #
- [Android] Add ability to show grouped notifications. Example code has been updated to demonstrate this functionality.
- Fixed the example project so it works with the new release of Cocoapods (1.5.0)
- Fixes for when API methods were called without specifying platform specific settings
[0.1.6] #
- BREAKING CHANGES Apologies again, this is another cleanup release. FlutterLocalNotifications class has been renamed to FlutterLocalNotificationsPlugin now as it makes more sense from a readability perspective. More importantly, the class and methods are also no longer static to faciliate mocking and testing. It's something I should've picked up on earlier so sorry once again. Check the source code for an example on how to mock the plugin when testing
[0.1.5] #
- BREAKING CHANGES There are no functional changes. This is an API cleanup release where I've reorganised the Dart classes to better separate them by platform. What this means is that the import statements in your coode will need to be fixed. Apologies to anyone using the plugin but I feel that this was necessary as Flutter may target additional platforms in the future. Hopefully you'll agree that the end result looks a better :)
[0.1.4] #
- [Android] Add inbox notification style
[0.1.3] #
- Fix broken example app for iOS due to incorrect reference to custom sound file. Added ability to handle when a notification is tapped. See updated example for details on how to do this and will navigate to another page. Note that the second page isn't rendering full-screen on Android if the notification was tapped on while the app was in the foreground. Suspect that this is Flutter rendering issue and have logged this on the Flutter repository at https://github.com/flutter/flutter/issues/16636
[0.1.2] #
- [Android] Bug fix in calculating when to show a scheduled notification. Ensure scheduled Android notifications will remain scheduled even after rebooting.
[0.1.1] #
- [Android] Add ability to use HTML markup to format the title and content of notifications
[0.1.0] #
- [Android] Add support for big text style for and being able format the big text style specific content using HTML markup.
[0.0.9] #
- [iOS] Enable ability to customise the sound for notifications (Important requires testing on older iOS versions < 10)
- [iOS] Can now specify default presentation options (Breaking change named parameters for iOS initialisation have changed) that can also be overridden at the notification level).
- [iOS] Fixes for reading in specified options
[0.0.8] #
- [Android] Enable ability to customise sound and vibration for notifications.
[0.0.7] #
- [Android] Fix notifications so that tapping on them will remove them and will also start the app if it has been terminated.
[0.0.6] #
- [iOS] Add ability to customise the presentation options when a notification is triggered while the app is in the foreground for notifications presented using the User Notifications Framework (iOS 10+). IMPORTANT: the named parameters for iOS initialisation settings constructor have had to change to differentiate between permission options and presentation options
[0.0.5] #
- [iOS] Updates to code to support both legacy notifications via UILocalNotification (before iOS 10) and the User Notifications framework introduced in iOS 10
[0.0.4] #
- Updated readme
[0.0.3] #
- Fix changelog
[0.0.2] #
- Readme fixes
[0.0.1] #
- Initial release