Android自定义View总结（个人笔记，结合开发代码实例）

本文结合自己开发过程中编写的代码及相关知识，对自定义View的使用进行了总结。

通常情况下，有以下三种方法来实现自定义的控件：
（1）对现有控件进行拓展
（2）通过组合来实现新的控件
（3）重写View来实现全新的控件

一、对现有控件进行拓展（重点在二、三，这边不贴代码了）
这是一个非常重要的自定义View方法，它可以在原生控件的基础上进行拓展，增加新的功能、修改显示的UI等。一般来说，我们可以在onDraw（）方法中对原生控件行为进行拓展。
。
。
。
。
。
。

二、创建复合控件
创建复合控件可以很好地创建出具有重用功能的控件集合。这种方式通常需要继承一个合适的ViewGroup，再给它添加指定功能的控件，从而组合成新的复合控件。通过这种方式创建的控件，我们一般会给它指定一些可配置的属性，让它具体更强的拓展性。

在项目需求中遇到很多共通的UI界面，通常情况下，这些界面都会被抽象出来，形成一个共通的UI组件（这边以博主编码过程中自定义的SettingItemView为例，该部分为项目中各个界面中包含的卡片）。所有需要添加该组件的界面都会引用该SettingItemView组件，而不是每个界面都在布局文件中写这样一个UI界面。
此外，设计者还可以给SettingItemView增加相应的接口，让调用者能够更加灵活地控制SettingItemView,这样不仅可以提高界面的复用率，更能在需要修改UI时，做到快速修改，而不需要对每个页面的卡片进行修改。
接下来结合实际开发的代码，就如何创建一个这样的UI模板进行总结。首先，模板应该具有通用性与可行性。也就是说，我们需要给调用者以丰富的接口，让他们可以更改模板中的文字、颜色、行为等信息，而不是所有的模板都一样，那样就失去了模板的意义。

1.定义属性
1.1
为一个View提供可自定义的属性非常简单，只需要在res资源目录的values目录下创建一个attrs.xml的属性定义文件，并在该文件中通过如下代码定义相应的属性即可：

<?xml version="1.0" encoding="utf-8"?>
<resources>

   <declare-styleable name="SettingItemView">
        <attr name="setting_title_text" format="string" />
        <attr name="setting_context_text" format="string" />
        <attr name="setting_show_switch" format="boolean" />
        <attr name="setting_switch_status" format="boolean" />
        <attr name="setting_text" format="string" />
        <attr name="setting_image" format="reference" />
        <attr name="setting_progress_bar" format="boolean" />
        <attr name="quick_is_open" format="boolean" />
        <attr name="show_color_container_icon" format="boolean"/>
    </declare-styleable>
 </resources>

我们在代码中通过declare-styleable标签声明了使用自定义属性，并通过name属性来确定引用的名称。最后，通过attr标签来声明具体的自定义属性，比如在这里定义的九个属性，并通过format属性来指定属性的类型。

这里需要注意的是，有些属性可以同时有不同的属性，eg:一个背景属性,可以是颜色属性，也可以是引用属性。可以把它指定为具体的颜色，也可以把它指定为一张图片。所有使用 “|”来分隔不同的属性—— “reference|color" 。

1.2
在确定好属性后，就可以创建一个自定义控件——SettingItemView，并让他继承自ViewGroup，从而组合一些需要的控件。(对应的layout：setting_item.xml也已创建，代码后续贴出)这边，我们继承RelativeLayout。在构造方法中，通过如下所示的代码来获取在XML布局文件中自定义的那些属性，即与我们使用系统提供的那些属性一样。

 TypedArray typedArray = context.obtainStyledAttributes(attrs, R.styleable.SettingItemView);

系统提供了TypedArray这样的数据结构来获取自定义属性集，后面引用的styleable的SettingItemView，就是我们在XML中通过 declare-styleable name="SettingItemView"所指定的name名。接下来，通过TypeArray对象的getString（）、getColor（）等方法，就可以获取这些定义的属性值。代码如下所示：

//通过这个方法，将你在attrs.xml中定义的declare-styleable的所有属性的值存储到TypedArray中
TypedArray typedArray = context.obtainStyledAttributes(attrs, R.styleable.SettingItemView);
        //限制类型的六个实际数值，从TypedArray中取出对应的值来为要设置的属性赋值
        mTitle = typedArray.getString(R.styleable.SettingItemView_setting_title_text);
        mContent = typedArray.getString(R.styleable.SettingItemView_setting_context_text);
        mShowSwitch = typedArray.getBoolean(R.styleable.SettingItemView_setting_show_switch, false);
