前言
可组合项 应该没有附带效应
,但是,如果在对应用状态进行转变时需要使用可组合项。此时你应该使用 Effect API , 以便以可以预测的方式来执行这些附带效应
附带效应是指在可组合函数范围之外发生的应用状态变化,用一句话概况就是:一个函数在执行的过程中,除了返回数值意以外,对调用方还会带来其他附加的影响,例如修改全局变量和参数等。
生命周期
当 Compose 首次运行可组合项的时候,在初始组合期间,他将跟踪为了描述界面而调用的组合项。当应用的状态发生变化时,Compose 会安排重组。重组指的是 Compose 重新执行可能因状态更改而更改的组合项。
组合只能通过初始组合生成且之鞥你通过重组更新。重组是修改组合的唯一方式。
可组合项的生命周期通过以下事件定义:进入组合,执行0次或者多次,最后退出组合
状态和效应用例
如官方文档所述,可组合项应当没有附带效应,如果需要更改应用状态,则就应该使用 Effect API
,以便以可预测的方式来执行这些附带效应
效应简称 Effect
,如果 API 上有 Effect
关键字的一般就是处理效应的了。Compose 中用的最多的就是 SideEffect
和 DisposableEffect
了。
LaunchedEffect
在某个可组合项的作用域内运行挂起函数。如果需要从组合项中安全带的调用挂起函数,请使用 LaunchedEffect
可组合项。
当 LaunchedEffect
进入组合时,他会启动一个协程,并将代码块作为参数传递。如果 LaunchedEffect
退出组合,协程将会取消。
如果使用不同的键
重组 LaunchedEffect
,系统将取消现有的协程,并在新的协程中启动新的挂起函数。
例如在一个顶级的页面中进行网络请求,请求是通过 LaunchedEffect
中创建的协程来完成的,如果发生这个过程中函数重组了,协程也会相应的取消,并重新创建协程在重新执行。下面示例中将请求的结果当做成了键
,这样当请求成功后,下次重组的时候也不会重新执行协程。如果重新重新获取数据,只需要修改 value 即可,例如示例中的按钮点击事件。
@Composable
fun HomeDetail() {
val state = rememberUserState()
LaunchedEffect(key1 = state) {
//模拟网络操作
delay(3000)
state.value = MyUserState()
}
state.value?.run {
Log.e("---345--->", this.name);
Log.e("---345--->", this.toString());
Scaffold() {
Column() {
Spacer(modifier = Modifier.padding(top = 50.dp))
Button(onClick = {
state.value = MyUserState("张三",50)
}) {
Text(text = "按钮")
}
Spacer(modifier = Modifier.padding(top = 100.dp))
Text(text = "姓名 ${this@run.name}")
Text(text = "姓名 ${this@run.age}")
}
}
}
}
@Composable
fun rememberUserState(myUserState: MutableState = mutableStateOf(null)) =
remember() {
mutableStateOf(myUserState.value)
}
}
class MyUserState(
var name: String = "345",
var age: Int = 20
)
复制代码
另外,官方还提供了一种用法:
@Composable
fun MyScreen(
state: UiState>,
scaffoldState: ScaffoldState = rememberScaffoldState()
) {
// 如果 UI 状态包含错误,则显示提示栏
if (state.hasError) {
// `LaunchedEffect` 将取消并重新启动,如果`scaffoldState.snackbarHostState` 改变
LaunchedEffect(scaffoldState.snackbarHostState) {
// 使用协程显示snackbar,当协程被取消时snackbar 会自动关闭。当 `state.hasError` 为 false 时,此协程将取消,并且仅在 `state.hasError` 为 true(由于上述 if-check)或 `scaffoldState.snackbarHostState` 更改时启动
scaffoldState.snackbarHostState.showSnackbar(
message = "Error message",
actionLabel = "Retry message"
)
}
}
Scaffold(scaffoldState = scaffoldState) {
/* ... */
}
}
复制代码
在上面代码中,如果状态发生错误,则会触发协程,如果没有错误,将会取消协程。由于 LaunchedEffect
调用点在 if 语句中,隐藏当该语句为 false 时,如果LaunchedEffect
包含在组合中,则会被移除,隐藏协程将会被取消。
rememberCoroutineScope
获取组合感知作用域,以便可以在组合外启动协程
由于 LaunchedEffect
是可组合函数,只能在可组合函数中使用。为了在可组合外启动协程,但是存在于作用域的限制,以便协程在退出组合时自动取消,这种情况就可以使用 rememberCoroutineScope
。此外,如果您需要手动控制一个或者多个协程生命周期,也可以使用它。
rememberCoroutineScope
是一个可组合函数,会返回一个 CoroutineScope
,该协程绑定到调用他的组合点。调用退出组合后,作用域取消。
下面看一下小栗子,可组合函数退出后,内部的协程就会被取消。
var coroutineScope: CoroutineScope? = null
@Composable
fun HomeDetail(
activity: MainActivity
) {
val state = rememberUserState()
coroutineScope = rememberCoroutineScope()
coroutineScope?.launch {
while (true) {
delay(1000)
Log.e("---345--->", "345");
}
}
}
复制代码
下面是官方的例子
@Composable
fun MoviesScreen(scaffoldState: ScaffoldState = rememberScaffoldState()) {
val scope = rememberCoroutineScope()
Scaffold(scaffoldState = scaffoldState) {
Column {
Button(
onClick = {
scope.launch {
scaffoldState.snackbarHostState.showSnackbar("Something happened!")
}
}
) {
Text("Press me")
}
}
}
}
复制代码
rememberUpdatedState
在效应中引用某个值,该效应在值改变时不重启
当一个键发生变化时,LaunchedEffect
会重启。但是在有些时候你可能希望在改效应中捕获某个值,但是如果这个值发生变化,你并不想效应重启。因此需要使用 rememberUpdatedState
来创建对可捕获和更新的该值的引用。这种方法对于包含长期操作的效应非常有用。
例如,LandingScreen 会在一段时间内消失或者重组,改函数内部的等待三秒钟也不应该重启。这种情况就可以使用 rememberUpdatedState
。如下:
@Composable
fun LandingScreen(onTimeout: () -> Unit) {
// 这将始终引用 LandingScreen 重构的最新 onTimeout 函数
val currentOnTimeout by rememberUpdatedState(onTimeout)
// 创建与 LandingScreen 的生命周期相匹配的效果。
// 如果 LandingScreen 重组,延迟不应再次开始。
LaunchedEffect(true) {
delay(3000)
currentOnTimeout()
}
/* Landing screen content */
}
@Composable
fun HomeDetail() {
LandingScreen {
Log.e("---345--->", "----");
}
//....
}
复制代码
DisposableEffect
需要清理的效应
对于需要在键发生变化或者可组合项退出的时候进行清理的附带效应,可以使用 DisposableEffect
。如果 DisposableEffect
键发生变化,可组合项需要清理当前效应,并通过再次调用进行重置。
@Composable
fun HomeScreen(
lifecycleOwner: LifecycleOwner = LocalLifecycleOwner.current,
onStart: () -> Unit, // 开启事件
onStop: () -> Unit // 停止时间
) {
// 当提供了一个新的lambdas时,可以安全地更新当前的lambdas
val currentOnStart by rememberUpdatedState(onStart)
val currentOnStop by rememberUpdatedState(onStop)
// 如果“lifecycleOwner”改变,处置并重置效果
DisposableEffect(lifecycleOwner) {
// 创建一个观察者来触发我们所记得的回调来发送事件
val observer = LifecycleEventObserver { _, event ->
if (event == Lifecycle.Event.ON_START) {
currentOnStart()
} else if (event == Lifecycle.Event.ON_STOP) {
currentOnStop()
}
}
// 将观察者添加到生命周期中
lifecycleOwner.lifecycle.addObserver(observer)
// 当组合函数离开时,会执行
onDispose {
lifecycleOwner.lifecycle.removeObserver(observer)
}
}
/* Home screen content */
}
复制代码
例如上面,通过 lifecycleOwner
,通过 Lifecycle
事件发送具体的事件。
在 DisposableEffect
里面将 observer
添加到了 lifecycleOwner
中,如果 lifecycleOwner
发生了改变,则系统就会通过 lifecycleOwner
处理并重启效应。
当可组合函数退出的时候就会 removeObserver
注意,在 onDispose 中方式空块并不是最佳的做法,可以想想是否还存在更适合的场景
还有 onDispose 必须作为最终的语句,否则将会报错
SideEffect
将 Compose 状态发布为 非 Compose 代码。
如果需要与非 Compose
管理的对象共享 Compose
状态,请使用 SideEffect
可组合项,因为每次成功重组都会调用该可组合项,
例如:每次重组的时候都设置状态栏
@Composable
private fun SetImmersion() {
if (isImmersion()) {
val systemUiController = rememberSystemUiController()
SideEffect {
systemUiController.run {
setSystemBarsColor(color = Color.Transparent, darkIcons = isDark())
setNavigationBarColor(color = Color.Black)
}
}
}
}
复制代码
下面是官方栗子:
@Composable
fun rememberAnalytics(user: User): FirebaseAnalytics {
val analytics: FirebaseAnalytics = remember {
/* ... */
}
// 在每一次成功的组合中,从当前的用户更新FirebaseAnalytics的userType,确保未来的分析事件附加此元数据
SideEffect {
analytics.setUserProperty("userType", user.userType)
}
return analytics
}
复制代码
produceState
将非 Compose
状态转为 Compose 状态
produceState
会启动一个协程,该协程将作用域限定为可将值推送到返回的 State
组合,使用此协程就可以将非 Compose 状态转为 Compose 状态,例如将 Flow,LiveData 等引入到组合。
即使 produceState
创建了一个协程,它也可以用于观察非挂起的数据源。如需要移除对该数据源的引用,请直接使用 awaitDispose
函数。
@Composable
fun loadNetworkImage(
url: String,
imageRepository: ImageRepository
): State> {
// 创建一个以 Result.Loading 作为初始值的 State>(initialValue = Result.Loading, url, imageRepository) {
// 在协程中,可以进行挂起调用
val image = imageRepository.load(url)
// 使用错误或成功结果更新状态。这将触发读取State时的重组
value = if (image == null) {
Result.Error
} else {
Result.Success(image)
}
}
}
复制代码
derivedStateOf
如果某个状态是从其他状态对象计算或者派生出来的,请使用 derivedStateOf
,使用此函数可以确保当计算中使用的状态之一发生变化时才会进行计算
@Composable
fun TodoList(highPriorityKeywords: List = listOf("Review", "Unblock", "Compose")) {
val todoTasks = remember { mutableStateListOf() }
// 只在todoTasks或highPriorityKeywords变化时计算高优先级任务,而不是在每次重组时
val highPriorityTasks by remember(highPriorityKeywords) {
derivedStateOf { todoTasks.filter { it.containsWord(highPriorityKeywords) } }
}
Box(Modifier.fillMaxSize()) {
LazyColumn {
items(highPriorityTasks) { /* ... */ }
items(todoTasks) { /* ... */ }
}
/* Rest of the UI where users can add elements to the list */
}
}
复制代码
在上面代码中,derivedStateOf
保证当 todoTasks
发生变化时,系统都会执行 highPriorityTasks
进行计算,并相应的更新界面。
如果 highPriorityTasks
发生变化,系统将会执行 remember
代码块,并且会创建新的派生状态对象并记住该对象,以代替旧对象。
snapshotFlow
将 Compose 的 State 转为 Flow
val listState = rememberLazyListState()
LazyColumn(state = listState) {
// ...
}
LaunchedEffect(listState) {
snapshotFlow { listState.firstVisibleItemIndex }
.map { index -> index > 0 }
.distinctUntilChanged()
.filter { it == true }
.collect {
MyAnalyticsService.sendScrolledPastFirstItemEvent()
}
}
复制代码
当 snapshotFlow
块中读取的 State
对象之一发生变化时,如果与之前发出的值不相等,Flow 就会向收集器发出新值。
在上面代码中 listState.firstVisibleItemIndex
被转为一个 Flow,从而可以受益于 Flow 的强大功能。
最后
Compose 提供了一系列的 Effect API
来有效的以可预测的方式执行这些附带效应,在日常开发中我们可以合理的使用 Effect Api
以求最安全的代码。
本篇文章参考 官方文档,以及 https://juejin.cn/column/6960699198618468359
。
如果有任何问题,还请指出,谢谢!
文章来源于互联网:Android | Compose 生命周期和附带效应
1、本站所有资源均从互联网上收集整理而来,仅供学习交流之用,因此不包含技术服务请大家谅解!
2、本站不提供任何实质性的付费和支付资源,所有需要积分下载的资源均为网站运营赞助费用或者线下劳务费用!
3、本站所有资源仅用于学习及研究使用,您必须在下载后的24小时内删除所下载资源,切勿用于商业用途,否则由此引发的法律纠纷及连带责任本站和发布者概不承担!
4、本站站内提供的所有可下载资源,本站保证未做任何负面改动(不包含修复bug和完善功能等正面优化或二次开发),但本站不保证资源的准确性、安全性和完整性,用户下载后自行斟酌,我们以交流学习为目的,并不是所有的源码都100%无错或无bug!如有链接无法下载、失效或广告,请联系客服处理!
5、本站资源除标明原创外均来自网络整理,版权归原作者或本站特约原创作者所有,如侵犯到您的合法权益,请立即告知本站,本站将及时予与删除并致以最深的歉意!
6、如果您也有好的资源或教程,您可以投稿发布,成功分享后有站币奖励和额外收入!
7、如果您喜欢该资源,请支持官方正版资源,以得到更好的正版服务!
8、请您认真阅读上述内容,注册本站用户或下载本站资源即您同意上述内容!
原文链接:https://www.dandroid.cn/21804,转载请注明出处。
评论0