Android自定义View如何设置类width/height的必填XML属性

首先要厘清一个常见误区：Android本身不存在语法层面的“必填XML属性”概念，哪怕是layout_width、layout_height，本质上也是靠两层校验实现的“强制感知”，你只要复刻这两层校验逻辑，就能达到完全一致的体验：

系统对width/height的真实校验逻辑：

• 编辑阶段：Android Lint做静态扫描，检测到缺失直接在XML节点下标红报错，IDE布局预览同步提示异常
• 运行阶段：View初始化解析布局参数时，拿不到合法属性值就直接抛异常崩溃，不会继续渲染流程

第一步：补全编辑期的IDE提醒逻辑 #

很多开发者给自定义View写了declare-styleable之后，就默认IDE会提醒用户必填属性，实际上IDE只会把你定义的attr当成可选配置，根本不会主动提示缺失。实际开发中要做的：

• 编写自定义Lint检测规则，对齐系统内置的MissingWidthHeightDetector的检测逻辑：只要在布局XML中识别到你自定义View的使用节点，没有传入你要求的必填自定义属性，就在对应属性行标红，弹出和系统提示风格完全一致的报错，比如文案写“Required XML attribute 'app:your_required_attr' was missing”
• 如果不想写自定义Lint规则，也可以把必填属性的说明绑定到自定义View的类文档注释上，至少保证IDE补全代码的时候，会提示用户这个属性是必须传入的

第二步：补全运行期的强制拦截逻辑 #

这部分是强制要求的核心，要和系统解析布局参数的时机完全对齐：

• 在自定义View的所有构造入口（两个参数的XML构造、三个参数的带defStyleAttr构造）的init代码块里，完成自定义属性的解析后，立刻做合法性校验
• 参考实现代码：

class MyCustomView @JvmOverloads constructor(
    context: Context,
    attrs: AttributeSet? = null,
    defStyleAttr: Int = 0
) : View(context, attrs, defStyleAttr) {

    // 你要求必填的属性，默认给一个不可能被正常业务用到的哨兵值
    private var requiredAttrValue: String = "DEFAULT_SENTINEL"

    init {
        attrs?.let { attributeSet ->
            val typedArray = context.obtainStyledAttributes(
                attributeSet,
                R.styleable.MyCustomView,
                defStyleAttr,
                0
            )
            requiredAttrValue = typedArray.getString(R.styleable.MyCustomView_required_attr) ?: "DEFAULT_SENTINEL"
            typedArray.recycle()
        }
        // 强制校验逻辑，和系统解析width/height时的异常逻辑对齐
        check(requiredAttrValue != "DEFAULT_SENTINEL") {
            "MyCustomView 必须传入 app:required_attr 属性，当前检测到缺失"
        }
    }
}

• 这套逻辑的效果就是：哪怕用户绕过了IDE的提醒，在布局里硬不填这个属性，只要走到View inflate的流程，就会直接抛出明确的异常崩溃，和写布局忘加layout_width时的崩溃行为完全一致，不会出现带着缺省值跑起来的隐性异常

几个容易踩的无效操作 #

• 不要试图靠修改attr的format类型实现必填效果：不管你把format设成enum、reference还是任何其他类型，都只是限制传值的范围，不会强制要求用户必须传入这个属性
• 不要把校验逻辑放在onMeasure、onDraw这类生命周期回调里：这类时机太晚，View已经完成inflate流程才报错，排查成本很高，必须放在构造阶段和系统属性的解析时机对齐
• 不要靠默认值兜底：比如给属性设一个默认的兜底值，本质上就丢失了“必填”的强制属性，用户不传的时候虽然不会崩溃，但View的行为会不符合预期

内容的提问来源于stack exchange，提问作者Mehran Mahmoudkhani