android开发相关——ButterKnife以及Android ButterKnife Zelezny

来源:互联网 发布:怎么开淘宝福利群 编辑:程序博客网 时间:2024/06/03 14:37

先扯两句

原本这篇博客是要继续写《一个Android工程的从零开始》的,不过看到了0502Leeyuu丶在简书上给我指出的问题。

你好,为什么要用compile ‘com.jakewharton:butterknife:5.1.1’,而不用最新版的?

为什么我使用这个版本的原因,正文中会予以说明,下面我就将自己解决的方法,以及0502Leeyuu丶为我提供的方法一同展示出来,也方便大家多角度选择。
还是厚着脸皮先将自己的github地址贴出来,大家可以去看一下我的源码。
MyBaseApplication (https://github.com/BanShouWeng/MyBaseApplication)

正文

ButterKnife集成

其实呢,看了我之前博客的朋友应该知道,我前面实际上并没有使用到ButterKnife,可项目中为什么会有这个呢,还是因为我一贯偷懒的一个尝试,也就是Android ButterKnife Zelezny插件的运用。
不过这个插件暂且不提,在文章后面会与大家分享,先说一下使用这个插件的一个前提,就是需要我们添加一下ButterKnife的库。
而Android Studio为了照顾我这种比较喜欢偷懒的人,专门给提供了一些添加开源库的方式。
这里写图片描述

按以上五步操作,会出现如下对话框。

这里写图片描述

在搜索框中输入我们想要查询的控件,点Shift+Enter(这个是鼠标移动到放大镜提示的,但是操作中,我点Enter也是可以的),就可以进行搜索,然后在所有搜索结果中选择出我们想要的开源库,点击OK即可。
好了博客原本的内容到这里就应该结束了,可是Android Studio实在是给我这样的懒人出了一个大难题啊,那就是如下图:

这里写图片描述

当我输入了“butter”时,下面的提示是Nothing to show,如果输入bu呢:

这里写图片描述

当然现在我的Android Studio出现的情况是输入ButterKnife或者butterknife的时候都可以找到我们要找到的开源库,当时当时出现的却是上面那个5.1.1的版本,具体原因暂时未知。
于是偷懒的我呢就直接拿来尝试了一下Android ButterKnife Zelezny,可用。不过由于没有到ButterKnife的部分就没有去搜索最新版。
这里呢,为了这次粗心向大家道歉,希望大家发现我博客中存在的问题以及不足也能同样提出来,谢谢大家了,更要感谢0502Leeyuu丶的认真严谨。
下面呢,就给出0502Leeyuu丶和我个人的两种解决方式:
1、贴出0502Leeyuu丶给出的解决方法:

0502Leeyuu丶: @半寿翁 一起学习,我也弄android没多久,要不你试试把全称com.jakewharton:butterknife:8.7.0放进去搜索一下,我之前弄cardview的时候也搜索不到,输入全称搜到了,不知道会不会起作用。而且最新版本的ButterKnife中的inject方法没了。

其中说到的inject类似理解为当前新版本中的bind,我尝试的过程中发现,将版本好去掉,也可以搜出结果。

2、GitHub上找到对应运用:

这里写图片描述

其中给我们提供了一个链接:http://jakewharton.github.io/butterknife/但是只在其中讲解了ButterKnife如何使用,并没有找到最新版本的相关信息。
不过返回到https://github.com/JakeWharton/butterknife页面向下翻,可以看到如下部分:

这里写图片描述

将dependencies中的代码粘到我们build.gradle(module: app)文件中的dependencies中。

这里写图片描述

可以看到文件上方出现如下提示:

这里写图片描述

点击右上角的Sync Now即可完成开源库的加载。

当然,以上两种方式都是应急时使用,还是希望大家可以直接在Library Dependency中添加成功。

ButterKnife使用

既然已经集成了,那么下面我们就来看看费这么到力气去集成ButterKnife,它会怎么帮我偷懒,才值得这么折腾。
它的作用,在http://jakewharton.github.io/butterknife/中可以查到,一言以蔽之就是资源的绑定,包括图片、文字等,也有控件和点击事件。
当然,一般常用的情况还是控件的绑定,以及点击事件。
使用之前,需要我们先将ButterKnife与当前的Activity或者Fragment绑定,也就是在onCreate方法中添加如下代码:

ButterKnife.bind(this);

控件绑定

//系统绑定TextView firstName = (TextView)findViewById( R.id.first_name);//ButterKnife绑定//绑定方法1@BindView(R.id.first_name) TextView firstName;//绑定方法2TextView firstName = ButterKnife.findById(view, R.id.first_name);

关于以上两种绑定的方法,还是有所不同的(好吧, 我承认这句是废话),至于如何不同,绑定方法1还是比较简单的,只要直接用就好,只是简单自然有简单的代价,那就是绑定方法1所使用的方法不能绑定私有控件或者是静态控件,所以有一些要求封装严谨的这种方法也就不适用了。
而绑定方法2,我尝试了创建私有控件,没有问题,静态的没有尝试,有兴趣的可以自己尝试一下,也可以看得出来,相对于系统提供的方法,他省去的部分是强转,可是这也就带来了另一个问题,那就是findById中的第一个参数——view:

baseScrollView = ButterKnife.findById(getLayoutInflater().inflate(R.layout.activity_base, null), R.id.base_scroll_view);

这部分代码我是将整体的内容合在了一起写,而view也就相当于getLayoutInflater().inflate(R.layout.activity_base, null),这自然就是我们整个布局的解析。
当然,如果在Fragment中,毕竟在onCreateView中原本也是需要解析一下布局的,就直接保存下来,在onViewCreated方法中直接使用解析。
在Activity中,就建议使用传递Activity参数的方式了,至于第三中Dialog的暂时没有尝试过,需要大家自行去探索了。

点击事件:

//系统点击事件findViewById( R.id.first_name).setOnClickListener(new View.OnClickListener() {            @Override            public void onClick(View v) {                Toast("点击了");            } });//@OnClick(R.id.first_name)public void sayHi(TextView firstName) {    Toast("点击了");}

当然,点击事件也是允许我们设置多个id的,如下:

@OnClick({R.id.first_name, R.id.last_name})    private void click(View view) {        switch (view.getId()){            case R.id.first_name:                break;            case R.id.last_name:                break;        }    }

对应做处理即可,如果需要对所点击控件操作的话,强转view即可。
其他更灵活的运用大家还是看一下官方提供的说明吧。

Android ButterKnife Zelezny

Android ButterKnife Zelezny插件安装

扯了这么多,终于该上我们的终极大Boss了,偷懒神器Android ButterKnife Zelezny。
首先第一步,自然是需要将这个插件安装到我们的Android Studio中。
快捷键 Ctrl + Alt + S打开设置页面:

这里写图片描述

依图打开Browse Repositories

这里写图片描述

如图找到我们要添加的插件Android ButterKnife Zelezny(这搜索才是我要的生活),点击install后会下载安装,成功后会提示重启Android Studio:

这里写图片描述

点击Restart Android Studio后会出现如下弹窗:

这里写图片描述

点击Restart,之后坐等Android Studio自动重启就好。

Android ButterKnife Zelezny的使用

使用的部分我就在自己的BaseActivity中进行了,首先是将之前创建的initView方法注释掉,因为Android ButterKnife Zelezny完成的就是控件初始化的操作。
在对应需要使用Activity或者Fragment中,将光标放置在layout对应的名称上,如下图的“activity_base”,然后点击Alt + Insert快捷键(光标在其他位置找不到所需要的选项):
这里写图片描述

可以看到出现了Generate ButterKnife Injections的选项,点击打开对话框(可以看到其后也有快捷键,不过与搜狗输入法的颜文字冲突,关闭后再次点击,还与其他软件冲突,一个一个关实在太费事了,也就放弃了直接一步到位,对于我这种懒人来说,这个绝对也是含泪完成的啊)

这里写图片描述

可以看到对应的命名都已经帮我们按照驼峰规则完成,同时也可以自行选择那些需要创建OnClick方法,我这里选择了四个。
其左下角有两个可选项:第一个是是否创建ViewHolder,这里暂时不需要;第二个是是否将点击事件的方法分开,自然也没有必要,所以就直接点击了Confirm。
处理完成后,可以看到我们的代码中多出了如下两部分代码:

    //控件绑定    @BindView(R.id.base_back)    ImageView baseBack;    @BindView(R.id.base_title)    TextView baseTitle;    @BindView(R.id.base_right_icon2)    ImageView baseRightIcon2;    @BindView(R.id.base_right_icon1)    ImageView baseRightIcon1;    @BindView(R.id.base_right_text)    TextView baseRightText;    @BindView(R.id.base_title_layout)    RelativeLayout baseTitleLayout;    @BindView(R.id.base_main_layout)    LinearLayout baseMainLayout;    @BindView(R.id.base_scroll_view)    ScrollView baseScrollView;    //点击事件        @OnClick({R.id.base_back, R.id.base_right_icon2, R.id.base_right_icon1, R.id.base_right_text})    public void onViewClicked(View view) {        switch (view.getId()) {            case R.id.base_back:                break;            case R.id.base_right_icon2:                break;            case R.id.base_right_icon1:                break;            case R.id.base_right_text:                break;        }    }

可以看得出来,明显要比之前使用的方法要简单的多,为了配合这部分使用,我将BaseActivity中的返回键也做了接口监听,代码参见附录2。

ps:不过由于前面说过,绑定方法1、2的利弊,所以这里只是演示了一下ButterKnife的使用效果,在BaseActivity的封装中,使用的还是原本的系统的方法解析控件,不过在后续的Activity和 Fragment中,如果对封装要求没有那么严谨的时候,使用ButterKnife确实是一个不错的选择,毕竟可以偷懒嘛。

附录

附录1

《一个Android工程的从零开始》- 目录

附录2

package com.banshouweng.mybaseapplication.base;import android.app.Activity;import android.content.Context;import android.content.Intent;import android.os.Bundle;import android.support.v7.app.AppCompatActivity;import android.util.Log;import android.view.View;import android.view.inputmethod.InputMethodManager;import android.widget.ImageView;import android.widget.LinearLayout;import android.widget.RelativeLayout;import android.widget.ScrollView;import android.widget.TextView;import android.widget.Toast;import com.banshouweng.mybaseapplication.R;import com.banshouweng.mybaseapplication.event.NetBroadcastReceiver;import com.banshouweng.mybaseapplication.ui.activity.MainActivity;import com.banshouweng.mybaseapplication.widget.CustomProgressDialog;import java.util.ArrayList;import java.util.List;import butterknife.BindView;import butterknife.ButterKnife;import butterknife.OnClick;public class BaseActivity extends AppCompatActivity implements NetBroadcastReceiver.NetEvevt {    /**     * 网络状态监听接受者     */    private static NetBroadcastReceiver.NetEvevt evevt;    /**     * 用于传递的上下文信息     */    public Context context;    public Activity activity;    @BindView(R.id.base_back)    ImageView baseBack;    @BindView(R.id.base_title)    TextView baseTitle;    @BindView(R.id.base_right_icon2)    ImageView baseRightIcon2;    @BindView(R.id.base_right_icon1)    ImageView baseRightIcon1;    @BindView(R.id.base_right_text)    TextView baseRightText;    @BindView(R.id.base_title_layout)    RelativeLayout baseTitleLayout;    @BindView(R.id.base_main_layout)    LinearLayout baseMainLayout;    @BindView(R.id.base_scroll_view)    ScrollView baseScrollView;    /**     * 是否重置返回按钮点击事件     */    private boolean isResetBack = false;    /**     * 点击回调方法     */    private OnClickRightIcon1CallBack onClickRightIcon1;    private OnClickRightIcon2CallBack onClickRightIcon2;    private OnClickRightTextCallBack onClickRightText;    private OnClickBackCallBack onClickBack;    /**     * 当前打开Activity存储List     */    private static List<Activity> activities = new ArrayList<>();    /**     * 加载提示框     */    private CustomProgressDialog customProgressDialog;    @Override    protected void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        setContentView(R.layout.activity_base);        if (!(this instanceof MainActivity)) {            activities.add(this);        }        ButterKnife.bind(this);        context = getApplicationContext();        activity = this;        customProgressDialog = new CustomProgressDialog(activity, R.style.progress_dialog_loading, "玩命加载中。。。");//        initView();    }    /**     * 隐藏返回键     */    private void hideBack() {        baseBack.setVisibility(View.GONE);    }    /**     * 设置标题     *     * @param title 标题的文本     */    public void setTitle(String title) {        baseTitle.setText(title);    }    public void setBaseBack(OnClickBackCallBack onClickBack) {        this.onClickBack = onClickBack;        isResetBack = true;    }    /**     * 设置右侧图片1(最右侧)     *     * @param resId             图片的资源id     * @param alertText         提示文本     * @param onClickRightIcon1 点击处理接口     */    public void setBaseRightIcon1(int resId, String alertText, OnClickRightIcon1CallBack onClickRightIcon1) {        this.onClickRightIcon1 = onClickRightIcon1;        baseRightIcon1.setImageResource(resId);        baseRightIcon1.setVisibility(View.VISIBLE);        //语音辅助提示的时候读取的信息        baseRightIcon1.setContentDescription(alertText);    }    /**     * 设置右侧图片2(右数第二个图片)     *     * @param resId     图片的资源id     * @param alertText 提示文本     */    public void setBaseRightIcon2(int resId, String alertText, OnClickRightIcon2CallBack onClickRightIcon2) {        this.onClickRightIcon2 = onClickRightIcon2;        baseRightIcon2.setImageResource(resId);        baseRightIcon2.setVisibility(View.VISIBLE);        //语音辅助提示的时候读取的信息        baseRightIcon2.setContentDescription(alertText);    }    /**     * 设置右侧文本信息     *     * @param text 所需要设置的文本     */    public void setBaseRightText(String text, OnClickRightTextCallBack onClickRightText) {        this.onClickRightText = onClickRightText;        baseRightText.setText(text);        baseRightText.setVisibility(View.VISIBLE);    }    /**     * 引用头部布局     *     * @param layoutId 布局id     */    public void setBaseContentView(int layoutId) {        //当子布局高度值不足ScrollView时,用这个方法可以充满ScrollView,防止布局无法显示        ((ScrollView) findViewById(R.id.base_scroll_view)).setFillViewport(true);        LinearLayout layout = (LinearLayout) findViewById(R.id.base_main_layout);        //获取布局,并在BaseActivity基础上显示        final View view = getLayoutInflater().inflate(layoutId, null);        //关闭键盘        hideKeyBoard();        //给EditText的父控件设置焦点,防止键盘自动弹出        view.setFocusable(true);        view.setFocusableInTouchMode(true);        LinearLayout.LayoutParams params = new LinearLayout.LayoutParams(                LinearLayout.LayoutParams.MATCH_PARENT, LinearLayout.LayoutParams.MATCH_PARENT);        layout.addView(view, params);    }    /**     * 隐藏键盘     */    public void hideKeyBoard() {        View view = activity.getWindow().peekDecorView();        if (view != null) {            InputMethodManager inputmanger = (InputMethodManager) activity.getSystemService(Context.INPUT_METHOD_SERVICE);            inputmanger.hideSoftInputFromWindow(view.getWindowToken(), 0);        }    }    /**     * 跳转页面     *     * @param clz 所跳转的目的Activity类     */    public void startActivity(Class<?> clz) {        startActivity(new Intent(this, clz));    }    /**     * 跳转页面     *     * @param clz    所跳转的目的Activity类     * @param bundle 跳转所携带的信息     */    public void startActivity(Class<?> clz, Bundle bundle) {        Intent intent = new Intent(this, clz);        if (bundle != null) {            intent.putExtra("bundle", bundle);        }        startActivity(intent);    }    /**     * 跳转页面     *     * @param clz         所跳转的Activity类     * @param requestCode 请求码     */    public void startActivityForResult(Class<?> clz, int requestCode) {        startActivityForResult(new Intent(this, clz), requestCode);    }    /**     * 跳转页面     *     * @param clz         所跳转的Activity类     * @param bundle      跳转所携带的信息     * @param requestCode 请求码     */    public void startActivityForResult(Class<?> clz, int requestCode, Bundle bundle) {        Intent intent = new Intent(this, clz);        if (bundle != null) {            intent.putExtra("bundle", bundle);        }        startActivityForResult(intent, requestCode);    }    /**     * 消息提示框     *     * @param message 提示消息文本     */    public void showToast(String message) {        Toast.makeText(context, message, Toast.LENGTH_SHORT).show();    }    /**     * 消息提示框     *     * @param messageId 提示消息文本ID     */    public void showToast(int messageId) {        Toast.makeText(context, messageId, Toast.LENGTH_SHORT).show();    }    /**     * 关闭所有Activity(除MainActivity以外)     */    public void finishActivity() {        for (Activity activity : activities) {            activity.finish();        }    }    /**     * 跳转到指定的Activity     *     * @param clz 指定的Activity对应的class     */    public void goTo(Class<?> clz) {        if (clz.equals(MainActivity.class)) {            finishActivity();        } else {            for (int i = activities.size() - 1; i >= 0; i--) {                if (clz.equals(activities.get(i).getClass())) {                    break;                } else {                    activities.get(i).finish();                }            }        }    }    @Override    protected void onDestroy() {        super.onDestroy();        activities.remove(this);    }    /**     * 网络变化回调方法     *     * @param mobileNetState 当前的网络状态     */    @Override    public void onNetChanged(int mobileNetState) {    }    /**     * 显示加载提示框     */    public void showLoadDialog() {        runOnUiThread(new Runnable() {            @Override            public void run() {                customProgressDialog.show();            }        });    }    /**     * 隐藏加载提示框     */    public void hideLoadDialog() {        runOnUiThread(new Runnable() {            @Override            public void run() {                if (customProgressDialog != null && customProgressDialog.isShowing()) {                    customProgressDialog.dismiss();                }            }        });    }    @OnClick({R.id.base_back, R.id.base_right_icon2, R.id.base_right_icon1, R.id.base_right_text})    public void onViewClicked(View view) {        switch (view.getId()) {            case R.id.base_back:                if (isResetBack) {                    onClickBack.clickBack();                } else {                    finish();                }                break;            case R.id.base_right_icon2:                onClickRightIcon2.clickRightIcon2();                break;            case R.id.base_right_icon1:                onClickRightIcon1.clickRightIcon1();                break;            case R.id.base_right_text:                onClickRightText.clickRightText();                break;        }    }    /**     * 图片一点击回调接口     */    public interface OnClickRightIcon1CallBack {        void clickRightIcon1();    }    /**     * 图片二点击回调接口     */    public interface OnClickRightIcon2CallBack {        void clickRightIcon2();    }    /**     * 右侧文字点击回调接口     */    public interface OnClickRightTextCallBack {        void clickRightText();    }    /**     * 返回键点击回调接口     */    public interface OnClickBackCallBack {        void clickBack();    }}
原创粉丝点击