Fork me on GitHub

slingfeature:update-feature-versions

Full name:

org.apache.sling:slingfeature-maven-plugin:1.9.2:update-feature-versions

Description:

Update the bundles/artifact versions

Attributes:

  • Requires a Maven project to be executed.
  • The goal is thread-safe and supports parallel builds.

Required Parameters

Name Type Since Description
<features> File - Directory containing feature files
Default: src/main/features
<testFeatures> File - Directory containing test feature files.
Default: src/test/features

Optional Parameters

Name Type Since Description
<classifiers> String - A comma separated list of classifiers to select the feature files. Use ':' to select the main artifact (no classifier).
User Property: classifiers
<defaultMetadata> Map<...> - This parameter is only declared to make Maven happy, it is evaluated in the Preprossor
<dryRun> boolean - If set to true, no changes are performed
Default: false
User Property: dryRun
<enableLegacyVariableReplacement> boolean 1.3.6 Enable old variable replacement in feature model based on the full maven project including system variables. If this is enabled, enableProjectVariableReplacement and replacePropertyVariables have no effect.
Default: false
<enableProjectVariableReplacement> boolean 1.3.6 Enable the replacement of variables when reading a feature model. The supported variables are "project.groupId", "project.artifactId", "project.version" and "project.osgiVersion".
Default: true
<featuresExcludes> String - Comma separated list of excludes for the feature files. Feature files excluded by this configuration are not processed at all.
<featuresIncludes> String - Comma separated list of includes for the feature files in the configured directory. Only feature files specified by this include are processed.
Default: **/*.json
<generatedFeatures> File - Directory containing generated feature files
<generatedFeaturesExcludes> String - Comma separated list of excludes for the generated feature files. Feature files excluded by this configuration are not processed at all.
<generatedFeaturesIncludes> String - Comma separated list of includes for the generated feature files in the configured directory. Only feature files specified by this include are processed.
Default: **/*.json
<jarStartOrder> int - The start level for the attached jar/bundle.
<replacePropertyVariables> String 1.3.6 A comma separated list of variables which are replaced when a feature model is read. The value of these variables is fetched from the project properties.
<skipAddFeatureDependencies> boolean - If set to true the artifacts from the feature are not added as dependencies with scope=provided to the project.
Default: false
<skipAddJarToFeature> boolean - If set to true the main jar artifact is not added to the feature.
Default: false
<skipAddJarToTestFeature> boolean - If set to true the main jar artifact is not added to the test feature.
Default: false
<skipAddTestFeatureDependencies> boolean - If set to true the artifacts from the test feature are not added as dependencies with scope=test to the project.
Default: true
<testFeaturesExcludes> String - Comma separated list of excludes for the test features.
<testFeaturesIncludes> String - Comma separated list of includes for the test features.
Default: **/*.json
<updatesExcludesList> String - A comma separated list of artifact patterns to exclude. Follows the pattern "groupId:artifactId:type:classifier:version". Designed to allow specifying the set of excludes from the command line.
User Property: excludes
<updatesIncludesList> String - A comma separated list of artifact patterns to include. Follows the pattern "groupId:artifactId:type:classifier:version". Designed to allow specifying the set of includes from the command line.
User Property: includes
<validateFeatures> boolean - If set to true the features are validated against the JSON schema.
Default: true
<versionScope> String - The scope to use to find the highest version, use ANY, MAJOR, MINOR, INCREMENTAL, or SUBINCREMENTAL
User Property: versionScope

Parameter Details

<classifiers>

A comma separated list of classifiers to select the feature files. Use ':' to select the main artifact (no classifier).
  • Type: java.lang.String
  • Required: No
  • User Property: classifiers

<defaultMetadata>

This parameter is only declared to make Maven happy, it is evaluated in the Preprossor
  • Type: java.util.Map<java.lang.String, java.util.Map<java.lang.String, java.lang.String>>
  • Required: No

<dryRun>

If set to true, no changes are performed
  • Type: boolean
  • Required: No
  • User Property: dryRun
  • Default: false

<enableLegacyVariableReplacement>

Enable old variable replacement in feature model based on the full maven project including system variables. If this is enabled, enableProjectVariableReplacement and replacePropertyVariables have no effect.
  • Type: boolean
  • Since: 1.3.6
  • Required: No
  • Default: false

<enableProjectVariableReplacement>

Enable the replacement of variables when reading a feature model. The supported variables are "project.groupId", "project.artifactId", "project.version" and "project.osgiVersion".
  • Type: boolean
  • Since: 1.3.6
  • Required: No
  • Default: true

<features>

Directory containing feature files
  • Type: java.io.File
  • Required: Yes
  • Default: src/main/features

<featuresExcludes>

Comma separated list of excludes for the feature files. Feature files excluded by this configuration are not processed at all.
  • Type: java.lang.String
  • Required: No

<featuresIncludes>

Comma separated list of includes for the feature files in the configured directory. Only feature files specified by this include are processed.
  • Type: java.lang.String
  • Required: No
  • Default: **/*.json

<generatedFeatures>

Directory containing generated feature files
  • Type: java.io.File
  • Required: No

<generatedFeaturesExcludes>

Comma separated list of excludes for the generated feature files. Feature files excluded by this configuration are not processed at all.
  • Type: java.lang.String
  • Required: No

<generatedFeaturesIncludes>

Comma separated list of includes for the generated feature files in the configured directory. Only feature files specified by this include are processed.
  • Type: java.lang.String
  • Required: No
  • Default: **/*.json

<jarStartOrder>

The start level for the attached jar/bundle.
  • Type: int
  • Required: No

<replacePropertyVariables>

A comma separated list of variables which are replaced when a feature model is read. The value of these variables is fetched from the project properties.
  • Type: java.lang.String
  • Since: 1.3.6
  • Required: No

<skipAddFeatureDependencies>

If set to true the artifacts from the feature are not added as dependencies with scope=provided to the project.
  • Type: boolean
  • Required: No
  • Default: false

<skipAddJarToFeature>

If set to true the main jar artifact is not added to the feature.
  • Type: boolean
  • Required: No
  • Default: false

<skipAddJarToTestFeature>

If set to true the main jar artifact is not added to the test feature.
  • Type: boolean
  • Required: No
  • Default: false

<skipAddTestFeatureDependencies>

If set to true the artifacts from the test feature are not added as dependencies with scope=test to the project.
  • Type: boolean
  • Required: No
  • Default: true

<testFeatures>

Directory containing test feature files.
  • Type: java.io.File
  • Required: Yes
  • Default: src/test/features

<testFeaturesExcludes>

Comma separated list of excludes for the test features.
  • Type: java.lang.String
  • Required: No

<testFeaturesIncludes>

Comma separated list of includes for the test features.
  • Type: java.lang.String
  • Required: No
  • Default: **/*.json

<updatesExcludesList>

A comma separated list of artifact patterns to exclude. Follows the pattern "groupId:artifactId:type:classifier:version". Designed to allow specifying the set of excludes from the command line.
  • Type: java.lang.String
  • Required: No
  • User Property: excludes

<updatesIncludesList>

A comma separated list of artifact patterns to include. Follows the pattern "groupId:artifactId:type:classifier:version". Designed to allow specifying the set of includes from the command line.
  • Type: java.lang.String
  • Required: No
  • User Property: includes

<validateFeatures>

If set to true the features are validated against the JSON schema.
  • Type: boolean
  • Required: No
  • Default: true

<versionScope>

The scope to use to find the highest version, use ANY, MAJOR, MINOR, INCREMENTAL, or SUBINCREMENTAL
  • Type: java.lang.String
  • Required: No
  • User Property: versionScope