PeriodicWorkRequest
public
final
class
PeriodicWorkRequest
extends WorkRequest
java.lang.Object | ||
↳ | androidx.work.WorkRequest | |
↳ | androidx.work.PeriodicWorkRequest |
A WorkRequest
for repeating work. This work executes multiple times until it is
cancelled, with the first execution happening immediately or as soon as the given
Constraints
are met. The next execution will happen during the period interval; note
that execution may be delayed because WorkManager
is subject to OS battery optimizations,
such as doze mode.
You can control when the work executes in the period interval more exactly - see
PeriodicWorkRequest.Builder
for documentation on flexInterval
s.
Periodic work has a minimum interval of 15 minutes.
Periodic work is intended for use cases where you want a fairly consistent delay between consecutive runs, and you are willing to accept inexactness due to battery optimizations and doze mode. Please note that if your periodic work has constraints, it will not execute until the constraints are met, even if the delay between periods has been met.
If you need to schedule work that happens exactly at a certain time or only during a certain time
window, you should consider using OneTimeWorkRequest
s.
The normal lifecycle of a PeriodicWorkRequest is ENQUEUED -> RUNNING -> ENQUEUED
. By
definition, periodic work cannot terminate in a succeeded or failed state, since it must recur.
It can only terminate if explicitly cancelled. However, in the case of retries, periodic work
will still back off according to
WorkRequest.Builder.setBackoffCriteria(BackoffPolicy, long, TimeUnit)
.
Periodic work cannot be part of a chain or graph of work.
Summary
Nested classes | |
---|---|
class |
PeriodicWorkRequest.Builder
Builder for |
Constants | |
---|---|
long |
MIN_PERIODIC_FLEX_MILLIS
The minimum flex duration for |
long |
MIN_PERIODIC_INTERVAL_MILLIS
The minimum interval duration for |
Inherited constants |
---|
Inherited methods | |
---|---|
Constants
MIN_PERIODIC_FLEX_MILLIS
public static final long MIN_PERIODIC_FLEX_MILLIS
The minimum flex duration for PeriodicWorkRequest
(in milliseconds).
Constant Value: 300000 (0x00000000000493e0)
MIN_PERIODIC_INTERVAL_MILLIS
public static final long MIN_PERIODIC_INTERVAL_MILLIS
The minimum interval duration for PeriodicWorkRequest
(in milliseconds).
Constant Value: 900000 (0x00000000000dbba0)
Content and code samples on this page are subject to the licenses described in the Content License. Java is a registered trademark of Oracle and/or its affiliates.