Added

• 6 new foreground service types: Added health, remoteMessaging, shortService, specialUse, systemExempted (API 34) and mediaProcessing (API 35) to ForegroundServiceType.
• Foreground service timeout handling: ForegroundService now implements onTimeout(int) (API 34) and onTimeout(int, int) (API 35) to gracefully stop services that exceed their time limits, preventing ANRs and RemoteServiceException.

Fixed

• Off-by-one bug in ForegroundServiceType.getSafeEnum(): Fixed character matching where mediaPlayback and mediaProjection were incorrectly resolved as manifest.
• Conflicting compileSdk 34: Removed duplicate compileSdk inside defaultConfig that shadowed the root-level compileSdkVersion = 36.
• Migrated annotation imports: Replaced javax.annotation and org.checkerframework with androidx.annotation across 17 files to fix missing imports after dependency updates.

Breaking changes

• iOS minimum deployment target raised to 15.0: The minimum iOS deployment target has been increased from iOS 12 to iOS 15. This change is required to support newer iOS APIs and aligns with Apple's current compatibility standards.
• Foreground service type removed from library manifest: The android:foregroundServiceType attribute is no longer declared in the library's AndroidManifest.xml. Consumer apps must declare the foreground service types they use in their own manifest.
• BIND_NOTIFICATION_LISTENER_SERVICE permission removed: This permission was declared with maxSdkVersion=22 which had no effect since the library's minSdk is 23. Consumer apps needing NotificationListenerService must declare this permission themselves.
• Build system updated: AGP 8.1.1 → 8.10.1, Gradle 8.10 → 8.11.1, dependencies updated (appcompat 1.7.1, material 1.13.0, media 1.7.1, room 2.8.4, lifecycle 2.10.0, sqlite 2.6.2, guava 33.5.0, annotation 1.9.1).

We’re excited to announce the release of Awesome Notifications v0.10.1, bringing essential updates to enhance compatibility and maintain long-term stability.

🆕 What’s New?

✅ Upgraded Dependencies – All dependencies have been updated to their latest stable versions, ensuring better performance and compatibility.
✅ Full Support for Flutter 3.27 – Removed deprecated Flutter V1 APIs, which are no longer supported in newer Flutter versions and could cause build failures.

📢 Why Update?

This version ensures seamless integration with the latest Flutter 3.27, resolves potential build issues, and improves overall stability.

We highly recommend all users upgrade to v0.10.1 to take advantage of these improvements! 🚀

We're excited to announce the release of Awesome Notifications Version 0.10.0. This update encompasses a range of enhancements designed to improve the functionality and stability of your notification experiences on both Android and iOS platforms, as well as ensuring full compatibility with the latest Flutter developments.

Key Enhancements:

Extended Support for Flutter 3.24

• Updated to Flutter 3.24: The entire Awesome Notifications framework, including the example app, has been updated to fully support Flutter 3.24. This includes adapting to new Gradle Java standards and leveraging the latest features and optimizations provided by Flutter.

Android Platform Enhancements

• Android 14 and AGP 8 Support: Upgraded all dependencies and the example app for full compatibility with Android 14 and Android Gradle Plugin 8, utilizing the latest Android features and development tools.
• Firebase Dependencies Updated: Updated all Firebase dependencies to support Firebase core 3.0.0, ensuring our framework integrates seamlessly with the latest Firebase improvements.
• MediaPlayer Album Art Resolution Fix: Addressed an issue where album art was displaying at reduced resolution on Android 14 devices. Album artwork now renders clearly and crisply, improving the visual quality of the media player.

iOS Platform Enhancements

• Resilience Against Misconfigured Notification Service Extensions: Made adjustments to enhance resilience against missing registered events caused by misconfigured Notification Service Extension targets. In such cases, events will be registered using the current date instead, avoiding crashes.

Cross-Platform Improvements

• Interval Changes to Duration Type: Changed interval values from integers (seconds) to Duration type, enhancing readability and understanding of time intervals within code.

Deprecated Features

• Deprecation of weekOfMonth Parameter: The weekOfMonth parameter is deprecated due to unimplemented dependencies expected in versions beyond 1.0.0. It may be reconsidered for future inclusion.

Breaking Changes

