将 Lifecycle 与 Compose 集成

Lifecycle 库提供内置 API，可让您与 Jetpack Compose 集成。关键 API 包括：

• 当前 Lifecycle.State 的 Flow。
• LifecycleEffects 允许您根据特定的 Lifecycle.Event 运行代码块。

这些集成提供了方便的挂钩，用于在 Compose 层次结构中管理生命周期。本文档概述了如何在您的应用中使用它们。

使用 Flow 收集生命周期状态

Lifecycle 公开了一个 currentStateFlow 属性，该属性提供当前 Lifecycle.State 作为 Kotlin StateFlow。您可以将此 Flow 收集为 State。这允许您的应用在组合期间读取生命周期的更改。

val lifecycleOwner = LocalLifecycleOwner.current
val stateFlow = lifecycleOwner.lifecycle.currentStateFlow
…
val currentLifecycleState by stateFlow.collectAsState()

可以使用 lifecycle-common 模块访问前面的示例。currentStateAsState() 方法可在 lifecycle-runtime-compose 模块中使用，只需一行代码即可方便地读取当前的生命周期状态。以下示例演示了这一点。

val lifecycleOwner = LocalLifecycleOwner.current
val currentLifecycleState = lifecycleOwner.lifecycle.currentStateAsState()

在生命周期事件上运行代码

还有一些 LifecycleEffects 允许您在发生特定 Lifecycle.Event 时运行代码块。

LifecycleEventEffect(Lifecycle.Event.ON_START) {
  // do something here
}

除了 LifecycleEventEffect 之外，您还可以使用 LifecycleStartEffect 和 LifecycleResumeEffect。这些 API 与特定事件相关联。它们还在其主代码块中提供一个额外的代码块，用于帮助清理事件可能触发的任何代码。

LifecycleStartEffect

LifecycleStartEffect 与 LifecycleEffect 类似，但它仅在 Lifecycle.Event.ON_START 事件上运行。它还接受像其他 Compose 密钥一样的密钥。当密钥更改时，它会触发代码块再次运行。

当发生Lifecycle.Event.ON_STOP事件或效果退出组合时，它会执行onStopOrDispose块。这允许清理启动块中任何部分的工作。

LifecycleStartEffect {
  // ON_START code is executed here

  onStopOrDispose {
    // do any needed clean up here
  }
}

LifecycleResumeEffect

LifecycleResumeEffect的工作方式与LifecycleStartedEffect相同，但它在Lifecycle.Event.ON_RESUME事件上执行。它还提供了一个onPauseOrDispose块来执行清理。

LifecycleResumeEffect {
  // ON_RESUME code is executed here

  onPauseOrDispose {
    // do any needed clean up here
  }
}