3. 基本用法——保存简单类型

3.1 原理概述

ViewModel 借助 SavedStateHandle 在配置变更（如屏幕旋转）时保存和恢复简单类型数据。SavedStateHandle 内部维护一个 Map<String, Object> 键值存储，进程未被杀死前数据保留在内存中；进程被系统回收后，数据会序列化到 Bundle，通过 onSaveInstanceState 持久化到磁盘，重建时再反序列化恢复。

3.2 支持的数据范围

3.3 实现流程

1. 创建 ViewModel：继承 ViewModel，构造函数接收 SavedStateHandle 参数；
2. 声明可观察状态：使用 getLiveData() 或 getStateFlow()，并传入默认值；
3. 在 Activity / Fragment 中获取状态：通过 viewModel.state.observe(...) 或 viewModel.stateFlow.collect(...) 订阅；
4. 更新状态：调用 savedStateHandle.set() 或直接通过 LiveData/StateFlow 的 setValue 更新；
5. 自动保存：配置变更或进程重建时，SavedStateHandle 自动将最新值持久化。

3.4 getLiveData 与 getStateFlow 方法详解

3.5 默认值设置规则

默认值在首次创建 SavedStateHandle 且对应 key 不存在时生效。规则如下：

• 默认值通过方法的第二个参数传入：getLiveData("count", 0)；
• 若 SavedStateHandle 中已存在该 key（如进程重建后），默认值不会覆盖已恢复的值；
• 默认值类型必须与泛型参数一致，否则编译报错或运行时 ClassCastException。

3.6 完整代码示例

CountViewModel.kt

class CountViewModel(
    private val savedStateHandle: SavedStateHandle
) : ViewModel() {

    // 使用 getLiveData — 默认值为 0
    val countLiveData: LiveData<Int> =
        savedStateHandle.getLiveData("count", 0)

    // 使用 getStateFlow — 默认值为 "默认文本"
    val textStateFlow: StateFlow<String> =
        savedStateHandle.getStateFlow("text", "默认文本")

    // Boolean 状态 — 默认值为 false
    val isEnabledLiveData: LiveData<Boolean> =
        savedStateHandle.getLiveData("enabled", false)

    fun increment() {
        val current = savedStateHandle.get("count") ?: 0
        savedStateHandle.set("count", current + 1)
    }

    fun updateText(newText: String) {
        savedStateHandle.set("text", newText)
    }

    fun toggleEnabled() {
        val current = savedStateHandle.get("enabled") ?: false
        savedStateHandle.set("enabled", !current)
    }
}

MainActivity.kt

class MainActivity : AppCompatActivity() {

    private val viewModel: CountViewModel by viewModels()

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        // LiveData 观察
        viewModel.countLiveData.observe(this) { count ->
            findViewById<TextView>(R.id.tvCount).text = count.toString()
        }

        viewModel.isEnabledLiveData.observe(this) { enabled ->
            findViewById<Button>(R.id.btnAction).isEnabled = enabled
        }

        // StateFlow 观察（需配合 lifecycleScope）
        lifecycleScope.launch {
            repeatOnLifecycle(Lifecycle.State.STARTED) {
                viewModel.textStateFlow.collect { text ->
                    findViewById<EditText>(R.id.etInput).setText(text)
                }
            }
        }

        findViewById<Button>(R.id.btnIncrement).setOnClickListener {
            viewModel.increment()
        }

        findViewById<Button>(R.id.btnToggle).setOnClickListener {
            viewModel.toggleEnabled()
        }
    }
}

3.7 内部流程可视化

下图展示了 SavedStateHandle 在配置变更和进程重建时对 String / Int / Boolean 等简单类型的保存与恢复流程：

3.8 调试技巧

• 验证恢复是否生效：在开发者选项中开启“不保留活动”，切换后台再返回，观察状态是否正确恢复；
• 检查 SavedStateHandle 内容：在 ViewModel 中添加日志，输出 savedStateHandle.keys() 查看当前所有 key 和对应值；
• 默认值触发测试：首次安装启动时观察默认值是否展示，确认 getLiveData / getStateFlow 的第二个参数已正确传递。

3.9 常见错误与避坑

3.10 性能与稳定性建议

• 避免在 SavedStateHandle 中保存大对象：序列化/反序列化大量数据会拖慢 Activity 重建速度，建议仅保存 String、Int、Boolean 等轻量状态；
• 不要频繁更新状态：每次 set() 都会触发 LiveData / StateFlow 通知，若在循环或高频事件中更新，考虑加入防抖或去重逻辑；
• 默认值使用常量：避免每次创建 ViewModel 时动态生成默认值对象，减少不必要的内存分配；
• 日志埋点监控恢复成功率：在 SavedStateHandle.keys() 不为空时输出恢复日志，便于定位异常状态。