Plugin Documentation

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

Goals

Goals available for this plugin:

Goal Description
tycho-version-bump:update-manifest This mojo updates the dependencies in a manifest with the current used build versions.

It is recommended to use as the lower bound the dependency the code was compiled with to avoid using newer code from dependencies, but managing that manually can be a daunting task.

This can be used to automate the task for example after dependencies are updated:

mvn tycho-version-bump:update-manifest

tycho-version-bump:update-product Quick&dirty way to update .product file to use latest versions of IUs available from specified metadata repositories.
tycho-version-bump:update-target This allows to update a target file to use newer version of specified items, e.g. IUs from updatesites or maven coordinates. In the simplest form this is called like
mvn -f [path to target project] tycho-version-bump:update-target

For updating maven target locations the mojo support Version number comparison rule-sets similar to the Versions Maven Plugin please check the documentation there for further information about ruleset files.

For updating installable unit locations (also known as update sites)

System Requirements

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

Maven 3.9.6
JDK 17

System Requirements History

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

Plugin Version Maven JDK
from 4.0.0 to 4.0.10 3.9.0 17
from 3.0.0 to 3.0.5 - 17
from 2.0.0 to 2.7.5 - 11
from 1.1.0 to 1.7.0 - 8
from 0.23.0 to 1.0.0 - 7
0.22.0 - 6
from 0.12.0 to 0.21.0 - 5

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.eclipse.tycho.extras</groupId>
          <artifactId>tycho-version-bump-plugin</artifactId>
          <version>5.0.0-SNAPSHOT</version>
        </plugin>
        ...
      </plugins>
    </pluginManagement>
    <!-- To use the plugin goals in your POM or parent POM -->
    <plugins>
      <plugin>
        <groupId>org.eclipse.tycho.extras</groupId>
        <artifactId>tycho-version-bump-plugin</artifactId>
      </plugin>
      ...
    </plugins>
  </build>
  ...
</project>

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