RemoteWorkManager

abstract fun beginUniqueWork(
    uniqueWorkName: String,
    existingWorkPolicy: ExistingWorkPolicy,
    work: (Mutable)List<OneTimeWorkRequest!>
): RemoteWorkContinuation

This method allows you to begin unique chains of work for situations where you only want one chain with a given name to be active at a time. For example, you may only want one sync operation to be active. If there is one pending, you can choose to let it run or replace it with your new work.

The uniqueWorkName uniquely identifies this set of work.

If this method determines that new work should be enqueued and run, all records of previous work with uniqueWorkName will be pruned. If this method determines that new work should NOT be run, then the entire chain will be considered a no-op.

If any work in the chain fails or is cancelled, all of its dependent work inherits that state and will never run. This is particularly important if you are using APPEND as your ExistingWorkPolicy.

fun beginUniqueWork(
    uniqueWorkName: String,
    existingWorkPolicy: ExistingWorkPolicy,
    work: OneTimeWorkRequest
): RemoteWorkContinuation

This method allows you to begin unique chains of work for situations where you only want one chain with a given name to be active at a time. For example, you may only want one sync operation to be active. If there is one pending, you can choose to let it run or replace it with your new work.

The uniqueWorkName uniquely identifies this set of work.

If this method determines that new work should be enqueued and run, all records of previous work with uniqueWorkName will be pruned. If this method determines that new work should NOT be run, then the entire chain will be considered a no-op.

If any work in the chain fails or is cancelled, all of its dependent work inherits that state and will never run. This is particularly important if you are using APPEND as your ExistingWorkPolicy.

abstract fun beginWith(work: (Mutable)List<OneTimeWorkRequest!>): RemoteWorkContinuation

Begins a chain with one or more OneTimeWorkRequests, which can be enqueued together in the future using enqueue.

If any work in the chain fails or is cancelled, all of its dependent work inherits that state and will never run.

fun beginWith(work: OneTimeWorkRequest): RemoteWorkContinuation

Begins a chain with one or more OneTimeWorkRequests, which can be enqueued together in the future using enqueue.

If any work in the chain fails or is cancelled, all of its dependent work inherits that state and will never run.

abstract fun cancelAllWork(): ListenableFuture<Void!>

Cancels all unfinished work. Use this method with extreme caution! By invoking it, you will potentially affect other modules or libraries in your codebase. It is strongly recommended that you use one of the other cancellation methods at your disposal.

Upon cancellation, onStopped will be invoked for any affected workers.

abstract fun cancelAllWorkByTag(tag: String): ListenableFuture<Void!>

Cancels all unfinished work with the given tag. Note that cancellation is a best-effort policy and work that is already executing may continue to run. Upon cancellation, onStopped will be invoked for any affected workers.

abstract fun cancelUniqueWork(uniqueWorkName: String): ListenableFuture<Void!>

Cancels all unfinished work in the work chain with the given name. Note that cancellation is a best-effort policy and work that is already executing may continue to run. Upon cancellation, onStopped will be invoked for any affected workers.

abstract fun cancelWorkById(id: UUID): ListenableFuture<Void!>

Cancels work with the given id if it isn't finished. Note that cancellation is a best-effort policy and work that is already executing may continue to run. Upon cancellation, onStopped will be invoked for any affected workers.

abstract fun enqueue(request: WorkRequest): ListenableFuture<Void!>

Enqueues one item for background processing.

abstract fun enqueue(requests: (Mutable)List<WorkRequest!>): ListenableFuture<Void!>

Enqueues one or more items for background processing.

abstract fun enqueueUniquePeriodicWork(
    uniqueWorkName: String,
    existingPeriodicWorkPolicy: ExistingPeriodicWorkPolicy,
    periodicWork: PeriodicWorkRequest
): ListenableFuture<Void!>

This method allows you to enqueue a uniquely-named PeriodicWorkRequest, where only one PeriodicWorkRequest of a particular name can be active at a time. For example, you may only want one sync operation to be active. If there is one pending, you can choose to let it run or replace it with your new work.

The uniqueWorkName uniquely identifies this PeriodicWorkRequest.

abstract fun enqueueUniqueWork(
    uniqueWorkName: String,
    existingWorkPolicy: ExistingWorkPolicy,
    work: (Mutable)List<OneTimeWorkRequest!>
): ListenableFuture<Void!>

This method allows you to enqueue work requests to a uniquely-named RemoteWorkContinuation, where only one continuation of a particular name can be active at a time. For example, you may only want one sync operation to be active. If there is one pending, you can choose to let it run or replace it with your new work.

The uniqueWorkName uniquely identifies this RemoteWorkContinuation.

fun enqueueUniqueWork(
    uniqueWorkName: String,
    existingWorkPolicy: ExistingWorkPolicy,
    work: OneTimeWorkRequest
): ListenableFuture<Void!>

This method allows you to enqueue work requests to a uniquely-named RemoteWorkContinuation, where only one continuation of a particular name can be active at a time. For example, you may only want one sync operation to be active. If there is one pending, you can choose to let it run or replace it with your new work.

The uniqueWorkName uniquely identifies this RemoteWorkContinuation.

java-static fun getInstance(context: Context): RemoteWorkManager

Gets the instance of RemoteWorkManager which provides a subset of WorkManager APIs that are safe to use for apps that use multiple processes.

abstract fun getWorkInfos(workQuery: WorkQuery): ListenableFuture<(Mutable)List<WorkInfo!>!>

Gets the ListenableFuture of the List of WorkInfo for all work referenced by the WorkQuery specification.