android-background-work

Android Background Processing Reference

A skill covering the background processing APIs in the official Android (Kotlin/Jetpack) documentation. According to the user's task, read the appropriate README.md, and from there follow through to the individual files.

Directory Structure

skills/android-background-work/
  SKILL.md
  references/
    workmanager/
      README.md
      backoffpolicy.md
      configuration.md
      constraints.md
      coroutineworker.md
      custom-configuration.md
      data.md
      debugging.md
      existingworkpolicy.md
      foreground-work.md
      listenableworker-threading.md
      long-running-support.md
      migrate-legacy-schedulers.md
      multiprocess.md
      observe-progress.md
      operation.md
      outofquotapolicy.md
      periodicworkrequest.md
      rxworker.md
      testing.md
      threading.md
      update-work.md
      workcontinuation.md
      worker-factory.md
      worker.md
      workinfo.md
      workmanager.md
      workquery.md
      workrequest.md
    services/
      README.md
      aidl.md
      bound-service.md
      foreground-service-restrictions.md
      foreground-service-timeout.md
      foreground-service-types.md
      foreground-service.md
      fgs-changes.md
      fgs-troubleshooting.md
      handle-user-stopping.md
      messenger.md
      processes-and-threads.md
      service-manifest.md
      service.md
      start-command-return-values.md
      start-stop-service.md
    alarms-broadcasts/
      README.md
      alarm-types.md
      alarmmanager.md
      boot-completed.md
      broadcastreceiver.md
      doze-app-standby.md
      exact-alarm-permissions.md
      implicit-broadcast-restrictions.md
      jobscheduler.md
      pendingintent.md
      registering-receivers.md
      sending-broadcasts.md
      user-initiated-data-transfer.md
      wakelock.md
      wakelock-best-practices.md
      wakelock-debug-locally.md
      wakelock-identify-use-cases.md
    coroutines-flow/
      README.md
      suspend-functions.md
      coroutine-scope.md
      launch-async-await.md
      dispatchers-withcontext.md
      job-cancellation.md
      exception-handling.md
      flow-basics.md
      flow-operators.md
      stateflow.md
      sharedflow.md
      callbackflow-channelflow.md
      combine-zip-flatmaplatest.md
      channel.md
      retry-retrywhen.md
      mutex-shared-mutable-state.md
      testing-coroutines-flow.md

Exploration Procedure

Derive the category from the task, and identify the target page in the category's README.md:

1. Find the category corresponding to the task in the mapping table below
2. That category's references/{category}/README.md Refer to to identify the target page
3. Read the .md of the relevant page to check the details

Task → Category Mapping

Task	Category	Reference README
I want to implement a persistent background task with Worker / CoroutineWorker	workmanager	references/workmanager/README.md
I want to set up execution conditions and schedules with WorkRequest / PeriodicWorkRequest / Constraints	workmanager	references/workmanager/README.md
I want to chain work with WorkContinuation, and monitor status with WorkInfo	workmanager	references/workmanager/README.md
I want to use expedited work / OutOfQuotaPolicy, and test WorkManager	workmanager	references/workmanager/README.md
I want to implement the Service lifecycle and the return value of onStartCommand	services	references/services/README.md
I want to handle foreground services and foregroundServiceType / start restrictions / time limits	services	references/services/README.md
I want to do inter-process communication (IPC) with bound services, Messenger, and AIDL	services	references/services/README.md
I want to schedule time-specified and exact alarms with AlarmManager	alarms-broadcasts	references/alarms-broadcasts/README.md
I want to send and receive broadcasts with PendingIntent / BroadcastReceiver	alarms-broadcasts	references/alarms-broadcasts/README.md
I want to handle Doze / App Standby / JobScheduler / BOOT_COMPLETED	alarms-broadcasts	references/alarms-broadcasts/README.md
I want to know the basics of Kotlin coroutines (launch, async, Job, Dispatchers)	coroutines-flow	references/coroutines-flow/README.md
I want to handle reactive data streams with Flow / StateFlow / SharedFlow / Channel	coroutines-flow	references/coroutines-flow/README.md
I want to do exception handling, cancellation, and testing of coroutines	coroutines-flow	references/coroutines-flow/README.md

viewModelScope / repeatOnLifecycle are handled by android-architecture, notifications by android-platform-core, and Compose side-effect APIs (LaunchedEffect etc.) by android-compose-ui.