Instance Property

backgroundRefreshStatus

Indicates whether the app can refresh content when running in the background.

Declaration

@property(nonatomic, readonly) UIBackgroundRefreshStatus backgroundRefreshStatus;

Discussion

You can use this property to determine whether Background App Refresh—an app's ability to open in the background to perform refresh tasks—is enabled, and warn the user if it is not. Don't warn the user if the value of this property is set to UIBackgroundRefreshStatusRestricted. A restricted user, such as one who is managed under parental controls, can't enable Background App Refresh.

Background App Refresh is disabled automatically when a device is operating in low-power mode. When this happens, the time available for performing background tasks is reduced to save power.

See Also

Managing Background Execution

UIBackgroundRefreshStatus

Constants indicating whether background execution is enabled for the app.

UIApplicationBackgroundRefreshStatusDidChangeNotification

Posted when the app’s status for downloading content in the background changes.

- beginBackgroundTaskWithName:expirationHandler:

Mark the start of a task that should continue if the app enters the background.

- beginBackgroundTaskWithExpirationHandler:

Mark the start of a task that should continue if the app enters the background.

- endBackgroundTask:

Marks the end of a specific long-running background task.

UIBackgroundTaskIdentifier

A unique token that identifies a request to run in the background.

backgroundTimeRemaining

The maximum amount of time remaining for the app to run in the background.