如何修复自定义RangeSliderView在Android Studio预览中缺失视图ID的问题

基于com.google.android.material.slider.RangeSlider开发了自定义RangeSliderView，真机运行无问题，但Android Studio的XML预览功能报错。已尝试重建项目、清理缓存、重启IDE，问题仍存在。

异常信息 #

java.lang.NullPointerException: Missing required view with ID: com.example.appname:id/sliding_pane_detail_container
    at com.example.appname.databinding.ViewRangeSliderBinding.bind(ViewRangeSliderBinding.java:78)
    at com.example.appname.databinding.ViewRangeSliderBinding.inflate(ViewRangeSliderBinding.java:54)
    at com.example.appname.core.view.RangeSliderView.<init>(RangeSliderView.kt:20)
    at java.base/jdk.internal.reflect.NativeConstructorAccessorImpl.newInstance0(Native Method)
    at java.base/jdk.internal.reflect.NativeConstructorAccessorImpl.newInstance(NativeConstructorAccessorImpl.java:77)
    at java.base/jdk.internal.reflect.DelegatingConstructorAccessorImpl.newInstance(DelegatingConstructorAccessorImpl.java:45)
    at java.base/java.lang.reflect.Constructor.newInstanceWithCaller(Constructor.java:499)
    at java.base/java.lang.reflect.Constructor.newInstance(Constructor.java:480)
    at com.android.tools.rendering.ViewLoader.createNewInstance(ViewLoader.java:293)
    at com.android.tools.rendering.ViewLoader.loadClass(ViewLoader.java:156)
    at com.android.tools.rendering.ViewLoader.loadView(ViewLoader.java:117)
    at com.android.tools.rendering.LayoutlibCallbackImpl.loadView(LayoutlibCallbackImpl.java:281)
    at android.view.BridgeInflater.loadCustomView(BridgeInflater.java:429)
    at android.view.BridgeInflater.loadCustomView(BridgeInflater.java:440)
    at android.view.BridgeInflater.createViewFromTag(BridgeInflater.java:344)
    at android.view.LayoutInflater.createViewFromTag(LayoutInflater.java:973)
    at android.view.LayoutInflater.rInflate_Original(LayoutInflater.java:1135)
    at android.view.LayoutInflater_Delegate.rInflate(LayoutInflater_Delegate.java:72)
    at android.view.LayoutInflater.rInflate(LayoutInflater.java:1109)
    at android.view.LayoutInflater.rInflateChildren(LayoutInflater.java:1096)
    at android.view.LayoutInflater.rInflate_Original(LayoutInflater.java:1138)
    at android.view.LayoutInflater_Delegate.rInflate(LayoutInflater_Delegate.java:72)
    at android.view.LayoutInflater.rInflate(LayoutInflater.java:1109)
    at android.view.LayoutInflater.rInflateChildren(LayoutInflater.java:1096)
    at android.view.LayoutInflater.rInflate_Original(LayoutInflater.java:1138)
    at android.view.LayoutInflater_Delegate.rInflate(LayoutInflater_Delegate.java:72)
    at android.view.LayoutInflater.rInflate(LayoutInflater.java:1109)
    at android.view.LayoutInflater.rInflateChildren(LayoutInflater.java:1096)
    at android.view.LayoutInflater.inflate(LayoutInflater.java:694)
    at android.view.LayoutInflater.inflate(LayoutInflater.java:505)
    at com.android.layoutlib.bridge.impl.RenderSessionImpl.inflate(RenderSessionImpl.java:365)
    at com.android.layoutlib.bridge.Bridge.createSession(Bridge.java:454)
    at com.android.tools.idea.layoutlib.LayoutLibrary.createSession(LayoutLibrary.java:120)
    at com.android.tools.rendering.RenderTask.createRenderSession(RenderTask.java:784)
    at com.android.tools.rendering.RenderTask.lambda$inflate$6(RenderTask.java:934)
    at com.android.tools.rendering.RenderExecutor$runAsyncActionWithTimeout$3.run(RenderExecutor.kt:202)
    at com.android.tools.rendering.RenderExecutor$PriorityRunnable.run(RenderExecutor.kt:316)
    at java.base/java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1136)
    at java.base/java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:635)
    at java.base/java.lang.Thread.run(Thread.java:840)

