Kotlin ViewModel

Kotlin ViewModel 全流程指南

ViewModel 的核心作用是以注重生命周期的方式存储和管理界面相关的数据。它最伟大的地方在于：当手机屏幕旋转（配置更改）导致 Activity 重建时，ViewModel 中的数据不会丢失。

大纲

1. 添加依赖
2. 创建 ViewModel 类
3. 在-activity-或-fragment-中初始化
4. ViewModel 的生命周期
5. 核心准则 Best Practices
6. 总结

1. 添加依赖

在build.gradle.kts (Module: app)中添加 Lifecycle 库：

dependencies{vallifecycle_version="2.8.0"// 请检查最新版本implementation("androidx.lifecycle:lifecycle-viewmodel-ktx:$lifecycle_version")implementation("androidx.lifecycle:lifecycle-livedata-ktx:$lifecycle_version")// 如果在 Activity/Fragment 中使用 'by viewModels()' 扩展implementation("androidx.activity:activity-ktx:1.9.0")}

2. 创建 ViewModel 类

ViewModel 应该存放所有的 UI 数据逻辑。建议配合 StateFlow 或 LiveData 使用，以实现响应式编程。

importandroidx.lifecycle.ViewModelimportkotlinx.coroutines.flow.MutableStateFlowimportkotlinx.coroutines.flow.StateFlowclassMyViewModel:ViewModel(){// 使用 StateFlow 管理状态privateval_counter=MutableStateFlow(0)valcounter:StateFlow<Int>=_counterfunincrementCounter(){_counter.value+=1}}

3. 在 Activity 或 Fragment 中初始化

⚠️ 千万不要直接通过val vm = MyViewModel()来实例化，否则它就失去了生命周期感知的特性。必须通过 ViewModelProvider 或by viewModels()委托。

3.1 在 Activity 中

classMainActivity:AppCompatActivity(){// 使用 ktx 扩展函数（推荐）privatevalviewModel:MyViewModelbyviewModels()overridefunonCreate(savedInstanceState:Bundle?){super.onCreate(savedInstanceState)setContentView(R.layout.activity_main)// 观察数据变化（以 Flow 为例）lifecycleScope.launch{repeatOnLifecycle(Lifecycle.State.STARTED){viewModel.counter.collect{count->// 更新 UI，例如：textView.text = count.toString()}}}}}

3.2 在 Fragment 中（共享 ViewModel）

如果你希望 Fragment 之间共享数据，可以使用activityViewModels()。

classMyFragment:Fragment(){// 与宿主 Activity 共享同一个 ViewModel 实例privatevalsharedViewModel:MyViewModelbyactivityViewModels()}

4. ViewModel 的生命周期

理解 ViewModel 的生命周期至关重要。它的存活时间比具体的 Activity 实例更长。

5. 核心准则 (Best Practices)

5.1 禁止持有 Context

⚠️ 绝对不要在 ViewModel 中引用 Activity、Fragment 或 View（会导致内存泄漏）。

如果需要 Context，请继承AndroidViewModel(application)：

classMyAndroidViewModel(application:Application):AndroidViewModel(application){privatevalprefs=application.getSharedPreferences("my_prefs",Context.MODE_PRIVATE)funsaveData(key:String,value:String){prefs.edit().putString(key,value).apply()}}

5.2 单向数据流

UI 观察 ViewModel 的状态 → UI 的操作调用 ViewModel 的方法 ↓ 不要在 UI 中直接修改 ViewModel 的变量

5.3 轻量化

• ViewModel只负责逻辑和数据
• ViewModel不负责处理复杂的 UI 动画或具体的框架调用

总结

你是正在做传统的 XML 布局开发，还是已经在使用 Jetpack Compose 了？（Compose 中 ViewModel 的注入方式略有不同）。