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.