1. 搭建测试环境：配置 Gradle 依赖、AndroidX Test 库、Mockito/KotlinMock、JUnit5 设置、Robolectric 选择

单元测试的可靠性直接取决于测试环境的正确搭建。本章将引导你从零配置一个基于 AndroidX Test、JUnit5、Mockito / KotlinMock 和 Robolectric 的现代测试项目。所有依赖、运行器、版本约束都必须精确对齐，否则会出现 ClassNotFoundException 或 Instrumentation 冲突。

1.1 依赖全景表

下表列出每类库的核心用途、推荐版本及声明方式。所有依赖放在模块级 build.gradle 的 dependencies 块中。

1.2 完整 Gradle 配置片段

将以下代码加入 app/build.gradle（Kotlin DSL 风格），同时确保 android 块中包含 testInstrumentationRunner 和 testOptions：

// app/build.gradle.kts
android {
    compileSdk = 35
    defaultConfig {
        targetSdk = 35
        testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
        // JUnit5 需要额外传递参数
        testInstrumentationRunnerArguments["runnerBuilder"] =
            "de.mannodermaus.junit5.AndroidJUnit5Builder"
    }
    testOptions {
        unitTests.isReturnDefaultValues = true
        unitTests.isIncludeAndroidResources = true  // Robolectric 必需
    }
}

dependencies {
    // AndroidX Test 核心
    testImplementation("androidx.test:core:1.6.1")
    // JUnit5 原生 API
    testImplementation("org.junit.jupiter:junit-jupiter-api:5.11.0")
    testImplementation("org.junit.jupiter:junit-jupiter-params:5.11.0")
    testRuntimeOnly("org.junit.jupiter:junit-jupiter-engine:5.11.0")
    // JUnit5 AndroidX 桥接
    testImplementation("androidx.test.ext:junit:1.2.1")
    testImplementation("org.junit.platform:junit-platform-runner:1.11.0")
    // Mockito / KotlinMock
    testImplementation("org.mockito:mockito-core:5.14.2")
    testImplementation("org.mockito.kotlin:mockito-kotlin:5.4.0")
    // Robolectric
    testImplementation("org.robolectric:robolectric:4.14.1")
}

1.3 JUnit5 与 Robolectric 的选择逻辑

• JUnit5 vs JUnit4：JUnit5 提供 @ParameterizedTest、@Nested 和更好的扩展模型。AndroidX Test ext:junit 已原生支持 JUnit5 运行器，但需要显式声明 testInstrumentationRunnerArguments。
• Robolectric vs 真机/模拟器：Robolectric 在 JVM 内模拟 Android 框架，适合纯逻辑 + 少量 UI 交互的单元测试；启动速度 < 2s，远快于模拟器。缺点是部分 Android 14+ 的新 API 可能尚未模拟，需通过 @Config(sdk = [34]) 降级 SDK。

1.4 常见错误与调试

1.5 环境搭建流水线（SVG）