Revapi Maven Plugin

Maven integration for Revapi.

Revapi Maven plugin enables API checks during the Maven build. By default, it checks the currently built project against the its latest released version (as reported by Maven). Alternatively, the two artifacts to can be set arbitrarily.

Goals Overview

The plugin offers the following goals:

Usage

Revapi maven plugin is very simple to use. Just define what revapi extensions should be used, what artifacts to compare and off you go. See the examples section, below.

In case you still have questions regarding the plugin’s usage, please feel free to contact the user mailing list. The posts to the mailing list are archived and could already contain the answer to your question as part of an older thread. Hence, it is also worth browsing/searching the mail archive.

If you feel like the plugin is missing a feature or has a defect, you can fill a feature request or bug report in our issue tracker. When creating a new issue, please provide a comprehensive description of your concern. Especially for fixing bugs it is crucial that the developers can reproduce your problem. For this reason, entire debug logs, POMs or most preferably little demo projects attached to the issue are very much appreciated. Of course, patches are most welcome, too. Contributors can check out the project from our source repository and will find supplementary information in the guide to helping with Maven.

Examples

The list of extensions you want to use with Revapi is provided to it as plugin dependencies. Usually you will want to check the API of your java archives, so this is the minimal configuration you need to provide to revapi (note that the basic features extension is implicitly present because without it Revapi can do literally nothing).

<plugin>
  <groupId>org.revapi</groupId>
  <artifactId>revapi-maven-plugin</artifactId>
  <version>...</version>
  <dependencies>
    <dependency>
      <groupId>org.revapi</groupId>
      <artifactId>revapi-java</artifactId>
      <version>...</version>
    </dependency>
  </dependencies>
  <executions>
    <execution>
      <goals><goal>check</goal></goals>
    </execution>
  </executions>
</plugin>

More examples can be found in the "Project Details" menu, including comparing specific artifacts, report configuration, multi file configuration, etc.

Back to top

Msb3 Maven skin by Marek Romanowski.