城市建设招标网站,西安微网站,移动端程序开发,搜狗推广优化点击查看#xff1a;Jetpack Compose 架构层 官网
本页面简要介绍了组成 Jetpack Compose 的架构层#xff0c;以及这种设计所依据的核心原则。 Jetpack Compose 不是一个单体式项目#xff1b;它由一些模块构建而成#xff0c;这些模块组合在一起#xff0c;构成了一个完…点击查看Jetpack Compose 架构层 官网
本页面简要介绍了组成 Jetpack Compose 的架构层以及这种设计所依据的核心原则。 Jetpack Compose 不是一个单体式项目它由一些模块构建而成这些模块组合在一起构成了一个完整的堆栈。通过了解组成 Jetpack Compose 的不同模块您可以 使用适当的抽象级别来构建应用或库了解何时可以“降级”到较低级别以获取更多的控制权或更高的自定义程度尽可能减少依赖项 层 Jetpack Compose 的主要层包括 图 1. Jetpack Compose 的主要层。 每一层均基于较低的层逐级构建并通过组合功能来创建更高级别的组件。每一层都是基于较低层的公共 API 构建的用于验证模块边界还支持您根据需要替换任何层。让我们自下而上地分析这些层。 运行时 此模块提供了 Compose 运行时的基本组件例如 remember、mutableStateOf、Composable 注释和 SideEffect。如果您只需要 Compose 的树管理功能而不需要其界面则可以考虑直接基于此层进行构建。 界面 界面层由多个模块ui-text、ui-graphics 和 ui-tooling 等组成。这些模块实现了界面工具包的基本组件例如 LayoutNode、Modifier、输入处理程序、自定义布局和绘图。如果您只需要用到界面工具包的基本概念则可以考虑基于此层进行构建。 基础 此模块为 Compose 界面提供了与设计系统无关的构建块例如 Row 和 Column、LazyColumn、特定手势的识别等。您可以考虑基于基础层构建自己的设计系统。 Material 此模块为 Compose 界面提供了 Material Design 系统的实现同时提供了一个主题系统以及若干样式化组件、涟漪效果指示元素和图标。在您的应用中使用 Material Design 时不妨基于此层进行构建。 设计原则 Jetpack Compose 的一个指导原则是提供可以组合在一起的重点突出的小块功能片段而不是几个单体式组件。这种方法有许多优点。 控制 更高级别的组件往往能完成更多操作但您拥有的直接控制权较少。如果您需要更多控制权可以“下拉”使用较低级别的组件。 例如如果您想为某个组件的颜色添加动画效果可以使用 animateColorAsState API val color animateColorAsState(if (condition) Color.Green else Color.Red)不过如果您需要组件始终以灰色开头则不能使用此 API。您可以改为下拉菜单使用较低级别的 Animatable API val color remember { Animatable(Color.Gray) }
LaunchedEffect(condition) {color.animateTo(if (condition) Color.Green else Color.Red)
}较高级别的 animateColorAsState API 本身基于较低级别的 Animatable API 构建而成。使用较低级别的 API 的过程更为复杂但可提供更多的控制权。请选择最符合您需求的抽象化级别。 自定义 通过将较小的构建块组合成更高级别的组件可大幅降低按需自定义组件的难度。例如可以考虑使用 Material 层提供的 Button 的实现 Composable
fun Button(// …content: Composable RowScope.() - Unit
) {Surface(/* … */) {CompositionLocalProvider(/* … */) { // set LocalContentAlphaProvideTextStyle(MaterialTheme.typography.button) {Row(// …content content)}}}
}Button 由 4 个组件组合而成 Material Surface用于提供背景、形状和点击处理方式等。CompositionLocalProvider用于在启用或停用相应按钮时更改内容的 Alpha 值ProvideTextStyle用于设置要使用的默认文本样式Row用于为相应按钮的内容提供默认布局政策 为了使结构更加清晰我们省略了一些参数和注释但整个组件只有 40 行左右的代码因为它只是组合了这 4 个组件来实现该按钮。Button 等组件会自行判断它们需要公开哪些参数同时在实现常见的自定义项和可能使组件更难使用的参数突增之间创造平衡。例如Material 组件可提供 Material Design 系统中指定的自定义项这样可以轻松遵循 Material Design 原则。 不过如果您希望在组件参数之外进行自定义则可以“降级”某个级别并复刻某个组件。例如Material Design 指定按钮应具有纯色背景。如果您需要渐变背景Button 参数就不适用了因为它不支持此选项。在此类情况下您可以将 Material Button 实现作为参考并构建您自己的组件 Composable
fun GradientButton(// …background: ListColor,modifier: Modifier Modifier,content: Composable RowScope.() - Unit
) {Row(// …modifier modifier.clickable(onClick {}).background(Brush.horizontalGradient(background))) {CompositionLocalProvider(/* … */) { // set material LocalContentAlphaProvideTextStyle(MaterialTheme.typography.button) {content()}}}
}上述实现继续使用 Material 层中的组件例如 Material 的当前内容 Alpha 值和当前文本样式的概念。不过它会将 Material Surface 替换为 Row 并设置其样式以获得所需的外观。 注意当“降级”到较低层以自定义组件时请确保不会因忽视无障碍功能支持等原因而使任何功能发生降级。您要为哪个组件创建分支就应以哪个组件作为指导。 如果您根本不想使用 Material 概念例如如果您要构建自己的定制设计系统则可以选择仅使用基础层组件 Composable
fun BespokeButton(// …backgroundColor: Color,modifier: Modifier Modifier,content: Composable RowScope.() - Unit
) {Row(// …modifier modifier.clickable(onClick {}).background(backgroundColor)) {// No Material components usedcontent()}
}Jetpack Compose 为最高级别的组件保留了最为简洁的名称。例如androidx.compose.material.Text 基于 androidx.compose.foundation.text.BasicText 构建。这样一来如果您想替换更高级别则可以为自己的实现提供更易于发现的名称。 注意为组件创建分支意味着您不会从上游组件的任何未来增补项或 bug 修复中受益。 选择合适的抽象化级别 Compose 以构建可重复使用的分层组件作为理念这意味着您不应该始终以构建较低级别的构建块为目标。许多较高级别的组件不仅能够提供更多功能而且通常还会融入最佳实践例如支持无障碍功能等。 例如如果您想为自己的自定义组件添加手势支持可以使用 Modifier.pointerInput 从头开始构建但在此之上还有其他更高级别的组件它们可以提供更好的起点例如 Modifier.draggable、Modifier.scrollable 或 Modifier.swipeable。 一般来讲最好基于能提供您所需功能的最高级别的组件进行构建以便从其包含的最佳实践中受益。 了解详情
如需查看构建自定义设计系统的示例请参阅 Jetsnack 示例。
