自定义View与属性声明基础
在Android应用开发中，自定义View是满足特定UI需求、提升用户体验的常见手段。当系统提供的标准控件无法满足设计或功能要求时，开发者需要创建继承自View或其子类的自定义组件。为了使这些自定义组件能够在布局XML文件中灵活配置，如同内置的TextView或Button一样接受参数，就需要为其定义专属的自定义属性。这便引入了declare-styleable的概念，它是连接自定义View逻辑代码与XML布局属性声明的桥梁。
declare-styleable本质上是一个在资源文件中定义的属性集合声明。它并不直接创建新的属性，而是将已有的或自定义的属性进行分组和引用，以便在Java或Kotlin代码中通过TypedArray一次性、类型安全地获取。这个过程通常在项目的res/values/attrs.xml文件中完成。理解其工作机制，是掌握自定义View高级技巧的关键一步。
定义declare-styleable与自定义属性
定义过程始于attrs.xml文件。首先，需要声明自定义属性本身，这通过string表示字符串，integer表示整数，color表示颜色值，dimension表示尺寸值（如dp, sp），reference表示资源引用（如@drawable/xxx），boolean表示布尔值等。也可以使用竖线组合多种格式，如color|reference。
在声明了所需的属性后，使用name属性通常与自定义View的类名保持一致，以提高可读性。一个简单的示例如下：
这里，我们为名为CustomCircleView的自定义View定义了三个属性。需要注意的是，declare-styleable内部也可以直接定义
在布局XML中使用自定义属性
定义好属性后，即可在布局文件中使用。首先，必须在根布局或使用该自定义View的父布局中声明自定义的XML命名空间。Android系统的命名空间是https://schemas.android.com/apk/res/android，而自定义的命名空间通常是https://schemas.android.com/apk/res-auto（现代推荐方式）或https://schemas.android.com/apk/[你的应用包名]。
使用res-auto可以让构建工具自动处理包名，更为简便。声明并应用属性的示例如下：
注意，自定义属性使用app:前缀（或其他自定义命名空间前缀），而非android:前缀。这样，布局编辑器就能识别这些属性，并可能在属性面板中显示它们。
在自定义View中解析属性值
在自定义View的构造方法中，需要解析从XML传递进来的属性值。这是通过obtainStyledAttributes方法获取一个TypedArray对象来完成的。该对象封装了在XML中为declare-styleable组定义的所有属性值。
解析过程通常在接受AttributeSet参数的构造方法中进行。关键步骤如下：
public class CustomCircleView extends View {
private int borderColor;
private float borderWidth;
private boolean showIndicator;
public CustomCircleView(Context context, AttributeSet attrs) {
super(context, attrs);
init(context, attrs);
}
private void init(Context context, AttributeSet attrs) {
// 获取TypedArray，R.styleable.CustomCircleView是自动生成的资源ID
TypedArray ta = context.obtainStyledAttributes(attrs, R.styleable.CustomCircleView);
try {
// 使用TypedArray的get方法族解析属性，第二个参数是默认值
borderColor = ta.getColor(R.styleable.CustomCircleView_customBorderColor, Color.TRANSPARENT);
borderWidth = ta.getDimension(R.styleable.CustomCircleView_customBorderWidth, 0f);
showIndicator = ta.getBoolean(R.styleable.CustomCircleView_showIndicator, false);
} finally {
// 必须回收TypedArray，这是一个重要的性能优化点
ta.recycle();
}
// ... 后续的初始化工作，如初始化画笔等
}
@Override
protected void onDraw(Canvas canvas) {
super.onDraw(canvas);
// 使用解析得到的borderColor, borderWidth, showIndicator进行绘制
// ... 绘制逻辑
}
}
代码中，R.styleable.CustomCircleView及其内部的R.styleable.CustomCircleView_customBorderColor等常量，是在项目编译时由Android构建工具根据attrs.xml文件自动生成的。务必在try-finally块中调用ta.recycle()，以释放底层资源。
高级用法与注意事项
除了基本用法，declare-styleable还有一些进阶技巧。首先是属性的继承与复用。一个titleText属性，同时在CustomHeaderView和CustomButtonView的declare-styleable中引用它。
其次，可以为属性定义枚举或标志位。这通过在
在代码中，可以使用ta.getInt(R.styleable.YourView_orientationMode, 0)来获取整数值，并与定义的常量进行比较。
另一个常见场景是为自定义属性提供默认值。这有两层含义：一是在TypedArray.getXXX方法中传入的默认参数；二是在View的构造方法中，如果未在XML中设置该属性，则使用代码中定义的默认值。良好的默认值能提升View的易用性。
最后，需要注意资源命名规范。避免与系统属性重名，建议使用具有项目或组件特色的前缀，以减少冲突。同时，确保attrs.xml文件语法正确，否则会导致编译错误或资源ID无法生成。正确处理TypedArray的回收，是避免内存泄漏的细节之一。掌握这些细节，能够让你在构建复杂、可配置的自定义UI组件时更加得心应手。
