glimpse
##Android View Styleable Attribute Binding
Easily obtain and bind styleable attribute values. Consider the following custom View class:
public class CustomView extends View {
boolean showText;
@ColorInt
int textColor;
public CustomView(Context context) {
this(context, null);
}
public CustomView(Context context, AttributeSet attrs) {
if (attrs != null) {
// Set fields defined in attributes
TypedArray a = context.obtainStyledAttributes(attrs, R.styleable.CustomView, 0, 0);
try {
showText = a.getBoolean(R.styleable.CustomView_showText, false);
textColor = a.getColor(R.styleable.CustomView_textColor, getResources().getColor(R.color.default_text_color));
} finally {
a.recycle();
}
} else {
// Set defaults
textColor = getResources().getColor(R.color.default_text_color);
}
}
This verbose code gets worse the more attributes there are. Glimpse removes the need to write this boilerplate code. With Glimpse, simply annotate your fields with the @Styleable
annotation providing their attribute names:
@Styleable(R.styleable.CustomView_showText)
boolean showText;
@ColorInt
@Styleable(value = R.styleable.CustomView_textColor, defaultRes = R.color.default_text_color)
int textColor;
Then call the static obtain
method providing the View object instance as the target, the AttributeSet containing the values, and any additional parameters:
Glimpse.obtain(this, attrs);
Using the library
Currently, in order to use the library, you must clone the repo and run the ./gradlew build
command. There should be two jars generated in the following locations:
LOCATION_TO_CLONED_GLIMPSE_FOLDER/compiler/build/libs/glimpse-compiler-VERSION_NUMBER.jar
LOCATION_TO_CLONED_GLIMPSE_FOLDER/annotation/build/libs/glimpse-annotation-VERSION_NUMBER.jar
Add these jars to your application's top level libs
folder. Then add the following lines to your app module's build.gradle
file:
apt files('../libs/glimpse-compiler-VERSION_NAME.jar')
compile files('../libs/glimpse-annotation-VERSION_NAME.jar')
Note: If you are using the Jack tool chain with the a newer Gradle version, you can replace the apt
command with the annotationProcessor
command.
Finally, sync and build your project.