SavedStateHandle 实现代码实战：定义 ViewModel、注入 SavedStateHandle、读写状态、验证持久化效果

SavedStateHandle 是 Android Architecture Components 提供的一个轻量级状态保存工具，它封装了 Bundle 的读写逻辑，能在 Activity 或 Fragment 因配置变更（如屏幕旋转）或系统回收后重建时，自动保留指定状态。其核心原理是：ViewModel 通过构造函数接收 SavedStateHandle，框架会将状态序列化到 Bundle 并存储在 SavedStateRegistryController 中；当进程重建时，handle 从相同的 Bundle 恢复数据，从而实现跨生命周期持久化。

一、实现流程

1. 定义 ViewModel 并声明 SavedStateHandle 构造参数 —— 在 ViewModel 构造函数中添加 savedStateHandle: SavedStateHandle 参数，框架会自动注入。
2. 在 Repository / DataSource 中读写状态 —— 通过 savedStateHandle.getLiveData(key) 或 getStateFlow(key) 获取可观察数据，或使用 get(key) / set(key, value) 进行一次性读写。
3. 在 Activity / Fragment 中实例化 ViewModel —— 使用 ViewModelProvider(this).get(MyViewModel::class.java)，无需手动传参。
4. 验证持久化效果 —— 触发屏幕旋转或通过开发者选项“不保留活动”强制销毁重建，观察状态是否恢复。

二、完整代码示例

以下是一个典型的 SavedStateHandle 实战 ViewModel：

// MyViewModel.kt
class MyViewModel(
    private val savedStateHandle: SavedStateHandle
) : ViewModel() {

    // 使用 LiveData 形式，带默认值
    val count: LiveData<Int> = savedStateHandle.getLiveData("count", 0)

    fun increment() {
        val current = savedStateHandle.get<Int>("count") ?: 0
        savedStateHandle["count"] = current + 1
    }

    // 直接使用 StateFlow 写法（需依赖 lifecycle-viewmodel-ktx）
    val userName: StateFlow<String> = savedStateHandle
        .getStateFlow("userName", "Guest")

    fun updateName(name: String) {
        savedStateHandle["userName"] = name
    }
}

在 Activity 中使用：

class MainActivity : AppCompatActivity() {
    private lateinit var viewModel: MyViewModel

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

        viewModel = ViewModelProvider(this)[MyViewModel::class.java]

        viewModel.count.observe(this) { value ->
            findViewById<TextView>(R.id.tvCount).text = value.toString()
        }

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

三、SavedStateHandle 与常规状态管理对比

四、调试：验证持久化效果

• 屏幕旋转测试：旋转设备，观察 count 值是否仍保持递增结果。
• 强制进程重建：在开发者选项中开启“不保留活动”，压 Home 键后再回到 App，检查状态。
• 日志验证：在 ViewModel 的 init 或 onCleared() 中添加 Log，确认重建后 ViewModel 实例是否重新创建且状态恢复。

// 调试日志示例
init {
    val saved = savedStateHandle.get<Int>("count")
    Log.d("MyViewModel", "ViewModel初始化，已有count=$saved")
}

五、常见错误与避坑

六、性能与稳定性优化

• 避免大对象频繁写入：每个 set() 都会触发序列化，大量图片 / bitmap 应存储在文件或数据库，仅保存轻量标识。
• 使用 StateFlow 替代 LiveData：StateFlow 支持协程配合，且默认支持防抖（distinctUntilChanged），减少冗余通知。
• 及时清理临时数据：对于仅在配置变更时需要保留、重建后不再需要的数据，可考虑在 ViewModel 的 onCleared() 中移除 key，避免残留 Bundle 占用内存。