SuperAPI AI 工具集

android-kotlin

编程与开发

查看项目

更新于 10-16 09:59

技能介绍

该技能用于指导 Android 应用的 Kotlin 开发,需配合 base.md 加载。内容按工程结构、构建配置、协程与状态管理、Compose 界面、测试、持续集成与代码检查、反模式展开。

用途与工程结构:给出 app 模块的标准目录划分,data(local/remote/repository)、di、domain(model/repository/usecase)、ui(feature/components/theme)等分层,便于按数据层、领域层与展示层组织代码。

主要能力:Gradle Kotlin DSL 的 app 级配置示例,包含 compose、Hilt、KSP 插件,compileSdk/targetSdk 34、minSdk 24、Java 17,以及 Compose BOM、Coroutines、Hilt、Room 和测试依赖声明。协程部分演示 ViewModel 中使用 StateFlow 暴露状态、viewModelScope 启动任务,Repository 用 Flow 先发缓存再请求网络并 flowOn 指定调度器。Compose 部分展示 hiltViewModel、collectAsStateWithLifecycle、Scaffold 与状态分支渲染;还给出 sealed interface 的结果封装与 map/getOrNull 扩展。

使用方式与测试:测试示例用 MockK 模拟 UseCase,结合 SavedStateHandle、runTest 与 Turbine 的 test 验证状态流,并提供 MainDispatcherRule 替换主调度器。CI 示例使用 GitHub Actions 设置 JDK 17、Gradle,依次执行 ./gradlew detekt、./gradlew ktlintCheck、./gradlew testDebugUnitTest、./gradlew assembleDebug。detekt.yml 配置长方法、参数数量、函数数量、行宽、通配导入和 GlobalScope 使用等规则。

适用场景与限制:适合需要搭建或规范 Android Kotlin 项目、编写 Compose 界面与协程状态流、接入 Hilt/Room、配置单元测试与 CI 检查的开发者。资料未提供具体版本兼容矩阵、性能数据、收费或许可信息,实际项目需按依赖版本自行验证。反模式清单提醒避免主线程 runBlocking、GlobalScope、在 init 中收集流、暴露 MutableStateFlow、不处理流异常、硬编码调度器、Composable 中副作用及不稳定参数等。