NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev, #756 most downloaded on pub.dev
Android implementation of the workmanager plugin.
Latest stable
0.10.9
Last release 2 months ago
07 Sep 2026
Ships unpredictably
gaps range from 2 weeks to 11 months
Nearly every release is documented
notes for 21 of 21 stable releases
Nothing withdrawn
no release was ever pulled
1 years old
21 releases · first in 2025
Drag across the ruler to compare, or tap a release to open it.
One-off work no longer stays RUNNING forever on Android 16 when the app is backgrounded mid-task: a new 30-second initialization watchdog fails the wo
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.Your coding agent can read these notes before it upgrades. Set up the MCP server →
workmanager_android v0.10.7 — manifest-declaration check for FGS permissions ( #731 , #733 )
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.8chore(release): publish packages — workmanager 0.10.8
chore(release): publish packages — workmanager 0.10.8 (#734)
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.7chore(release): publish packages
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:
> ⚠️ 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:
Note: This release has breaking changes.
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:
Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
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:
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+1`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!
Note: This release has breaking changes.
FIX: prevent NullPointerException in BackgroundWorker.getDartTask (#636).
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+1This 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!
WorkmanagerPlatform methods for Androidbe.tramckrijte to dev.fluttercommunity namespaceNetworkType 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 nameisInDebugMode was not properly initializedOne column per month.