Butter Knife简介和使用指南

为什么要使用Butter Knife

其github项目地址在这里
Butter Knife是一款基于注解来生成模板代码的安卓工具。通过它我们可以更简便的绑定页面布局和添加点击事件的监听。

  1. 使用@BindView 方法来代替findViewById。此外还可以通过@BindBool,@BindColor,@BindDimen,@BindDrawable,@BindInt,@BindString来绑定对应的资源。
  2. 在集合或数组中存放多个view,在行为、设置、属性上设置一次,所有的view都能生效。
  3. 使用@OnClick方法来添加点击事件的监听
    由于Butter Knife的实现方式是生成代码而非反射的方式,所以并不会减慢app的运行速度。而使用它可以在一定程度上简化代码。

如何在项目中应用Butter Knife

首先在你的项目gradle文件中添加:

 buildscript {
    repositories {
        mavenCentral()
    }
    dependencies {
        classpath 'com.jakewharton:butterknife-gradle-plugin:8.4.0'
    }
 }

然后在你的模块gradle文件中添加:

applyplugin:'com.jakewharton.butterknife'
dependencies {  
  compile'com.jakewharton:butterknife:8.4.0'
  annotationProcessor'com.jakewharton:butterknife-compiler:8.4.0'
}

在android模块中使用

在不同场景中的应用
在使用时,你可以只给某个id设置click事件而不获取此id实例。

在library module中使用

首先也是在lib module中引入butterkinfe库。其使用方式场景跟android module基本是相同的。需要有以下几点需要注意:

  1. 在绑定view的时候,用R2来代替R。

     classExampleActivityextendsActivity{
       @BindView(R2.id.user)EditTextusername;
       @BindView(R2.id.pass)EditTextpassword;...
     }
    
  2. 在写点击事件监听时。每个view单独写一个方法。而不是通过view.getID来区分点击的控件。比如下面的这种情况就是错误的

错误方式.

@OnClick({R2.id.back, R2.id.txt_bind_we_chat_btn, R2.id.txt_bind_phone_btn})
public void onClick(View view) {
    switch (view.getId()) {
        case R2.id.back:
            break;
        case R2.id.txt_bind_phone_btn:
            break;
        case R2.id.txt_bind_we_chat_btn:
            break;
    }
}

虽然这样可以给每个id设置对应的点击事件,但是通过view.getId()方法获取的id是R文件的id,这不是一个final值,不能用来做区分,而这个值跟我们使用的R2中的值并不是相同的。所以我们需要对每个时间单独写一个click注解。

范例:

@OnClick(R2.id.txt_bind_we_chat_btn)
public void onBindWeChatClick(View v) {
    bindWeChat();
}

@OnClick(R2.id.txt_bind_phone_btn)
  public void onBIndPhoneClick(View v) {
    bindPhoe();
}

@OnClick(R2.id.back)
public void onBackClick() {
    finish();
}

细心的同学可以注意到,在这样的情况下,我们写响应函数时,当没有用到过VIew参数时,是可以省略的。

  1. 注意
    在我们将R改为R2的时候,项目可能会报红,没有找到这个文件或者数值,这个时候,需要点击Build->make project.或者make 当前module。

推荐一个Android Studio Plugin----Butter Knife插件

使用此插件可以快速帮我们生成绑定id和点击事件代码。绑定ID还会将下划线格式改为小驼峰格式。具体使用和安装查看
ButterKnifeZelezny

你可能感兴趣的:(Butter Knife简介和使用指南)