NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev
Manage background execution on Android, iOS, macOS, Windows and Linux - OEM auto-start settings, battery optimization, exact alarms, boot callbacks and scheduled headless tasks.
Latest stable
1.6.0
Last release 29 days ago
24 Oct 2026
Ships unpredictably
gaps range from 1 weeks to 9 months
Most releases are documented
notes for 25 of 32 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
34 releases · first in 2021
Drag across the ruler to compare, or tap a release to open it.
Deprecated (still working): every original top-level function (getAutoStartPermission, isAutoStartAvailable, scheduleTask, ...) is now @Deprecated and…
AutoStart class with consistent names and richer results. Methods that open settings return SettingsResult (opened, notAvailable, unsupported, failed) and AutoStart.scheduleTask returns ScheduleResult (scheduled, exactAlarmDenied, invalidCallback, unsupported, failed). Nothing throws.getAutoStartPermission, isAutoStartAvailable, scheduleTask, ...) is now @Deprecated and delegates to AutoStart, with the same signatures and bool results, so existing code keeps compiling. See the README migration table.AutoStart.cancelTask(taskId) and AutoStart.getScheduledTaskIds() on Android, iOS, macOS, Linux and Windows (getScheduledTaskIds enumerates Task Scheduler entries).AutoStart.completeBackgroundTask() releases a headless engine when the callback finishes.AutoStart.getStatus() returns a BackgroundStatus snapshot (manufacturer, auto-start, battery optimization, exact alarms).AutoStartFlutterPlatform (previously a dead template layer on a different channel name), so the plugin can be faked in tests.canScheduleExactAlarms fails closed on real errors.completeBackgroundTask() or after 5 minutes) instead of leaking, and goAsync() plus an optional wake lock (only used if your app declares WAKE_LOCK; the plugin declares no permissions) keep the process alive while the Dart callback runs from the boot/alarm receivers.EXACT_ALARM_DENIED; task ids no longer collide; disableBatteryOptimization no longer crashes when no activity can handle the intent.systemctl --user and use UTC consistently.executeInBackground spawns the isolate through a top-level entry point and initialises the background binary messenger, so plugins that support background isolates now work inside the callback.executeInBackground now have this plugin attached, so completeBackgroundTask() releases them.strict-casts, strict-raw-types and public_member_api_docs, expanded tests, and moved the example to the new API.Your coding agent can read these notes before it upgrades. Set up the MCP server →
Android: Removed deprecated package attribute from AndroidManifest.xml.
canScheduleExactAlarms() and openExactAlarmSettings() APIs to check and navigate to system "Alarms & reminders" settings for exact background alarms.openBatteryOptimizationSettings() navigating to the standard system battery optimization screen (ACTION_IGNORE_BATTERY_OPTIMIZATION_SETTINGS), providing a 100% Google Play policy-safe alternative to direct dialog prompts.kotlin-android and uses jvmToolchain(17).android.newDsl=false to stay compatible with AGP 9 DSL changes.jcenter() repository from Gradle configuration.package attribute from AndroidManifest.xml.getPlatformVersion handler and verified Android unit tests.openBatteryOptimizationSettings across iOS, macOS, Windows, and Linux.!kIsWeb safeguards to prevent UnsupportedError when running in web-enabled Flutter projects.--android-skip-build-dependency-validation so builds pass on modern Flutter toolchains.canScheduleExactAlarms, openExactAlarmSettings, and openBatteryOptimizationSettings.Major Feature (Phase 3): Added executeInBackground API for immediate, headless execution of Dart callbacks without attaching a UI.
executeInBackground API for immediate, headless execution of Dart callbacks without attaching a UI.
FlutterEngine to run background tasks efficiently without disruption.FlutterEngine via FlutterCallbackCache to run tasks headlessly.Isolate.spawn API natively.executeInBackground behavior and required permission contexts for Phase 3 background tasks.Feature (Phase 2 - Apple): Added scheduleTask implementation for iOS and macOS natively using UNUserNotificationCenter for precise local notifications
scheduleTask implementation for iOS and macOS natively using UNUserNotificationCenter for precise local notifications.getLaunchArguments for iOS and macOS to capture notification payloads when the app receives a scheduled task trigger.Improvement (Android): Refined isAutoStartPermission logic to query actual intent resolution via Package Manager, ensuring more accurate availability
isAutoStartPermission logic to query actual intent resolution via Package Manager, ensuring more accurate availability reporting.LNK2001) and narrowing conversion warnings (C4244).Log import.Breaking Change (Opt-in Permissions): Removed all default permissions from the library manifest. Developers must now manually add permissions (e.g., R…
scheduleTask API to schedule top-level Dart callbacks at specific times.
AlarmManager for exact alarms even in Doze mode.getLaunchArguments to detect if the app was woke up by a task or boot.RECEIVE_BOOT_COMPLETED, SCHEDULE_EXACT_ALARM) to their own AndroidManifest.xml.Major Release: The "Background Super-Plugin" Update!
registerBootCallback API for Android, Windows, macOS, and Linux to run headless Dart code or launch your app when the device boots up.
BOOT_COMPLETED intent and spawns a secure background Flutter Engine.SMAppService to register Login Items natively..desktop files.startForegroundService and stopForegroundService APIs for Android to stick a persistent keep-alive notification in the status bar.disableBatteryOptimization to use the ACTION_REQUEST_IGNORE_BATTERY_OPTIMIZATIONS direct system dialog prompt instead of jumping into settings.Implemented native C++ unit tests for Windows and Linux to enhance stability.
Major release including Windows and macOS support.
Comprehensively updated README for Windows support.
Updated platform support table in README.
Feature: Added Windows support.
Fixed Swift Package Manager (SPM) support configuration.
Added Swift Package Manager (SPM) support for iOS.
Updated README to accurately reflect iOS support.
iOS Support: Added support for iOS.
isAutoStartAvailable: Checks UIBackgroundRefreshStatus.getAutoStartPermission: Opens App Settings.getDeviceManufacturer: Returns "Apple".Added openCustomSetting API to open specific settings by package and activity name.
openCustomSetting API to open specific settings by package and activity name.Added specific intents for Honor devices (com.hihonor.systemmanager).
com.hihonor.systemmanager).Breaking Change: Migrated Android plugin to Kotlin. Ensure your project supports Kotlin.
getAutoStartPermission now returns Future<bool> indicating if the settings page was successfully opened.openAppInfo method as a fallback to open system App Info settings.getDeviceManufacturer method to identify the device manufacturer.Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
* added support for null safety
* added support for null safety
added support for RealMe Phones.
fixed plugin calling problems and deleted static values.
fixed homepage link and documentation.
* fixed homepage link.
* fixed documentation problems.
* It's the initial release.
One column per quarter.