---

name: android-background-work description: Implement WorkManager and background processing correctly on Android. Use when creating Worker classes, scheduling tasks, choosing between WorkManager and Foreground Services, or setting up Hilt in workers; defer FCM and notification delivery to android-notifications. metadata: triggers: files: - '**/*Worker.kt' keywords: - CoroutineWorker - WorkManager - doWork - PeriodicWorkRequest - OneTimeWorkRequest - '@HiltWorker'

Android Background Work Standards

Priority: P1 (HIGH)

Implementation Guidelines

WorkManager

• CoroutineWorker: Use for all background tasks.
• Constraints: explicit (Require Network, Charging).
• Hilt: Use @HiltWorker for DI integration. Inject dependencies via @AssistedInject constructor; bind with HiltWorkerFactory in WorkManager configuration.

Foreground Services

• Only When Necessary: Use generating visible notifications only for tasks user actively aware of (Playback, Calls, Active Navigation). Otherwise use WorkManager.

Anti-Patterns

• No IntentService: Deprecated. Use WorkManager for all background tasks.
• No Short Background Jobs: Use Coroutines in ViewModel scope instead.

References

• Worker Template