用途:为 Android 项目提供测试编写标准,覆盖单元测试、Compose UI 测试与 Hilt 集成测试,适用于设计基于 MockK 或协程测试工具的测试行为。
主要能力:提出四支柱测试价值框架(防回归、抗重构、快速反馈、可维护性),用于定性评估单元测试价值,并明确不应在缺乏实测的情况下静态编造数值评分。核心规则包括:测试命名采用 Method_Scenario_ExpectedBehavior;断言 UI 状态转换(如通过 Turbine 测试 StateFlow/UiState),禁止断言 30 属性的样板状态副本;测试计算、校验、领域不变量及非平凡序列化/解析或错误映射,禁止测试自动生成代码、平凡 getter 或重复字面赋值的回声测试;仓库与数据源须测试契约合规与错误映射,禁止 1:1 透传式 mock 回声;修复缺陷的 PR 须先引入可复现失败的测试。
使用方式:单元测试覆盖 ViewModel、Usecase、Repository、Utils,使用 runTest 配合 MainDispatcherRule,以 MockK 或 fake 模拟。UI 集成测试覆盖 Composable 屏幕与导航流程,使用 createAndroidComposeRule 加 Hilt(HiltAndroidRule),通过 @TestInstallIn 注入 fake 仓库。覆盖率作为诊断指标由项目配置,应验证风险加权的关键路径而非追求任意百分比。禁止真实网络与 Thread.sleep,异步时序使用 IdlingResource 或 composeTestRule.waitUntil。
限制:资料未提供具体安装命令、版本要求或平台支持范围;负向断言仅在“缺失”属于业务契约时添加。