workmanager_android

workmanager_android v0.10.7 — manifest-declaration check for FGS permissions (#731, #733)

• Expedited work (and other foreground-service features) now validate against the merged manifest declaration instead of the runtime permission grant state.
• On Android 16+ a foreground-service permission can be revoked or denied at runtime even when declared — the old check then false-positived and threw, killing valid expedited work. Declared permission now passes regardless of grant state; a genuinely missing declaration still fails loudly at registration.

workmanager v0.10.8

• Dependency bump: workmanager_android ^0.10.7.

chore(release): publish packages — workmanager 0.10.9 (#736)

• FIX(android): one-off work no longer stays RUNNING forever on Android 16 when the app is backgrounded during task execution (#732).

2026-08-19

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• workmanager - v0.10.8
• workmanager_android - v0.10.7

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.8

• FIX(android): one-off work no longer stays RUNNING forever on Android 16 when the app is backgrounded during task execution (#732).

chore(release): publish packages — workmanager 0.10.8 (#734)

• FIX(android): expedited work no longer fails when Android 16 revokes a foreground-service permission at runtime (#731).

2026-08-04

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• workmanager - v0.10.7
• workmanager_android - v0.10.6
• workmanager_web - v0.2.0

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.7

• FIX(android): expedited work no longer fails when Android 16 revokes a foreground-service permission at runtime (#731).

• chore(release): publish packages

• [email protected]
• [email protected]
• [email protected]

• docs: fix work-info wording, document FGS opt-in + web messaging

• work-info.mdx: replace 'the maintainer explicitly declined to surface
  it' with a neutral design statement (docs.page garbling).
• troubleshooting.mdx: new section for the Play Console
  FOREGROUND_SERVICE_DATA_SYNC declaration/video requirement — what it
  means, when to opt in, and that a missed opt-in throws at registration.
• web.mdx: document the page<->worker messaging API (sendMessageToWorker,
  workerMessages, sendToPage) and link the live demo.
• workmanager_impl.dart: dartdoc note + docs.page link on
  registerOneOffTask's foregroundServiceConfig (dataSync opt-in).

• FIX(android): make FOREGROUND_SERVICE_DATA_SYNC opt-in (#725).
• FEAT(android): fail loudly when a foreground service permission is missing from the merged manifest.

• FIX(android): build with AGP 9 and android.builtInKotlin=false (#722).

2026-08-03

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• workmanager - v0.10.5
• workmanager_android - v0.10.4
• workmanager_apple - v0.9.10
• workmanager_platform_interface - v0.10.4
• workmanager_linux - v0.1.1+1
• workmanager_web - v0.1.3+1

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_linux - v0.1.1+1
• workmanager_web - v0.1.3+1

• FIX(android): build with AGP 9 and android.builtInKotlin=false (#722).

• FEAT(android): progress updates for long-running tasks (#720).

• FEAT: work status observation — getWorkInfo across platforms (fixes #194) (#719).

• FEAT(android): expedited work support (#715).

• FEAT(android): add ContentUriTrigger constraints (fixes #413) (#709).

• BREAKING FEAT: align minimum Flutter version to 3.38 across packages (prep for 0.10.0) (#701).

Note: This release has breaking changes.

• BREAKING FEAT: align minimum Flutter version to 3.38 across packages (prep for 0.10.0) (#701).

• FIX(android): notify running callbacks when work is cancelled (fixes #432) (#705).

• FIX(android): AGP 9 built-in Kotlin compilerOptions (#711).

2026-08-02

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• workmanager - v0.10.1
• workmanager_web - v0.1.1

• FIX(android): AGP 9 built-in Kotlin compilerOptions (#711).

• FIX(ios): run one-off tasks on the main engine to avoid release crash (fixes #653) (#697).
• FEAT(ios): add BGContinuedProcessingTask support (fixes #638) (#700).
• FEAT(android): long-running workers via foreground service (#698).

• FEAT(ios): add BGContinuedProcessingTask support (fixes #638) (#700).
• FEAT(android): long-running workers via foreground service (#698).

• FEAT(ios): add BGHealthResearchTaskRequest support (fixes #532) (#693).

• FEAT: support typed Lists/Maps in inputData (fixes #426) (#690).
• FEAT: macOS support via NSBackgroundActivityScheduler (fixes #424) (#689).

• FEAT: support typed Lists/Maps in inputData (fixes #426) (#690).

• FIX(ios): auto-register BGTask launch handlers for scheduled tasks (#692).

• FIX(android): honor initialDelay for periodic tasks without a flex window (#691).

• REFACTOR: replace debug mode with extensible hook-based system (#630).
• REFACTOR: Migrate internal interfaces to pigeon (#613).
• FIX: resolve critical null handling crashes from contributor reports (#626).
• FEAT: Migrate to federated plugin architecture (#611).
• BREAKING FIX: resolve issue #622 - periodic tasks running at incorrect frequencies (#628).

Note: This release has breaking changes.

• REFACTOR: replace debug mode with extensible hook-based system (#630).
• REFACTOR: Migrate internal interfaces to pigeon (#613).
• FIX: resolve critical null handling crashes from contributor reports (#626).
• FEAT: Migrate to federated plugin architecture (#611).
• BREAKING FIX: resolve issue #622 - periodic tasks running at incorrect frequencies (#628).

• FIX: prevent NullPointerException in BackgroundWorker.getDartTask (#636).

• FIX: Android initialization bug and iOS 14 availability annotations (#647).

• FIX: remove kotlin-android since AGP 9 supports it https://github.com/fluttercommunity/flutter_workmanager/issues/667 (#682).
• FIX: Failed host lookup, by bumping androidx.work:work-runtime to 2.11.2 and Android minSdkVersion to 23 (#679).
• FIX: NullPointerException by replacing companion FlutterLoader with FlutterInjector singleton (#678).

Initial Release

• BREAKING: Migrate to federated plugin architecture
• Initial release of the Android implementation
• Implement all WorkmanagerPlatform methods for Android
• Support for one-off and periodic tasks using WorkManager API
• Migrate from be.tramckrijte to dev.fluttercommunity namespace

Breaking Changes

• BREAKING: Enum values changed from snake_case to camelCase:
  • NetworkType values: not_required → notRequired, not_roaming → notRoaming, metered → metered (unchanged)
  • OutOfQuotaPolicy values: run_as_non_expedited_work_request → runAsNonExpeditedWorkRequest, drop_work_request → dropWorkRequest
• BREAKING: Removed JSON serialization for inputData - now uses native Map transfer

New Features

• Add isScheduledByUniqueName method to check if a periodic task is scheduled by its unique name
• Support for constraints: network type, battery not low, charging, device idle, storage not low
• Support for backoff policies: linear and exponential
• Added comprehensive integration tests

Bug Fixes

• Fixed NullPointerException when isInDebugMode was not properly initialized
• Fixed inputData type handling - now properly supports all primitive types and lists
• Fixed v2 embedding import in BackgroundWorker

Improvements

• Updated to Android target SDK 35
• Updated Android dependencies to latest versions
• Improved CI/CD with Android emulator caching
• Better error handling and type safety
• Fix documentation formatting and typo in BackgroundWorker