如果您要为应用编写 Compose 代码或构建 Compose 库和 API,请遵循最佳实践,使代码可扩缩、性能更出色,并与生态系统的其余部分保持一致。
以下文档为编写使用 Compose 的代码的所有人提供了指南:
- Jetpack Compose 的 API 准则:概述了使用 Jetpack Compose 编译器插件和运行时的任何系统的模式、最佳实践和规范性样式准则。其中包括以下主题:
- 基于 Kotlin 编码规范的 Compose 专用 Kotlin 样式指南
- 针对基于 Compose 运行时功能构建的
@Composable
函数和 API 的指南 - 适用于使用和扩展 Compose 界面工具包的 API 的指南
- 设计 Compose API 时用于解决用例的模式
- Jetpack Compose 中
@Composable
组件的 API 准则:提供有关创建和使用@Composable
界面组件的一系列准则和建议,包括以下主题:- 创建组件和叠加组件
- 为新组件命名
- 表达组件依赖项
@Composable
组件中的参数- 遵循创建与组件相关的类和函数的正确模式
- 记录
@Composable
组件 - 改进组件的无障碍功能
- 更新组件 API 时保持向后兼容性
受众群体
这些指南针对以下三类受众编写:
- 基于 Jetpack Compose 构建应用的开发者。如果您在应用的某些部分使用了 Jetpack Compose,则属于此类群体。
- 负责 Jetpack Compose 框架开发的开发者。如果您对
androidx.compose
库做出了贡献,则属于此群组。 - 基于 Jetpack Compose 创建库的开发者。如果您创建 Compose API 或 Compose 界面元素的库,则属于此类用户。这些 Compose 组件库可以是公开的,也可以是贵公司或团队的本地库。
每条样式准则的严格程度因您所在的群组而异。例如,Jetpack Compose 框架开发通常会最严格地遵守这些准则。
如需详细了解每个开发者受众群体的要求,请参阅 RFC2119。
为框架和指南做出贡献
我们欢迎您对 androidx
代码库中的部分库以及样式指南(Compose API 指南和 @Composable
组件指南)本身做出贡献。
如需贡献资源,请按照 androidx
贡献指南中的说明操作。