Kotlin ViewModel
2026/5/11 18:01:40 网站建设 项目流程

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 实例更长。

阶段说明
创建当 Activity 第一次启动时
存活当 Activity 因为旋转屏幕而销毁并重新创建时,ViewModel 依然存在
销毁只有当 Activity 真正彻底结束(调用finish())或进程被杀掉时,ViewModel 才会调用onCleared()并销毁

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 的注入方式略有不同)。

关键点说明
依赖添加lifecycle-viewmodel-ktx + activity-ktx
实例化方式by viewModels()ViewModelProvider,禁止new MyViewModel()
数据管理配合 StateFlow / LiveData 实现响应式
生命周期跨配置变化存活,真正 finish 时销毁
最佳实践不持有 Context,单向数据流,轻量化

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询