0 0
Read Time:3 Minute, 12 Second


React Native background service library for running background tasks forever in Android & iOS. Schedule a background job that will run your JavaScript when your app is in the background or foreground.


  • Android: This library relies on React Native’s HeadlessJS for Android. Before building your JS task, make sure to read all the documentation. The jobs will run even if the app has been closed.
  • iOS: This library relies on iOS’s UIApplication beginBackgroundTaskWithName method, which won’t keep your app in the background forever by itself. However, you can rely on other libraries like react-native-track-player that use audio, geolocalization, etc. to keep your app alive in the background while you execute the JS from this library.


Getting started:-

Install Using yarn :

yarn add react-native-background-actions

Or Install Using npm :

npm install --save react-native-background-actions


To use this library you need to ensure you are using the correct version of React Native. If you are using a version of React Native that is lower than 0.47 you will need to upgrade before attempting to use this library latest version.


Using React Native >= 0.60:

Linking the package manually is not required anymore with Autolinking.

  • iOS Platform:

$ cd ios && pod install && cd .. // CocoaPods on iOS needs this extra step

The background support requires you to activate the background capability in Xcode.
The background support requires you to activate the background capability in Xcode.
  • Android Platform:

Modify your android/app/src/main/AndroidManifest.xml and add the following:

<manifest ... >
      <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
      <uses-permission android:name="android.permission.WAKE_LOCK" />
      <application ... >
          <service android:name="com.asterinet.react.bgactions.RNBackgroundActionsTask" />

Using React Native < 0.60:

You then need to link the native parts of the library for the platforms you are using. The easiest way to link the library is using the CLI tool by running this command from the root of your project:

$ react-native link react-native-background-actions

If you can’t or don’t want to use the CLI tool, you can also manually link the library using the instructions below (click on the arrow to show them):

Manually link the library on iOS
  1. In XCode, in the project navigator, right click Libraries ➜ Add Files to [your project's name]
  2. Go to node_modules ➜ react-native-background-actions and add RNBackgroundActions.xcodeproj
  3. In XCode, in the project navigator, select your project. Add libRNBackgroundActions.a to your project’s Build Phases ➜ Link Binary With Libraries
  4. Run your project (Cmd+R)<

Manually link the library on Android
    • Open up android/app/src/main/java/[...]/MainApplication.java
  • Add import com.asterinet.react.bgactions.BackgroundActionsPackage; to the imports at the top of the file
  • Add new BackgroundActionsPackage() to the list returned by the getPackages() method
    • Append the following lines to android/settings.gradle
include ':react-native-background-actions'
project(':react-native-background-actions').projectDir = new File(rootProject.projectDir, 	'../node_modules/react-native-background-actions/android')
    • Insert the following lines inside the dependencies block in android/app/build.gradle
  • compile project(':react-native-background-actions')


Check Usage Here : react-native-background-actions Usage


GitHub:- https://github.com/Rapsssito/react-native-background-actions

If You Have Any Problem Or Doubts,
Please Do Ask Or Suggest In Comment.

Do Follow Us on:



Also Check out: A Performant And Easy to use hold to open context menu for React Native

0 %
0 %
0 %
0 %
0 %
0 %

By Akash Kothari

I am passionate about my work. Because I love what I do, I have a steady source of motivation that drives me to do my best. In my last job, this passion led me to challenge myself daily and learn new skills that helped me to do better work

Average Rating

5 Star
4 Star
3 Star
2 Star
1 Star

One thought on “React Native background service library for running background tasks forever

Leave a Reply

Discover more from TechDevil

Subscribe now to keep reading and get access to the full archive.

Continue reading