Maven Surefire Plugin – Plugin Documentation

Plugin Documentation

This report describes goals, parameters details, requirements and sample usage of this plugin.

Goals

Goals available for this plugin:

Goal	Description
surefire:help	Display help information on maven-surefire-plugin. Call `mvn surefire:help -Ddetail=true -Dgoal=<goal-name>` to display parameter details.
surefire:test	Run tests using Surefire.

System Requirements

The following specifies the minimum requirements to run this Maven plugin:

Maven	3.6.3
JDK	1.8

System Requirements History

The following specifies the minimum requirements to run this Maven plugin for historical versions:

Plugin Version	Maven	JDK
from 3.3.0 to 3.5.0	3.6.3	8
from 3.0.0-M6 to 3.2.5	3.2.5	8
from 3.0.0-M1 to 3.0.0-M5	3.0	7
from 2.20 to 2.22.2	2.2.1	6
from 2.18 to 2.19.1	2.2.1	5
from 2.12 to 2.17	2.0.9	5
from 2.6 to 2.11	2.0.9	1.4
2.5	2.0.9	1.3
2.4.3	2.0.6	1.3
from 2.4 to 2.4.2	-	1.3
from 2.3 to 2.3.1	2.0	1.3
from 2.0-beta-1 to 2.2	-	-

Usage

You should specify the version in your project's plugin configuration:

<project>
  ...
  <build>
    <!-- To define the plugin version in your parent POM -->
    <pluginManagement>
      <plugins>
        <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-surefire-plugin</artifactId>
          <version>3.5.0</version>
        </plugin>
        ...
      </plugins>
    </pluginManagement>
    <!-- To use the plugin goals in your POM or parent POM -->
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-surefire-plugin</artifactId>
      </plugin>
      ...
    </plugins>
  </build>
  ...
</project>

For more information, see "Guide to Configuring Plug-ins"