• Minimum Android SDK Increased to 23: The minimum Android version supported is now Android 6.0 (Marshmallow), to utilize newer security and encryption features.
• Minimum iOS Deployment Target Increased to iOS 12: The increase in iOS deployment target to iOS 12 enhances compatibility with newer iOS features and improves security and performance.
• Manual Addition of Android Permissions Required: Developers must now manually declare necessary permissions in their AndroidManifest.xml to ensure full functionality of the notification features, in case they are needed:
  • android.permission.VIBRATE
  • android.permission.SCHEDULE_EXACT_ALARM
  • android.permission.USE_FULL_SCREEN_INTENT
  • android.permission.WAKE_LOCK
  • android.permission.FOREGROUND_SERVICE
  • android.permission.RECEIVE_BOOT_COMPLETED

This version represents our commitment to providing a powerful, flexible notifications framework that meets the demands of modern app development. By addressing key areas of enhancement and ensuring compatibility with the latest development standards, we aim to deliver a more reliable, feature-rich package that developers can depend on for creating engaging notification experiences.

We encourage all users to update to version 0.10.0 to take full advantage of these improvements.

Transition Support from Github to Discord Community

• GitHub Issues Closure: Effective immediately, GitHub issues will no longer be open for new support requests. Existing issues will remain accessible as an archive and resource.
• Discord Community Support: All support for Awesome Notifications has transitioned to our Discord community. This move aims to provide a more dynamic, interactive, and efficient support experience.
• Reasons for Change:
  • Community Rules Respect: Numerous issues posted on GitHub have not adhered to our community guidelines, impacting heavily on support efficiency and effectiveness.
  • Efficiency and Effectiveness: Managing support through GitHub has become exceedingly time-consuming, particularly when posts omit critical information or disregard guidelines.
  • Quality of Support: Our Discord community allows for real-time engagement, resource sharing, and a closer-knit user and developer interaction, which wasn't true for GitHub.
• Next Steps for Users: We encourage all users to join our Discord community https://discord.awesome-notifications.carda.me/ for ongoing support, updates, and to connect with fellow users and the development team.

We're excited to announce the release of Awesome Notifications Version 0.9.3. This update encompasses a range of improvements and updates designed to enhance the functionality and stability of your notification experiences on both Android and iOS platforms.

Key Enhancements:

Enhanced Stability and Event Management

• Introduced a double-check mechanism for createdDate and displayedDate fields within the lost events manager to prevent null pointer exceptions and ensure the reliability of event tracking on iOS in cases where the implementation doesn't follow the awesome recommendations.

Richer Notification Content

• Expanded notification capabilities to include image support across all layouts on iOS, providing a richer and more engaging user experience.

Dependency and Standards Upgrades

• Project dependencies across the board have been upgraded to their latest versions, embracing improvements, security patches, and new features to ensure the framework remains robust and secure.
• Specifically for Android, dependencies were updated and the project was migrated to comply with Flutter 3.19 standards, including modifications to build.gradle files and dependency management to enhance compatibility and performance.
• The iOS core has been updated to version 0.9.3, aligning with the latest native improvements and features.

UI Component Improvements

• The SimpleButton widget in the example app has been refined to replace deprecated properties with the latest Flutter equivalents, ensuring that the UI components of Awesome Notifications stay current and fully functional.

System Updates

• Both Android Core dependencies and iOS core versions have been updated to 0.9.3, bringing in the latest enhancements from the core libraries to the Awesome Notifications package.

This version represents our commitment to providing a powerful, flexible notifications framework that meets the demands of modern app development. By addressing key areas of enhancement and ensuring compatibility with the latest development standards, we aim to deliver a more reliable, feature-rich package that developers can depend on for creating engaging notification experiences.

We encourage all users to update to version 0.9.3 to take full advantage of these improvements.

Added

• Cancel schedule for iOS: The feature cancelSchedule was added to iOS platform.
• Example app updated: The example app was updated to reflect the last changes.

[0.9.1] - 2024-11-01

Breaking Changes

• Progress Property Now Double: The progress property in NotificationContent has been changed from int to double. This modification enhances the precision of progress values in notifications.

Breaking Changes

