原生移动开发 / 系统课时
ViewModel 生命周期
ViewModel 生命周期
这一节用一个可旋转页面观察 ViewModel 的存活边界:配置变更会重建 Activity,但同一页面作用域内的 ViewModel 会被复用;真正离开页面后它才会被清理。完成示例后,你还能区分配置变更、主动结束和进程死亡三种情况。
学习目标
- 创建页面作用域的
ViewModel,并从 Compose 页面读取其状态 - 解释配置变更时 Activity 与 ViewModel 为什么具有不同的生命周期
- 判断
onCleared()何时会执行,以及 ViewModel 不能解决哪些持久化问题
ViewModel 跟随的是作用域而不是 View 实例
ViewModel 不是 Activity 或 Fragment 的子对象,它保存在对应 ViewModelStoreOwner 的 ViewModelStore 中。Activity 因旋转等配置变更被销毁并重建时,系统会把原有的 store 交给新实例,因此同一 key 对应的 ViewModel 可以继续使用,页面状态不必重新从零开始。
当作用域永久结束,例如 Activity 调用 finish()、Fragment 被真正移除,或导航目的地从返回栈中移除,对应的 ViewModel 才会进入清理阶段。这个差异正是它适合保存屏幕级状态的原因。

用旋转页面验证复用行为
下面示例可直接放进已经启用 Jetpack Compose 的 Android 应用模块;模块需要具备 lifecycle-viewmodel-compose、lifecycle-runtime-compose、Compose Material 3 与 Kotlin Coroutines 依赖。计数值只存于 ViewModel,Activity 本身不保存它。
package com.example.viewmodeldemo
import android.os.Bundle
import android.util.Log
import androidx.activity.ComponentActivity
import androidx.activity.compose.setContent
import androidx.compose.foundation.layout.Column
import androidx.compose.material3.Button
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.runtime.getValue
import androidx.lifecycle.ViewModel
import androidx.lifecycle.compose.collectAsStateWithLifecycle
import androidx.lifecycle.viewmodel.compose.viewModel
import kotlinx.coroutines.flow.MutableStateFlow
import kotlinx.coroutines.flow.asStateFlow
import kotlinx.coroutines.flow.update
class CounterViewModel : ViewModel() {
private val _count = MutableStateFlow(0)
val count = _count.asStateFlow()
fun increment() {
_count.update { it + 1 }
}
override fun onCleared() {
Log.d("CounterVM", "onCleared")
}
}
class MainActivity : ComponentActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContent { CounterScreen() }
}
}
@Composable
fun CounterScreen(viewModel: CounterViewModel = viewModel()) {
val count by viewModel.count.collectAsStateWithLifecycle()
Column {
Text("Count: $count")
Button(onClick = viewModel::increment) {
Text("+1")
}
}
}预期结果
首次进入页面:Count: 0
点击一次 +1:Count: 1
旋转屏幕后:Count: 1
最终退出并结束 Activity:Logcat 可看到 <TIME> D/CounterVM: onCleared<TIME> 等日志前缀会随设备和 Logcat 格式变化。关键观察点不是 Activity 是否重建,而是旋转后计数仍为 1;这说明新 Activity 取得了原作用域中已存在的 ViewModel。
真正清理时会发生什么
onCleared() 适合做与 ViewModel 自身生命周期绑定的释放工作,但常见协程通常不需要手动取消:在 viewModelScope 中启动的协程会随 ViewModel 清理而取消。更重要的是,不要让 ViewModel 长期持有 Activity、Fragment、View 或其他短生命周期 UI 对象,否则会让旧页面实例无法及时回收。
onCleared() 也不是“应用进程退出回调”。如果系统直接终止整个进程,内存对象会一起消失,不能假设这个方法一定执行。因此数据库写入、文件持久化或必须完成的业务提交,不应依赖它作为最后保障。
配置变更不等于进程恢复
ViewModel 解决的是同一进程内、同一页面作用域中的状态保留。进程死亡后再次进入应用,会创建新的 ViewModel;如果某个状态必须跨进程恢复,应把持久数据写入仓库、数据库或 DataStore,把少量可恢复的页面参数交给 SavedStateHandle。
判断一个值是否适合放进 ViewModel,可以问两个问题:它是否属于当前屏幕的状态,以及它是否只需要在页面作用域内存活。满足这两个条件时,ViewModel 是合适的状态持有者;需要跨进程长期保存的数据则应下沉到持久化层。