该资料是 Android Kotlin 开发技能参考,覆盖从工程骨架到测试与持续集成的实践要点。用途:指导搭建分层 Android 应用,并示范协程、Compose、依赖注入与测试的写法。
主要能力与组织方式:
- 项目结构:给出 app/src/main/kotlin 下按 data(local/remote/repository)、di、domain(model/repository/usecase)、ui(feature/components/theme)分层的目录示例,以及 test 与 androidTest 目录。
- 构建配置:提供 Kotlin DSL 的 build.gradle.kts 示例,包含 Android application、Kotlin、Hilt、KSP 插件,compileSdk 34、minSdk 24、Java 17、Compose 编译扩展及 Compose BOM、Coroutines、Hilt、Room、JUnit、MockK、Turbine 等依赖声明。
- 协程与 Flow:展示 @HiltViewModel 的 ViewModel 使用 MutableStateFlow 暴露只读 StateFlow、SavedStateHandle 读取参数、viewModelScope 加载数据并更新 UiState;Repository 返回 Flow,先用 Room 缓存再请求网络,并用 flowOn 指定调度器。
- Compose:演示 Composable 通过 hiltViewModel() 获取 ViewModel、collectAsStateWithLifecycle() 收集状态、Scaffold/TopAppBar 结构,以及用 when 处理加载、成功和错误状态。
- 状态建模:给出 sealed interface Result 及 getOrNull、map 扩展函数的写法。
- 测试:用 MockK 与 Turbine 测试 ViewModel,coEvery 模拟用例返回 flowOf,uiState.test 逐步断言加载与成功状态;并给出 MainDispatcherRule 通过 TestWatcher 设置与重置主调度器。
- CI 与规范:提供 GitHub Actions 工作流,执行 detekt、ktlintCheck、testDebugUnitTest、assembleDebug;给出 detekt.yml 的长度、复杂度与协程检查配置。
- 反模式清单:列出避免 runBlocking 阻塞主线程、GlobalScope、在 init 中收集 Flow、暴露可变状态、Flow 未 catch、硬编码调度器、Composable 副作用、不稳定参数等问题。
使用方式:按示例创建工程结构并配置 Gradle 依赖与插件,在 ViewModel/Repository 中遵循协程与状态暴露约定,在 Compose 层使用状态驱动 UI,配合测试与 CI 命令校验。
限制:资料未提供具体版本兼容矩阵、发布流程、收费或授权信息,也未说明完整安装命令与运行步骤,相关内容暂未提供。