SuperAPI AI 工具集

jetpack-best-practices

编程与开发

查看项目

更新于 10-15 20:14

技能介绍

用途:在 packages/cds-android 或 apps/android-app 中编写或评审 Jetpack Compose / Kotlin 代码时使用,覆盖 @Composable API、Modifier 参数等场景。

主要能力:以 references/compose-api-guidelines.md 为权威依据,该文件是 AOSP Compose API 指南的逐字收录版本,要求在编写或评审 Compose API 前阅读,不得凭记忆转述或自创与之冲突的风格。CDS Android 属于“基于 Jetpack Compose 的库开发”,应参照该受众的 MUST/SHOULD/MAY 标记,并接近框架开发标准。

常用规则:每个元素接受并尊重 Modifier 参数,它作为第一个可选参数、默认 Modifier、应用于最外层布局节点且只使用一次,不得接收后丢弃;发出 UI 的 Composable 返回 Unit,并以 PascalCase 名词命名(如 Button、SlideButton);状态提升,优先无状态 Composable,接收值加 onValueChange 回调;CompositionLocal 用于横切上下文(本代码库中即主题),需有合理默认值,不用于配置具体组件;参数顺序为必需参数、modifier、其他可选参数、末尾 @Composable content lambda;默认值写在签名中。

CDS Android 边界规则::cds 使用 Kotlin 显式 API 模式,每个公开声明都是对客户的承诺,应作为决策而非满足编译器的反射,默认使用 internal;通过 CdsTheme.colors / CdsTheme.space 读取 token,用 cdsTheme { } 编写主题,LocalCdsTheme 公开仅为让自定义 Modifier 节点在组合外读取主题;不得仅为让 apps/android-app 编译而扩大声明可见性。

限制:组件 API 指南未收录于此,设计全新组件时需另行查阅;资料未提供安装命令、收费或平台信息。