Fork me on GitHub

versions:update-properties

Full name:

org.codehaus.mojo:versions-maven-plugin:2.8.1:update-properties

Description:

Sets properties to the latest versions of specific artifacts.

Attributes:

  • Requires a Maven project to be executed.
  • Executes by direct invocation only.
  • Since version: 1.0-alpha-1.

Optional Parameters

Name Type Since Description
<allowDowngrade> boolean 2.4 If a property points to a version like 1.2.3-SNAPSHOT and your repo contains a version like 1.1.0 without settings this to true the property will not being changed.
Default value is: false.
User property is: allowDowngrade.
<allowIncrementalUpdates> boolean 2.4 Whether to allow the incremental version number to be changed.
Default value is: true.
User property is: allowIncrementalUpdates.
<allowMajorUpdates> boolean 2.4 Whether to allow the major version number to be changed.
Default value is: true.
User property is: allowMajorUpdates.
<allowMinorUpdates> boolean 2.4 Whether to allow the minor version number to be changed.
Default value is: true.
User property is: allowMinorUpdates.
<allowSnapshots> boolean 1.0-alpha-1 Whether to allow snapshots when searching for the latest version of an artifact.
Default value is: false.
User property is: allowSnapshots.
<autoLinkItems> boolean 1.0-alpha-2 Whether properties linking versions should be auto-detected or not.
Default value is: true.
User property is: autoLinkItems.
<excludeProperties> String 1.0-alpha-1 A comma separated list of properties to not update.
User property is: excludeProperties.
<excludeReactor> boolean 1.0-alpha-3 Whether to skip processing dependencies that are produced as part of the current reactor.
Default value is: true.
User property is: excludeReactor.
<excludes> String[] 1.0-beta-1 A list of artifact patterns to exclude. Follows the pattern "groupId:artifactId:type:classifier:version". This configuration setting is ignored if excludesList is defined.
<excludesList> String 1.0-beta-1 A comma separated list of artifact patterns to exclude. Follows the pattern "groupId:artifactId:type:classifier:version". Designed to allow specifing the set of excludes from the command line. When specifying excludes from the pom, use the excludes configuration instead. If this property is specified then the exclude configuration is ignored.
User property is: excludes.
<generateBackupPoms> boolean 1.0-alpha-3 Controls whether a backup pom should be created.
Default value is: true.
User property is: generateBackupPoms.
<includeProperties> String 1.0-alpha-1 A comma separated list of properties to update.
User property is: includeProperties.
<includes> String[] 1.0-beta-1 A list of artifact patterns to include. Follows the pattern "groupId:artifactId:type:classifier:version". This configuration setting is ignored if includesList is defined.
<includesList> String 1.0-beta-1 A comma separated list of artifact patterns to include. Follows the pattern "groupId:artifactId:type:classifier:version". Designed to allow specifing the set of includes from the command line. When specifying includes from the pom, use the includes configuration instead. If this property is specified then the include configuration is ignored.
User property is: includes.
<processDependencies> boolean 1.0-alpha-3 Whether to process the dependencies section of the project.
Default value is: true.
User property is: processDependencies.
<processDependencyManagement> boolean 1.0-alpha-3 Whether to process the dependencyManagement section of the project.
Default value is: true.
User property is: processDependencyManagement.
<processParent> boolean 2.3 Whether to process the parent section of the project. If not set will default to false.
Default value is: false.
User property is: processParent.
<properties> Property[] 1.0-alpha-3 Any restrictions that apply to specific properties.
<rulesUri> String 1.0-alpha-3 URI of a ruleSet file containing the rules that control how to compare version numbers. The URI could be either a Wagon URI or a classpath URI (e.g. classpath:///package/sub/package/rules.xml).
User property is: maven.version.rules.
<serverId> String 1.0-alpha-3 settings.xml's server id for the URL. This is used when wagon needs extra authentication information.
Default value is: serverId.
User property is: maven.version.rules.serverId.

Parameter Details

<allowDowngrade>

If a property points to a version like 1.2.3-SNAPSHOT and your repo contains a version like 1.1.0 without settings this to true the property will not being changed.
  • Type: boolean
  • Since: 2.4
  • Required: No
  • User Property: allowDowngrade
  • Default: false

<allowIncrementalUpdates>

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

<allowMajorUpdates>

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

<allowMinorUpdates>

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

<allowSnapshots>

Whether to allow snapshots when searching for the latest version of an artifact.
  • Type: boolean
  • Since: 1.0-alpha-1
  • Required: No
  • User Property: allowSnapshots
  • Default: false

<autoLinkItems>

Whether properties linking versions should be auto-detected or not.
  • Type: boolean
  • Since: 1.0-alpha-2
  • Required: No
  • User Property: autoLinkItems
  • Default: true

<excludeProperties>

A comma separated list of properties to not update.
  • Type: java.lang.String
  • Since: 1.0-alpha-1
  • Required: No
  • User Property: excludeProperties

<excludeReactor>

Whether to skip processing dependencies that are produced as part of the current reactor.
  • Type: boolean
  • Since: 1.0-alpha-3
  • Required: No
  • User Property: excludeReactor
  • Default: true

<excludes>

A list of artifact patterns to exclude. Follows the pattern "groupId:artifactId:type:classifier:version". This configuration setting is ignored if excludesList is defined.
  • Type: java.lang.String[]
  • Since: 1.0-beta-1
  • Required: No

<excludesList>

A comma separated list of artifact patterns to exclude. Follows the pattern "groupId:artifactId:type:classifier:version". Designed to allow specifing the set of excludes from the command line. When specifying excludes from the pom, use the excludes configuration instead. If this property is specified then the exclude configuration is ignored.
  • Type: java.lang.String
  • Since: 1.0-beta-1
  • Required: No
  • User Property: excludes

<generateBackupPoms>

Controls whether a backup pom should be created.
  • Type: boolean
  • Since: 1.0-alpha-3
  • Required: No
  • User Property: generateBackupPoms
  • Default: true

<includeProperties>

A comma separated list of properties to update.
  • Type: java.lang.String
  • Since: 1.0-alpha-1
  • Required: No
  • User Property: includeProperties

<includes>

A list of artifact patterns to include. Follows the pattern "groupId:artifactId:type:classifier:version". This configuration setting is ignored if includesList is defined.
  • Type: java.lang.String[]
  • Since: 1.0-beta-1
  • Required: No

<includesList>

A comma separated list of artifact patterns to include. Follows the pattern "groupId:artifactId:type:classifier:version". Designed to allow specifing the set of includes from the command line. When specifying includes from the pom, use the includes configuration instead. If this property is specified then the include configuration is ignored.
  • Type: java.lang.String
  • Since: 1.0-beta-1
  • Required: No
  • User Property: includes

<processDependencies>

Whether to process the dependencies section of the project.
  • Type: boolean
  • Since: 1.0-alpha-3
  • Required: No
  • User Property: processDependencies
  • Default: true

<processDependencyManagement>

Whether to process the dependencyManagement section of the project.
  • Type: boolean
  • Since: 1.0-alpha-3
  • Required: No
  • User Property: processDependencyManagement
  • Default: true

<processParent>

Whether to process the parent section of the project. If not set will default to false.
  • Type: boolean
  • Since: 2.3
  • Required: No
  • User Property: processParent
  • Default: false

<properties>

Any restrictions that apply to specific properties.
  • Type: org.codehaus.mojo.versions.Property[]
  • Since: 1.0-alpha-3
  • Required: No

<rulesUri>

URI of a ruleSet file containing the rules that control how to compare version numbers. The URI could be either a Wagon URI or a classpath URI (e.g. classpath:///package/sub/package/rules.xml).
  • Type: java.lang.String
  • Since: 1.0-alpha-3
  • Required: No
  • User Property: maven.version.rules

<serverId>

settings.xml's server id for the URL. This is used when wagon needs extra authentication information.
  • Type: java.lang.String
  • Since: 1.0-alpha-3
  • Required: No
  • User Property: maven.version.rules.serverId
  • Default: serverId