Maven

Contributing to Apache Maven Surefire

ASF Jira Maven Central Apache License, Version 2.0, January 2004

CI Jenkins Status Jenkins tests Jenkins JaCoCo

Verify

The Maven Community

slack forks

Project Documentation

Maven 3.0 Plugin API

Usage of maven-surefire-plugin, maven-failsafe-plugin, maven-surefire-report-plugin

Development Information

Build the Surefire project using Maven 3.2.5+ and JDK 1.8+.

  • In order to run tests for a release check during the Vote, the following memory requirements are needed:

    On Linux/Unix:

    export MAVEN_OPTS="-server -Xmx512m -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=384m -XX:+UseG1GC -XX:+UseStringDeduplication -XX:+TieredCompilation -XX:TieredStopAtLevel=1 -XX:SoftRefLRUPolicyMSPerMB=50 -Djava.awt.headless=true"
    

    On Windows:

    set MAVEN_OPTS="-server -Xmx256m -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=384m -XX:+UseG1GC -XX:+UseStringDeduplication -XX:+TieredCompilation -XX:TieredStopAtLevel=1 -XX:SoftRefLRUPolicyMSPerMB=50 -Djava.awt.headless=true"
    
  • In order to build and run the tests:

    mvn install site site:stage -P reporting,run-its
    
  • To set up the project in Eclipse IDE or IntelliJ IDEA, please follow these steps:

    • Build module surefire-shared-utils with profile ide-development and install it into the local maven repository using this Maven command:

      mvn install -P ide-development -f surefire-shared-utils/pom.xml
      
    • Build module surefire-grouper in order to generate and compile sources into target/generated-sources/javacc using this Maven command:

      mvn compile -f surefire-grouper/pom.xml
      
    • In Eclipse, select File > Import ... > Maven Project

      • Select all projects (poms) except surefire-shared-utils, enter profile ide-development in Advanced -> Profiles
      • Check module surefire-grouper has source folder target/generated-sources/javacc. If not, add it manually in the module's project properties
    • In IntelliJ, select Maven > Profiles and check ide-development

Deploying web site

See http://maven.apache.org/developers/website/deploy-component-reference-documentation.html

Built with Maven