第2章 JUnit4与JUnit5在Android中的配置

2.1 原理概述

JUnit4与JUnit5在Android测试中的核心差异在于依赖模型、扩展机制和运行时兼容性。
JUnit4依赖单一的 junit:junit 库，通过 AndroidJUnitRunner 运行测试；JUnit5则采用分离式架构（JUnit Platform + Jupiter + Vintage），允许同时运行JUnit3/4/5测试。
在Android项目中配置两种版本时，需注意Instrumentation测试与本地单元测试的类加载顺序差异，以及JUnit5对Android Gradle Plugin (AGP) 的最低版本要求。

2.2 依赖引入与Gradle配置

2.2.1 JUnit4 基础依赖

// app/build.gradle (Module)
android {
    defaultConfig {
        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }
}

dependencies {
    // JUnit4
    testImplementation 'junit:junit:4.13.2'
    androidTestImplementation 'androidx.test.ext:junit:1.1.5'

    // Android测试工具（可选）
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.5.1'
    androidTestImplementation 'androidx.test:rules:1.5.0'
}

2.2.2 JUnit5 依赖配置（使用 android-junit5 插件）

// project/build.gradle (Project)
buildscript {
    dependencies {
        classpath 'de.mannodermaus.gradle.plugins:android-junit5:1.10.0.0'
    }
}

// app/build.gradle (Module)
apply plugin: 'de.mannodermaus.android-junit5'

android {
    defaultConfig {
        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }
}

dependencies {
    // JUnit5 Platform + Jupiter
    testImplementation 'org.junit.jupiter:junit-jupiter-api:5.10.2'
    testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.10.2'
    androidTestImplementation 'org.junit.jupiter:junit-jupiter-api:5.10.2'
    androidTestRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.10.2'

    // Vintage引擎（运行旧版JUnit3/4）
    testImplementation 'org.junit.vintage:junit-vintage-engine:5.10.2'
}

2.3 测试运行器对比

2.4 参数化测试实现

2.4.1 JUnit4 参数化（@RunWith(Parameterized.class)）

import org.junit.Test;
import org.junit.runner.RunWith;
import org.junit.runners.Parameterized;
import org.junit.runners.Parameterized.Parameters;
import java.util.Arrays;
import java.util.Collection;

@RunWith(Parameterized.class)
public class CalculatorParamTest {
    private int input1;
    private int input2;
    private int expected;

    public CalculatorParamTest(int input1, int input2, int expected) {
        this.input1 = input1;
        this.input2 = input2;
        this.expected = expected;
    }

    @Parameters
    public static Collection<Object[]> data() {
        return Arrays.asList(new Object[][]{
            {2, 3, 5},
            {0, 0, 0},
            {-1, -1, -2}
        });
    }

    @Test
    public void testAdd() {
        assertEquals(expected, Math.add(input1, input2));
    }
}

2.4.2 JUnit5 参数化（@ParameterizedTest + @ValueSource）

import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.CsvSource;
import static org.junit.jupiter.api.Assertions.assertEquals;

class CalculatorParamTestJ5 {

    @ParameterizedTest
    @CsvSource({
        "2, 3, 5",
        "0, 0, 0",
        "-1, -1, -2"
    })
    void testAdd(int input1, int input2, int expected) {
        assertEquals(expected, Math.add(input1, input2));
    }
}

2.5 规则（Rule）与扩展（Extension）使用

2.5.1 JUnit4 典型规则

import androidx.test.ext.junit.rules.ActivityScenarioRule;
import org.junit.Rule;
import org.junit.Test;

public class MainActivityTest {
    @Rule
    public ActivityScenarioRule<MainActivity> activityRule =
            new ActivityScenarioRule<>(MainActivity.class);

    @Test
    public void testActivityCreated() {
        activityRule.getScenario().onActivity(activity -> {
            // 测试Activity生命周期
        });
    }
}

2.5.2 JUnit5 扩展（替代规则）

import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.RegisterExtension;
import androidx.test.ext.junit.rules.ActivityScenarioExtension;

public class MainActivityJ5Test {
    @RegisterExtension
    static ActivityScenarioExtension<MainActivity> activityExtension =
            new ActivityScenarioExtension<>(MainActivity.class);

    @Test
    void testActivityCreated() {
        activityExtension.getScenario().onActivity(activity -> {
            // 相同功能
        });
    }
}

2.6 调试与常见错误

2.7 性能与稳定性优化

• 依赖冲突：若项目同时引入JUnit4和JUnit5，务必通过 configurations.all { exclude module: 'junit' } 排除旧版以防方法重复。
• 测试执行速度：JUnit5支持动态测试（@TestFactory）和条件测试（@EnabledIf），可减少无效执行，提升CI流水线效率。
• 规则线程安全：使用 @RegisterExtension 时建议将字段设为 static 以避免每个测试实例重复创建Activity，节省开销。
• 混淆配置：开启ProGuard/R8时需保留JUnit反射相关类，否则参数化测试的构造函数参数绑定会失败。

2.8 本章小结