Practical guides for common native_workmanager scenarios.
- Periodic API Sync - Most common use case
- File Upload with Retry - Error handling patterns
- Background Cleanup - Scheduled maintenance tasks
- Photo Auto-Backup - ContentUri triggers (Android)
- Hybrid Workflow - Native + Dart workers combined
- Chain Processing - Sequential workflows
By Platform:
- Android-specific: Photo Auto-Backup
- iOS-specific: None (all cross-platform)
- Cross-platform: All others
By Complexity:
- Beginner: Periodic API Sync, Background Cleanup
- Intermediate: File Upload with Retry, Photo Auto-Backup
- Advanced: Hybrid Workflow, Chain Processing
By Feature:
- HTTP operations: Periodic API Sync, File Upload
- Dart workers: Background Cleanup, Hybrid Workflow
- Task chains: Chain Processing
- Triggers: Photo Auto-Backup
If you're new to native_workmanager:
- Start with Periodic API Sync to understand basics
- Learn error handling with File Upload
- Try Dart workers with Background Cleanup
- Explore advanced features with remaining guides
All examples in these guides are:
- ✅ Complete - Copy-paste ready
- ✅ Tested - Verified on Android & iOS
- ✅ Production-ready - Include error handling
- ✅ Commented - Explain key concepts
Each guide includes:
- Android-specific behavior - How it works on Android
- iOS-specific behavior - How it works on iOS
- Common pitfalls - What to avoid
- Best practices - Recommended patterns
In these guides, you'll learn:
- How to schedule different types of tasks
- When to use native workers vs Dart workers
- How to handle errors and retries
- How to chain tasks together
- Platform-specific considerations
- Common mistakes to avoid
Not covered here:
- API reference - See main README.md
- API documentation - See doc/API_REFERENCE.md
Found an issue or have a suggestion? Please open an issue at: https://github.com/user/native_workmanager/issues
Last updated: 2026-01-27