Configuring JUnit 5 Testing in Gradle Projects

JUnit 5 is the latest version of the popular Java testing framework, offering many new features and improvements over JUnit 4. This guide will walk you through the steps to configure JUnit 5 in your Gradle projects, ensuring you can take advantage of its capabilities.

Step 1: Set Up a New Gradle Project

If you don't already have a Gradle project, you can create a new one using the following commands:

mkdir gradle-junit5-example
cd gradle-junit5-example
gradle init --type java-application

Step 2: Modify build.gradle to Include JUnit 5

Open the build.gradle file and add the necessary dependencies for JUnit 5. Ensure you are using the latest versions of all dependencies.

plugins {
    id 'java'

repositories {

dependencies {
    // JUnit 5 dependencies
    testImplementation 'org.junit.jupiter:junit-jupiter-api:5.10.0'
    testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.10.0'

    // Other dependencies (example)
    implementation 'org.apache.commons:commons-lang3:3.12.0'
    implementation ''
    runtimeOnly 'mysql:mysql-connector-java:8.0.29'

test {


  • testImplementation: This configuration is used for dependencies required to compile the test source set.
  • testRuntimeOnly: This configuration is used for dependencies required to run the tests.
  • useJUnitPlatform(): This method tells Gradle to use JUnit Platform for running the tests.

Step 3: Create a Sample Test Class

Create a directory structure for your test classes. Inside the src/test/java directory, create a new test class,

package com.example;

import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.assertEquals;

public class ExampleTest {

    void testAddition() {
        assertEquals(2, 1 + 1, "1 + 1 should equal 2");


  • @Test: This annotation marks a method as a test method.
  • assertEquals: This is an assertion method that checks if the expected value matches the actual value.

Step 4: Running Tests

To run the tests, use the following command:

gradle test

Gradle will compile the test classes and run the tests using JUnit 5.

Step 5: Generate Test Reports

Gradle generates test reports by default. You can find the test reports in the build/reports/tests/test directory. Open the index.html file in a web browser to view the report.

Step 6: Configuring Test Logging (Optional)

You can configure the test logging to get more detailed information about the test execution.

test {
    testLogging {
        events "PASSED", "FAILED", "SKIPPED"
        exceptionFormat "full"


  • events "PASSED", "FAILED", "SKIPPED": Specifies which test events to log.
  • exceptionFormat "full": Configures the format for exception messages in the logs.

Example Project Structure

Here is an example of what your project structure should look like:

├── build.gradle
├── gradlew
├── gradlew.bat
├── settings.gradle
├── src
│   ├── main
│   │   ├── java
│   │   │   └── com
│   │   │       └── example
│   │   │           └──
│   ├── test
│       └── java
│           └── com
│               └── example
│                   └──


Configuring JUnit 5 in your Gradle projects is straightforward. By following the steps outlined in this guide, you can set up and run JUnit 5 tests, leverage its new features, and generate detailed test reports. This setup ensures that your testing framework is up-to-date and capable of handling modern testing requirements.

For more detailed information on JUnit 5, refer to the JUnit 5 User Guide.

For more detailed information on Gradle, refer to the Gradle User Guide.