官网butterknife
Butterknife专注于android系统的view注入框架,使用Butterknife对性能基本上没有损失,它的注解并不是运行时反射机制,而是在编译的时候生成了新的class,项目集成方便,使用也方便。
一、Butterknife的优势:
1. 强大的View绑定和Click事件处理功能,简化了代码,提升开发效率
2. 方便的处理Adapter里的ViewHolder绑定问题
3. 运行时不会影响APP的效率,使用以及配置方便
4. 可读性强
二、ButterKnife使用:
注意事项:
1、在Activity 类中绑定 :ButterKnife.bind(this);必须在setContentView();之后绑定;且父类bind绑定后,子类不需要再bind。
2、在非Activity 类(eg:Fragment、ViewHolder)中绑定: ButterKnife.bind(this,view);这里的this不能替换成getActivity()。
3、在Activity中不需要做解绑操作,在Fragment 中必须在onDestroyView()中做解绑操作。
4、使用ButterKnife修饰的方法和控件,不能用private or static 修饰,否则会报错。错误: @BindViewfields must not be private or static.(com.zyj.wifi.ButterknifeActivity.button1)
5、使用ButterKnife.bind(this,view)绑定一个view的子节点字段。如果你在子View的布局里或者自定义view的构造方法里 使用了inflate,你可以立刻调用此方法。或者,从XML inflate来的自定义view类型可以在onFinishInflate回调方法中使用它。
依赖:
implementation'com.jakewharton:butterknife:10.2.1'
annotationProcessor'com.jakewharton:butterknife-compiler:10.2.1'
使用:获取View控件,Click点击事件处理
Activity使用
在onCreate方法里:
//绑定处理
ButterKnife.bind(this);
View注解
@BindView(R.id.signin_title_usersignin)
TextViewsigninTitleUsersignin;
@BindView(R.id.signin_edit_name)
EditTextsigninEditName;
Click注解
@OnClick({R.id.signin_button_signin})
public void onViewClicked(View view) {
//写入点击后的逻辑操作
}
}
Fragment使用
public class BlankFragment extends Fragment {
@BindView(R.id.txt)
TextView txt;
@BindView(R.id.btn)
Button btn;
Unbinder unbinder;
@Override
public View onCreateView(LayoutInflater inflater, ViewGroup container,
BundlesavedInstanceState) {
// Inflate the layout for this fragment
View inflate = inflater.inflate(R.layout.fragment_blank, container,false);
unbinder = ButterKnife.bind(this, inflate);
return inflate;
}
@Override
public void onDestroyView() {
super.onDestroyView();
unbinder.unbind();
}
@OnClick(R.id.btn)
public void onViewClicked() {
//自己的逻辑代码
}
}
额外多加一个知识点:
设置多个view的属性:
apply() 作用:允许您立即对列表中的所有视图进行操作。
Action和Setter接口 作用:Action和Setter接口允许指定简单的行为。
public classMainActivity extends AppCompatActivity {
@BindViews({R2.id.first_name,R2.id.middle_name, R2.id.last_name})
List nameViews;
@Override
protected void onCreate(BundlesavedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
//绑定activity
ButterKnife.bind(this);
//设置多个view的属性
//方式1:传递值
ButterKnife.apply(nameViews,DISABLE);
//方式2:指定值
ButterKnife.apply(nameViews, ENABLED,false);
////方式3 设置View的Property
ButterKnife.apply(nameViews,View.ALPHA, 0.0f);//一个Android属性也可以用于应用的方法。
}
/*
* Action接口设置属性
*/
static final ButterKnife.ActionDISABLE = new ButterKnife.Action() {
@Override
public void apply(View view, int index){
view.setEnabled(false);//目的是使多个view都具备此属性
}
};
/*
* Setter接口设置属性
*/
static final ButterKnife.Setter ENABLED = new ButterKnife.Setter() {
@Override
public void set(View view, Booleanvalue, int index) {
view.setEnabled(value);//目的是使多个view都具备此属性,可变boolean值是可以传递的
}
};
}
三、常用标签
绑定标签
1.@BindArray —->绑定String里面的array数组;
@BindArray(R.array.name) String[] names;
2.@BindBitmap —->绑定图片资源为Bitmap;
@BindBitmap(R.mipmap.icon) Bitmap bitmap;
3.@BindString —->绑定一个String变量;
@BindString(R.string.username) String name;
4.@BindColor —->绑定color;
@BindColor(R.color.colorAccent) int red;
5. @BindDimen—->绑定Dimen;
@BindDimen(R.dimen.width) int appWidth;
6. @BindDrawable —->绑定Drawable;
@BindDrawable(R.drawable.pic) Drawable myPic;
7. @BinddFloat —->绑定float;
8. @BindInt —->绑定int;
9. @BindBool—->绑定boolean值
事件标签
1. @OnClick—->点击事件
2. @OnCheckedChanged —->选中,取消选中
3. @OnEditorAction —->软键盘的功能键
4. @OnFocusChange —->焦点改变
5. @OnItemClick item—->被点击(注意这里有坑,如果item里面有Button等这些有点击的控件事件的,需要设置这些控件属性focusable为false)
6. @OnItemLongClick item—->长按(返回真可以拦截onItemClick)
7. @OnItemSelected —->item被选择事件
8. @OnLongClick —->长按事件
9. @OnPageChange —->页面改变事件
10. @OnTextChanged —->EditText里面的文本变化事件
11. @OnTouch —->触摸事件
12. @Optional —->选择性注入,如果当前对象不存在,就会抛出一个异常,为了压制这个异常,可以在变量或者方法上加入一下注解,让注入变成选择性的,如果目标View存在,则注入, 不存在,则什么事情都不做
四、ButterKnife的代码混淆
-keep class butterknife.** { *; }
-dontwarn butterknife.internal.**
-keep class **$$ViewBinder { *; }
-keepclasseswithmembernames class * {
@butterknife.* ;
}
-keepclasseswithmembernames class * {
@butterknife.* ;
}
总结:ButterKnife是一个让程序员简化代码的,提高效率的框架