了解此API、以生命周期感知方式收集数据流的理由

• 使用界面状态
  https://developer.android.google.cn/topic/architecture/ui-layer#consume-ui-state

collectAsStateWithLifecycle

collectAsStateWithLifecycle 是一个可组合函数，可从数据流中收集值，并以生命周期感知方式将最新值表示为 Compose State。每当数据流发出新值时，此 State 对象的值都会更新，从而让组合 (Composition) 中每个使用 State.value 的对象进行重新组合。

• State
  https://developer.android.google.cn/reference/kotlin/androidx/compose/runtime/State

默认情况下，collectAsStateWithLifecycle 使用 Lifecycle.State.STARTED 从数据流中开始和结束收集值。这些动作会在生命周期 (Lifecycle) 移入和移出目标状态时发生。您可以通过 minActiveState 参数配置此生命周期状态。

△ 默认情况下，当应用处于后台时 collectAsStateWithLifecycle 会取消收集数据流

• Lifecycle.State.STARTED
  https://developer.android.google.cn/reference/android/arch/lifecycle/Lifecycle.State#started

以下代码片段展示了如何使用 collectAsStateWithLifecycle 来收集可组合函数中的 ViewModel 所公开的 StateFlow 的 uiState 字段: 

/* Copyright 2022 Google LLC.     SPDX-License-Identifier: Apache-2.0 */
@OptIn(ExperimentalLifecycleComposeApi::class)@Composablefun AuthorRoute(  onBackClick: () -> Unit,  modifier: Modifier = Modifier,  viewModel: AuthorViewModel = hiltViewModel()) {  val uiState: AuthorScreenUiState by viewModel.uiState.collectAsStateWithLifecycle()
  AuthorScreen(    authorState = uiState.authorState,    newsState = uiState.newsState,    modifier = modifier,    onBackClick = onBackClick,    onFollowClick = viewModel::followAuthorToggle,  )}

每当 AuthorViewModel 的 uiState 发出新的 AuthorScreenUiState 值时，都会重新组合 AuthorRoute。有关 collectAsStateWithLifecycle 的更多用法，请参考 "Now in Android" 应用及相关迁移 PR。

• AuthorViewModel
  https://github.com/android/nowinandroid/blob/main/feature-author/src/main/java/com/google/samples/apps/nowinandroid/feature/author/AuthorViewModel.kt
• AuthorRoute
  https://github.com/android/nowinandroid/blob/main/feature-author/src/main/java/com/google/samples/apps/nowinandroid/feature/author/AuthorScreen.kt
• Now in Android
  https://github.com/android/nowinandroid/search?q=collectAsStateWithLifecycle
• 迁移 PR
  https://github.com/android/nowinandroid/pull/166

如果您要在项目中使用 collectAsStateWithLifecycle API，请将 androidx.lifecycle.lifecycle-runtime-compose 工件添加到项目中。

/* Copyright 2022 Google LLC.     SPDX-License-Identifier: Apache-2.0 */
// app/build.gradle filedependencies {    implementation "androidx.lifecycle2.6.0-alpha01"}

• 版本 2.6.0-alpha01
  https://developer.android.google.cn/jetpack/androidx/releases/lifecycle#version_26_2

• ExperimentalLifecycleComposeApi
  https://developer.android.google.cn/reference/kotlin/androidx/lifecycle/compose/ExperimentalLifecycleComposeApi

工作原理

collectAsStateWithLifecycle 在实现机制上使用了 repeatOnLifecycle API，我们也推荐大家在 Android 视图 (View) 系统中收集数据流的 API。

• collectAsStateWithLifecycle 的实现机制
  https://cs.android.com/androidx/platform/frameworks/support/+/androidx-main:lifecycle/lifecycle-runtime-compose/src/main/java/androidx/lifecycle/compose/FlowExt.kt;l=168

• repeatOnLifecycle
  https://developer.android.google.cn/reference/kotlin/androidx/lifecycle/package-summary#(androidx.lifecycle.Lifecycle).repeatOnLifecycle(androidx.lifecycle.Lifecycle.State,kotlin.coroutines.SuspendFunction1)

借助 collectAsStateWithLifecycle，您无需输入下方的样板代码，这些代码同样以生命周期感知的方式从可组合函数收集数据流: 

