PackageTrack
Sign in Get early access

flutter_foreground_task

This plugin is used to implement a foreground service on the Android platform.

11.0.1 171K downloads/mo #912 most downloaded on pub.dev Dev-hwang/flutter_foreground_task

What this package is like to depend on

Last release 4 days ago

20 Aug 2026

Release timing varies

gaps range from 9 days to 8 months

Nearly every release is documented

notes for 98 of 101 stable releases

Nothing withdrawn

no release was ever pulled

5 years old

101 releases · first in 2021

6 releases in the last 12 months

see the full history below

Release timeline

101 releases · Apr 2021 to Aug 2026
2022 2023 2024 2025 2026
Release Pre-release

Releases

latest 60 of 101
  1. 11.0.1 20 Aug 2026
    Release notes
    • [CHORE] Upgrade shared_preferences from 2.5.3 to 2.5.5
    • [DOCS] Update README
    Open source →
  2. 11.0.0 18 Aug 2026
    Release notes
    • [CHORE] Bump minimum supported SDK version to Flutter 3.44/Dart 3.12
    • [FEAT] Migrate to built-in Kotlin (KGP) #385
    • [FEAT] Support Swift Package Manager (SPM) #387
    • Check migration_documentation for changes
    Open source →
  3. 10.0.0 15 Jul 2026
    Release notes
    • [CHORE] Bump minimum supported SDK version to Flutter 3.38.0
    • [FEAT] Add UIScene life cycle support for iOS #378
    Open source →
  4. 9.2.2 01 Apr 2026
    Release notes
    • [FIX] Resolved frequent ForegroundServiceDidNotStartInTime and ForegroundServiceDidNotStopInTime exceptions by avoiding redundant foreground service start contracts. #377
    Open source →
  5. 9.2.1 03 Mar 2026
    Release notes
    • [FIX] Prevent crash in onDestroy #372
    Open source →
  6. 9.2.0 24 Dec 2025
    Release notes
    • [FEAT] Add allowAutoRestart option, which enables the service to automatically restart if it is terminated by the system.
    • [FEAT] Add stopWithTask option, to ensure service termination when the app UI is dismissed.
    • [FEAT] Add mediaProcessing foreground service type.
    • [FIX] Fix FLAG_STOP_WITH_TASK bitmask check error.
    Open source →
  7. 9.1.0 14 Apr 2025
    Release notes
    • [FEAT] Support manual foregroundServiceType via serviceTypes in startService
    Open source →
  8. 9.0.0 13 Apr 2025
    Release notes
    • [CHORE] Bump minimum supported SDK version to Flutter 3.22/Dart 3.4
    • [CHORE] Bump kotlin_version(1.7.10 -> 1.9.10), gradle(7.3.0 -> 8.6.0) for Android 15
    • [FEAT] Add isTimeout param to the onDestroy callback
    • [FIX] Fix "null object" error #332
    • [FIX] Fix "Reply already submitted" error #330
    • [FIX] Prevent crash by catching exceptions during foreground service start
    • Check migration_documentation for changes
    Open source →
  9. 8.17.0 02 Dec 2024
    Release notes
    • [FEAT] Allow onNotificationPressed to trigger without SYSTEM_ALERT_WINDOW permission
      • Do not use the launchApp function inside the onNotificationPressed callback
      • Instead, use the notificationInitialRoute option of the startService or updateService functions
    Open source →
  10. 8.16.0 01 Dec 2024
    Release notes
    • [BREAKING] Change ServiceRequestResult class to sealed class for improved code readability
    • [BREAKING] Change method for customizing notification icon
    • [FEAT] Add copyWith function for models reuse
    • Check migration_documentation for changes
    Open source →
  11. 8.14.0 20 Nov 2024
    Release notes
    • [FEAT] Support quickboot for HTC devices
    Open source →
  12. 8.13.0 01 Nov 2024
    Release notes
    • [CHORE] Downgrade iOS minimumVersion from 13.0 to 12.0
    Open source →
  13. 8.12.0 29 Oct 2024
    Release notes
    • [FEAT] Add setOnlyAlertOnce option to AndroidNotificationOptions pr-#287
    • [CHANGE] Change notification channel importance from DEFAULT to LOW
    Open source →
  14. 8.11.0 23 Oct 2024
    Release notes
    • [FEAT] Allow sending Set collection using FlutterForegroundTask.sendDataToMain
    Open source →
  15. 8.10.4 04 Oct 2024
    Release notes
    • [FIX] Fixed an issue where main function was called repeatedly when there was no callback to start
    • [FIX] Handle exceptions that occur when service component cannot be found
    Open source →
  16. 8.10.2 02 Oct 2024
    Release notes
    • [FIX] Fixed an issue where exception was thrown when flutterEngine failed to start #282
    • [FIX] Fixed an issue with flutterEngine not being destroyed properly
    Open source →
  17. 8.10.0 24 Sep 2024
    Release notes
    • [BREAKING] Change onStart, onDestroy callback return type from void to Future<void>
      • The onRepeatEvent callback is called when the onStart asynchronous operation has finished
      • Now you can access network, database, and other plugins in onDestroy callback #276
      • Check migration_documentation for changes
    Open source →
  18. 8.9.0 23 Sep 2024
    Release notes
    • [CHANGE] Ignore autoRunOnBoot option when service is stopped by developer
    • [CHANGE] Ignore autoRunOnBoot option when android:stopWithTask is set to true
    • [FEAT] Add TaskStarter to check who started the task #276
      • Add starter parameter to onStart callback of TaskHandler
      • .developer: The task has been started by the developer (startService, restartService, updateService)
      • .system: The task has been started by the system (reboot, app-updates, AlarmManager-restart)
    • [FEAT-iOS] Allow background app refresh
      • Bump iOS minimumVersion to 13.0
      • You need to add BGTaskSchedulerPermittedIdentifiers key in ios/Runner/info.plist file
      • Check Getting started-iOS for more details
    Open source →
  19. 8.8.1 06 Sep 2024
    Release notes
    • [FIX] Fix issue related to openIgnoreBatteryOptimizationSettings #275
    Open source →
  20. 8.8.1+1 09 Sep 2024
    Release notes
    • [DOCS] Update example to see two-way communication flow
    Open source →
  21. 8.8.0 03 Sep 2024
    Release notes
    • [REMOVE] Remove notification permission request code in startService
      • Notification permission request is required before starting the service
      • Check step-4 of readme
    • [FIX-Android] Fix issue with calling onRepeatEvent without waiting for repeat delay after onStart
      • If use the eventAction: ForegroundTaskEventAction.repeat(millis)
      • flow: onStart - (millis) - onRepeatEvent - (millis) - onRepeatEvent..
    Open source →
  22. 8.7.0 01 Sep 2024
    Release notes
    • [FEAT] Allow permission settings page to be opened even if permission is granted
      • openIgnoreBatteryOptimizationSettings()
      • openSystemAlertWindowSettings()
      • openAlarmsAndRemindersSettings()
    Open source →
  23. 8.6.0 28 Aug 2024
    Release notes
    • [BREAKING] Change the way to set the task intervals (for increase scalability)
      • Remove interval, isOnceEvent option in ForegroundTaskOptions model
      • Add eventAction option with ForegroundTaskEventAction constructor
      • Check migration_documentation for changes
    Open source →
  24. 8.5.0 23 Aug 2024
    Release notes
    • [FEAT] Add openAlarmsAndRemindersSettings utility
      • This utility allows the Android OS to immediately restart service in doze mode.
      • required android.permission.SCHEDULE_EXACT_ALARM permission.
      • When you call this function, will be gone to the settings page. So you need to explain to the user why set it.
      • Check utility_documentation for more details.
    • [FEAT] Add canScheduleExactAlarms utility
      • Returns whether the android.permission.SCHEDULE_EXACT_ALARM permission is granted.
      • In some cases, permission is granted automatically. Don't worry :)
    Open source →
  25. 8.4.0 23 Aug 2024

    Nothing published for this version

  26. 8.3.1 21 Aug 2024
    Release notes
    • [FIX] Fixed an issue where Map collection could not be cast in onReceiveData #258
    Open source →
  27. 8.3.0 09 Aug 2024
    Release notes
    • [FEAT] Add showBadge option to AndroidNotificationOptions.
    • [DEPRECATED] Deprecated AndroidNotificationOptions.id. Use startService(serviceId) instead.
    • [DOCS] Separate models, utility, migration documentation.
    Open source →
  28. 8.2.0 07 Aug 2024
    Release notes
    • [CHORE-AOS] Down Android minSdkVersion to 21
    Open source →
  29. 8.1.0 06 Aug 2024
    Release notes
    • [FIX-AOS] Fixed an issue where notification text was not visible on Android 7.1 and below
    • [FEAT-iOS] Implement onNotificationButtonPressed
    • [FEAT-iOS] Implement onNotificationPressed
    • [FEAT-iOS] Implement onNotificationDismissed
    • [FEAT-iOS] Implement notification permission request and check function
      • Request notification permission in the Example._requestPermissions function
    Open source →
  30. 8.0.0 23 Jul 2024
    Release notes
    • [BREAKING] Redesign the communication method between TaskHandler and UI
      • Fixed an issue where SendPort.send does not work when calling receivePort getter function after app restart #244
      • Allow task data to be listened on multiple pages
      • Check migration_documentation for changes
    Open source →
  31. 7.5.2 22 Jul 2024
    Release notes
    • [FIX] Fixed an issue that caused poor performance and delays in TaskHandler
    • [FIX-iOS] Fixed an issue where onDestroy was not called when an app was closed in recent apps
    Open source →
  32. 7.5.0 19 Jul 2024
    Release notes
    • [FEAT] Support notificationText with multiple lines #182
    • [REMOVE] Remove WillStartForegroundTask widget
      • This widget is designed to start a service when the app is minimized.
      • This widget had an ambiguous purpose, it caused a lot of problems because the widget controlled the service.
      • These issues have led me to remove this widget. Please implement it yourself if necessary.
    Open source →
  33. 7.5.0+1 21 Jul 2024
    Release notes
    • [DOCS] Update readme
      • Update documentation on how to pass timestamp to UI isolate
      • Update WithForegroundTask documentation comments
    Open source →
  34. 7.4.3 18 Jul 2024
    Release notes
    • [FEAT-Recommended] Improve restart alarm that occurs when the service terminates abnormally
    Open source →
  35. 7.4.2 18 Jul 2024
    Release notes
    • [FIX] Fixed an issue where notification events were handled on both when using plugin in multiple apps #137
    • [FIX] Fixed an issue where the service did not restart when Android OS forcibly terminated the service #223
    Open source →
  36. 7.4.0 18 Jul 2024
    Release notes
    • [FEAT] Add result class to handle service request errors
      • The return value of service request functions changed from boolean to ServiceRequestResult
    • [FEAT] Add function to send data to TaskHandler
      • You can send data from UI to TaskHandler using FlutterForegroundTask.sendData function
    Open source →
  37. 7.2.0 16 Jul 2024
    Release notes
    • [FEAT] Add ability to restart service when app is deleted from recent app list
      • To restart service on Android 12+, you must allow the REQUEST_IGNORE_BATTERY_OPTIMIZATIONS permission
    • [REMOVE] Remove isSticky from AndroidNotificationOptions
      • The isSticky option is automatically set by the service based on the Manifest android:stopWithTask
    Open source →
  38. 7.1.0 14 Jul 2024
    Release notes
    • [FEAT-Recommended] Allow updateService to be processed without service restart
    Open source →
  39. 7.0.0 13 Jul 2024
    Release notes
    • [CHORE] Updates minimum supported SDK version to Flutter 3.10 / Dart 3.0
    • [BREAKING] Change timezone(local > UTC) of timestamp in TaskHandler callback
    • [BREAKING] Remove iconData, buttons from AndroidNotificationOptions
    • [FEAT] Add ability to update notification icon and buttons for Android platform
    • [FEAT] Add onNotificationDismissed callback for Android 14
    Open source →
  40. 6.5.0 12 Jun 2024
    Release notes
    • [CHORE] Bump Android minSdkVersion to 23
    • [FIX] Fixed an issue where notification actions did not work on Android 14
    Open source →
  41. 6.4.0 04 Jun 2024
    Release notes
    • [REMOVE] Remove foregroundServiceType option
    • [FEAT] Add autoRunOnMyPackageReplaced option
    Open source →
  42. 6.3.0 04 Jun 2024
    Release notes
    • [FEAT] Add option to allow multiple foregroundServiceType
    • [DOCS] Update readme
    Open source →
  43. 6.2.0 25 Apr 2024
    Release notes
    • [FEAT] Support AGP 8
    • [FEAT] Add foregroundServiceType option to specify foreground service type on Android 14 and higher
    Open source →
  44. 6.1.3 16 Feb 2024
    Release notes
    • [DOCS] Update readme #192
    • [CHORE] Remove platform dependency
    • [CHORE] Update dependencies
    Open source →
  45. 6.1.2 13 Sep 2023
    Release notes
    • [FIX] Fix issue where SecurityException occurred when registering runtime receiver #175
    Open source →
  46. 6.1.1 24 Aug 2023
    Release notes
    • [TEST] Add assertions to service options
    Open source →
  47. 6.1.0 22 Aug 2023
    Release notes
    • [BREAKING] Remove future return of TaskHandler callback function
    • [FIX] Fix issue where isRunningService is not updated after calling onDestroy
    • [FIX] Fix storage data not syncing between isolates
    • [FIX] Fix the service could not be started when the notification channel information is empty
    • [CHORE] Upgrade dependencies - shared_preferences
    Open source →
  48. 6.0.0 02 Jun 2023
    Release notes
    • [BREAKING] Rename the callback function to clarify what information the event provides
      • Rename onButtonPressed to onNotificationButtonPressed
      • Rename onEvent to onRepeatEvent
    • [FEAT] Add textColor option to NotificationButton
    • [FEAT] Add ability to change task options while service is running
    Open source →
  49. 6.0.0+1 12 Jun 2023
    Release notes
    • [REFACTOR] Move required permissions on the Android platform inside the plugin
    Open source →
  50. 5.2.1 31 May 2023
    Release notes
    • [FIX] Fix issue where service could not be started in the background
    Open source →
  51. 5.2.0 23 May 2023
    Release notes
    • [FEAT] Add id option to AndroidNotificationOptions
    • [FEAT] The WillStartForegroundTask widget supports receiving data
    Open source →
  52. 5.0.0 22 May 2023
    Release notes
    • [CHORE] Update dependency constraints to sdk: '>=2.18.0 <4.0.0' flutter: '>=3.3.0'
    • [FEAT] Add notification permission request func for Android 13
      • FlutterForegroundTask.checkNotificationPermission()
      • FlutterForegroundTask.requestNotificationPermission()
    • [DOCS] Update documentation to the latest version
    • [FIX] Fix service not starting when notification permission is denied
    Open source →
  53. 4.2.0 18 May 2023
    Release notes
    • [FEAT] Add notification permission request func for Android 13
      • According to the official documentation, starting with Android 13 and higher, you need to request notification permission to expose foreground service notifications.
      • In this version, notification permission requests occur when the startService function is called.
      • Add <uses-permission android:name="android.permission.POST_NOTIFICATIONS" /> permission to your AndroidManifest.xml file.
    Open source →
  54. 4.1.0 17 Feb 2023
    Release notes
    • [CHORE] Bump Android coroutines version to 1.6.4
    • [CHANGE] Change the way get receivePort from asynchronous to synchronous #128
      • Can register and get receivePort without starting the service.
      • From now on, register receivePort before starting the service. Please check the readme and example.
    • [FIX] Fix issue where the results of the service start and stop functions did not match the service status
    Open source →
  55. 4.0.1 07 Feb 2023
    Release notes
    • [FIX] Fix mounted error #133
    Open source →
  56. 4.0.0 07 Feb 2023
    Release notes
    • [CHORE] Bump Android Gradle version to 7.1.2
    • [CHORE] Update minimum Flutter version to 3.0.0 #130 #131
    • [DOCS] Update readme #125
    Open source →
  57. 3.10.0 25 Sep 2022
    Release notes
    • [FEAT] Add isOnceEvent option to ForegroundTaskOptions.class.
    • [DOCS] Add entry-point pragma.
    • [REFACTOR] Refactor code using plugin_platform_interface.
    Open source →
  58. 3.9.0 14 Sep 2022
    Release notes
    • [FEAT] Add allowWakeLock option to ForegroundTaskOptions.class.
    • [FEAT] Add forceOpen option to openSystemAlertWindowSettings().
    Open source →
  59. 3.8.2 16 Aug 2022
    Release notes
    • Fix issue with SharedPreferences won't provide updated data from main isolate while running on background. Thanks @h2210316651
    Open source →
  60. 3.8.1 19 Jul 2022
    Release notes
    • Fix issue where sendPort returned null when restartService called.
    Open source →

Every package, every release, already written down.

The archive is open and free. Watching your own project is what we are building next.

Browse the archive