相关代码 #

自定义属性（attrs.xml） #

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <attr name="title" format="string" />
    <attr name="stepSize" format="float" />
    <attr name="valueFrom" format="float" />
    <attr name="valueTo" format="float" />

    <declare-styleable name="RangeSliderView">
        <attr name="title" />
        <attr name="stepSize" />
        <attr name="valueFrom" />
        <attr name="valueTo" />
        <attr name="values" format="reference" />
        <attr name="labelBehavior" />
    </declare-styleable>
</resources>

自定义视图布局（view_range_slider.xml） #

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <TextView
        android:id="@+id/title_text_view"
        style="@style/TextAppearance.Material3.BodyLarge"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:gravity="center"
        tools:text="Title" />

    <com.google.android.material.slider.RangeSlider
        android:id="@+id/slider"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />

</LinearLayout>

自定义视图代码（RangeSliderView.kt） #

class RangeSliderView(context: Context, attrs: AttributeSet) : LinearLayout(context, attrs) {

    private val binging: ViewRangeSliderBinding
    private val isDiscrete: Boolean

    val rangeValue get() = with(binging.slider.values) { listOf(this[0], this[1]) }

    init {
        val inflater = LayoutInflater.from(context)
        binging = ViewRangeSliderBinding.inflate(inflater, this, true)
        with(binging) {
            context.theme.obtainStyledAttributes(attrs, R.styleable.RangeSliderView, 0, 0).apply {
                try {
                    titleTextView.text = getString(R.styleable.RangeSliderView_title)
                    with (slider) {
                        stepSize = getFloat(R.styleable.RangeSliderView_stepSize, 0.0F)
                        isDiscrete = stepSize % 1 == 0F
                        valueFrom = getFloat(R.styleable.RangeSliderView_valueFrom, 0.0F)
                        valueTo = getFloat(R.styleable.RangeSliderView_valueTo, 100.0F)
                        labelBehavior = getInt(R.styleable.RangeSliderView_labelBehavior, 0)

                        if (hasValue(com.google.android.material.R.styleable.RangeSlider_values)) {
                            val valuesId: Int = getResourceId(R.styleable.RangeSliderView_values, 0)
                            val values: TypedArray = getResources().obtainTypedArray(valuesId)
                            this.values = convertToFloat(values)
                        }
                    }
                } finally {
                    recycle()
                }
            }
        }
    }

    fun setValues(values: List<Float>) {
        binging.slider.values = values
    }

    private fun convertToFloat(values: TypedArray): List<Float?> {
        val ret: MutableList<Float?> = ArrayList()
        for (i in 0 until values.length()) {
            ret.add(values.getFloat(i, -1.0f))
        }
        return ret
    }
}

解决方法 #

1. 清理Data Binding缓存文件 #

异常提示的sliding_pane_detail_containerID不存在于自定义视图布局中，说明Data Binding生成的Binding类与实际布局不匹配。手动删除build/generated/data_binding_base_class_source_out目录下的相关文件，然后重新编译项目。

2. 修复属性判断逻辑 #

代码中判断values属性是否存在时，错误使用了Material库的RangeSlider_values，应替换为自定义的RangeSliderView_values：

// 原代码
if (hasValue(com.google.android.material.R.styleable.RangeSlider_values)) {
// 修改为
if (hasValue(R.styleable.RangeSliderView_values)) {
}

3. 适配预览上下文 #

Android Studio预览使用特殊上下文，可能导致初始化异常。在自定义视图初始化时添加预览模式判断：

init {
    val inflater = if (isInEditMode) {
        LayoutInflater.from(context).cloneInContext(ContextThemeWrapper(context, R.style.Theme_YourAppName))
    } else {
        LayoutInflater.from(context)
    }
    binging = ViewRangeSliderBinding.inflate(inflater, this, true)
    // 后续初始化代码...
}

4. 检查Material组件版本 #

确保com.google.android.material:material依赖版本与Android Studio预览工具兼容，避免版本差异引发预览问题。

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