Android Studio中含DataBinding的自定义View无法生成布局预览

问题根源 #

Android Studio布局预览时，自定义View内部的DataBinding变量obj未被初始化，解析@{obj.title}表达式时触发空指针，导致预览崩溃。另外你的代码还存在两个隐性问题：binding变量作用域错误、布局属性未与自定义方法绑定。

具体修复步骤 #

1. 修复binding变量作用域

把原来init块内的局部binding改为类成员变量，否则setObjData方法无法访问它：

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

    // 改为类成员变量
    private lateinit var binding: SimpleViewBinding

    init {
        val inflater = LayoutInflater.from(context)
        binding = SimpleViewBinding.inflate(inflater, this, true)
    }

    fun setObjData(uiState: UiState<ExampleData>) {
        if (uiState is UiState.Data) {
            binding.obj = uiState.data
        }
    }
}

2. 给预览模式添加默认测试数据

在init块中判断是否处于预览编辑模式，给obj设置默认值，避免预览时表达式空指针：

init {
    val inflater = LayoutInflater.from(context)
    binding = SimpleViewBinding.inflate(inflater, this, true)

    // 预览模式下设置默认数据
    if (isInEditMode) {
        // 替换成你的ExampleData实际构造方式，确保title字段有值
        binding.obj = ExampleData(title = "预览占位文本")
    }
}

3. 绑定布局属性与自定义方法

你布局里的app:ObjData="@{viewmodel.obj}"目前是无效的，因为没有对应的BindingAdapter关联到setObjData方法。添加以下BindingAdapter代码：

// 放在任意顶层类或单例中，比如SimpleView.kt文件内
@BindingAdapter("objData")
fun SimpleView.setObjDataBinding(uiState: UiState<ExampleData>?) {
    uiState?.let { setObjData(it) }
}

然后修改布局中的属性名（符合Android小写开头的命名规范）：

<com.project.example.view.SimpleView
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    app:objData="@{viewmodel.obj}"/>

4. 检查DataBinding变量类型正确性

确保simple_view.xml中obj的类型com.project.example.model.dataObject拼写正确，且title字段是public的，或者有对应的getter方法（比如getTitle()），否则DataBinding无法访问该字段。

验证修改 #

做完以上修改后，重新编译项目，再打开引用自定义View的布局，就能正常生成预览了。

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