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);
}
需要注意的是:
- Butterkinife.bind(this) 必须在setContentView()后面;
- setContentView()不能通过注解实现;
- 在父类中绑定后,就不用在子类中再进行绑定了(因此,建议写一个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即可解决。