Android Tabbed Activity点击FAB通过ViewModel修改Fragment文本问题

默认Tabbed Activity模板生成的代码中，每个标签页Fragment独立初始化自己的PageViewModel实例，和MainActivity持有的ViewModel不是同一个对象，因此Activity中修改ViewModel数据时，Fragment无法收到更新通知。

1. 统一ViewModel作用域 #

必须保证MainActivity和所有标签页Fragment使用同一个PageViewModel实例，这是数据同步的核心前提

• 在MainActivity中初始化绑定Activity生命周期的PageViewModel：

class MainActivity : AppCompatActivity() {
    private lateinit var binding: ActivityMainBinding
    // 声明共享ViewModel
    private lateinit var pageViewModel: PageViewModel

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        binding = ActivityMainBinding.inflate(layoutInflater)
        setContentView(binding.root)

        // 初始化Activity级别的共享ViewModel，所有同Activity下的Fragment都能拿到同一个实例
        pageViewModel = ViewModelProvider(this)[PageViewModel::class.java]

        val sectionsPagerAdapter = SectionsPagerAdapter(this, supportFragmentManager)
        val viewPager: ViewPager = binding.viewPager
        viewPager.adapter = sectionsPagerAdapter
        val tabs: TabLayout = binding.tabs
        tabs.setupWithViewPager(viewPager)
        val fab: FloatingActionButton = binding.fab

        fab.setOnClickListener { view ->
            Snackbar.make(view, "文本已更新", Snackbar.LENGTH_LONG)
                .setAction("Action", null).show()
            // 点击FAB时直接调用ViewModel的更新方法即可
            pageViewModel.onInc()
            // 如果要自定义文本，调用后续新增的更新方法即可
            // pageViewModel.updateText("FAB点击后更新的自定义文本")
        }
    }
}

• 修改标签页Fragment获取ViewModel的方式，不要使用Fragment自身作为作用域，改为使用宿主Activity的作用域：

// 标签页Fragment（默认模板叫PlaceholderFragment）中
class PlaceholderFragment : Fragment() {
    private lateinit var pageViewModel: PageViewModel
    private var _binding: FragmentPlaceholderBinding? = null
    private val binding get() = _binding!!

    override fun onCreateView(
        inflater: LayoutInflater, container: ViewGroup?,
        savedInstanceState: Bundle?
    ): View {
        _binding = FragmentPlaceholderBinding.inflate(inflater, container, false)
        return binding.root
    }

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        // 核心修改：使用requireActivity()作为ViewModelStoreOwner，获取和Activity同一个实例
        pageViewModel = ViewModelProvider(requireActivity())[PageViewModel::class.java]
        
        // 观察ViewModel中的数据变化，更新TextView
        pageViewModel.text.observe(viewLifecycleOwner) { text ->
            binding.sectionLabel.text = text
        }
        // 如果要显示分数，可追加观察逻辑
        pageViewModel.score.observe(viewLifecycleOwner) { score ->
            binding.sectionLabel.append("\n当前分数：$score")
        }
    }

    override fun onDestroyView() {
        super.onDestroyView()
        _binding = null
    }
}

2. 扩展PageViewModel支持自定义文本更新 #

如果需要点击FAB时修改任意显示文本，在原有PageViewModel中新增自定义文本的LiveData和更新方法即可：

class PageViewModel : ViewModel() {
    private val _index = MutableLiveData<Int>()
    // 当前分数
    private val _score = MutableLiveData<Int>()
    // 新增：自定义显示文本
    private val _customText = MutableLiveData<String>()

    // 合并多个数据源生成最终显示的文本
    val displayText: LiveData<String> = MediatorLiveData<String>().apply {
        addSource(_index) { value = buildFinalText() }
        addSource(_score) { value = buildFinalText() }
        addSource(_customText) { value = buildFinalText() }
    }

    val score: LiveData<Int> get() = _score

    init {
        _score.value = 0
        Log.i("PageViewModel", "PageViewModel created!")
    }

    private fun buildFinalText(): String {
        val index = _index.value ?: 0
        val score = _score.value ?: 0
        val customText = _customText.value ?: "Hello world from section: $index"
        return "$customText\n当前分数：$score"
    }

    fun onInc() {
        _score.value = (_score.value ?: 0) + 1
    }

    fun setIndex(index: Int) {
        _index.value = index
    }

    // 新增：更新自定义文本的方法
    fun updateText(content: String) {
        _customText.value = content
    }
}

修改完后Fragment中只需要观察displayText即可，不需要再分别观察多个字段。

3. （可选）开启数据绑定省略手写观察逻辑 #

如果需要用数据绑定自动关联数据和UI，不需要手动写observe回调，按以下步骤修改：

1. 模块级build.gradle中开启dataBinding：

android {
    // ... 其他配置
    buildFeatures {
        dataBinding true
    }
}

2. 修改标签页的布局文件，外层加layout标签，声明ViewModel变量：

<?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="pageViewModel"
            type="替换为你自己的PageViewModel全路径包名" />
    </data>
    <androidx.constraintlayout.widget.ConstraintLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent">

        <TextView
            android:id="@+id/section_label"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="@{pageViewModel.displayText}"
            android:layout_gravity="center"
            app:layout_constraintTop_toTopOf="parent"
            app:layout_constraintBottom_toBottomOf="parent"
            app:layout_constraintStart_toStartOf="parent"
            app:layout_constraintEnd_toEndOf="parent"/>

    </androidx.constraintlayout.widget.ConstraintLayout>
</layout>

3. 在Fragment中完成数据绑定关联，无需手动写observe：

override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    pageViewModel = ViewModelProvider(requireActivity())[PageViewModel::class.java]
    // 绑定生命周期和ViewModel
    binding.lifecycleOwner = viewLifecycleOwner
    binding.pageViewModel = pageViewModel
}

修改完成后，点击FAB调用ViewModel的更新方法，所有标签页的TextView会自动刷新内容。

• 禁止在Fragment中通过ViewModelProvider(this)获取PageViewModel，否则会生成Fragment独立的ViewModel实例，无法和Activity同步数据
• 观察LiveData时必须使用viewLifecycleOwner作为生命周期所有者，避免内存泄漏

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