README
react-native-background-task
Periodic background tasks for React Native apps, cross-platform (iOS and Android), which run even when the app is closed.
This library allows the scheduling of a single periodic task, which executes when the app is in the background or closed, no more frequently than every 15 minutes. Network, AsyncStorage etc can be used (anything except UI), so perfect for things like a background data sync for offline support.
Behind the scenes, this library takes a different approach with each platform:
- Android: A native implementation, which provides scheduling on top of
RN's built-in Headless JS
(Android only).
- Min API level: 16 (Android 4.1).
- iOS: A proxy around react-native-background-fetch,
which uses the iOS-specific
Background Fetchtechnique.
To achieve a unified API, this library exposes the lowest common denominator (e.g. only support for a single task, even though Android can support multiple).
For more per-platform flexibility, there are other platform-specific libraries with more granular customisation.