0
  • 聊天消息
  • 系统消息
  • 评论与回复
登录后你可以
  • 下载海量资料
  • 学习在线课程
  • 观看技术视频
  • 写文章/发帖/加入社区
会员中心
创作中心

完善资料让更多小伙伴认识你,还能领取20积分哦,立即完善>

3天内不再提示

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

谷歌开发者 来源:谷歌开发者 作者:谷歌开发者 2022-09-23 10:46 次阅读

我们推荐以生命周期感知方式在 Android 上收集数据流。如果您正在用 Jetpack Compose 构建 Android 应用,请使用 collectAsStateWithLifecycle API 以生命周期感知方式从用户界面收集数据流。

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

借助 collectAsStateWithLifecycle,您可以在不需要应用资源时释放它们,例如当应用处于后台时。此类资源可能包括 Firebase 查询、位置或网络更新及数据库连接等,在不需要它们的情况下让其处于活跃状态会影响用户设备的运行健康状况。 请继续阅读本文,以详细了解此 API、以生命周期感知方式收集数据流的理由,以及此 API 与 collectAsState API 的差异。

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 参数配置此生命周期状态。

cce1b05a-3ae0-11ed-9e49-dac502259ad0.png

△ 默认情况下,当应用处于后台时 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,  )}

每当 AuthorViewModeluiState 发出新的 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"}

注意: 这是一个尚处于 Alpha 版的全新 API,且该 API 还要求您使用ExperimentalLifecycleComposeApi 注释。

  • 版本 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,您无需输入下方的样板代码,这些代码同样以生命周期感知的方式从可组合函数收集数据流:


/*Copyright2022GoogleLLC.   SPDX-License-Identifier: Apache-2.0 */@ComposablefunAuthorRoute(...){vallifecycle=LocalLifecycleOwner.current.lifecyclevaluiStatebyproduceState(initialValue=viewModel.uiState.valuekey1=lifecyclekey2=viewModel){lifecycle.repeatOnLifecycle(state=STARTED){viewModel.uiState.collect{value=it}}}
AuthorScreen(...)}

在架构中收集数据流

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

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

cd05bbf8-3ae0-11ed-9e49-dac502259ad0.png

△ 在界面层中,使用 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

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

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

Android 应用可以在海量 Android 设备上运行。但遗憾的是,所有设备和用户拥有的资源都是有限的,因此应用通常在受限环境中运行。运行 Android 应用时,有一些重要因素会影响用户体验和设备系统健康:
  • CPU 使用: 在所有设备组件中,CPU 的耗电量最高。而电池续航时间一直是用户关注的重点,因此如果发生 CPU 滥用的情况,用户可能会卸载您的应用;

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

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

如果 Android 开发者想满足用户的需求、确保设备系统健康,或 "为数十亿用户打造产品",则应该根据其目标市场、设备或国家/地区的实际情况来优化上述这些因素。根据设备类型和设备上 Android 版本的不同,让不必要的资源保持活跃可能会产生负面影响。在界面层中使用 collectAsStateWithLifecycle 可以让层次结构的其余部分得以释放资源。
  • 为数十亿用户打造产品
    https://developer.android.google.cn/docs/quality-guidelines/build-for-billions

与 collectAsState 的差异

开发者们经常会问道: 如果 collectAsStateWithLifecycle 是从 Android 可组合函数中收集数据流最安全的方法,那现在为什么还需要 collectAsState API?为什么不将生命周期感知功能添加到 collectAsState 中,而是创建新的 API?

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

https://developer.android.google.cn/jetpack/compose/lifecycle

cd2510ac-3ae0-11ed-9e49-dac502259ad0.png

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

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

但是,在 Android 应用中使用 Compose 时,Android 生命周期也会对资源的管理方式产生非常大的影响。即使 Compose 在 Android 应用处于后台时停止重组,collectAsState 也会继续收集数据流。这使得层次结构的其余部分无法释放资源。

collectAsStatecollectAsStateWithLifecycle 在 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(...)}

推荐大家以生命周期感知方式在 Android 上收集数据流,这样做可以使应用的其他部分在需要时释放资源。 如果您正在使用 Jetpack Compose 构建 Android 应用,请使用 collectAsStateWithLifecycle 可组合函数来执行此操作。 另外: 感谢 Jose AlcérrecaMarton BraunAlejandra Stamato 和 Jake Roseman 对文章内容进行审核。

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

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

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

审核编辑 :李倩

声明:本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人,不代表电子发烧友网立场。文章及其配图仅供工程师学习之用,如有内容侵权或者其他违规问题,请联系本站处理。 举报投诉
  • Android
    +关注

    关注

    12

    文章

    3935

    浏览量

    127371
  • API
    API
    +关注

    关注

    2

    文章

    1499

    浏览量

    61988
  • 数据流
    +关注

    关注

    0

    文章

    119

    浏览量

    14356

原文标题:在 Jetpack Compose 中安全地使用数据流

文章出处:【微信号:Google_Developers,微信公众号:谷歌开发者】欢迎添加关注!文章转载请注明出处。

