@@ -11,11 +11,11 @@ Conceal provides a set of Java APIs to perform cryptography on Android. It was d
1111Gradle
1212``` gradle
1313dependencies {
14- compile 'com.github.afiqiqmal:ConcealSharedPreference-Android:1.5.2 '
14+ compile 'com.github.afiqiqmal:ConcealSharedPreference-Android:1.5.5 '
1515
1616 //or
1717
18- compile 'com.github.afiqiqmal:ConcealSharedPreference-Android:1.5.2 ' {
18+ compile 'com.github.afiqiqmal:ConcealSharedPreference-Android:1.5.5 ' {
1919 exclude group: 'com.google.code.gson', module: 'gson'
2020 }
2121}
@@ -50,7 +50,7 @@ Permission need to use in your project. Please Allow it first, or it will affect
5050<uses-permission android : name =" android.permission.READ_EXTERNAL_STORAGE" />
5151```
5252
53- SharedPreferences initialize
53+ ##### Initialize
5454``` java
5555ConcealPrefRepository concealPrefRepository = new ConcealPrefRepository .PreferencesBuilder (this )
5656 // .useThisPrefStorage("Android_Prefs")
@@ -71,68 +71,79 @@ ConcealPrefRepository concealPrefRepository = new ConcealPrefRepository.Preferen
7171 - for files - in folder / files
7272```
7373
74- < b > Save data</ b >
74+ ##### Save data
7575
7676``` java
77- concealPrefRepository. putString(KEY ," Hello" );
78- concealPrefRepository. putInt(KEY ,1000000 );
79- concealPrefRepository. putDouble(KEY ,100.00 );
80- concealPrefRepository. putbyte(KEY ,new byte []);
81- concealPrefRepository. putMap(KEY ,new Map<String ,String > ());
77+ concealPrefRepository. put(KEY ," Hello" );
78+ concealPrefRepository. put(KEY ,1000000 );
79+ concealPrefRepository. put(KEY ,100.00 );
80+ concealPrefRepository. put(KEY ,new byte []);
81+ concealPrefRepository. put(KEY ,new Map<String ,String > ());
82+ ...
83+ ...
84+ ```
8285
83- // using gson
86+ for complex object might need use ` putModel ` which use gson
87+ ```
8488concealPrefRepository.putModel(KEY, new Gson().fromJson(loadJSONFromAsset(context, "users.json"), User.class));
8589concealPrefRepository.putModel(KEY, new Gson().fromJson(loadJSONFromAsset(context, "users.json"), new TypeToken<ArrayList<Users>>(){}.getType()));
90+ ```
8691
92+
93+ Files and Images
94+ ```
8795// Files and Images will be encrypted
8896// prefix of this encrypted images and files start with "conceal_enc_";
8997File getFile = new File(Environment.getExternalStorageDirectory().getAbsolutePath()+"/testing.pdf");
9098concealPrefRepository.putFile(KEY,getFile,boolean deleteOldFiles);
9199// deleteOldFiles - true or false.. true - will delete choosen file and move to new path
92100
93101//put images
94- concealPrefRepository. putImage(KEY , BitmapFactory . decodeResource(getResources(), R . mipmap. ic_launcher));
95- concealPrefRepository. putImage(KEY , File file);
96- ...........
102+ concealPrefRepository.put(KEY, BitmapFactory.decodeResource(getResources(), R.mipmap.ic_launcher));
103+ concealPrefRepository.put(KEY, File file);
104+ concealPrefRepository.putDrawable(KEY, Drawable ID);
105+ ...
106+ ...
97107```
98108
99- OR
109+ ##### < b >For Method Chaining</ b >
100110``` java
101111new ConcealPrefRepository .Editor (" PREFIX" ) // optional - get default from global prefix
102- .putString(KEY ," Hello" )
103- .putInt(KEY ,1000000 )
104- .putBoolean(KEY ,true )
105- .putByte(KEY ,new byte [])
106- .putFile(KEY ,getFile,boolean deleteOldFiles);
107- .putImage(KEY , BitmapFactory . decodeResource(getResources(), R . mipmap. ic_launcher))
108- .putImage(KEY , imageFile)
109- .putListString(KEY ,STRING_LIST )
110- .putListFloat(KEY ,FLOAT_LIST )
111- .........
112+ .put(KEY ," Hello" )
113+ .put(KEY ,1000000 )
114+ .put(KEY ,true )
115+ .put(KEY ,new byte [])
116+ .put(KEY ,getFile,boolean deleteOldFiles);
117+ .put(KEY , BitmapFactory . decodeResource(getResources(), R . mipmap. ic_launcher))
118+ .put(KEY , imageFile)
119+ .put(KEY ,STRING_LIST )
120+ .put(KEY ,FLOAT_LIST )
121+ ...
122+ ...
112123 .apply(); // .commit();
113124```
114125
115- <b >Get total data</b >
126+ ##### <b >Get total data</b >
116127``` java
117128System . out. println(concealPrefRepository. getPrefsSize());
118129```
119130
120- <b >Get all sharedpreferences data</b >
131+ ##### <b >Get all sharedpreferences data</b >
121132``` java
122133Map<String ,String > getAll = concealPrefRepository. getAllSharedPrefData();
123134```
124135
125- <b >Get all sharedpreferences data in List String</b >
136+ ##### <b >Get all sharedpreferences data in List String</b >
126137``` java
127138List<String > getAll = concealPrefRepository. getAllSharedPrefDataToString();
128139```
129140
130- <b >Get all encrypted Files inside created folder</b >
141+ ##### <b >Get all encrypted Files inside created folder</b >
131142``` java
132143List<CryptoFile > getFiles = concealPrefRepository. getAllConcealEncryptedFiles();
133144```
134145
135- <b >Fetching data</b >
146+ ##### <b >Fetching data</b >
136147
137148``` java
138149concealPrefRepository. getString(KEY );
@@ -154,7 +165,7 @@ File enc_file = concealPrefRepository.getFile(KEY,true); //return File
154165........
155166```
156167
157- <b >Clear key and SharedPreferences</b >
168+ ##### <b >Clear key and SharedPreferences</b >
158169
159170``` java
160171concealPrefRepository. destroyCrypto(); // clear key
@@ -164,17 +175,17 @@ concealPrefRepository.remove(KEY1,KEY2,KEY3,KEY4) //String... keys
164175concealPrefRepository. removeFile(KEY ); // delete assosiate file (images and files) return boolean
165176```
166177
167- <b >Check if key exists</b >
178+ ##### <b >Check if key exists</b >
168179``` java
169180concealPrefRepository. contains(KEY ); // return boolean
170181```
171182
172- <b >Get SharedPreferences</b >
183+ ##### <b >Get SharedPreferences</b >
173184``` java
174185concealPrefRepository. getPreferences();
175186```
176187
177- <b >Listener Data Changes</b >
188+ ##### <b >Listener Data Changes</b >
178189``` java
179190public class BaseActivity extends AppCompatActivity implements OnDataChangeListener {
180191 ....
@@ -185,8 +196,7 @@ public class BaseActivity extends AppCompatActivity implements OnDataChangeListe
185196}
186197```
187198
188- <b >Easier Save User Detail Preferences</b >
189-
199+ ##### <b >Easier Save User Detail Preferences</b >
190200``` java
191201new ConcealPrefRepository .UserPref ()
192202.setFirstName(" Firstname" )
@@ -203,15 +213,15 @@ ConcealPrefRepository.UserPref().applyFirstName("Firstname"); //directly apply
203213ConcealPrefRepository . UserPref(). applyLastName(" Firstname" ); // directly apply
204214```
205215
206- <b >Get User Detail</b >
216+ ##### <b >Get User Detail</b >
207217``` java
208218new ConcealPrefRepository .UserPref (). getFirstName()
209219new ConcealPrefRepository .UserPref (). getLastName()
210220new ConcealPrefRepository .UserPref (). getEmail()
211221.....
212222```
213223
214- <b >Key prefix - Apply key with prefix</b >
224+ ##### <b >Key prefix - Apply key with prefix</b >
215225``` java
216226new ConcealPrefRepository .UserPref (" KEY PREFIX" ). setFirstName(" Firstname" ). apply();
217227new ConcealPrefRepository .UserPref (" KEY PREFIX" ). setLastName(" Firstname" ). apply();
@@ -238,13 +248,13 @@ ConcealCrypto concealCrypto = new ConcealCrypto.CryptoBuilder(this)
238248 .create();
239249```
240250
241- #### Hash
251+ ##### Hash
242252
243253```
244254concealCrypto.hashKey(plaintext); // SHA-256
245255```
246256
247- #### Encrypt
257+ ##### Encrypt
248258
249259```
250260concealCrypto.obscure(test); // encrypt using facebook conceal
@@ -257,7 +267,7 @@ concealCrypto.obscureFile(File file,boolean deleteOldFile);
257267```
258268
259269
260- #### Decrypt
270+ ##### Decrypt
261271
262272```
263273concealCrypto.deObscure(cipher); // decrypt using facebook conceal
0 commit comments