//        mSwitchStatus = typedArray.getBoolean(R.styleable.SettingItemView_setting_switch_status, false);
        mBottomTextContent = typedArray.getString(R.styleable.SettingItemView_setting_text);
        mBottomImageResourceId = typedArray.getResourceId(R.styleable.SettingItemView_setting_image, R.drawable.avatar);
        //再加一个进度条的限制属性
        mShowProgressBar = typedArray.getBoolean(R.styleable.SettingItemView_setting_progress_bar, false);
        mShowColorContainerIcon = typedArray.getBoolean(R.styleable.SettingItemView_show_color_container_icon, false);

        mIsOpen = typedArray.getBoolean(R.styleable.SettingItemView_quick_is_open, false);
        //获取完TypedArray的值后，一般要调用recycle方法来避免重新创建的时候的错误。
        typedArray.recycle();

这里需要注意的是，当获取完所有的属性值后，需要调用TypedArray的recyle方法来完成资源的回收。

2.组合控件
2.1
接下来，我们就可以开始组合控件了。在SettingItemView中，这边我们自己定义了对应的layout，即setting_item.xml。此外，还可以通过动态添加控件的方式，使用addView（）方法将这三个控件加入到对应定义的UI模板中（这边未使用这个方法，后续对该方法对应代码也进行一下研究）。
在代码中我们给各个控件设置前面所获取到的具体的属性值，比如文字内容，根据布尔值设置控件是否要显示等，使用公共方法动态修改UI模板中的UI，这进一步提高了模板的可定制性。

以前一步已经定义的mTitle控件以及mContent、mShowColorContainerIcon这两个属性为例：
声明对应的对象变量：

 private TextView mSettingItemTitle;
 private String mContent;
 private boolean mShowColorContainerIcon;

对这些变量在构造函数中进行对应赋值

mSettingItemTitle = view.findViewById(R.id.tv_setting_item_title);

mContent = typedArray.getString(R.styleable.SettingItemView_setting_context_text);
mShowColorContainerIcon = typedArray.getBoolean(R.styleable.SettingItemView_show_color_container_icon, false);

为他们设置前面获取到的具体属性值，或根据设置的属性值属性进行相应操作：

       if (mTitle != null) {
     
            mSettingItemTitle.setText(mTitle);
        }

        if (mContent != null) {
     
            mSettingItemContent.setVisibility(VISIBLE);
            mSettingItemContent.setText(mContent);
        }

   //判断颜色模块两个图片是否要显示
        if (mShowColorContainerIcon) {
     
            //将原本xml中的图片改成在代码中把舒适与便捷中的返回颜色图片给显示
            mColorContainerIcon.setVisibility(VISIBLE);
            mColorContainerIconOne.setVisibility(VISIBLE);
            mColorContainerHotZone.setVisibility(VISIBLE);
        }

2.2
**那么如何来给UI模板中的点击按钮等设计点击事件呢？**既然是UI模板，那么每个调用者所需要这些按钮能够实现的功能都是不一样的。因此，不能直接在UI模板中添加具体的实现逻辑，只能通过接口回调的思想，将具体的实现逻辑交给调用者，实现过程如下所示：

2.2.1 定义接口
在UI模板类中（这边即SettingItemView.java类）定义一个接口，在接口中创建方法（一个或多个均可），编写的三个接口代码如下所示：

    //定义接口，创建设置项被点击方法
    public interface ItemClickListener {
     
        void onClick();
    }

    //定义接口，创建按钮改变方法
    public interface ItemSwitchChangedListener {
     
        void onChange(boolean isChecked);
    }

    public interface ColorIconClickListener {
     
        void onClickColorIcon();
    }

2.2.2 暴露接口给调用者
在模板方法中，为需要点击的按键等增加了点击事件，但是不去实现具体的逻辑，而是调用接口中相应的点击方法，以其中一个点击事件为例说明，代码如下所示：

定义接口中点击事件的监听变量

//定义接口中点击事件的监听变量
    private ItemClickListener mItemClickListener;