/* Copyright 2022 Google LLC.           SPDX-License-Identifier: Apache-2.0 */@Composablefun AuthorRoute(...) {    val lifecycle = LocalLifecycleOwner.current.lifecycle    val uiState by produceState(        initialValue = viewModel.uiState.value        key1 = lifecycle        key2 = viewModel    ) {        lifecycle.repeatOnLifecycle(state = STARTED) {            viewModel.uiState.collect { value = it }        }    }
    AuthorScreen(...)}

在架构中收集数据流

应用架构中的类型不应该知道其他类型的实现细节。界面不应该知道 ViewModel 如何产生界面状态。如果界面在屏幕上不可见，则应停止收集数据流，以释放应用资源 (如果可行的话)。

界面可以通过使用 collectAsStateWithLifecycle 收集界面状态来帮助释放资源。ViewModel 可以通过以收集器感知的方式生成界面状态来完成相同的操作。如果没有收集器，例如当界面在屏幕上不可见时，则停止收集来自数据层的上游数据流。您可以在生成界面状态时使用 .stateIn(WhileSubscribed) 数据流 API 来执行此操作。如需了解更多信息，请观看 "Kotlin Flows 实战" 讲座的这一部分。如要测试以这种方法生成界面状态的 ViewModel，请查看测试指南。

△ 在界面层中，使用 collectAsStateWithLifecycle 收集界面状态，并在数据层公开响应式数据流时使用 .stateIn(WhileSubscribed) 生成界面状态。这样一来应用的其余部分便能在不需要的时候释放资源

• .stateIn(WhileSubscribed)
  https://github.com/android/nowinandroid/blob/main/feature-author/src/main/java/com/google/samples/apps/nowinandroid/feature/author/AuthorViewModel.kt#L104

• Kotlin Flows 实战
  https://www.youtube.com/watch?v=fSB6_KE95bU&t=1009s

• 测试 StateFlow
  https://developer.android.google.cn/kotlin/flow/test#statein

数据流的使用者和生产者不需要知道彼此的实现方式。在具备多个环境、变体、代码库和功能的大型应用中找出实现细节是非常耗时的。更糟糕的是，依赖于实现细节的代码维护起来非常困难。

让资源在后台保持活跃状态

• CPU 使用: 在所有设备组件中，CPU 的耗电量最高。而电池续航时间一直是用户关注的重点，因此如果发生 CPU 滥用的情况，用户可能会卸载您的应用；

• 流量消耗: 在未连接 Wi-Fi 时减少应用的网络流量，可以帮助用户节省流量费用；

• 内存用量: 应用对内存的使用方式也会对设备的整体稳定性和性能产生非常大的影响。

• 为数十亿用户打造产品
  https://developer.android.google.cn/docs/quality-guidelines/build-for-billions

与 collectAsState 的差异

可组合函数的生命周期与 Compose 运行的平台无关。正如 "可组合项的生命周期" 页面中所述，可组合函数的实例进入组合，执行 0 次或多次重组，然后离开组合:

△ 组合中可组合函数实例的生命周期

collectAsState API 遵循组合的生命周期。此 API 在可组合项进入组合时开始收集数据流，并在可组合项离开组合时停止收集。collectAsState 是用于收集数据流且与平台无关的 API。

collectAsState 和 collectAsStateWithLifecycle 在 Compose 中各有用途。后者用于开发 Android 应用，前者用于在其他平台进行开发。

从 collectAsState 迁移到 collectAsStateWithLifecycle 非常容易: 

/* Copyright 2022 Google LLC.     SPDX-License-Identifier: Apache-2.0 */
@Composablefun AuthorRoute(...) {    val lifecycle = LocalLifecycleOwner.current.lifecycle    val uiState by produceState(        initialValue = viewModel.uiState.value        key1 = lifecycle        key2 = viewModel    ) {        lifecycle.repeatOnLifecycle(state = STARTED) {            viewModel.uiState.collect { value = it }        }    }
    AuthorScreen(...)}

• Jose Alcérreca
  https://medium.com/u/e0a4c9469bb5

• Marton Braun
  https://medium.com/u/ec2087b3c81f

• Alejandra Stamato
  https://medium.com/u/92c44d274e60