在Android开发中，我们经常需要自定义视图（View）以满足特定的UI需求，为了提高自定义视图的灵活性和可配置性，Android提供了一种强大的机制——declare-styleable，通过使用declare-styleable，开发者可以定义自己的XML属性，并在布局文件中使用这些属性来设置自定义视图的外观和行为，本文将详细介绍declare-styleable的概念、使用方法以及实际应用示例。

一、什么是declare-styleable？

declare-styleable是Android中的一个资源类型，用于声明一组自定义的XML属性，这些属性可以在自定义视图的构造函数中被解析和使用，从而实现对视图外观和行为的灵活控制，通过declare-styleable，开发者可以像使用系统提供的XML属性一样，使用自定义属性来配置自定义视图。

二、如何使用declare-styleable？

使用declare-styleable通常分为以下几个步骤：

1、声明自定义属性：在res/values目录下创建一个attrs.xml文件，用于声明自定义属性。

2、在自定义视图中使用这些属性：通过TypedArray解析XML属性，并在视图的构造函数中应用这些属性。

3、在布局文件中使用自定义视图和属性：在布局XML文件中引用自定义视图，并使用声明的自定义属性进行配置。

1. 声明自定义属性

在res/values/attrs.xml中声明自定义属性，假设我们有一个自定义按钮，希望支持背景颜色和文本颜色的自定义：

<!-- res/values/attrs.xml -->
<resources>
    <declare-styleable name="CustomButton">
        <attr name="custom_background" format="color"/>
        <attr name="custom_text_color" format="color"/>
    </declare-styleable>
</resources>

在这个例子中，我们声明了一个名为CustomButton的自定义样式集，其中包含两个属性：custom_background和custom_text_color，它们的格式都是颜色。

2. 在自定义视图中使用这些属性

在自定义视图的构造函数中解析这些属性，假设我们有一个名为CustomButton的自定义视图类：

// CustomButton.java
package com.example.myapp;
import android.content.Context;
import android.content.res.TypedArray;
import android.graphics.Color;
import android.util.AttributeSet;
import android.widget.Button;
public class CustomButton extends Button {
    private int customBackgroundColor;
    private int customTextColor;
    public CustomButton(Context context, AttributeSet attrs) {
        super(context, attrs);
        // 获取自定义属性
        TypedArray a = context.getTheme().obtainStyledAttributes(
                attrs,
                R.styleable.CustomButton,
                0, 0);
        try {
            customBackgroundColor = a.getColor(R.styleable.CustomButton_custom_background, Color.TRANSPARENT);
            customTextColor = a.getColor(R.styleable.CustomButton_custom_text_color, Color.BLACK);
        } finally {
            a.recycle();
        }
        // 应用自定义属性
        setBackgroundColor(customBackgroundColor);
        setTextColor(customTextColor);
    }
}

在这个示例中，我们在CustomButton的构造函数中使用TypedArray解析传入的XML属性，并根据解析结果设置按钮的背景颜色和文本颜色。

3. 在布局文件中使用自定义视图和属性

在布局XML文件中使用自定义视图和属性。

<!-- activity_main.xml -->
<com.example.myapp.CustomButton
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="Custom Button"
    app:custom_background="#FF6200EE"
    app:custom_text_color="#FFFFFF"/>

在这个布局文件中，我们创建了一个CustomButton实例，并通过自定义属性app:custom_background和app:custom_text_color设置了按钮的背景颜色和文本颜色。

三、实际应用示例

为了更好地理解declare-styleable的实际应用，让我们来看一个更复杂的示例，假设我们需要创建一个自定义的进度条视图，该视图支持不同的指示器颜色、指示器大小和进度条高度。

1. 声明自定义属性

在res/values/attrs.xml中声明自定义属性：

<!-- res/values/attrs.xml -->
<resources>
    <declare-styleable name="CustomProgressBar">
        <attr name="indicatorColor" format="color"/>
        <attr name="indicatorSize" format="dimension"/>
        <attr name="progressBarHeight" format="dimension"/>
    </declare-styleable>
</resources>

2. 创建自定义进度条视图

创建一个名为CustomProgressBar的自定义视图类：

// CustomProgressBar.java
package com.example.myapp;
import android.content.Context;
import android.content.res.TypedArray;
import android.graphics.Canvas;
import android.graphics.Paint;
import android.util.AttributeSet;
import android.view.View;
public class CustomProgressBar extends View {
    private int indicatorColor;
    private float indicatorSize;
    private float progressBarHeight;
    private float progress;
    private Paint paint;
    public CustomProgressBar(Context context, AttributeSet attrs) {
        super(context, attrs);
        TypedArray a = context.getTheme().obtainStyledAttributes(
                attrs,
                R.styleable.CustomProgressBar,
                0, 0);
        try {
            indicatorColor = a.getColor(R.styleable.CustomProgressBar_indicatorColor, 0xFF000000); // 默认黑色
            indicatorSize = a.getDimension(R.styleable.CustomProgressBar_indicatorSize, 10f); // 默认10dp
            progressBarHeight = a.getDimension(R.styleable.CustomProgressBar_progressBarHeight, 20f); // 默认20dp
        } finally {
            a.recycle();
        }
        paint = new Paint();
        paint.setAntiAlias(true);
    }
    public void setProgress(float progress) {
        this.progress = progress;
        invalidate(); // 请求重绘
    }
    @Override
    protected void onDraw(Canvas canvas) {
        super.onDraw(canvas);
        paint.setColor(indicatorColor);
        paint.setStrokeWidth(indicatorSize);
        canvas.drawRect(0, (getHeight() - progressBarHeight) / 2, getWidth() * progress, (getHeight() + progressBarHeight) / 2, paint);
    }
}

在这个示例中，CustomProgressBar继承自View，并在构造函数中解析自定义属性，它还包含一个setProgress方法，用于更新进度条的进度，并调用invalidate()请求重绘，在onDraw方法中，根据解析的属性绘制进度条。

3. 在布局文件中使用自定义进度条视图

在布局XML文件中使用自定义进度条视图和属性：

<!-- activity_main.xml -->
<com.example.myapp.CustomProgressBar
    android:id="@+id/customProgressBar"
    android:layout_width="match_parent"
    android:layout_height="50dp"
    android:layout_marginTop="20dp"
    app:indicatorColor="#FF6200EE"
    app:indicatorSize="5dp"
    app:progressBarHeight="10dp"/>

在这个布局文件中，我们创建了一个CustomProgressBar实例，并通过自定义属性设置了指示器颜色为紫色、指示器大小为5dp以及进度条高度为10dp，我们还可以通过代码动态更新进度条的进度，

// MainActivity.java
package com.example.myapp;
import android.os.Bundle;
import android.widget.SeekBar;
import androidx.appcompat.app.AppCompatActivity;
import com.example.myapp.CustomProgressBar;
public class MainActivity extends AppCo