• Pod modifications: Now it's necessary to also add Awesome Notifications pod modification inside PodFile at iOS folder.
• Receive port and send port: The methods sendPort.send() and receivePort!.listen() now only accept serialized data, not objects. Convert your data to a map format and reconstruct it later from this format.
• License Key (Year 2): Starting the year 2 support of awesome suite. In case your license was generated for Year 1 and you're still under the 1-year purchase support you just need to reply to the license email requesting the free update.

Added

• Translation keys and Args: Implemented support for dynamic localization in notifications. Translation keys (titleLocKey, bodyLocKey) and their respective arguments (titleLocArgs, bodyLocArgs) can now be used to localize notification content dynamically based on the user's language preference.
• Authentication required action: New action property that requires user authentication to proceed.

Improvements

• Extended Support: We're excited to announce the commencement of our "Year 2 Support Season." This includes ongoing maintenance, regular updates, and dedicated support.
• Flutter 3.16.5 Compatibility: The plugin is now fully compatible with Flutter 3.16.5.

Bug Fixes

• Enhanced Event Handling on Android: We've modified event handlers on Android to support negative values. This enhancement ensures more robust and reliable event management.
• Resolved Silent Callback Issue: Fixed a previously encountered issue where silent callbacks were missing for silent background actions.

Added

• New media player features (Playback state, speed and duration) for media player notifications

Improved

• Support for Flutter 3.16.0 and the new methods exclusive for Main targets on iOS
• Dependencies updated
• Unit tests updated
• Documentation updated

Improved

• iOS awesome_notifications library updated to version 0.8.1

Fixed

• Swift libraries updated to utilize a shared reference from the new Logger class.

Fixed

• Updated library versions to 0.8.0 to ensure that project lock files are updated.

Improved

• Enhanced versioning of iOS core libraries to better support DevOps, ensuring greater flexibility for future updates.

Added

• Integration with awesome_notifications_core to automatically manage versions
• Support for Android 14

Improved

• Documentation updated

Added

• Full support for Flutter 3.13
• Support for iOS 17
• Compatibility with AGP 8
• Automated tests for Dart code in master, with over 90% coverage

Fixed

• New image provider for native resource media

Improved

• Project dependencies upgraded to the latest version available
• Documentation updated

Added

• Chronometer indicator for Android notifications

Fixed

• Default app small icon fixed on Android
• New field timeoutAfter exposed on NotificationContentModel constructor
• Notification events changed to fire also for negative address
• Filters to separate meta data from payload on iOS pushes changed to ignore local notifications
• Order of recreation notification events changed on iOS to preserve expired lost events

Improved

• iOS minimal deployment target decreased to 11
• TimeoutAfter modified to use Duration, instead of integer values to represent seconds

Fixed

• Replaces local references from development repositories to online versions
• Updates and improves documentation due new pub.dev requirements

Improved

• Android core dependencies moved to new repository
• Added new native module switcher to avoid the folder copy at example/android folder.
• Added new test cases for actionType property

Added

• Added translation feature to notifications based on app configurations or custom configurations
• Added "AwnAppGroupName" property to "Info.plist" to support custom App Group names on iOS
• Added support for inexact schedules, allowing notifications to be scheduled at approximate times rather than exact times
• Added "delayTolerance" parameter to schedules to provide a tolerance for delayed notifications (in seconds)
• Added methods to API to list all active notification IDs and check if a notification ID is * * currently active
• Achieved 97.7% test coverage with new test cases for all relevant classes

Improved

• SQLite database to replace SharedPreferences on Android
• Ability for displayed notification events to fire in the exact amount that they had displayed to the user, even with the same ID
• Example app with ReceivePort and SendPort

Fixed

• schedule map conversions for interval notifications with repeat option on Android
• onCreated and onDisplayed calling events for Notification Target Extensions on iOS

• Adds single page example on pub.dev
• Fixes background action definition labels for iOS
• Fixes getInitialNotificationAction for larger projects with intense initial loading
• Ensures notifications with reply buttons do not close the status bar after sending text messages
• Updates and improves documentation

• Updates Discord markdown links on pub.dev

• Adds badge parameter into notification's content to set the app badge value through notifications
• Adds deep merge method into MapUtils to allow notification content combinations
• Increases Flutter minimal version to 2.14 due to DecoderCallback deprecation
• Updates and improves documentation

• Upgrades Media Style dependencies

