A small library containing a wrapper/helper for the Shared Preferences of android.
Switch branches/tags
Nothing to show
Clone or download
Latest commit 0ca13a4 Jun 21, 2018

README.md

EasyPrefs

A small library containing a wrapper/helper for the shared preferences of Android.

With this library you can initialize the shared preference inside the onCreate of the Application class of your app.

Java:

public class PrefsApplication extends Application {

    @Override
    public void onCreate() {
        super.onCreate();
        // Initialize the Prefs class
        new Prefs.Builder()
                .setContext(this)
                .setMode(ContextWrapper.MODE_PRIVATE)
                .setPrefsName(getPackageName())
                .setUseDefaultSharedPreference(true)
                .build();
    }
}

Kotlin:

class PrefsApplication : Application() {

    override fun onCreate() {
        super.onCreate()
        // Initialize the Prefs class
        Prefs.Builder()
                .setContext(this)
                .setMode(ContextWrapper.MODE_PRIVATE)
                .setPrefsName(packageName)
                .setUseDefaultSharedPreference(true)
                .build()
    }

}

Usage

After initialization, you can use simple one-line methods to save values to the shared preferences anywhere in your app, such as:

  • Prefs.putString(key, string)
  • Prefs.putLong(key, long)
  • Prefs.putBoolean(key, boolean)

Retrieving data from the Shared Preferences can be as simple as:

String data = Prefs.getString(key, default value)

If the shared preferences contains the key, the string will be obtained, otherwise the method returns the default string provided. No need for those pesky contains() or data != null checks!

For some examples, see the sample App.

Bonus feature: ordered sets

The default implementation of getStringSet on Android does not preserve the order of the strings in the set. For this purpose, EasyPrefs adds the methods:

void Prefs.putOrderedStringSet(String key, Set<String> value);

and

Set<String> Prefs.getOrderedStringSet(String key, Set<String> defaultValue);

which internally use Java's LinkedHashSet to retain a predictable iteration order. These methods have the added benefit of adding the missing functionality of storing sets to pre-Honeycomb devices.

Download

Grab the latest dependency through Gradle:

dependencies {
    implementation 'com.pixplicity.easyprefs:library:1.9.0'
}

The Bintray project page contains all AARs of current and previous versions.

License

Copyright 2014 Pixplicity (http://pixplicity.com)

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.