一文弄懂 repeatOnLifecycle

repeatOnLifecycle 是 Android Jetpack 生命周期组件库中的一个实用扩展函数,主要用于在 LifecycleOwner(如 Activity 或 Fragment)的生命周期状态变化时自动启动和取消协程任务。它结合了 Kotlin 协程和生命周期感知能力,帮助开发者避免内存泄漏和无效的资源消耗。


​核心功能​

  1. 自动启停协程
    当 Lifecycle 进入或退出指定状态(如 STARTED 或 RESUMED)时,自动启动或取消协程块内的任务。
  2. 避免内存泄漏
    协程会在 Lifecycle 销毁时自动取消,无需手动管理。
  3. 简化代码
    替代传统的 lifecycle.addObserver 手动监听,减少模板代码。

​使用场景​

  • 在 Activity/Fragment 可见时(STARTED)开始数据加载,不可见时停止。
  • 替代 LiveData 的协程版本(如结合 Flow 使用)。

​基本用法​

1. 添加依赖

确保项目中已引入 lifecycle-runtime-ktx:

kotlin 复制代码
implementation "androidx.lifecycle:lifecycle-runtime-ktx:2.6.0"

2. 示例代码

kotlin 复制代码
class MyActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        
        lifecycleScope.launch {
            repeatOnLifecycle(Lifecycle.State.STARTED) {
                // 当 Activity 进入 STARTED 状态时启动协程
                someFlow.collect { data ->
                    updateUI(data)
                }
                // 当 Activity 进入 STOPPED 状态时自动取消协程
            }
        }
    }
}

​关键参数​

  • ​state​

    指定触发协程的生命周期状态(通常为 STARTED 或 RESUMED):

    • STARTED:界面可见但可能未获取焦点(适合大多数场景)。
    • RESUMED:界面完全可见且可交互(需要严格实时性的场景)。

​与 launchWhenX 的区别​

特性 repeatOnLifecycle launchWhenStarted
​协程取消时机​ 生命周期离开指定状态时取消 仅在生命周期销毁时取消
​资源效率​ 更高(及时取消) 较低(可能后台运行)
​推荐场景​ 数据流(如 Flow)收集 简单的一次性任务

​官方推荐 ​:对于 Flow 收集,优先使用 repeatOnLifecycle。


​结合 Flow 使用​

kotlin 复制代码
lifecycleScope.launch {
    repeatOnLifecycle(Lifecycle.State.STARTED) {
        viewModel.dataFlow
            .catch { /* 异常处理 */ }
            .collect { data -> updateUI(data) }
    }
}

​注意事项​

  1. 协程作用域
    需在 lifecycleScope 或 viewModelScope 中调用,确保协程与生命周期绑定。
  2. 状态选择
    根据需求选择 STARTED 或 RESUMED,避免过度频繁启停。
  3. 替代方案
    对于 Compose,可使用 collectAsStateWithLifecycle。

通过 repeatOnLifecycle,开发者可以更安全、高效地管理协程任务的生命周期,尤其适合需要响应式数据更新的场景。

相关推荐
hai_android1 天前
一行 asLiveData,背后是一座生命周期的桥
android·java·kotlin
传奇开心果编程3 天前
【Jetpack Compose娓娓道来】第44课:持久化——让数据“关掉App也不丢”
android·kotlin·移动开发·数据持久化·jetpack compose·ui框架·声明式ui
OriginCoding3 天前
一个 JDK 跑起六个分布式挑战:Kotlin 版 Gossip Glomers(一)
分布式·kotlin
alexhilton4 天前
MVI 让屏幕一次只有一个状态
android·kotlin·android jetpack
金銀銅鐵8 天前
一个 4 个常量的枚举,Kotlin 在字节码里生成了什么
jvm·kotlin
Easyhood9 天前
Android 开发入门实践(十四):Compose 副作用入门与四个常用 API
android·开发语言·kotlin·android jetpack·compose
松仔log10 天前
Kotlin中级——callbackFlow
java·前端·kotlin
zh_xuan10 天前
kotlin常见面试题
开发语言·kotlin·面试题
mmsx10 天前
耳切法切带洞多边形:论文能跑通,真实数据为什么崩
android·kotlin
Kapaseker10 天前
Kotlin 又要加语法糖了:这次轮到 if-else
android·kotlin