ButterKnife基本使用

ButterKnife框架使用可以方便我们不用写大量的重复繁琐的findViewById和setOnClickListener等代码，它采用依赖注入的方式，通过注解的方式让view和代码中的对象绑定起来。

logo.png

GitHub地址：https://github.com/JakeWharton/butterknife

ButterKnife使用

• 添加依赖

由于8.0.0之后的版本和之前的版本有差异，这里主要是8.1.0最新版本的添加方法，注意两个步骤都要完成：

1.Project的build.gradle中添加：

    dependencies { 
        classpath 'com.neenbedankt.gradle.plugins:android-apt:1.8'
    }

2.App的build.gradle中添加：

    apply plugin: 'com.neenbedankt.android-apt'

    dependencies {
        compile 'com.jakewharton:butterknife:8.1.0'
        apt 'com.jakewharton:butterknife-compiler:8.1.0'
    }

• Activity中使用

    public class MainActivity extends AppCompatActivity {
        @BindView(R.id.title_tv) TextView titleTv;
        @BindView(R.id.back_btn) Button backBtn;
        @BindView(R.id.logo_img) ImageView logoImg;
        
        @Override 
        public void onCreate(Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);
            setContentView(R.layout.activity_main);
            ButterKnife.bind(this);
        }
    }
  

注意：ButterKnife.bind(this)必须在setContentView之后。

• Fragment中使用

    public class ListFragment extends Fragment{
        @BindView(R.id.title_tv) TextView titleTv;
        @BindView(R.id.listview) ListView listView;
        private Unbinder unbinder;
        @Override 
        public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
            View view = inflater.inflate(R.layout.fragment_list, container, false);
            unbinder = ButterKnife.bind(this, view);
            return view;
        }
        @Override
        public void onDestroyView() {    
            super.onDestroyView();    
            unbinder.unbind();
        }
    }
  

由于Fragment的生命周期不同于Activity，当在CreateView方法中绑定视图时，需要在onDestoryView中把对应的视图设置为null，这时需要解绑ButterKnife。

• ViewHolder中使用

    static class ViewHolder {
        @BindView(R.id.name_tv) TextView nameTv;
        @BindView(R.id.content_tv) TextView contentTv;
        @BindView(R.id.head_img) ImageView headImg;
  
        public ViewHolder(View view) {
            ButterKnife.bind(this, view);
        }
    }
  

• 事件监听绑定

    //点击事件
    @OnClick(R.id.submit)
    public void buttonClick(Button button){
        //TODO ...
    }
  
    //listview item点击事件
    @OnItemClick(R.id.listview)
    public void itemClick(ListView listView){
        //TODO ...
    }
  
    //多个控件具有相同的点击事件
    @OnClick({ R.id.btn1, R.id.btn2, R.id.btn3 })
    public void buttonsClick(Button button){
        //TODO ...
    }
  

ps：方法中的参数是可选的，但如果存在，必须是这个控件类或者控件类的父类。

• 资源绑定

可以用@BindBool，@BindColor，@BindDimen，@BindDrawable，@BindInt和@BindString通过绑定R.bool以及其他对应id来进行资源的预定义。
@BindString(R.string.title) String title;
@BindDrawable(R.drawable.graphic) Drawable graphic;
@BindColor(R.color.red) int red;
@BindDimen(R.dimen.spacer) Float spacer;
//...
通过这种方式，就可以把资源直接赋值给变量，从而不再需要初始化。

• 可选绑定

默认情况下，@bind和监听器绑定都必须有一个目标view，当butter knife找不到对应的view时会抛出一个异常。为了防止这种异常情况的发生，可以在绑定的字段前面使用@Nullable注解，在绑定的方法前面则可使用@Option注解，来表明对应的是一个可选绑定。

注：任何名为@Nullable第三方的注解都可以对字段起作用，这里推荐使用Android的”support-annotations“ library提供的@Nullable注解。
@Nullable @BindView(R.id.might_not_be_there) TextView mightNotBeThere;
@Optional @OnClick(R.id.maybe_missing)
void onMaybeMissingClicked() {
// TODO ...
}

• 其他

butter knife也提供了一个findById方法，如果要在某些情况下查找某些子view，可以使用它来简化代码。
View view = LayoutInflater.from(context).inflate(R.layout.thing, null);
TextView firstName = ButterKnife.findById(view, R.id.first_name);
TextView lastName = ButterKnife.findById(view, R.id.last_name);

• 混淆

  -keep class butterknife.** { *; }
  -dontwarn butterknife.internal.**
  -keep class **$$ViewBinder { *; }
  -keepclasseswithmembernames class * {
      @butterknife.* ;
  }
  -keepclasseswithmembernames class * {
      @butterknife.* ;
  }
  

参考资料

官方文档：https://jakewharton.github.io/butterknife/