tycho-version-bump:update-target

Full name:

org.eclipse.tycho.extras:tycho-version-bump-plugin:5.0.0-SNAPSHOT:update-target

Description:

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)

Attributes:

  • Requires a Maven project to be executed.
  • The goal is not marked as thread-safe and thus does not support parallel builds.

Optional Parameters

Name Type Since Description
<allowIncrementalUpdates> boolean - Whether to allow the incremental version number to be changed.
Default: true
User Property: allowIncrementalUpdates
<allowMajorUpdates> boolean - Whether to allow the major version number to be changed.
Default: true
User Property: allowMajorUpdates
<allowMinorUpdates> boolean - Whether to allow the minor version number to be changed.
Default: true
User Property: allowMinorUpdates
<allowSubIncrementalUpdates> boolean - Whether to allow the subIncremental version number to be changed.
Default: true
User Property: allowSubIncrementalUpdates
<mavenIgnoredVersions> Set<String> -

Allows specifying ignored maven artifact versions as an alternative to providing a mavenRuleSet parameter.


User Property: maven.version.ignore
<mavenRuleSet> RuleSet -

Allows specifying a org.codehaus.mojo.versions.model.RuleSet object describing rules on maven artifact versions to ignore when considering updates.

<mavenRulesUri> String - URI of a ruleSet file containing the rules that control how to compare version numbers.
User Property: maven.version.rules
<project> MavenProject - No description.
User Property: project
<targetFile> File - Specify the path to the target file to update, if not given the current project settings will be used to find a suitable file
User Property: target
<updateSiteDiscovery> String - A comma separated list of update site discovery strategies, the following is currently supported:
  • parent - search the parent path for a composite that can be used to find newer versions

User Property: discovery

Parameter Details

<allowIncrementalUpdates>

Whether to allow the incremental version number to be changed.
  • Type: boolean
  • Required: No
  • User Property: allowIncrementalUpdates
  • Default: true

<allowMajorUpdates>

Whether to allow the major version number to be changed.
  • Type: boolean
  • Required: No
  • User Property: allowMajorUpdates
  • Default: true

<allowMinorUpdates>

Whether to allow the minor version number to be changed.
  • Type: boolean
  • Required: No
  • User Property: allowMinorUpdates
  • Default: true

<allowSubIncrementalUpdates>

Whether to allow the subIncremental version number to be changed.
  • Type: boolean
  • Required: No
  • User Property: allowSubIncrementalUpdates
  • Default: true

<mavenIgnoredVersions>

Allows specifying ignored maven artifact versions as an alternative to providing a mavenRuleSet parameter.

  • Type: java.util.Set<java.lang.String>
  • Required: No
  • User Property: maven.version.ignore

<mavenRuleSet>

Allows specifying a org.codehaus.mojo.versions.model.RuleSet object describing rules on maven artifact versions to ignore when considering updates.

  • Type: org.codehaus.mojo.versions.model.RuleSet
  • Required: No

<mavenRulesUri>

URI of a ruleSet file containing the rules that control how to compare version numbers.
  • Type: java.lang.String
  • Required: No
  • User Property: maven.version.rules

<project>

No description.
  • Type: org.apache.maven.project.MavenProject
  • Required: No
  • User Property: project

<targetFile>

Specify the path to the target file to update, if not given the current project settings will be used to find a suitable file
  • Type: java.io.File
  • Required: No
  • User Property: target

<updateSiteDiscovery>

A comma separated list of update site discovery strategies, the following is currently supported:
  • parent - search the parent path for a composite that can be used to find newer versions
  • Type: java.lang.String
  • Required: No
  • User Property: discovery