Initial import

Author: Jens Driller

.gitignore

@@ -0,0 +1,6 @@
+.gradle
+.idea
+.DS_Store
+*.iml
+build
+local.properties

LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Jens Driller
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,67 @@
+Android - MaterialPreference
+============================
+* A simple backward-compatible implementation of a Material Design Preference aka settings item
+* XML layouts are taken from [Android Platform Framework Base](https://github.com/android/platform_frameworks_base)
+
+Screenshots
+-----------
+* Here's a side-by-side comparison with a native Lollipop preference:
+
+![alt text](https://raw.github.com/jenzz/Android-MaterialPreference/master/assets/Screenshot1.png "Material Preference Screenshot")
+
+Usage
+-----
+In your settings XML file that describes your preferences (must be located in `res/xml/` folder)
+just use the custom [`Preference`](http://developer.android.com/reference/android/preference/Preference.html)
+and [`PreferenceCategory`](http://developer.android.com/reference/android/preference/PreferenceCategory.html) like this:
+
+```xml
+<com.jenzz.materialpreference.PreferenceCategory
+  android:title="Material Category">
+
+  <com.jenzz.materialpreference.Preference
+    android:title="Material Preference"
+    android:summary="Material Summary" />
+
+</com.jenzz.materialpreference.PreferenceCategory>
+```
+
+That's it. You can use all the attributes you know from the original preferences.
+
+You're probably wondering why there's only a Material Design version
+of [`Preference`](http://developer.android.com/reference/android/preference/Preference.html)
+and one for [`PreferenceCategory`](http://developer.android.com/reference/android/preference/PreferenceCategory.html).
+Where are [`ListPreference`](http://developer.android.com/reference/android/preference/ListPreference.html),
+[`EditTextPreference`](http://developer.android.com/reference/android/preference/EditTextPreference.html), etc?
+I don't use them. Instead I just show a simple [`Preference`](http://developer.android.com/reference/android/preference/Preference.html)
+and display a Material Design dialog when the user selects it.
+I highly recommend using the [material-dialogs](https://github.com/afollestad/material-dialogs) library for that.
+
+Theming
+-------
+* On Lollipop, the preference color is derived from the `android:colorAccent` attribute of your app theme.
+* If you're using AppCompat, it is inherited from the `colorAccent` attribute.
+* If you want a totally different color for your preferences (why would you?), you can still override it in your app theme like this:
+
+```xml
+<style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
+  <item name="mp_colorAccent">#bada55</item>
+</style>
+```
+
+Example
+-------
+Check out the [sample project](https://github.com/jenzz/Android-MaterialPreference/tree/master/sample) for an example implementation.
+
+Download
+--------
+
+Grab it via Gradle:
+
+```groovy
+compile 'com.jenzz:materialpreference:1.0'
+```
+
+License
+-------
+This project is licensed under the [MIT License](https://raw.githubusercontent.com/jenzz/Android-MaterialPreference/master/LICENSE).

assets/Screenshot1.png

@@ -0,0 +1,15 @@
+buildscript {
+  repositories {
+    jcenter()
+  }
+  dependencies {
+    classpath 'com.android.tools.build:gradle:1.0.1'
+    classpath 'com.novoda:bintray-release:0.2.5'
+  }
+}
+
+allprojects {
+  repositories {
+    jcenter()
+  }
+}

build.gradle

@@ -0,0 +1,7 @@
+# suppress inspection "UnusedProperty" for whole file
+VERSION_NAME=1.0
+VERSION_CODE=1
+
+ANDROID_BUILD_COMPILE_SDK_VERSION=21
+ANDROID_BUILD_TARGET_SDK_VERSION=21
+ANDROID_BUILD_TOOLS_VERSION=21.1.2

gradle.properties

@@ -0,0 +1,6 @@
+#Wed Apr 10 15:27:10 PDT 2013
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-2.2.1-all.zip