SuperAPI AI 工具集

android-kotlin

编程与开发

查看项目

更新于 10-16 07:30

技能介绍

用途

该技能面向 Android Kotlin 应用开发,覆盖协程(Coroutines)、Jetpack Compose、Koin 依赖注入与 MockK 测试等主题,提供了一套可参考的项目结构、构建配置与代码示例,用于搭建或规范 Android 现代架构项目。

项目结构

资料给出了分层目录结构:

  • data/:数据层,包含 local/(Room 数据库)、remote/(Retrofit/Ktor 服务)、repository/(仓库实现)。
  • di/:Koin 模块。
  • domain/:业务逻辑,包含 model/(领域模型)、repository/(仓库接口)、usecase/(用例)。
  • ui/:表现层,包含 feature/(功能页面,如 FeatureScreen.kt 与 FeatureViewModel.kt)、components/(可复用 Compose 组件)、theme/(Material 主题)。
  • App.kt:Application 类。
  • 测试目录:test/(单元测试)与 androidTest/(仪器测试)。

构建配置

采用 Kotlin DSL 与 Version Catalog(gradle/libs.versions.toml)。资料列出了版本号与依赖库,包括 AGP 8.3.0、Kotlin 1.9.22、Compose BOM 2024.02.00、Room 2.6.1、Retrofit 2.9.0、OkHttp 4.12.0、Koin 3.5.3、Coil 2.6.0、WorkManager 2.9.0、Media3 1.3.0、MockK 1.13.8 等。应用级 build.gradle.kts 中配置了 namespace、compileSdk、minSdk = 24、targetSdk = 36、Java 11 兼容、allWarningsAsErrors、若干 -opt-in 编译参数,以及 Compose 构建特性。依赖涵盖 Compose、Room、网络、WorkManager、Preference、Navigation、图片与工具、Media、Koin 与测试库。

协程与 Flow

资料给出 ViewModel 使用 StateFlow 的示例:通过 MutableStateFlow 暴露 uiState,在 viewModelScope.launch 中调用用例,使用 catch 与 collect 更新状态,并提供 clearError 等方法。Repository 接口返回 Flow,实现类通过 flow { } 先发出缓存数据再请求网络并更新缓存,使用 flowOn(dispatcher) 切换调度器,saveUser 使用 withContext。

Jetpack Compose

示例展示了带 ViewModel 的屏幕:使用 koinViewModel() 获取 ViewModel,通过 collectAsStateWithLifecycle() 收集状态,将界面拆分为 UserScreen 与无状态的 UserScreenContent。内容中使用 Scaffold、TopAppBar、CircularProgressIndicator、Snackbar 等组件,并根据 isLoading、user、error 状态分支渲染。

Koin 依赖注入

资料给出 Koin 模块示例:appModule 中通过 single、factory、viewModel 注册仓库、用例与 ViewModel;networkModule 中构建 Retrofit 并创建 API 接口。Application 类在 onCreate 中调用 startKoin,传入 androidContext 与模块列表。

状态封装

资料给出 Result 密封接口示例,包含 Success、Error、Loading 三种状态,并提供 getOrNull 与 map 扩展函数。

适用场景与限制

适用于需要参考 Android Kotlin 分层架构、Compose 界面、协程状态管理与 Koin 注入方式的开发场景。资料中部分内容(如 Navigation 3 相关别名)带有注释说明,实际使用时需按项目情况确认对应库与版本。资料未提供收费、价格、平台支持范围或具体使用效果等信息。