WorkRequest.Builder

public final @NonNull B addTag(@NonNull String tag)

Adds a tag for the work. You can query and cancel work by tags. Tags are particularly useful for modules or libraries to find and operate on their own work.

public final @NonNull W build()

Builds a WorkRequest based on this Builder.

@RequiresApi(value = 26)
public final @NonNull B keepResultsForAtLeast(@NonNull Duration duration)

Specifies that the results of this work should be kept for at least the specified amount of time. After this time has elapsed, the results may be pruned at the discretion of WorkManager when this WorkRequest has reached a finished state (see WorkInfo.State.isFinished) and there are no pending dependent jobs.

When the results of a work are pruned, it becomes impossible to query for its WorkInfo.

Specifying a long duration here may adversely affect performance in terms of app storage and database query time.

public final @NonNull B keepResultsForAtLeast(long duration, @NonNull TimeUnit timeUnit)

Specifies that the results of this work should be kept for at least the specified amount of time. After this time has elapsed, the results may be pruned at the discretion of WorkManager when there are no pending dependent jobs.

When the results of a work are pruned, it becomes impossible to query for its WorkInfo.

Specifying a long duration here may adversely affect performance in terms of app storage and database query time.

@RequiresApi(value = 26)
public final @NonNull B setBackoffCriteria(
    @NonNull BackoffPolicy backoffPolicy,
    @NonNull Duration duration
)

Sets the backoff policy and backoff delay for the work. The default values are BackoffPolicy.EXPONENTIAL and WorkRequest#DEFAULT_BACKOFF_DELAY_MILLIS, respectively. duration will be clamped between WorkRequest.MIN_BACKOFF_MILLIS and WorkRequest.MAX_BACKOFF_MILLIS.

public final @NonNull B setBackoffCriteria(
    @NonNull BackoffPolicy backoffPolicy,
    long backoffDelay,
    @NonNull TimeUnit timeUnit
)

Sets the backoff policy and backoff delay for the work. The default values are BackoffPolicy.EXPONENTIAL and WorkRequest#DEFAULT_BACKOFF_DELAY_MILLIS, respectively. backoffDelay will be clamped between WorkRequest.MIN_BACKOFF_MILLIS and WorkRequest.MAX_BACKOFF_MILLIS.

@ExperimentalWorkRequestBuilderApi
public final @NonNull B setBackoffForSystemInterruptions()

Specifies that the backoff policy (as specified via setBackoffCriteria) will be applied when work is interrupted by the system without the app requesting it. This might happen when the ListenableWorker runs longer than it should, or when constraints defined for a given ListenableWorker are unmet.

public final @NonNull B setConstraints(@NonNull Constraints constraints)

Adds constraints to the WorkRequest.

public @NonNull B setExpedited(@NonNull OutOfQuotaPolicy policy)

Marks the WorkRequest as important to the user. In this case, WorkManager provides an additional signal to the OS that this work is important.

Note that although the execution time of this work won't be counted against your app's quota while your app is in the foreground, if the expedited work continues in the background, you are susceptible to quota. However, power management restrictions, such as Battery Saver and Doze, are less likely to affect expedited work. Because of this, expedited work is best suited for short tasks which need to start immediately and are important to the user or user-initiated.

public final @NonNull B setId(@NonNull UUID id)

Sets a unique identifier for this unit of work.

The id can be useful when retrieving WorkInfo by id or when trying to update an existing work. For example, using WorkManager.updateWork requires that the work has an id.

@RequiresApi(value = 26)
public @NonNull B setInitialDelay(@NonNull Duration duration)

Sets an initial delay for the WorkRequest.

public @NonNull B setInitialDelay(long duration, @NonNull TimeUnit timeUnit)

Sets an initial delay for the WorkRequest.

public final @NonNull B setInputData(@NonNull Data inputData)

Adds input Data to the work. If a worker has prerequisites in its chain, this Data will be merged with the outputs of the prerequisites using an InputMerger.

public final @NonNull B setTraceTag(@NonNull String traceTag)

Specifies the name of the trace span to be used by WorkManager when executing the specified WorkRequest.

WorkManager uses the simple name of the ListenableWorker class truncated to a 127 character string, as the traceTag by default.

You should override the traceTag, when you are using ListenableWorker delegation via a WorkerFactory.