react-native-user-defaults

An wrapper for iOS UserDefaults

- Installation
- Usage
- License

Installation

$3

Using either Yarn:

``bash
yarn add @kamaal111/react-native-user-defaults
`

Or npm:

`bash
npm install @kamaal111/react-native-user-defaults
`

$3

- React Native 0.60+

CLI autolink feature links the module while building the app.

_Note_ For iOS using cocoapods, run:

`bash
$ cd ios && pod install
`

- React Native <= 0.59

The following steps are only necessary if you are working with a version of React Native lower than 0.60:

`bash
$ react-native link @kamaal111/react-native-user-defaults
`

#### iOS

1. In Xcode in the project navigator, right click Libraries > Add Files to [your project's name]
2. Go to node_modules > @kamaal111/react-native-user-defaults and add RNUserdefaults.xcodeproj
3. In XCode, in the project navigator, select your project. Add libRNUserdefaults.a to your project's BuildPhases > Link Binary With Libraries
4. Run your project (cmd+R)

#### Android

No configuration needed

Usage

Import RNUserdefaults from @kamaal111/react-native-user-defaults:

`javascript
import RNUserdefaults from '@kamaal111/react-native-user-defaults';
`

$3

`javascript
// This is the value you want to save
// Make sure the value is an string
const value = JSON.stringify({ hallo: 'world' });
// The key to get or remove the value
const key = 'key-for-value';
// To set the value in standard UserDefaults
RNUserdefaults.set(value, key);
// The UserDefaults suite indetifier
const suite = 'group.example.app';
// iOS only: To set the value in a self defined UserDefaults suite.
RNUserdefaults.setFromSuite(value, key, suite);
`

$3

`javascript
// The key to get or remove the value
const key = 'key-for-value';
// To get the value in standard UserDefaults
const value = await RNUserdefaults.get(key);
// The UserDefaults suite indetifier
const suite = 'group.example.app';
//iOS only: To get the value in a self defined UserDefaults suite
const value = await RNUserdefaults.getFromSuite(key, suite);
`

$3

`javascript
// The key to get or remove the value
const key = 'key-for-value';
// To remove the value in standard UserDefaults
RNUserdefaults.remove(key);
// The UserDefaults suite indetifier
const suite = 'group.example.app';
// iOS only: To remove the value in a self defined UserDefaults suite
RNUserdefaults.removeFromSuite(key, suite);
``