Butterknife 注解框架在 Android Studio 上的使用

作为一名Android开发人员，是不是已经厌烦了大量的findViewById以及setOnClickListener代码，而ButterKnife是一个专注于Android系统的View注入框架，可以让你在添加注解时偷偷懒，直接点击几下鼠标既可以完成注解的增加，同时还是图形化的操作，可以说，大大的减轻了开发负担，尤其是当你的layout中有很多很多的view需要通过findViewById来获得引用时，从此让你从这些烦人臃肿的代码中解脱出来。

butterknife 的介绍 ： http://jakewharton.github.io/butterknife/

Butter Knife 的特性：
1. 支持 Activity 中的 View 注入
2. 支持 View 中的 View 注入
3. 支持 View 事件回调函数注入
4. 目前支持如下事件回调函数：
-View: @OnLongClick and @OnFocusChanged.
-TextView: @OnEditorAction.
-AdapterView: @OnItemClick and @OnItemLongClick.
-CompoundButton: @OnCheckedChanged.

一、Butterknife 插件的下载与安装

1、插件的下载

CSDN下载频道链接
GitHub下载链接
JetBrainsPlugin Repository 中的下载链接

2、插件的安装

Andorid Studio （后面简称为 AS）的插件安装方式一般有2种：
1、 在线安装
File–>settings–>Plugins–>Browse repositories–>然后再输入框输入ButterKnife Zelezny并搜索–>install–>restart Android studio（安装后重启生效）
2、 本地安装
file–>settings–>Plugins–>Install plugin from disk–>然后选择下载好的jar文件并Ok确认–>最后重启studio工具（安装后重启生效）

下面具体介绍下 【本地安装】：
插件下载好之后放在某盘下的某文件夹中（tip：自己记住位置，后面会用到），然后打开我们的开发工具 AS，如图中所示步骤进行操作，安装后需要重启 AS 即可生效：

二、Butterknife 插件的加库及使用

1、如何让插件在代码中生效呢？加库。

有两种添加方式：
1. 使用图形化界面添加： File -> Project Structure -> app -> Dependencies -> 右侧“+”-> 选第一个 Library Dependency -> 搜索选择要添加的插件 -> OK -> OK 即可;
2. 在 module对应的 build.gradle 的 dependencies 中加入：

compile 'com.jakewharton:butterknife:7.0.0'

2、使用

在你需要导入注解的Activity或者Fragment或者ViewHolder的layout资源代码上，右击，选择 Generate 然后 Generate ButterKnife Injections：

然后生成类似于下列的选择框：

其中，Element为view的类型，ID为layout中资源的id名字，
1 所在列代表你将要选择的控件对应得id生成注解，
2 代表当前控件是否注解onClick事件，
3 Variable Name 即为你在代码中引用出来的变量名，
4 代表是否生成ViewHolder；

选择完毕之后直接点击 Confirm 确认就是了， OK，所有的操作步骤就完了。

三、一些注入的示例代码

1、在 Activity 中注入：

public class MainActivity extends AppCompatActivity {


    @Bind(R.id.tv_Id)
    TextView tvId;
    @Bind(R.id.btn_Id)
    Button btnId;
    @Bind(R.id.btn02_Id)
    Button btn02Id;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        ButterKnife.bind(this);
        // TODO Use "injected" views...
    }
}

2、在 Fragment 中注入：

public class MainFragment extends Fragment {

    @Bind(R.id.iv_Id)
    ImageView ivId;
    @Bind(R.id.btn_Id)
    Button btnId;

    @Nullable
    @Override
    public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
        View view = inflater.inflate(R.layout.fragment_main, container, false);
        ButterKnife.bind(this, view);
        // TODO Use "injected" views...
        return view;
    }

    @Override
    public void onDestroyView() {
        super.onDestroyView();
        ButterKnife.unbind(this);
    }
}

3、在 ViewHolder 模式中注入：

public class MyAdapter extends BaseAdapterHelper<String> {

    private Context mContext = null;
    private List<String> list = new ArrayList<>();
    private ViewHolder mHolder;

    public MyAdapter(List<String> list, Context context) {
        super(list, context);
        this.list = list;
        this.mContext = context;
    }

    @Override
    public View getItemView(int position, View convertView, ViewGroup parent, List<String> list, LayoutInflater inflater) {
        if (convertView == null){
            convertView = inflater.inflate(R.layout.item_layout, parent, false);
            mHolder = new ViewHolder(convertView);
            convertView.setTag(mHolder);
        }else {
            mHolder = (ViewHolder) convertView.getTag();
        }

        mHolder.mTvId.setText("This is Chitty.");
        // etc...

        return convertView;
    }

    class ViewHolder {
        private ImageView mIvId;
        private TextView mTvId;

        public ViewHolder(View convertView) {
            mIvId = (ImageView) convertView.findViewById(R.id.iv_Id);
            mTvId = (TextView) convertView.findViewById(R.id.tv_Id);
        }
    }
}

4、注入回调函数

    // 不带参数
    @OnClick(R.id.btn_Id)
    public void onClick() {
        // TODO submit data to server...
    }

    // 带有 Button 参数
    @OnClick(R.id.btn_Id)
    public void onClick(Button btn) {
        btn.setText("Click Me");
    }

    // 同时注入多个 View 事件
    @OnClick({R.id.btn_Id, R.id.btn02_Id})
    public void onClick(View view) {
        switch (view.getId()) {
            case R.id.btn_Id:
                Toast.makeText(this, "Click me!", Toast.LENGTH_SHORT).show();
                break;
            case R.id.btn02_Id:
                Toast.makeText(this, "Click me,too.", Toast.LENGTH_SHORT).show();
                break;
        }
    }