逐句理解项目含义。
可以到项目地址查看源码,加速Github 对照,因为完全拿代码没意义
- MainActivity/setContent/ProvideWindowInsets
ProvideWindowInsets
要在可组合中设置 Insets,需要调用 ProvideWindowInsets 函数并包装您的内容。 这通常会在可组合层次结构的顶层附近完成:
该库不会禁用窗口装饰拟合。 为了让视图层次结构能够接收插图,您需要确保从Activity中调用:WindowCompat.setDecorFitsSystemWindows(window, false)。
需要将系统栏背景设置为透明,这可以通过我们的系统 UI 控制器库来完成。setContent 之前代码中设置,官方标准
例子:
setContent {
MaterialTheme {
ProvideWindowInsets {
// your content
}
}
}
Providers
/**
* [Providers] binds values to [ProvidableCompositionLocal] keys. Reading the [CompositionLocal]
* using [CompositionLocal.current] will return the value provided in [Providers]'s [values]
* parameter for all composable functions called directly or indirectly in the [content] lambda.
*
* @sample androidx.compose.runtime.samples.compositionLocalProvider
*
* @see CompositionLocal
* @see compositionLocalOf
* @see staticCompositionLocalOf
*/
@Composable
@OptIn(InternalComposeApi::class)
fun Providers(vararg values: ProvidedValue<*>, content: @Composable () -> Unit) {
currentComposer.startProviders(values)
content()
currentComposer.endProviders()
}
[Providers] 将值绑定到 [ProvidableCompositionLocal] 键。
读取 [CompositionLocal]使用 [CompositionLocal.current] 将返回 [Providers] 的 [values] 中提供的值
在 [content] lambda 中直接或间接调用的所有可组合函数的参数。
理解这个我们需要去读他的源码看他是干什么的。
ProvidedValue-----》CompositionLocal
class ProvidedValue<T> internal constructor(
val compositionLocal: CompositionLocal<T>,
val value: T,
val canOverride: Boolean
)
一个实例,用于保存 [Providers] 提供的值,并由[ProvidableCompositionLocal.provides] 中缀运算符创建
如果 [canOverride] 为 false
,则提供的值不会覆盖范围内可能已经存在的值。
具体代码不贴上来,看下CompositionLocal 源码
Compose 将数据通过组合树显式地通过参数传递,达到可组合的功能。 这中方式是最简单和最好的方式,让数据流过那个树。
有时,此模型可能很麻烦,或者因需要大量componets 流过的数据而崩溃。组件,或者当组件需要在彼此之间传递数据但保留该实现时细节为私密。 对于这些情况,[CompositionLocal]s 可以用作获取数据的隐式方式流过一个组合。
val openDrawerEvent = viewModel.drawerShouldBeOpened.observeAsState()
drawerShouldBeOpened 是一个MainViewModel实例
observeAsState
开始观察这个 LiveData 并通过 State 表示它的值。 每次将新值发布到 LiveData 时,返回的 State 将被更新,从而导致每个 State.value 用法的重新组合。当这个可组合的处置或当前 LifecycleOwner 移动到Lifecycle.State.DESTROYED 状态时,内部观察者将自动删除。
接下来的几行代码,还是比较简单,就是操作抽屉的开关操作和状态设置。
JetchatDrawer 抽屉自定义封装
@Composable
fun ColumnScope.JetchatDrawer(onProfileClicked: (String) -> Unit, onChatClicked: (String) -> Unit) {
// Use statusBarsHeight() to add a spacer which pushes the drawer content
// below the status bar (y-axis)
Spacer(Modifier.statusBarsHeight())
DrawerHeader()
Divider()
DrawerItemHeader("Chats")
ChatItem("composers", true) { onChatClicked("composers") }
ChatItem("droidcon-nyc", false) { onChatClicked("droidcon-nyc") }
DrawerItemHeader("Recent Profiles")
ProfileItem("Ali Conors (you)", meProfile.photo) { onProfileClicked(meProfile.userId) }
ProfileItem("Taylor Brooks", colleagueProfile.photo) {
onProfileClicked(colleagueProfile.userId)
}
}
具体细节查看源码