Repository files navigation

when you want to store some small ,insensitive and permanent information in your app

1. npm install react-native-user-defaults
2. open xcode, right click onLibraries, then clickAdd Files..., selectnode_modules -> react-native-user-defaults -> RCTUserDefaults.xcodeproj
3. still in xcode, select main project file, thenBuild Phases -> Link Binary... -> Add items -> libRCTUserDefaults.a

If you are not clear about the step 2 and 3, you can check react-nativeofficial doc , follow the step 1 and 2 in the official doc.

Inobjective-c andswift, you have to use specific method for specific type, likesetObject andstringForKey. But inreact-native, I believe that all you need is justset andget.

Every method supportscallback andpromise

import userDefaults from 'react-native-user-defaults'

set({String}, {String, Number, Bool, Object, Array}, [,suiteName] [,callback])Example:userDefaults.set("key1", "valueIsString") .then(data => console.log(data))   // Save successuserDefaults.set("key2", [1, true], "group.com.company.app", (err, data) => { if(!err) console.log(data)         // Save success})

get({String} [,suiteName] [,callback])Example:userDefaults.get("key1") .then(data => console.log(data))   // value for the key1userDefaults.get("key2", "group.com.company.app", (err, data) => { if(!err) console.log(data)         // value for the key2})

remove({String} [,suiteName] [,callback])Example:userDefaults.remove("key1") .then(data => console.log(data))   // Remove success

empty([suiteName] [,callback])Example:userDefaults.empty() .then(data => console.log(data))   // Empty success

1. No tests? I have tested all methods, I promise. I've checked other famous react-native components, they all don't have tests, I think we are all seeking a way of formal tests.
2. Why not swift? I wrote this in swift at the beginning, but I find it's hard for others and even myself to integrate it into an existed project.
3. Type bug? if youset('key1', '12'), thenget('key1'), you will get12, not'12', I don't take this as a bug so that we can use this component more conveniently. If you don't think so, tell me.

MIT