Guide to Testing Development Versions of Plugins

Why would I want to do this?

If a bug you are encountering has been reported as fixed but not yet released, you can confirm that it has been fixed for you. Or perhaps you just like to live on the bleeding edge.

You are highly encouraged to join the development list for the project and provide your feedback, or help promote release of the plugin in question.

Note: This is not recommended as an everyday or in production practice! Snapshots are for testing purposes only and are not official releases. For more information, see the Releases FAQ.

How do I do this?

Development versions of Maven plugins are periodically published to the repository: http://repository.apache.org/snapshots/.

Note: Currently, this is not done automatically by our continuous integration setup. This is coming soon.

Other sites may publish there own - for example, the Mojo project hosts theirs at http://snapshots.repository.codehaus.org/

The first step is to include this in your project:

<project>
  ...
  <pluginRepositories>
    <pluginRepository>
      <id>apache.snapshots</id>
      <url>http://repository.apache.org/snapshots/</url>
    </pluginRepository>
  </pluginRepositories>
  ...
</project>

After this is included, there are three ways to use the updated versions:

  • Set the appropriate version in the plugin, eg 2.0.1-SNAPSHOT
  • If you have not specified a version, use the -U switch to update plugins for the given Maven run
  • You can have Maven automatically check for updates on a given interval, for example:
    <project>
      ...
      <pluginRepositories>
        <pluginRepository>
          <id>apache.snapshots</id>
          <url>http://repository.apache.org/snapshots/</url>
          <!-- The releases element here is due to an issue in Maven 2.0 that will be
               fixed in future releases. This should be able to be disabled altogether. -->
          <releases>
            <updatePolicy>daily</updatePolicy>
          </releases>
          <snapshots>
            <updatePolicy>daily</updatePolicy>
          </snapshots>
        </pluginRepository>
      </pluginRepositories>
      ...
    </project>

Note: These last two techniques mean that every plugin will be updated to the latest snapshot version.

The development version will stop being used if the <pluginRepository> element is removed from your POM and the version is set back to the release version. If you are using the command line or an unspecified version, you will also need to remove the version from the local repository.

Using Settings without Modifying the Project

If you are using the goals from the command line on a number of projects, you should include this in your settings.xml file instead.

You need to modify your ~/.m2/settings.xml file to include two new profiles and then when you need access to the plugin snapshots use -Papache. The profile only needs to be enabled once so that the plugins can be downloaded into you local repository. Once in your local repository Maven can succesfully resolve the dependencies and the profile no longer needs to be activated.

<settings>
  ...
  <profiles>
    <profile>
      <id>apache</id>
      <pluginRepositories>
        <pluginRepository>
          <id>apache.snapshots</id>
          <name>Maven Plugin Snapshots</name>
          <url>http://repository.apache.org/snapshots/</url>
          <releases>
            <enabled>false</enabled>
          </releases>
          <snapshots>
            <enabled>true</enabled>
          </snapshots>
        </pluginRepository>
      </pluginRepositories>
    </profile>
  </profiles>
  ...
</settings>

When invoking Maven for Apache profile, do it like this:

mvn -Papache <phase|goal>

Using a Repository Manager

In addition to the above you may want to use a repository manager so that you can retain the builds you have been using. For information on this technique, see the Guide to Testing Staged Releases.

How do I make changes to the source and test development versions of the plugins?

For information on this, see the Guide to Maven 2.0 Development.