Android数据绑定问题：Include布局共享ViewModel同步数据失败

核心问题原因 #

Include布局不会自动继承主布局的ViewModel实例，必须显式传递绑定变量，否则子布局的双向绑定会失效，导致link变量始终为空。

正确实现步骤 #

1. 子布局声明绑定变量 #

在包含EditText的子布局（例如layout_edit_link.xml）中，必须定义与主布局一致的ViewModel变量：

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android">
    <data>
        <variable
            name="viewModel"
            type="com.yourpackage.MainScreenLogic" />
    </data>

    <EditText
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="@={viewModel.link}" />
</layout>

2. 主布局显式传递ViewModel #

主布局使用Include标签时，必须通过自定义属性传递ViewModel，同时给Include设置android:id（否则DataBinding无法关联子布局绑定）：

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto">
    <data>
        <variable
            name="viewModel"
            type="com.yourpackage.MainScreenLogic" />
    </data>

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:orientation="vertical">

        <include
            android:id="@+id/include_link"
            layout="@layout/layout_edit_link"
            app:viewModel="@{viewModel}" />

    </LinearLayout>
</layout>

3. ViewModel变量符合双向绑定要求 #

ViewModel中的link需使用MutableLiveData或ObservableField，确保DataBinding能识别双向绑定：

class MainScreenLogic : ViewModel() {
    // 使用MutableLiveData的写法
    val link = MutableLiveData<String>()

    // 或使用ObservableField的写法
    // val link = ObservableField<String>("")
}

4. 主页面绑定ViewModel并设置生命周期所有者 #

在Activity/Fragment中，确保ViewModel正确绑定到布局，并设置lifecycleOwner让LiveData感知生命周期：

class MainActivity : AppCompatActivity() {
    private lateinit var binding: ActivityMainBinding
    private lateinit var viewModel: MainScreenLogic

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        binding = DataBindingUtil.setContentView(this, R.layout.activity_main)
        viewModel = ViewModelProvider(this)[MainScreenLogic::class.java]
        binding.viewModel = viewModel
        binding.lifecycleOwner = this
    }
}

常见错误排查 #

• 未给Include设置android:id：无ID会导致DataBinding无法关联子布局的绑定变量。
• 子布局未声明同名ViewModel变量：子布局必须有对应variable定义才能接收传递的实例。
• 双向绑定语法错误：必须用@={}而非@{}，后者是单向绑定。
• 未设置lifecycleOwner：使用LiveData时，不绑定生命周期会导致数据更新无法同步到UI。

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