Jetpack Compose 高级应用与原理（2）：高级状态管理：超越 remember { mutableStateOf(...) }

本文是「Jetpack Compose 高级应用与原理」系列的第 2 篇，共 3 篇。在上一篇中，我们探讨了「引言：声明式 UI 的范式革命」的相关内容。

三、高级状态管理：超越 remember { mutableStateOf(…) }

Compose 提供了丰富且强大的状态管理机制。

1. 基础状态类型

• State<T> 与 MutableState<T>： Compose 中状态的基本表示。读取 .value 会订阅重组，写入 .value 会触发重组（对于 MutableState）；
• remember： 保证在重组期间状态（或任何计算结果）得以保留。

2. 快照系统（Snapshot System）——并发状态的核心

• 概念： Compose 状态管理建立在一个类似软件事务内存（STM）的快照系统之上。对 MutableState 的所有写入操作首先发生在当前线程的一个隔离的快照中。这些修改对其他线程（或其他正在进行的重组）是不可见的。只有当这个快照被**应用（Apply）**时（通常由 Compose 框架在事件处理结束或下一帧开始时自动完成），这些修改才会成为全局可见状态，并触发相应的重组；
• 优点：
  • 原子性： 一系列状态修改要么一起应用，要么都不应用；
  • 隔离性： 并发的读取（如重组过程）不会读到尚未应用的、不一致的中间状态；
  • 一致性： 保证 UI 状态的一致性；
• 支撑功能： 快照系统是 derivedStateOf、多线程状态修改等高级功能的基础。

3. 状态提升（State Hoisting）

• 模式： 将状态（State 对象）提升到 Composable 层级树中需要访问该状态的所有组件的最低共同祖先那里进行管理。子组件接收不可变的状态数据作为参数，并通过回调函数（Lambda）将事件/修改请求向上传递给状态所有者；
• 优点：
  • 单一数据源（Single Source of Truth）： 状态集中管理，避免状态副本和不一致；
  • 可复用性： 子组件不持有状态，变得更通用、可复用；
  • 可测试性： 子组件更容易进行预览和单元测试（传入假数据和空 lambda）。状态管理逻辑也可以在提升后的位置进行独立测试。

这是 Compose 中构建可维护 UI 的核心模式。

4. ViewModel 与状态持有器（State Holders）

• ViewModel： 通常作为屏幕级别状态的持有者和业务逻辑处理单元（遵循 Android 架构组件建议）。ViewModel 中的状态（如通过 StateFlow 暴露）驱动整个屏幕的 UI；
• State Holder Class： 对于某个特定复杂 Composable（如下拉菜单、可编辑列表项）的状态和 UI 逻辑，可以创建一个普通的 Kotlin 类作为其状态持有器。这个类持有相关的 MutableState，并提供处理事件的方法。Composable 函数创建并 remember 这个状态持有器实例，并将状态和事件处理委托给它。优点： 使得 Composable 函数本身更简洁（只负责描述 UI），并将状态逻辑封装起来，易于测试和复用。

5. 衍生与生产状态

• derivedStateOf { calculation }：

  • 场景： 当某个 UI 状态需要根据一个或多个其他 State 对象计算得出时使用；
  • 智能计算： calculation Lambda 只在它的某个内部读取的 State 对象的值实际发生变化时才会重新执行。如果依赖的 State 触发了重组，但其值并未改变，derivedStateOf 不会重新计算；
  • 优点： 避免了不必要的、可能昂贵的计算，优化性能。例如，根据列表状态计算「全选」按钮是否启用。

• produceState(initialValue, key1, …) { … }：

  • 场景： 需要将非 Compose 状态（如来自 Flow、LiveData，或需要执行 suspend 函数获取的数据）转换为 Compose 的 State；
  • 机制： 启动一个与 Composition 绑定的协程。在这个协程的作用域内，可以通过 value = ... 来更新 State。如果任何 key 参数发生变化，当前协程会被取消，并启动一个新的协程来重新生产状态；
  • 优点： 将异步数据源桥接到 Compose 状态系统的标准方式。自动处理协程的启动、取消和重启。

• Flow.collectAsState() / Flow.collectAsStateWithLifecycle()：

  • 场景： 将 Kotlin Flow（冷流或 StateFlow/SharedFlow）转换为 Compose State；
  • collectAsState()：简单地收集 Flow 并在新值到达时更新 State；
  • collectAsStateWithLifecycle()（推荐）：在遵循组件生命周期的情况下收集 Flow（例如，在 onStop 时停止收集，onStart 时恢复），可以避免在后台不必要地消耗资源。需要添加 androidx.lifecycle.runtime.compose 依赖。

