Android实践（二） | 注解框架ButterKnife基本

ButterKnife是JakeWharton完成的一个注解框架，它不会影响App的效率，被广泛应用于Android开发。
项目地址：https://github.com/JakeWharton/butterknife
文档地址：http://jakewharton.github.io/butterknife/

使用ButterKnife，我们可以不用写很多的findViewById()语句，以及通过getResources获取String、Color等资源，这可以让我们的代码更加简洁，使用起来也很方便。下面来看怎么用吧！

首先当然是添加依赖（建议去github查看最新版本）

implementation 'com.jakewharton:butterknife:9.0.0-rc2'
annotationProcessor 'com.jakewharton:butterknife-compiler:9.0.0-rc2'

接下来要在Activity中进行绑定：

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    ButterKnife.bind(this);
}

需要注意的是：

1. Butterkinife.bind(this) 必须在setContentView()后面；
2. setContentView()不能通过注解实现；
3. 在父类中绑定后，就不用在子类中再进行绑定了（因此，建议写一个BaseActivity，进行Activity绑定，然后让所有的Activity去继承BaseActivity）。

绑定控件

通常操作：

Button button = (Button)findViewById(R.id.button);

使用ButterKnife：

@BindView(R.id.button) Button button;

这里需要注意：使用ButterKnife注解的控件或资源不能用private等修饰符。

绑定资源

通常操作：

String str = getResources().getString(R.string.app_name);
int color = getResources().getColor(R.color.colorPrimary);
Drawable drawable = getResources().getDrawable(R.drawable.ic_launcher_background);

使用ButterKnife：

@BindString(R.string.app_name) String str;
@BindColor(R.color.colorPrimary) int color;
@BindDrawable(R.drawable.ic_launcher_background) Drawable drawable;

是不是高端大气上档次，简洁明了不啰嗦！！！

当然，在Fragment中使用也不是问题

public class LeftFragment extends Fragment {
    
    @BindView(R.id.button)
    Button button;

    @Override
    public View onCreateView(LayoutInflater inflater, ViewGroup container,
                             Bundle savedInstanceState) {
        View view = inflater.inflate(R.layout.fragment_left, container, false);
        ButterKnife.bind(this, view);
        return view;
    }
}

不过在Fragment中使用ButterKinfe时，我们需要在onDestroy方法中对其进行解绑，因此在Fragment中使用时我们要这样写：

public class LeftFragment extends Fragment {

    @BindView(R.id.button)
    Button button;

    private Unbinder unbinder;

    @Override
    public View onCreateView(LayoutInflater inflater, ViewGroup container,
                             Bundle savedInstanceState) {
        View view = inflater.inflate(R.layout.fragment_left, container, false);
        unbinder = ButterKnife.bind(this, view);
        return view;
    }

    @Override
    public void onDestroy() {
        super.onDestroy();
        unbinder.unbind();
    }
}

当我们调用 ButterKnife.bind() 方法时，会返回一个Unbinder对象，我们只需要重写onDestroy()方法，调用Unbinder对象的unbind()方法，进行解绑。

在Adapter里面也是可以用的

public class ListAdapter extends BaseAdapter {

    @Override
    public View getView(int position, View convertView, ViewGroup parent) {
        ViewHolder holder;
        if (convertView == null){
            convertView = mInflater.inflate(R.layout.item_article, parent, false);
            holder = new ViewHolder(convertView);
            convertView.setTag(holder);
        }else {
            holder = (ViewHolder)convertView.getTag();
        }
        return convertView;
    }

    public final class ViewHolder{
        @BindView(R.id.title) TextView mTitleText;
        @BindView(R.id.inform) TextView mInformText;

        public ViewHolder(View view){
            ButterKnufe.bind(this, view)
        }
    }
}

总之，任何需要 findViewById() 的地方都可以使用ButterKnife来简化代码。

前面只说了绑定View和资源，接下来当然是Listener啦

单个View监听

@OnClick(R.id.show)
public void show(){
    //TODO
}

@OnClick(R.id.show)
public void show(TextView textview){
    //TODO
}

@OnClick(R.id.show)
public void show(View view){
    //TODO
}

所有监听方法的参数都是可选的，可写可不写。

多个View监听

@OnClick({R.id.button1, R.id.button2, R.id.text})
public void show(View view){
    switch (view.getId()){
        case R.id.button1:
            //TODO
            break;
        case R.id.button2:
            //TODO
            break;
        case R.id.text:
            //TODO
            break;
        default:
            break;
    }
}

---

---

当然，这里所列举出来的都是一些比较常用的基本用法，如果你想了解更多关于ButterKnife的用法，可以去看看 JakeWharton 给出的文档。

补充：
如果在运行时报这个错误：

只需要在 app 的 build.gradle 文件中的 android 标签下 加上

android {
    ···
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

将JDK版本指定为1.8即可解决。