如何在指定版本环境下结合build.gradle.kts与Kotlin使用JUnit 5？

我来帮你搞定在Kotlin项目里用build.gradle.kts配置JUnit 5的事儿，还会加上Jigsaw模块系统的适配，完全匹配你给出的版本要求：Java 10.0.1、Kotlin 1.2.41、Gradle 4.7。

一、基础JUnit 5配置（不含Jigsaw） #

先从最基础的配置开始，确保你能正常运行JUnit 5测试：

1. 首先在build.gradle.kts里引入Kotlin和JUnit相关依赖，配置测试任务：

plugins {
    kotlin("jvm") version "1.2.41"
    java
}

repositories {
    mavenCentral()
}

dependencies {
    // Kotlin标准库（适配JDK8+）
    implementation(kotlin("stdlib-jdk8", version = "1.2.41"))
    
    // JUnit 5核心依赖
    testImplementation(kotlin("test-junit5", version = "1.2.41"))
    testImplementation("org.junit.jupiter:junit-jupiter-api:5.4.2")
    testRuntimeOnly("org.junit.jupiter:junit-jupiter-engine:5.4.2")
}

// 配置测试任务使用JUnit Platform
tasks.test {
    useJUnitPlatform()
    // 可选：显示测试详细执行结果
    testLogging {
        events("passed", "skipped", "failed")
    }
}

// 指定JVM编译目标为Java 10
tasks.withType<KotlinCompile> {
    kotlinOptions.jvmTarget = "10"
}

2. 编写一个简单的Kotlin测试类验证配置：

import org.junit.jupiter.api.Test
import kotlin.test.assertEquals

class SampleTest {
    @Test
    fun `test basic addition`() {
        assertEquals(2, 1 + 1)
    }
}

运行./gradlew test就能看到测试执行结果了。

二、加入Jigsaw模块系统支持 #

如果要启用Jigsaw模块，需要补充以下配置：

1. 创建模块描述文件 #

在src/main/java下创建module-info.java（Kotlin 1.2.41对模块的支持有限，用Java的模块描述更稳妥）：

module com.yourcompany.yourapp {
    requires kotlin.stdlib;
    // 如有其他依赖模块，在这里添加requires声明
}

在src/test/java下创建测试模块的描述文件（必须用open关键字，因为JUnit需要反射访问测试类）：

open module com.yourcompany.yourapp.test {
    requires com.yourcompany.yourapp;
    requires kotlin.stdlib;
    requires org.junit.jupiter.api;
}

2. 在Gradle中启用模块支持 #

修改build.gradle.kts，添加模块系统相关配置：

// 启用自动推断模块路径
java {
    modularity.inferModulePath = true
}

// 确保测试任务使用模块路径执行
tasks.test {
    useJUnitPlatform()
    jvmArgs = listOf("--module-path", classpath.asPath)
}

3. 完整的build.gradle.kts示例 #

整合所有配置后的完整文件如下：

plugins {
    kotlin("jvm") version "1.2.41"
    java
}

repositories {
    mavenCentral()
}

java {
    modularity.inferModulePath = true
}

dependencies {
    implementation(kotlin("stdlib-jdk8", version = "1.2.41"))
    
    testImplementation(kotlin("test-junit5", version = "1.2.41"))
    testImplementation("org.junit.jupiter:junit-jupiter-api:5.4.2")
    testRuntimeOnly("org.junit.jupiter:junit-jupiter-engine:5.4.2")
}

tasks.withType<KotlinCompile> {
    kotlinOptions.jvmTarget = "10"
}

tasks.test {
    useJUnitPlatform()
    jvmArgs = listOf("--module-path", classpath.asPath)
    testLogging {
        events("passed", "skipped", "failed")
    }
}

关键注意事项 #

• JUnit 5版本选择：我选了5.4.2，这个版本完全兼容Java 10，如果你需要更新版本，确保它支持Java 10即可。
• 测试模块的open关键字：必须添加，否则JUnit无法通过反射实例化测试类和调用测试方法。
• Gradle 4.7模块支持：这个版本的模块功能已经可用，但细节上不如后续版本完善，如果遇到依赖问题，优先检查模块声明的requires语句是否正确。

内容的提问来源于stack exchange，提问作者xiang