Flutter Workmanager

pub package pub points likes popularity GitHub Workflow Status license

Execute Dart code in the background, even when your app is closed. A Flutter wrapper around Android's WorkManager and iOS Background Tasks.

📖 Documentation

Complete documentation is available at docs.page →

🚀 Quick Example

@pragma('vm:entry-point')
void callbackDispatcher() {
  Workmanager().executeTask((task, inputData) async {
    print("Background task: $task");
    // Your background work here
    return Future.value(true);
  });
}

void main() {
  Workmanager().initialize(callbackDispatcher);
  Workmanager().registerOneOffTask("task-id", "simpleTask");
  runApp(MyApp());
}

🎯 Use Cases

Perfect for:

  • Data sync - Keep your app's data fresh
  • File uploads - Reliable uploads in background
  • Cleanup tasks - Remove old files and cache
  • Notifications - Check for new messages
  • Database maintenance - Optimize and clean databases

🏗️ Federated Architecture

This plugin uses a federated architecture with platform-specific implementations:

  • workmanager: Main package providing the unified API
  • workmanager_android: Android implementation using WorkManager
  • workmanager_apple: iOS/macOS implementation using Background Tasks

🐛 Support & Issues

📱 Example App

See the example folder for a complete working demo with all features.


For detailed setup instructions, advanced configuration, and troubleshooting, visit the complete documentation.

Libraries

workmanager