• Decreases Flutter SDK dependency from 2.18 to 2.12 to support old Flutter applications
• Adds switch imports for Dart:io and Dart:html to improve web support
• Updates Awesome web portal URLs

• Initial release of Awesome Notifications version 0.7.0

• Updates iOS core dependency to version 0.7.1 to match FCM add-on plugin

• Adds new Flutter plugin architecture to make it compatible with all available platforms
• Extracts Android and iOS core to be reused in remote repositories and other languages

• Fixes to change the plugin domain name

• Makes modifications according to lint warnings to increase pub.dev score

• Decreases Dart support to support version 2.18.0.
• Replaces DecoderCallback with DecoderBufferCallback due to Flutter deprecation for resource images

• Runs dart format over Lib to increase pub.dev score

• Updates Android core dependency to 0.7.0-alpha.7+6

• Fixes out-of-sync definition values between Flutter, Android, and iOS
• Extends coverage to Android 13 (SDK 33), without the new request dialog (temporary)

• Includes the Donate with PayPal section

• Fixes zero being saved instead of the actual handles for silent background actions
• Adds getLifeCycle function to return the current life cycle state of awesome notifications
• Adds optional value for payload data

• iOS notification actions improved to gain more performance and ensure the fast first opening
• iOS notification builder refactored to ensure the ios category creation before the notification being displayed
• iOS notification builder refactored to ensure the completion handle order for push notifications
• Fixes displayOnForeground e displayOnBackground for iOS

