测试依赖配置：从选择到集成

测试依赖配置是 WorkManager 单元测试得以运行的物质基础。你需要选择测试框架、Mock 库以及 Android 模拟环境，并将它们声明到 build.gradle 中。本章将梳理每个选择背后的原理，给出可复用的配置范例，并展示依赖关系图。

2.1 核心依赖选型原理

WorkManager 单元测试涉及三层依赖：

• 测试执行引擎：JUnit 4 或 JUnit 5。JUnit 4 是 Android 生态中最成熟的选择，而 JUnit 5 提供了更灵活的扩展模型和参数化测试。
• Mock 框架：Mockito（支持 Java/Kotlin）或 MockK（Kotlin 原生）。Kotlin 项目推荐 MockK，它完美处理 final 类和扩展函数；Mockito 在配合 mockito-inline 时也能胜任。
• Android 环境模拟：Robolectric 提供了在 JVM 上运行 Android 组件的能力，避免依赖真实设备或模拟器。

这些依赖需要版本兼容。例如 Robolectric 4.x 要求 JUnit 4 且已内嵌 @RunWith(RobolectricTestRunner::class)；若使用 JUnit 5，则需要额外适配库 robolectric-junit5。

2.2 配置实现流程

1. 打开模块级 build.gradle（通常为 app/build.gradle）。
2. 在 dependencies 块内添加测试依赖，声明 testImplementation（仅单元测试生效）。
3. 按项目语言选择 Mock 框架：Kotlin 项目可选 MockK，Java 项目选 Mockito。
4. 若使用 JUnit 5，需额外添加 testRuntimeOnly 运行时引擎依赖。
5. 添加 Robolectric 核心库，并在 android 块中配置 testOptions 以确保正确运行。

2.3 完整 build.gradle 配置范例

以下是一个同时支持 JUnit 5、MockK 和 Robolectric 的典型配置（Kotlin DSL）：

android {
    defaultConfig {
        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }
    testOptions {
        unitTests {
            isIncludeAndroidResources = true
        }
    }
}

dependencies {
    // JUnit 5 依赖（如果使用 JUnit 4 可替换为 jUnit:junit:4.13.2）
    testImplementation("org.junit.jupiter:junit-jupiter-api:5.10.0")
    testRuntimeOnly("org.junit.jupiter:junit-jupiter-engine:5.10.0")

    // MockK（相较于 Mockito，原生支持 Kotlin）
    testImplementation("io.mockk:mockk:1.13.5")

    // Robolectric（内嵌 JUnit 4 Runner，需搭配 junit-platform-impl）
    testImplementation("org.robolectric:robolectric:4.10.3")
    // 若使用 JUnit 5，需额外添加 robolectric-junit5 适配器
    testImplementation("org.robolectric:robolectric-junit5:4.10.3")
}

2.4 JUnit 4 与 JUnit 5 对比

2.5 Mock 框架选择：Mockito vs MockK

2.6 依赖配置决策与结构图

下图从“WorkManager 单元测试”出发，展示了各依赖的选择分支和最终集成到 build.gradle 的过程：

2.7 调试与常见错误

• 依赖冲突：运行 ./gradlew app:dependencies 检查是否出现多个版本的 JUnit 或 Mock 库。使用 strictly 或 force 解决。
• Robolectric 找不到资源：确认 android { testOptions { unitTests.includeAndroidResources = true } } 已设置。
• Mockito 无法 mock final 类：添加 testImplementation("org.mockito:mockito-inline:5.2.0") 或创建 src/test/resources/mockito-extensions/org.mockito.plugins.MockMaker 文件，内容为 mock-maker-inline。
• JUnit 5 + Robolectric 报错：缺少 robolectric-junit5 或版本不兼容。

2.8 性能与稳定性优化

• 最小化测试依赖：仅添加真正需要的库，避免引入大型 Android 依赖拖慢构建。
• 版本锁定：将测试依赖版本写在 gradle.properties 或版本目录文件中，避免间接依赖升级导致不稳定。
• 分离测试配置：如果项目同时使用 JUnit 4 和 JUnit 5（过渡期），使用 testImplementation 和 androidTestImplementation 区分，防止混淆。