Android中ButterKnife(黄油刀)的详细使用
最近刚学会使用ButterKnife,真是超级好用,忍不住要分享给大家了。
写在前面:该文档使用7.0版本,8.0版本方法名有所改动,建议看官方文档,整体业务逻辑和原理没什么变动。
在android编程过程中,我们会写大量的布局和点击事件,像初始view、设置view监听这样简单而重复的操作让人觉得麻烦类,所以可以采用注解的方式去实现,而ButterKnife则是注解中相对简单易懂的很不错的开源框架,而网上的文档和例子都过时了,7.0之后的版本改动很大,之前的注解都不能用了,所以借鉴官方文档总结了一下,接下来就介绍一下如何使用。基本参照官方文档,加上自己的心得。
ButterKnife 优势:
1.强大的View绑定和Click事件处理功能,简化代码,提升开发效率
2.方便的处理Adapter里的ViewHolder绑定问题
3.运行时不会影响APP效率,使用配置方便
4.代码清晰,可读性强
使用心得:
1.Activity ButterKnife.bind(this);必须在setContentView();之后,且父类bind绑定后,子类不需要再bind
2.Fragment ButterKnife.bind(this, mRootView);
3.属性布局不能用private or static 修饰,否则会报错
4.setContentView()不能通过注解实现。(其他的有些注解框架可以)
官网http://jakewharton.github.io/butterknife/
使用步骤:
一.导入ButterKnife jar包:
1)如果你是Eclipse,可以去官网下载jar包
2)如果你是AndroidStudio可以直接 File->Project Structure->Dependencies->Library dependency 搜索butterknife即可,第一个就是
3)当然也可以用maven和gradle配置
<span style="font-family:SimSun;font-size:14px;">MAVEN <dependency> <groupId>com.jakewharton</groupId> <artifactId>butterknife</artifactId> <version>(insert latest version)</version> </dependency> GRADLE
compile 'com.jakewharton:butterknife:(insert latest version)' Be sure to suppress this lint warning in your build.gradle.(关闭)
lintOptions { disable 'InvalidPackage'
} </span>
注意如果在Library 项目中使用要按如下步骤(github中有具体描述)否则无法找到view:
注:官网和github也有对应的引用步骤。
二.常见使用方法:
1)由于每次都要在Activity中的onCreate绑定Activity,所以个人建议写一个BaseActivity完成绑定,子类继承即可
注:ButterKnife.bind(this);绑定Activity 必须在setContentView之后:
实现如下(FragmentActivity 实现一样):
<span style="font-family:SimSun;font-size:14px;">public abstract class BaseActivity extends Activity { public abstract int getContentViewId(); @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(getContentViewId()); ButterKnife.bind(this); initAllMembersView(savedInstanceState); } protected abstract void initAllMembersView(Bundle savedInstanceState); @Override protected void onDestroy() { super.onDestroy(); ButterKnife.unbind(this);//解除绑定,官方文档只对fragment做了解绑 }
} </span>
2)绑定fragment
<span style="font-family:SimSun;font-size:14px;">public abstract class BaseFragment extends Fragment { public abstract int getContentViewId(); protected Context context; protected View mRootView; @Nullable @Override public View onCreateView(LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) { mRootView =inflater.inflate(getContentViewId(),container,false); ButterKnife.bind(this,mRootView);//绑定framgent this.context = getActivity(); initAllMembersView(savedInstanceState); return mRootView; } protected abstract void initAllMembersView(Bundle savedInstanceState); @Override public void onDestroyView() { super.onDestroyView(); ButterKnife.unbind(this);//解绑 }
} </span>
3)绑定view
<span style="font-family:SimSun;font-size:14px;">@Bind(R.id.hello_world)
TextView mHelloWorldTextView;
@Bind(R.id.app_name)
TextView mAppNameTextView;//view</span>
4)绑定资源
<span style="font-family:SimSun;font-size:14px;">@BindString(R.string.app_name)
String appName;//sting
@BindColor(R.color.red)
int textColor;//颜色
@BindDrawable(R.mipmap.ic_launcher)
Drawable drawable;//drawble
@Bind(R.id.imageview)
ImageView mImageView;
@Bind(R.id.checkbox)
CheckBox mCheckBox;
@BindDrawable(R.drawable.selector_image)
Drawable selector; </span>
5)Adapter ViewHolder 绑定
<span style="font-family:SimSun;font-size:14px;">public class TestAdapter extends BaseAdapter { private List<String> list; private Context context; public TestAdapter(Context context, List<String> list) { this.list = list; this.context = context; } @Override public int getCount() { return list==null ? 0 : list.size(); } @Override public Object getItem(int position) { return list.get(position); } @Override public long getItemId(int position) { return position; } @Override public View getView(int position, View convertView, ViewGroup parent) { ViewHolder holder; if (convertView == null) { convertView = LayoutInflater.from(context).inflate(R.layout.layout_list_item, null); holder = new ViewHolder(convertView); convertView.setTag(holder); } else { holder = (ViewHolder) convertView.getTag(); } holder.textview.setText("item=====" + position); return convertView; } static class ViewHolder { @Bind(R.id.hello_world) TextView textview; public ViewHolder(View view) { ButterKnife.bind(this, view); } }
} </span>
6)点击事件的绑定:不用声明view,不用setOnClickLisener()就可以绑定点击事件
a.直接绑定一个方法
<span style="font-family:SimSun;font-size:14px;">@OnClick(R.id.submit)
public void submit(View view) { // TODO submit data to server...
} </span>
b.所有监听方法的参数是可选的
<span style="font-family:SimSun;font-size:14px;">@OnClick(R.id.submit)
public void submit() { // TODO submit data to server...
} </span>
c.定义一个特定类型,它将自动被转换
<span style="font-family:SimSun;font-size:14px;">@OnClick(R.id.submit)
public void sayHi(Button button) { button.setText("Hello!");
}</span>
d.多个view统一处理同一个点击事件,很方便,避免抽方法重复调用的麻烦
<span style="font-family:SimSun;font-size:14px;">@OnClick({ R.id.door1, R.id.door2, R.id.door3 })
public void pickDoor(DoorView door) { if (door.hasPrizeBehind()) { Toast.makeText(this, "You win!", LENGTH_SHORT).show(); } else { Toast.makeText(this, "Try again", LENGTH_SHORT).show(); }
} </span>
e.自定义view可以绑定自己的监听,不指定id
<span style="font-family:SimSun;font-size:14px;">public class FancyButton extends Button { @OnClick public void onClick() { // TODO do something! }
} </span>
f.给EditText加addTextChangedListener(即添加多回调方法的监听的使用方法),利用指定回调,实现想回调的方法即可,哪个注解不会用点进去看下源码上的注释就会用了
<span style="font-family:SimSun;font-size:14px;">@OnTextChanged(value = R.id.mobileEditText, callback = OnTextChanged.Callback.BEFORE_TEXT_CHANGED)
void beforeTextChanged(CharSequence s, int start, int count, int after) { }
@OnTextChanged(value = R.id.mobileEditText, callback = OnTextChanged.Callback.TEXT_CHANGED)
void onTextChanged(CharSequence s, int start, int before, int count) { }
@OnTextChanged(value = R.id.mobileEditText, callback = OnTextChanged.Callback.AFTER_TEXT_CHANGED)
void afterTextChanged(Editable s) { } </span>
7)对一组View进行统一操作
a.装入一个list
<span style="font-family:SimSun;font-size:14px;">@Bind({ R.id.first_name, R.id.middle_name, R.id.last_name })
List<EditText> nameViews; </span>
b.设置统一处理
<span style="font-family:SimSun;">static final ButterKnife.Action<View> DISABLE = new ButterKnife.Action<View>() { @Override public void apply(View view, int index) { view.setEnabled(false); }
};
static final ButterKnife.Setter<View, Boolean> ENABLED = new ButterKnife.Setter<View, Boolean>() { @Override public void set(View view, Boolean value, int index) { view.setEnabled(value); }
};<span style="color: silver; line-height: normal; background-color: rgb(248, 248, 248);"> </span><a target=_blank href="http://blog.csdn.net/itjianghuxiaoxiong/article/details/50177549#" class="ViewSource" title="view plain" style="line-height: normal; color: rgb(160, 160, 160); text-decoration: none; border: none; padding: 1px; margin: 0px 10px 0px 0px; display: inline-block; width: 16px; height: 16px; text-indent: -2000px; background-image: url("images/default/ico_plain.gif"); background-attachment: initial; background-color: inherit; background-size: initial; background-origin: initial; background-clip: initial; background-position: 0% 0%; background-repeat: no-repeat;">view plain</a></span><span data-mod="popu_168" style="font-size: 9px; font-family: Verdana, Geneva, Arial, Helvetica, sans-serif; color: silver; line-height: normal;"> <a target=_blank href="http://blog.csdn.net/itjianghuxiaoxiong/article/details/50177549#" class="CopyToClipboard" title="copy" style="color: rgb(160, 160, 160); text-decoration: none; border: none; padding: 1px; margin: 0px 10px 0px 0px; font-size: 9px; display: inline-block; width: 16px; height: 16px; text-indent: -2000px; background-image: url("images/default/ico_copy.gif"); background-attachment: initial; background-color: inherit; background-size: initial; background-origin: initial; background-clip: initial; background-position: left top; background-repeat: no-repeat;">c</a></span>
c.统一操作处理,例如设置是否可点,属性等
<span style="font-family:SimSun;">ButterKnife.apply(nameViews, DISABLE);
ButterKnife.apply(nameViews, ENABLED, false);</span><span style="font-family:Arial;font-size: 14px;"> </span>
8)可选绑定:默认情况下,“绑定”和“监听”绑定都是必需的。如果不能找到目标视图,则将抛出异常。所以做空处理
<span style="font-family:SimSun;">@Nullable @Bind(R.id.might_not_be_there) TextView mightNotBeThere; @Nullable @OnClick(R.id.maybe_missing) void onMaybeMissingClicked() { // TODO ...
} </span>
三、代码混淆
<span style="font-family:SimSun;font-size:14px;">-keep class butterknife.** { *; }
-dontwarn butterknife.internal.**
-keep class **$$ViewBinder { *; } -keepclasseswithmembernames class * { @butterknife.* <fields>;
} -keepclasseswithmembernames class * { @butterknife.* <methods>;
} </span>
四、Zelezny插件的使用
在AndroidStudio->File->Settings->Plugins->搜索Zelezny下载添加就行 ,可以快速生成对应组件的实例对象,不用手动写。使用时,在要导入注解的Activity 或 Fragment 或 ViewHolder的layout资源代码上,右键——>Generate——Generate ButterKnife Injections,然后就出现如图的选择框。(此动态图来自官网)
原文链接: 点击打开链接
Android中ButterKnife(黄油刀)的详细使用相关推荐
- android中 menu的属性详细解释
android中 menu的属性详细解释 <?xml version="1.0" encoding="utf-8"?> <menu xmlns ...
- android危险权限分组,Android 中的危险权限详细整理
Android 中的危险权限详细整理 前言: Android 中有上百种权限,现在将所有的权限归为两类: 一类是普通权限 一类的危险权限 普通权限是指那些不会威胁到用户安全和隐私的权限,这部分权限系统 ...
- android[butterKnife(黄油刀)史诗详细使用方法]
butterKnife中文又名黄油刀,是一款Android视图的字段和方法绑定快速注解框架. 1.首先把查看方式改变成Android. 2.打开Gradle Scripts层下的build.radle ...
- Android中ButterKnife的详细使用
最近刚学会使用ButterKnife,真是超级好用,忍不住要分享给大家了. 写在前面:该文档使用7.0版本,8.0版本方法名有所改动,建议看官方文档,整体业务逻辑和原理没什么变动. 在Android编 ...
- Android中ButterKnife的使用
简介 ButterKnife是注解中相对简单易懂的很不错的开源框架,使用ButterKnife可以提升我们的开发效率,不需要写很多findViewById来找到View对象,可以为我们省去很多的时间. ...
- Android中的动画(二)和ButterKnife (黄油刀)
属性动画 什么是属性动画? 通过改变对象的属性做动画 ValueAnimator的使用方法 ValueAnimator valueAnimator=ValueAnimator.ofInt(height ...
- Android 自定义注解详细用法,手写Butterknife黄油刀
前言 本篇文章主要讲解 Java 注解在Android中的常见用法 Java 注解(Annotation) Java 注解(Annotation)又称 Java 标注,是 JDK5.0 引入的一种注释 ...
- 【Android】Studio 依赖 ButterKnife 黄油刀 时出现 空指针异常
一 . 出现过程描述 在项目中使用黄油刀,在依赖中加入'com.jakewharton:butterknife:8.0.1',结果项目 运行报错,提示空指针异常NullPointerException ...
- Android框架之ButterKnife(黄油刀)
Android框架之ButterKnife(黄油刀) Butterknife简介 ButterKnife是一个专注于Android系统的View注入框架,可以减少大量的findViewById以及se ...
最新文章
- 移动端各种小技巧及优化体验(网上看到记录一下省的总结了)
- SAP Spartacus里Commerce后台CMS Component和前台Angular的一一映射关系
- E: 无法获得锁 /var/lib/dpkg/lock - open (11: 资源暂时不可用)
- 关于eclipse解压安装的问题
- 数学原来这么有趣,一组图唤醒你的思维!
- 移动端海洋实时仿真技术研究与实现
- iphone iPhone开发中为UINavigationBar设置背景图片方法
- Java编程:将五子棋棋盘内容用稀疏矩阵存储至磁盘,并从中重新读取内容——稀疏数组和算法
- 清华计算机科学与技术专业收分,2016年清华大学计算机科学与技术专业最低分是多少?...
- OpenCV-图像处理(20、霍夫变换-直线)
- 在点光源的基础上利用光域网来分布光的传播范围及方向_daiding
- 二种方法js实现轮播图自动切换
- 新主播如何在直播行业混得好
- 计算机中的微信无法启动,微信电脑版无法直接打开EXCEL:为什么电脑打不开excel表格...
- 413 Arithmetic Slices
- 紫书——Repeating Decimals UVA - 202
- bixby怎么编程_三星的Bixby很烂。 这是如何将其关闭。
- 敬語使用方法 第三章 他社を訪問する・来客対応(3.7~3.12)
- 腾讯邮件服务器备份,怎样使用邮件备份功能?
- lisp的vla函数画矩形_AutoLISP反应器vlr-object-reactor函数应用
热门文章
- 【计算几何】德劳内三角剖分算法 | 利用 scatter 绘制散点图 | 实现外接圆生成 | scipy库的 Dealunay 函数 | 实战: A-B间欧氏距离计算
- 右手螺旋判断磁感应强度方向_如何判断磁感应强度方向 方法是什么
- 徐磊语法 6 7 时态的正确定义
- 百家号自媒体的文章在哪个时间段发文效果比较好?
- fatal: You have not concluded your cherry-pick (CHERRY_PICK_HEAD exists). Please, commit your change
- 太平洋网站的css样式
- Unity下如何实现RTMP或RTSP流播放和录制
- C语言——首字母大写
- 实验三 面向对象(二)(预习报告)
- 【游戏开发Unity】捏脸系统(附源码)