Kotlin使用View Binding时BottomSheetBehavior视图不显示问题排查

核心问题原因 #

• 视图未添加到界面树：仅通过inflate创建了BottomSheet布局对应的View实例，但从未将该实例添加到Activity绑定的根布局中，该视图完全没有参与界面渲染，自然无法展示。
• BottomSheetBehavior绑定对象错误：app:layout_behavior属性是配置给CoordinatorLayout的子ConstraintLayout的，你当前将外层CoordinatorLayout作为Behavior的宿主，完全不符合BottomSheet的使用规则。
• 初始状态默认隐藏：布局中配置了app:behavior_peekHeight="0dp"、app:behavior_hideable="true"，默认状态为隐藏，若触发展示时未明确指定展开状态也会导致无内容显示。
• 废弃API混用：代码同时使用了已废弃的Kotlin Android Extensions和View Binding，存在变量引用冲突的潜在风险。

修复步骤 #

1. 调整代码逻辑 #

import android.os.Bundle
import android.view.View
import com.google.android.material.bottomsheet.BottomSheetBehavior

class XYZ : BaseActivity() {

    private lateinit var binding: XYZLayout
    // 提升BottomSheet绑定实例为类变量
    private lateinit var bottomSheetBinding: BottomSheetLayoutBinding
    private val behavior: BottomSheetBehavior<ConstraintLayout> by lazy {
        // 绑定到配置了layout_behavior的子ConstraintLayout
        val sheetBehavior = BottomSheetBehavior.from(bottomSheetBinding.bottomSheetContent)
        sheetBehavior.addBottomSheetCallback(object : BottomSheetBehavior.BottomSheetCallback() {
            override fun onSlide(bottomSheet: View, slideOffset: Float) {}
            override fun onStateChanged(bottomSheet: View, newState: Int) {}
        })
        sheetBehavior
    }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        binding = XYZLayout.inflate(layoutInflater)
        setContentView(binding.root)
        // 初始化BottomSheet绑定并添加到根布局
        bottomSheetBinding = BottomSheetLayoutBinding.inflate(layoutInflater, binding.root, false)
        binding.root.addView(bottomSheetBinding.root)
        
        // 点击触发展示示例
        binding.yourTriggerView.setOnClickListener {
            behavior.state = BottomSheetBehavior.STATE_EXPANDED
        }
    }
}

2. 调整BottomSheet布局，给子ConstraintLayout加id #

<?xml version="1.0" encoding="utf-8"?>
<androidx.coordinatorlayout.widget.CoordinatorLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:id="@+id/bottom_sheet_root"
    android:layout_height="match_parent">

    <androidx.constraintlayout.widget.ConstraintLayout
        android:id="@+id/bottom_sheet_content"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_gravity="bottom"
        app:behavior_fitToContents="true"
        app:behavior_hideable="true"
        app:behavior_peekHeight="0dp"
        app:layout_behavior="@string/bottom_sheet_behavior">

      <!-- 原有布局内容 -->

    </androidx.constraintlayout.widget.ConstraintLayout>

</androidx.coordinatorlayout.widget.CoordinatorLayout>

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