• Coverage extended to Android 12L (SDK 32)
• All exceptions have been standardized with distinct exception codes to improve native error handling via PlatformException
• New exception catcher implemented to handle all native exceptions and provide better integration with Firebase Analytics.
• StopForeground method by id was Fixes on Android
• Message layout grouping Fixes (https://github.com/rafaelsetragni/awesome_notifications/pull/466)
• Background actions improved on iOS to hold long tasks
• Background actions improved on iOS to increase UI performance through background threads
• Adds console performance measures for iOS
• Adds warning messages for non implemented layouts on iOS
• Notification's payload attribute changed to support null values
• awesome_notifications_core package renamed to core to reduce import's path length
• Documentation improved

• Fixes NotificationCalendar's inverted error "The time conditions are invalid"
• Documentation improved with new imports and observations with common found issues during beta phase
• Dart source code cleaned to improve pub points

• Fixes empty title and body for messaging layout
• Removed Java cast warnings for cases where's a previous type checking.

• AsyncTask replaced by Handler/Looper due deprecation in Android 12
• FULL_WAKE_LOCK replaced by SCREEN_BRIGHT_WAKE_LOCK to improve battery life in Android
• Implemented research by Android alarm intents to optimize the reschedule process
• Adds id helpers to improve the performance of ScheduleManger's cancellations process in almost 100 times

• Adds dart isolates to allow receiving background notifications without bring the app to foreground
• Adds silentBackground, silentBackgroundAction, disableAction and dismissAction action types for notifications and buttons
• InputField type deprecated, as now is possible to combine input buttons with all other action types. Now, to use InputField, please use the property requireInputText
• Internal architecture rewrote to decrease O.S. interventions, allowing to increase the performance while create and schedules notifications in almost 10 times
• Date objects replaced by Calendar type to enable real time zone operations in native layer
• Adds test unit cases to increase test coverage (55% coverage)
• Network images for foreground services are reactivated
• Upgraded external dependencies to become compatible with Flutter 2.10

• Adds customSound feature for Android (only applicable for versions older than Android 8 (Oreo))
• Type parameter T removed from AwesomeAssertUtils to allows it to be compatible with Flutter web parser.

• Adds rounded images for large icon and big picture
• Adds bool value extraction for Map objects in dart
• Fixes immutable error for input buttons in Android 12
• Network images for foreground services are temporarily disabled (https://github.com/rafaelsetragni/awesome_notifications/issues/369)

• Adds sound extension for notifications with categories Alarm and Call
• Adds call notification behavior (stay floating on screen and keep playing the sound in loop) for Call category
• Adds CancellationManager to reorganize all dismiss and cancellation methods in a single place
• Created StatusBarManager to manage which notifications are currently active, improving performance and extending support to Android 5.0 Lollipop (SDK 21)
• Notification layouts BigPicture, Messaging and MessagingGroup improved to be more performative and to reuses network connection data
• Adds history box to notification's reply buttons on Android 8.0 to 12.0
• iOS swift completion handlers modified to allow display notifications from another plugins

• Adds Channel's Group feature for Android
• Adds notification's category feature for Android
• Adds fullScreenIntent permission and content option to allow to show notifications in full screen mode.
• Adds PreciseAlarms permission and schedule option to allow to show scheduled notifications with more precision.
• Adds showPage methods to provide shortcuts to channel permissions page and alarm permission page.
• Adds shouldShowRationale method for android to check if the requested permissions require user intervention to be enable.
• Adds request permissions methods to demand the users permissions considered dangerous by the system.
• Permission's request methods refactored to enable a more modular and scalable evolution to comport future permissions for Android
• Documentation has been improved with the new permissions methods, channel's group, notification categories, fullScreenIntent and PreciseAlarms permissions

• Java lambda expressions removed to turn Android source compatible with old Java 7

• Update readme file and PermissionManager to be compatible with Android 12 and Java 7

• Adds wakeUpScreen option in notification content to wake up screen when a notification is displayed (Requires to add WAKE_LOCK permission into AndroidManifest.xml).
• Adds custom permissions for method requestPermissionToSendNotifications (has no effect on Android).
• Documentation has been improved with wakeUpScreen option

• Media button receiver removed from AndroidManifest.xml due incompatibility with some Galaxy models and another plugins (#81 and #320)
• Documentation on scheduling notifications has been improved

• PushNotification class deprecated, as all push features are being moved to the new companion plugin. Instead, use NotificationModel.
• Adds isDangerousOption for action buttons, to color the text in red to indicate a dangerous option for the user.
• Adds color option for action buttons, to color the text in Android 8.0 Oreo and beyond (has no effect on iOS).
• Fixes for issue #321, when a new notification is erroneously created when the user taps on notification action button.

• Adds validation to prevent scheduling with repeating intervals smaller than 60 seconds (iOS restriction)
• Adds crontab schedule to allow complex schedules based on initial and expiration date, a list of precise dates, or a crontab expression, and all four options can be combined together (only for Android)
• Defined the final standard to replace negative IDs by random values
• Minimum Android requirements increased to SDK 23 (Android 6.0 Marshmallow) due to new cancellation methods with unsecure procedures on API prior 23

• Adds messaging layout and messaging group layout
• Adds method showNotificationPage to programmatically redirect the user to O.S. notifications permission page
• Minimum Android requirements increased to SDK 21 (Android 5.0 Lollipop) due to new cancellation methods
• Adds new cancellation methods (dismiss, cancel schedules and cancel all (dismiss and schedules at same time))) based on group key or channel key
• Property "autoCancel" changed to "autoDismissable", to match the new cancellation methods naming principles
• Adds internal group key based on ID, to prevent Android auto grouping with 4+ notification from same channel when group key was not specified
• Android channels refactored to keep the original channel key at maximum as possible, maximizing the compatibility with another plugins.
• Models refactored to follow the native standards and transformations from map data
• Calendar millisecond precision has been deprecated, due devices do not provide or ignore such precision.
• Adds error handling for image assets (iOS)
• Adds video tutorial into README file
• Version numbering has changed to better translate the stage of development for future releases.

• Plugin upgraded to support dart Null Safety
• FCM service native support removed for iOS and Android.
• iOS awesome extensions removed.
• Schedule feature downgraded due to iOS official developer's incapacity and SO limitations (could be reactivated manually).
• Adds an example to how to integrate awesome_notification with firebase_messaging plugin.
• Documentation improved

• Flutter version Fixes, according to pub.dev warnings

• Fixes Android first grouped message as summary behaviour.

• Fixes Android canceling for a grouped notification set as summary behaviour
• Adds color hexadecimal representation for json content

• Adds native firebase handling for will present notification method
• Adds fixedDate to getNextDate on iOS
• Adds .aiff example files with more quality
• Adjust weekday to work with ISO 8601

• Adds behavior of bringing action buttons to foreground on iOS
• Adds debug option on initialize method to lower debug verbosity if not necessary
• Improves error messages and error handling for iOS and Android platforms