[译]JUnit5 Gradle示例 - 基于Gradle运行测试
本文翻译自JUnit 5 Gradle Example。
在本教程中,我们将学习在基于Gradle
编写JUnit 5
测试时如何获取相关的依赖,以及如何配置 JUnit Gradle
插件来运行相关测试。
本文是JUnit 5 教程的一部分。
相关依赖
若要能够编写JUnit 5
测试需要在build.gradle
中添加junit-jupiter作为依赖项:
dependencies {
testImplementation("org.junit.jupiter:junit-jupiter:5.8.0")
}
之后配置让相关测试使用JUnit
平台:
test {
useJUnitPlatform()
}
至此我们已经有了使用Gradle
编写和运行JUnit 5
测试的最基本配置。
旧版本配置
从JUnit Jupiter 5.4.0
开始有一个聚合器组件junit-jupiter
它可以传递对junit-jupiter-api
、junit-jupiter-params
和junit-jupiter-engine
的依赖以简化依赖关系管理,这意味着我们不需要额外的依赖项就能够编写参数化测试。
为了能够使用旧版本编写JUnit 5
测试,需要junit-jupiter-api
组件作为依赖项,同时需要在运行时类路径下添加JUnit Jupiter测试引擎:
dependencies {
testImplementation("org.junit.jupiter:junit-jupiter-api:5.3.2")
testRuntimeOnly("org.junit.jupiter:junit-jupiter-engine:5.3.2")
}
从Gradle 4.6
开始,提供了对JUnit Jupiter
的原生支持,而在使用Gradle 4.5
或更早版本时,为了能够运行JUnit 5
测试则必须配置JUnit Gradle
插件:
buildscript {
repositories {
mavenCentral()
}
dependencies {
classpath 'org.junit.platform:junit-platform-gradle-plugin:1.3.2'
}
}
apply plugin: 'org.junit.platform.gradle.plugin'
至此我们已经有了使用旧版本的Gradle
运行JUnit 5
测试的基本配置。
运行测试
JUnit Gradle
插件默认情况下在src/test/java
目录下查找测试用例。
可通过添加一个空测试来检查我们的配置是否生效。
class GradleExampleTest {
@Test
void shouldRun() {
}
}
在命令行中运行相关测试:
gradle test
我们应该能看到类似如下输出:
:test
BUILD SUCCESSFUL in 2s
好了, JUnit Gradle
插件现在可正常运行我们的测试。
总结
在这个JUnit 5 Gradle
教程中,我们学习了如何添加编写JUnit 5
测试所需的依赖项以及如何配置JUnit Gradle
插件以便能够运行测试。
本文的示例代码能在GitHub中找到。