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.