收藏 人收藏

    评论

    相关推荐

    什么是PLM产品生命周期管理系统?

    在当今竞争激烈的制造业环境中,企业不仅要关注产品的设计和生产,还需要对产品的整个生命周期进行全面管理。这包括了从产品概念构思、设计开发、生产制造、销售分发,到最终报废处理的每一个环节。为了高效、系统
    的头像 发表于 11-23 16:14 188次阅读
    什么是PLM产品<b class='flag-5'>生命周期</b>管理系统?

    如何确保车规级芯片全生命周期的安全

    为保障质量、安全性和可靠性,汽车行业始终如一地贯彻着严苛的标准。然而,这种对汽车安全性和可靠性的坚定追求,也催生了对预测性维护的迫切需要,即在芯片生命周期管理(SLM)中,使用先进的监测和分析技术来预测和预防半导体组件的故障。
    的头像 发表于 08-12 10:47 485次阅读
    如何确保车规级芯片全<b class='flag-5'>生命周期</b>的安全

    半导体全生命周期测试:哪些设备在默默守护你的电子产品?

    半导体产业作为现代电子工业的核心,其产品的全生命周期测试对于确保产品质量、提高生产效率和降低成本具有重要意义。半导体全生命周期测试设备涵盖了从原材料检测到最终产品测试的一系列设备,本文将对这些设备进行详细介绍。
    的头像 发表于 07-01 09:38 342次阅读
    半导体全<b class='flag-5'>生命周期</b>测试:哪些设备在默默守护你的电子产品?

    鸿蒙开发组件:DataAbility的生命周期

    应用开发者可以根据业务场景实现data.js/data.ets中的生命周期相关接口。DataAbility生命周期接口说明见下表。
    的头像 发表于 06-20 09:39 439次阅读

    鸿蒙开发:【PageAbility的生命周期

    PageAbility生命周期是PageAbility被调度到INACTIVE、ACTIVE、BACKGROUND等各个状态的统称。PageAbility生命周期流转及状态说明见如下图1、表1所示。
    的头像 发表于 06-17 10:05 695次阅读
    鸿蒙开发:【PageAbility的<b class='flag-5'>生命周期</b>】

    设备全生命周期管理流程有哪些?

    采购与安装阶段设备全生命周期管理系统对设备需求进行分析,记录设备信息,确保设备正确安装并达到预期性能。维护保养阶段制定科学维护计划,定期检查和保养。性能优化与升级阶段通过分析数据发现问题,优化设备性能。
    的头像 发表于 06-13 15:21 742次阅读
    设备全<b class='flag-5'>生命周期</b>管理流程有哪些?

    鸿蒙Ability Kit(程序框架服务)【UIAbility组件生命周期】实例

    本文档主要描述了应用运行过程中UIAbility和自定义组件的生命周期。对于UIAbility,描述了Create、Foreground、Background、Destroy四种生命周期。对于页面
    的头像 发表于 05-31 15:03 1118次阅读
    鸿蒙Ability Kit(程序框架服务)【UIAbility组件<b class='flag-5'>生命周期</b>】实例

    如何保护电子元器件延长生命周期

    元器件延长生命周期,解决这个问题的一种方法是在生产结束后长期储存半导体元件。该解决方案使您能够在设备的整个使用寿命期间持续供应组件。01电子设备如果没有组成它们的
    的头像 发表于 05-31 13:59 517次阅读
    如何保护电子元器件<b class='flag-5'>以</b>延长<b class='flag-5'>生命周期</b>

    Traveo II B-H中的SECURE和SECURE_WITH_DEBUG生命周期阶段有何不同?

    Traveo II B-H 中的 SECURE 和 SECURE_WITH_DEBUG 生命周期阶段有何不同?
    发表于 05-21 07:07

    HarmonyOS开发案例:【UIAbility和自定义组件生命周期

    本文档主要描述了应用运行过程中UIAbility和自定义组件的生命周期。对于UIAbility,描述了Create、Foreground、Background、Destroy四种生命周期。对于页面
    的头像 发表于 05-10 15:31 1246次阅读
    HarmonyOS开发案例:【UIAbility和自定义组件<b class='flag-5'>生命周期</b>】

    IBM推出全新IT生命周期管理模式

    IBM近日正式推出了IBM Storage Assurance,这是一项创新的IT生命周期管理方案。其设计初衷在于为客户提供数据中心管理的灵活性与控制权,最大化系统性能。该方案融合了IBM FlashSystem的硬件和软件创
    的头像 发表于 05-09 11:47 588次阅读

    IBM推出IBM Storage Assurance这一全新的IT生命周期管理模式

    近日,IBM 推出了 IBM Storage Assurance 这一全新的 IT 生命周期管理模式,旨在为客户的数据中心提供灵活的选择与控制,最大程度提高性能。
    的头像 发表于 05-08 14:09 419次阅读

    企业数据备份体系化方法论的七大原则:数据生命周期规划:资产管理的新篇章

    在数字化浪潮中,数据如同新时代的石油,成为了推动企业前进的核心动力。但与所有宝贵资源一样,如果我们不能妥善管理,这种无形的资产就难以发挥其应有的价值。这就是为何数据生命周期规划(DLP)显得如此重要
    的头像 发表于 03-11 14:24 348次阅读

    什么是设备全生命周期管理系统?

    设备全生命周期管理系统是一款能够对设备进行全周期数字化管理的软件平台,它通过将设备信息电子化,使得设备的管理和监督更加便捷。这个系统不仅涵盖了设备的采购、使用、维修、报废等各个阶段,还能够对设备
    的头像 发表于 02-26 14:21 1189次阅读
    什么是设备全<b class='flag-5'>生命周期</b>管理系统?

    BCP为什么只有在收集数据后才存储数据

    有很多不便之处,因为可以存储在 BCP 中的收集数据的数量限制为 10,000。 为什么只有在收集数据后才存储数据
    发表于 01-22 07:06