NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev, #750 most downloaded on pub.dev
A common platform interface for the workmanager plugin.
Latest stable
0.10.5
Last release 2 months ago
07 Sep 2026
Ships unpredictably
gaps range from 4 weeks to 11 months
Nearly every release is documented
notes for 14 of 14 stable releases
Nothing withdrawn
no release was ever pulled
1 years old
14 releases · first in 2025
Drag across the ruler to compare, or tap a release to open it.
chore(release): publish packages — workmanager 0.10.10
chore(release): publish packages — workmanager 0.10.10 (#740)
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.9Your coding agent can read these notes before it upgrades. Set up the MCP server →
New 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:
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.2+1FEAT(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.
This 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 abstract class with all method signaturesWorkmanagerConfig, Constraints, BackoffPolicyNetworkType values: not_required → notRequired, not_roaming → notRoaming, metered → metered (unchanged)OutOfQuotaPolicy values: run_as_non_expedited_work_request → runAsNonExpeditedWorkRequest, drop_work_request → dropWorkRequestOne column per month.