BackgroundMode

Describes which background execution strategy fits your use case.

Mode	Survives app kill	Visible to user	Best for
Coroutine	❌	❌	Short async work while app is open
WorkManagerOnce	✅	❌	Deferred one-shot tasks
WorkManagerPeriodic	✅	❌	Recurring background sync
WorkManagerScheduled	✅	❌	Calendar-based (every Friday 7PM)
Foreground	✅	✅ (notif)	Music, GPS, long downloads

Constructors

protected constructor()

data class Coroutine(val scope: CoroutineScope, val dispatcher: CoroutineDispatcher = Dispatchers.IO) : BackgroundMode

Coroutine tied to a CoroutineScope — cancelled when scope is cancelled.

data class Foreground(val channelId: String, val channelName: String, val notificationId: Int = 1, val title: String, val text: String = "", @DrawableRes val icon: Int) : BackgroundMode

Foreground service with a visible notification — survives app kill.

data class WorkManagerOnce(val uniqueName: String, val policy: ExistingWorkPolicy = ExistingWorkPolicy.KEEP, val constraints: Constraints = Constraints.NONE, val inputData: Map<String, Any> = emptyMap()) : BackgroundMode

WorkManager one-time task — survives app kill, runs once.

data class WorkManagerPeriodic(val uniqueName: String, val intervalMinutes: Long, val policy: ExistingPeriodicWorkPolicy = ExistingPeriodicWorkPolicy.KEEP, val constraints: Constraints = Constraints.NONE, val inputData: Map<String, Any> = emptyMap()) : BackgroundMode

WorkManager periodic task — survives app kill, repeats on interval.

data class WorkManagerScheduled(val uniqueName: String, val dayOfWeek: DayOfWeek, val hour: Int, val minute: Int = 0, val policy: ExistingWorkPolicy = ExistingWorkPolicy.REPLACE, val constraints: Constraints = Constraints.NONE) : BackgroundMode

WorkManager calendar-scheduled task — runs at a specific day/time, self-reschedules.