tycho-versions:set-version

Full name:

org.eclipse.tycho:tycho-versions-plugin:0.22.0:set-version

Description:

Sets the version of the current project and child projects with the same version, and updates references as necessary.

The set-version goal implements a version refactoring for a Tycho reactor: When updating the version of a project, it consistently updates the version strings in the project's configuration files (e.g. pom.xml and META-INF/MANIFEST.MF) and all references to that project (e.g. in a feature.xml).

In many cases, the set-version goal changes the version of multiple projects or entities at once. In addition to the current project, child projects with the same version are also changed. The set of version changes is determined according to the following rules:

  • When the parent project of a project is changed and the project has the same version as the parent project, the project is also changed.
  • When an eclipse-plugin project is changed and the plugin exports a package with a version which is the same as the unqualified project version, the version of the package is also changed.
  • When an eclipse-repository project is changed and a product file in the project has an equivalent version, the version in the product file is also changed.

Attributes:

  • Requires a Maven project to be executed.
  • Executes as an aggregator plugin.
  • Executes by direct invocation only.

Required Parameters

Name Type Since Description
newVersion String -

The new version to set to the current project and other entities which have the same version as the current project.


User property is: newVersion.

Optional Parameters

Name Type Since Description
artifacts String -

Initial list of of projects to be changed. From these projects, the full list of projects to be changed is derived according to the rules described above. If set, this parameter needs to be specified as a comma separated list of artifactIds.


Default value is: ${project.artifactId}.
User property is: artifacts.
properties String 0.18.0

Comma separated list of names of POM properties to set the new version to. Note that properties are only changed in the projects explicitly listed by the artifacts parameter.


User property is: properties.

Parameter Details

artifacts:

Initial list of of projects to be changed. From these projects, the full list of projects to be changed is derived according to the rules described above. If set, this parameter needs to be specified as a comma separated list of artifactIds.

  • Type: java.lang.String
  • Required: No
  • User Property: artifacts
  • Default: ${project.artifactId}

newVersion:

The new version to set to the current project and other entities which have the same version as the current project.

  • Type: java.lang.String
  • Required: Yes
  • User Property: newVersion

properties:

Comma separated list of names of POM properties to set the new version to. Note that properties are only changed in the projects explicitly listed by the artifacts parameter.

  • Type: java.lang.String
  • Since: 0.18.0
  • Required: No
  • User Property: properties