Threading in WorkManager
Stay organized with collections
Save and categorize content based on your preferences.
In Getting started with WorkManager,
we mentioned that WorkManager performs background work asynchronously on your
behalf. The basic implementation addresses the demands of most apps. For more
advanced use cases, such as correctly handling work being stopped, you should
learn about threading and concurrency in WorkManager.
There are four different types of work primitives provided by WorkManager:
Worker is the simplest implementation,
and the one you have seen in previous sections. WorkManager automatically runs
it on a background thread (that you can override). Read more about threading
in Worker instances in Threading in Worker.CoroutineWorker is the
recommended implementation for Kotlin users. CoroutineWorker instances
expose a suspending function for background work. By default, they run a
default Dispatcher, which you can customize. Read more about threading in
CoroutineWorker instances in Threading in CoroutineWorker.RxWorker is the recommended
implementation for RxJava users. RxWorkers should be used if a lot of your
existing asynchronous code is modelled in RxJava. As with all RxJava concepts,
you are free to choose the threading strategy of your choice. Read more about
threading in RxWorker instances in Threading in RxWorker.ListenableWorker is the base
class for Worker, CoroutineWorker, and RxWorker. It is intended for
Java developers who have to interact with callback-based asynchronous APIs
such as FusedLocationProviderClient and are not using RxJava. Read more
about threading in ListenableWorker instances in Threading in ListenableWorker.
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2024-01-03 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-01-03 UTC."],[],[],null,["# Threading in WorkManager\n\nIn [Getting started with WorkManager](/topic/libraries/architecture/workmanager/basics),\nwe mentioned that WorkManager performs background work asynchronously on your\nbehalf. The basic implementation addresses the demands of most apps. For more\nadvanced use cases, such as correctly handling work being stopped, you should\nlearn about threading and concurrency in WorkManager.\n\nThere are four different types of work primitives provided by WorkManager:\n\n- [`Worker`](/reference/androidx/work/Worker) is the simplest implementation, and the one you have seen in previous sections. WorkManager automatically runs it on a background thread (that you can override). Read more about threading in `Worker` instances in [Threading in Worker](/topic/libraries/architecture/workmanager/advanced/worker).\n- [`CoroutineWorker`](/reference/kotlin/androidx/work/CoroutineWorker) is the recommended implementation for Kotlin users. `CoroutineWorker` instances expose a suspending function for background work. By default, they run a default `Dispatcher`, which you can customize. Read more about threading in `CoroutineWorker` instances in [Threading in CoroutineWorker](/topic/libraries/architecture/workmanager/advanced/coroutineworker).\n- [`RxWorker`](/reference/androidx/work/RxWorker) is the recommended implementation for RxJava users. RxWorkers should be used if a lot of your existing asynchronous code is modelled in RxJava. As with all RxJava concepts, you are free to choose the threading strategy of your choice. Read more about threading in `RxWorker` instances in [Threading in RxWorker](/topic/libraries/architecture/workmanager/advanced/rxworker).\n- [`ListenableWorker`](/reference/androidx/work/ListenableWorker) is the base class for `Worker`, `CoroutineWorker`, and `RxWorker`. It is intended for Java developers who have to interact with callback-based asynchronous APIs such as `FusedLocationProviderClient` and are not using RxJava. Read more about threading in `ListenableWorker` instances in [Threading in ListenableWorker](/topic/libraries/architecture/workmanager/advanced/listenableworker)."]]