6. 状态保存与恢复（rememberSaveable）

• 场景： 需要在 Activity 或进程因配置更改（如旋转屏幕）或系统回收而重建后，恢复 UI 状态；
• 用法： 使用 rememberSaveable { mutableStateOf(...) } 替代 remember；
• 要求： 状态的类型必须能够被存储在 Bundle 中（原始类型、Parcelable、Serializable，或提供了自定义的 Saver 对象）；
• 原理： 底层利用了 Android 的 onSaveInstanceState / onCreate(savedInstanceState) 机制。

---

四、副作用处理：与 Compose 世界之外的互动

Composable 函数的核心职责是描述 UI，它们本身应该是纯净的。任何需要与外部世界交互（如网络请求、数据库读写、启动协程、注册监听器）的操作都属于副作用（Side Effect），必须使用特定的 Effect API 来安全地执行。

1. 为什么需要 Effect API？

直接在 Composable 函数体中执行副作用会导致：

• 不可预测的执行： Composable 可能在每次重组时都执行，导致副作用被意外触发多次；
• 生命周期问题： 副作用可能需要在 Composable 进入或离开 Composition 时启动或清理（如注册/注销监听器），直接写在函数体中无法实现。

2. 关键 Effect API

• LaunchedEffect(key1, key2, …) { block }：

  • 行为： 当 LaunchedEffect 首次进入 Composition 时，或者当其任何一个 key 参数发生变化时，启动一个新的协程来执行 block 中的 suspend 函数。当 key 变化或 Composable 离开 Composition 时，上一个协程会被自动取消；
  • 用途： 执行与 Compose 状态变化或生命周期相关的一次性或可重启的 suspend 操作。例如：根据 userId 获取用户数据、在 scaffoldState 变化时显示 Snackbar、基于某个状态触发一次动画；
  • 关键点： key 参数决定了 block 何时重新执行。key1 = Unit 或 key1 = true 表示只在进入时执行一次。

• rememberCoroutineScope()：CoroutineScope：

  • 行为： 获取一个绑定到当前 Composable 调用点的生命周期的 CoroutineScope；
  • 用途： 需要在非 Composable 上下文（如按钮的 onClick lambda）中启动一个与 UI 生命周期同步的协程时使用。这个协程会在 Composable 离开 Composition 时自动取消；
  • 对比 LaunchedEffect： LaunchedEffect 在 Composable 进入/key 变化时自动启动协程；rememberCoroutineScope 提供一个作用域让你在需要时（如事件回调中）手动 launch 协程。

• DisposableEffect(key1, key2, …) { onDispose { cleanup } }：

  • 行为： 当 DisposableEffect 进入 Composition 或 key 变化时，执行其主 block（通常用于设置）。它必须返回一个 onDispose lambda。当 Composable 离开 Composition 或 key 变化导致 Effect 重启时，onDispose lambda 会被执行；
  • 用途： 管理需要**清理（cleanup）**的资源或回调。例如：注册并注销 BroadcastReceiver、添加并移除 LifecycleObserver、订阅并取消订阅外部数据源；
  • 关键点： onDispose 是其核心，用于执行配对的清理操作。

• SideEffect { block }：

  • 行为： block 中的代码会在每次成功的重组之后被调用；
  • 用途： 用于将 Compose 的状态同步给非 Compose 管理的外部对象（「发布」状态）。例如，将当前的 Compose 状态值更新到一个外部的分析库或日志系统中。使用场景非常有限，需谨慎。

• produceState（也是 Effect）： 如前所述，用于将异步源转换为 State，本质上也是启动了一个受管理的协程。

• rememberUpdatedState(value)：State<T>：

  • 场景： 在一个可能长时间运行的 Effect（如 LaunchedEffect 或 DisposableEffect 的 onDispose）中，需要访问某个传入 Composable 的最新值，而不是 Effect 启动时捕获的旧值；
  • 用法： val latestOnValueChange by rememberUpdatedState(onValueChange)。在 Effect 的 lambda 中始终使用 latestOnValueChange；
  • 优点： 避免了因为 key 没有变化而导致 Effect 内部捕获了过时的 lambda 或状态值。

---

---

下一篇我们将探讨「Compose 布局模型：声明式的测量与放置」，敬请关注本系列。

「Jetpack Compose 高级应用与原理」系列目录

1. 引言：声明式 UI 的范式革命
2. 高级状态管理：超越 remember { mutableStateOf(…) }（本文）
3. Compose 布局模型：声明式的测量与放置