NewYour coding agent can read the release notes before it upgrades.Set up the MCP server β
pub.dev
pub.dev, #698 most downloaded on pub.dev
Flutter Workmanager. This plugin allows you to schedule background work on Android and iOS.
Latest stable
0.10.10
Last release 2 months ago
07 Sep 2026
Release timing varies
gaps range from 2 weeks to 1.7 years
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
69 releases Β· first in 2019
Drag across the ruler to compare, or tap a release to open it.
Background tasks no longer fail ~30 seconds after start on Android 16 when the Dart isolate is slow to boot. Root cause: the Pigeon migration inverted
notifyBackgroundChannelInitialized), which only then invokes the task. Race eliminated by construction; the 30s watchdog stays as a dead-engine guard.notifyBackgroundChannelInitialized backing the handshake fix.Your coding agent can read these notes before it upgrades. Set up the MCP server β
workmanager_android v0.10.8 β bounded Dart engine init, main-thread stops ( #732 , #735 )
onTaskStopped callbacks) now run on the main thread β fixes the spurious @UiThread exception notification on every cancel and makes the #705 stop-reason feature actually fire on Android.workmanager_android ^0.10.8.chore(release): publish packages β workmanager 0.10.8
chore(release): publish packages β workmanager 0.10.8 (#734)
workmanager_android ^0.10.7.Packages with breaking changes:
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
workmanager - v0.10.8Free-form two-way postMessage channel: sendMessageToWorker() / workerMessages / sendToPage.
postMessage channel: sendMessageToWorker() / workerMessages / sendToPage.FOREGROUND_SERVICE_DATA_SYNC + the dataSync service type are no longer in the merged manifest by default (Play Console special type: declaration + demo video requirement even when unused).workmanager.enableDataSyncForegroundService=true in gradle.properties.dataSync without the opt-in (or expedited work with a stripped manifest) throws a descriptive error at registration instead of a SecurityException mid-task.workmanager_android ^0.10.6, workmanager_web ^0.2.0.Packages with breaking changes:
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
workmanager - v0.10.7The plugin failed to evaluate on AGP 9 with Flutter's default android.builtInKotlin=false (Could not find method kotlin()); 0.9.x failed even harder (
android.builtInKotlin=false fix (#722)android.builtInKotlin=false (Could not find method kotlin()); 0.9.x failed even harder (plugin class never compiled).kotlin-android whenever built-in Kotlin is not active β AGP < 9, or android.builtInKotlin != true β matching AGP 9's own defaults (built-in Kotlin on by default). Same pattern flutter_timezone 5.1.0 ships. Thanks @EdwynZN (#721).workmanager_android ^0.10.5.Workmanager().reportProgress(Map) from inside the handler (uniqueName threaded through the worker context) + setProgressListener((uniqueName, progress
Workmanager().reportProgress(Map) from inside the handler (uniqueName threaded through the worker context) + setProgressListener((uniqueName, progress) {}) for the app side. Wired to WorkManager setProgressAsync + LiveData observation with catch-up on relaunch.notifyBackgroundChannelInitialized host signal backing the Android handshake fix (#738).Packages with breaking changes:
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
workmanager - v0.10.9New platform package: systemd-based background execution for Linux.
New platform package: systemd-based background execution for Linux.
systemd-run --user units; periodic tasks as .timer/.service pairs with Persistent=true (catch-up on missed runs).WorkmanagerLinux.maybeRunBackgroundTask(args, callbackDispatcher) from main() runs the task without a window and exits with a journal-friendly exit code.--payload.loginctl enable-linger for timer persistence).Platform.isLinux β WorkmanagerLinux); dependency on workmanager_linux ^0.1.1.New cross-platform API: Workmanager().getWorkInfo(uniqueName) β WorkInfo? (uniqueName, WorkState scheduled/running/succeeded/failed/cancelled, isPerio
New cross-platform API: Workmanager().getWorkInfo(uniqueName) β WorkInfo? (uniqueName, WorkState scheduled/running/succeeded/failed/cancelled, isPeriodic, taskName, tags, lastFinishedAt).
WorkInfoStore) fed by the existing status pipeline β same API, honest semantics.null).Also: .swiftlint.yml thresholds aligned with the codebase (CI swiftlint image drifted and started failing on pre-existing style debt).
feat: expedited work support β expedited: true on registerOneOffTask calls setExpedited(), making OutOfQuotaPolicy actually take effect (Android 12+;
expedited: true on registerOneOffTask calls setExpedited(), making OutOfQuotaPolicy actually take effect (Android 12+; runs as a foreground service with a system notification). One-off only (WorkManager limitation).outOfQuotaPolicy implicitly expedited the work (a side effect of the old setExpedited(OutOfQuotaPolicy) call). It is now inert without expedited: true β set the flag explicitly.FEAT(web): service worker based background execution (experimental) (#707) β workmanager_web 0.1.1
Packages:
Full changelogs:
fix: AGP 9 built-in Kotlin compilerOptions (#711) β replaces the removed android.kotlinOptions with the AGP 9 compilerOptions DSL, fixing builds on AG
android.kotlinOptions with the AGP 9 compilerOptions DSL, fixing builds on AGP 9 + android.builtInKotlin=true.feat: ContentUriTrigger constraints (fixes #413, #709) β register one-off/periodic tasks that run when a content URI (or its descendants) changes, e.g
Constraints(contentUriTriggers: [...]) + ContentUriTrigger API; guarded to API 24+.> β οΈ Breaking change: this release raises the minimum Flutter version from 3.32 to 3.38 for workmanager, workmanager_android, and workmanager_platformβ¦
β οΈ Breaking change: this release raises the minimum Flutter version from 3.32 to 3.38 for
workmanager,workmanager_android, andworkmanager_platform_interface.
Packages:
Full changelogs:
FIX(android): notify running callbacks when work is cancelled (fixes #432) (#705) β workmanager 0.10.0+1, workmanager_android 0.10.0+1
Packages:
Full changelogs:
FEAT(ios): add BGContinuedProcessingTask support (fixes #638) (#700) β workmanager_apple 0.9.6
Packages:
Full changelogs:
Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
FEAT(ios): add UIScene lifecycle support (fixes #662) (#696) β workmanager_apple 0.9.5
Packages:
Full changelogs:
Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
workmanager - v0.9.1workmanager_android - v0.9.1workmanager_apple - v0.9.3Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
workmanager - v0.9.1+1workmanager_android - v0.9.1+1workmanager_apple - v0.9.3+1Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
workmanager - v0.9.1+2`isInDebugMode` parameter is deprecated in Workmanager().initialize()
This release introduces a major upgrade to the debugging experience with an extensible hook-based system, eliminating the risk of debug notifications appearing in production apps while providing better task lifecycle visibility.
isInDebugMode parameter is deprecated in Workmanager().initialize()
WorkmanagerDebug.setCurrent()registerPeriodicTask now uses ExistingPeriodicWorkPolicy
ExistingWorkPolicy parameter with ExistingPeriodicWorkPolicyNotificationDebugHandler - Shows task status as notifications with configurable channelsLoggingDebugHandler - Writes task events to system logTaskStatus.SCHEDULED - Tasks are now tracked when first scheduledTaskStatus.RESCHEDULED - Better visibility into task retry behaviorKEEP to UPDATEUPDATE ensures new task configurations replace existing onesrunAttemptCount to properly identify retrying tasksSpecial thanks to @Dr-wgy, @jonathanduke, @Muneeza-PT, and all contributors who helped identify and resolve critical issues!
FIX: Android initialization bug and iOS 14 availability annotations (#647).
This release fixes critical issues with Android initialization and iOS build compatibility.
This release fixes critical issues with Android initialization and iOS build compatibility.
Android: Fixed PlatformException "You have not properly initialized the Flutter WorkManager Package" on first run (#645)
currentDispatcherHandle when initialize() is callediOS: Fixed build errors with Logger availability (#641)
LoggingDebugHandlerworkmanager v0.9.0+3workmanager_android v0.9.0+2workmanager_apple v0.9.1+2workmanager_platform_interface v0.9.1+1Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
workmanager - v0.9.0+4workmanager_android - v0.9.0+3workmanager_apple - v0.9.2workmanager_platform_interface - v0.9.2workmanager - v0.9.0+4workmanager_android - v0.9.0+3workmanager_apple - v0.9.2workmanager_platform_interface - v0.9.2This release represents a major architectural change to the flutter_workmanager plugin, migrating to a federated plugin structure for better platform
This release represents a major architectural change to the flutter_workmanager plugin, migrating to a federated plugin structure for better platform extensibility and maintainability.
workmanager_platform_interface - Shared platform interfaceworkmanager_android - Android WorkManager implementationworkmanager_apple - iOS BGTaskScheduler implementation (renamed from workmanager_ios)workmanager - Main package with unified APINetworkType: not_required β notRequired, not_roaming β notRoamingOutOfQuotaPolicy: run_as_non_expedited_work_request β runAsNonExpeditedWorkRequest, drop_work_request β dropWorkRequestisScheduledByUniqueName method to check if a periodic task is scheduledinitialDelaySeconds parameter handling - was previously ignoredisInDebugMode was not properly initializedprintScheduledTasks now returns String instead of void (#585)Special thanks to @thegriffen, @jogapps, @navaronbracke, @yarith28, and all contributors who helped make this release possible!
workmanager_platform_interface for shared platform interfaceworkmanager_android package with Android WorkManager implementationworkmanager_apple package with iOS BGTaskScheduler implementationNetworkType values: not_required β notRequired, not_roaming β notRoaming, metered β metered (unchanged)OutOfQuotaPolicy values: run_as_non_expedited_work_request β runAsNonExpeditedWorkRequest, drop_work_request β dropWorkRequestisScheduledByUniqueName method to check if a periodic task is scheduled by its unique name (Android only)initialDelaySeconds parameter handling - was previously ignoredisInDebugMode was not properly initializedMinimum Dart SDK: 3.2.0 (was 3.1.2)
See CHANGELOG.md for full details.
This release brings the plugin up to current Flutter/Dart standards while maintaining all existing functionality.
Android: Removed V1 plugin APIs - this is now a Android V2 plugin only
Android: Bump to workmanager 2.8.1
Call DartPluginRegistrant.ensureInitialized when isolate is starting
Various stability improvements and new features for iOS
pedantic checks with flutter_lintsiOS: Add implementations for cancelCall and cancelByUniqueName
OutOfQuotaPolicy needs to be specified)Android: Use Number type for specifying the callback handler key & convert to Long
Number type for specifying the callback handler key & convert to LongrequiresNetworkConnectivity correctly.Resolves issues on iOS which prevented native calls from being parsed correctly.
Resolve a null pointer error in BackgroundWorker
Replace _noDuration variable with Duration.zero directly
Duration.zero directly (#283)Documentation for BGTaskScheduler added
iOS: Modern-style task processing using BGTaskScheduler is now supported. Please see the updated instructions in IOS_SETUP.md.
Android: Load Flutter environment asynchronously in the Worker task
Bumps Android dependencies (Kotlin, AGP, workmanager 2.5.0)
The package now supports null-safety
BREAKING CHANGE: The Dart side is now instantiated using the factory pattern for easier mocking & testing.
Restore iOS compatibility for Flutter 1.20
Define iOS module so that host apps without use_frameworks! setting can consume the iOS module
Fix crash when FlutterEngine would be destroyed twice
Cleanup FlutterEngine when job is stopped or cancelled #140,
Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
workmanager - v0.10.6Android v2 embedding.The result was not correctly mapped to a RETRY when returning false from a background task
Using Backoff Policy in conjunction with device idle constraint is an illegal action. Backoff policy is now nullable in the Android code. See issue #1
Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
workmanager - v0.10.2workmanager_android - v0.10.2workmanager_apple - v0.9.8workmanager_platform_interface - v0.10.2workmanager_web - v0.1.2BackgroundTaskHandler now correctly returns to background method channeliOSPerformFetch method now no longer crashessetPluginRegistrantCallback as described in our docs, making it possible to access other plugins during a backround fetchPackages with breaking changes:
Packages with breaking changes:
Packages with other changes:
workmanager_android - v0.10.1workmanager_apple - v0.9.7workmanager_platform_interface - v0.10.1workmanager - v0.10.1+2workmanager_web - v0.1.1+1Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
workmanager - v0.10.1+2workmanager_web - v0.1.1+1Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
workmanager - v0.10.3workmanager_android - v0.10.3workmanager_apple - v0.9.9workmanager_platform_interface - v0.10.3workmanager_web - v0.1.3Improved debug notification with result message first
iOS: π Make sure all the implementers plugins are available in the background isolate by registering them first. This requires the user to provide us
AppDelegateiOS performBackgroundFetch now actually works.
[βΌοΈ BREAKING change] You will need to clear the preferences or re-install the App if you had registered jobs already on Android.
π expose setPluginRegistrantCallback to the old rusty Java people
setPluginRegistrantCallback to the old rusty Java peopleEverything now refers to the top level callback as the *callbackDispatcher*
NetworkTypesrc folderI should test a little better before publishing to pub.dev.
ExistingWorkPolicy and BackoffPolicyA bugfix were parsing the BackOffPolicy was still wrong.
BackOffPolicy was still wrong.A bugfix were parsing of the ExistingWorkPolicy and BackoffPolicy went rogue. Addresses #9
ExistingWorkPolicy and BackoffPolicy went rogue. Addresses #9One column per quarter.