添加定义的监听变量的set方法
暴露该方法给调用者来注册接口回调，通过接口来获得回调者对接口方法的实现：

    public void setItemClickListener(ItemClickListener itemClickListener) {
     
        this.mItemClickListener = itemClickListener;
    }

点击事件，通过定义的监听变量mItemClickListener调用接口中相应的点击方法，即 mItemClickListener.onClick();这一步：

       mBottomContainer.setOnClickListener(new OnClickListener() {
     
            @Override
            public void onClick(View view) {
     
                if (mItemClickListener != null) {
     
                //调用定义的ItemClickListener接口中的onClick（）方法
                    mItemClickListener.onClick();
                }
            }
        });
        

2.2.3 实现接口回调

在调用者的代码中，调用者需要实现这样一个接口，并完成接口中的方法，确定具体的实现逻辑，并使用2.2.2步骤中暴露的方法，将接口的对象传递进去，从而完成回调。通常情况下，可以匿名内部类的形式来实现接口中的方法，代码如下：

     assistModeContainer.setItemClickListener(new SettingItemView.ItemClickListener() {
     
            @Override
            public void onClick() {
     
                DialogUtils.showRadioButtonDialogFragment(
                        getActivity(),
                        assistMode,
                        String.format(getString(R.string.set_front_crash_assist_mode)),
                        assistModeIndex,
                        mIndex -> {
     
                            assistModeIndex = mIndex;
                        }
                );
            }
        });

这边是一个Fragment类，其中的控件通过SettingItemView.java中暴露的接口setItemClickListener，将接口的对象传递进去，从而完成回调。（其中具体的逻辑实现是关于弹窗显示等功能，这边可以忽略）

3.引用UI模板
最后一步，自然是在需要使用的地方引用UI模板，在引用前，需要制定引用第三方控件的名字空间。在布局文件中，可以看到如下一行代码：

xmlns:android="http://schemas.android.com/apk/res/android"

这行代码就是在指定引用的名字空间xmlns，即xml namespace。这里指定了名字空间为"android"，因此在接下来使用系统属性的时候，才可以使用"android:"来引用Android的系统属性。同样的，如果要使用自定义的属性，那么就需要创建自己的名字空间，在Android Studio中，第三方的控件都使用如下代码来引入名字空间。

xmlns:app="http://schemas.android.com/apk/res-auto"

这里我们将引入的第三方控件的名字空间取名为app，之后在XML文件中使用自定义的熟悉时，就可以通过这个名字空间来引入。选取一个引入该UI模板的代码为例，代码如下:

              <com.***.***.ui.custom.SettingItemView
                    android:id="@+id/alarm_speed_container"
                    android:layout_width="@dimen/assist_driving_setting_item_view_width_of_alarm_speed_container"
                    android:layout_height="@dimen/assist_driving_setting_item_view_height_of_alarm_speed_container"
                    android:layout_marginTop="@dimen/elements_margin_top"
                    android:background="@drawable/carsetting_littlewidget_low"
                    app:layout_constraintStart_toStartOf="parent"
                    app:layout_constraintTop_toBottomOf="@id/over_speed_alarm_container"
                    app:setting_image="@drawable/carsetting_pop_icon_enable"
                    app:setting_text="@string/speed"
                    app:setting_title_text="@string/alarm_speed" />

使用自定义的View与系统原生的View最大的区别就是在申明控件时，需要指定完整的包名，而在引用自定义的属性时，需要使用自定义的xmlns名字。

三、重写View来实现全新的控件

当Android系统原生的控件无法满足我们的需求时，我们就可以完全创建一个新的自定义View来实现需要的功能。创建一个自定义View，难点在于绘制控件和实现交互，这也是评价一个自定义View优劣的标准之一。通常需要继承View类，并重写它的onDraw()、onMeasure()等方法来实现绘制逻辑，同时通过重写onTouchEvent（）等触控事件来实现交互逻辑。当然，我们还可以像实现组合控件方式那样，通过引入自定义属性，丰富自定义View的可定制性。

其实，不论是多么复杂的图形、控件，它都是由这些最基本的图形绘制出来的，关键就在于你如何去分解、设计这些图形，当你的脑海里有了一副设计图之后，剩下的事情就只是对坐标的计算了。

不论是多么复杂的自定义View，他一定是慢慢迭代起来的功能。

直接附上自己开发过程中几个重写的View源码：

自定义TintPlate源码
自定义RoundImageView源码