React Native Shared Preferences

Android's Native key value storage system in React Native

Installation

< RN 0.47

npm install [email protected] --save

>= RN 0.47

npm install react-native-shared-preferences --save

Project setup and initialization

• In android/settings.gradle

...
include ':react-native-shared-preferences', ':app'
project(':react-native-shared-preferences').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-shared-preferences/android')

• In android/app/build.gradle

...
dependencies {
    /* YOUR DEPENDENCIES HERE */
    compile "com.facebook.react:react-native:+"
    compile project(":react-native-shared-preferences") // <--- add this
}

• Register Module (in MainApplication.java)

import in.sriraman.sharedpreferences.RNSharedPreferencesReactPackage;  // <--- import

public class MainActivity extends ReactActivity {
  ......

  @Override
  protected List<ReactPackage> getPackages() {
      return Arrays.<ReactPackage>asList(
          new MainReactPackage(),
          new RNSharedPreferencesReactPackage() // <--- Add this
      );
  }

  ......

}

Usage

Import

import SharedPreferences from "react-native-shared-preferences";

Configure name of preferences file. (Optional. Must be called before other functions.)

SharedPreferences.setName("name");

Set Item

SharedPreferences.setItem("key", "value");

Get an value

const value = await SharedPreferences.getItem("key");

Get multiple items

const values = await SharedPreferences.getItems(["key1", "key2"]);

Get all values

const values = await SharedPreferences.getAll();

Clear all values

SharedPreferences.clear();

Get all keys - returns promise with array of keys

const keys = await SharedPreferences.getAllKeys();

Remove Item

SharedPreferences.removeItem("key");

Credits

Sujith Niraikulathan.