tycho-packaging:build-qualifier

Full name:

org.eclipse.tycho:tycho-packaging-plugin:0.17.0:build-qualifier

Description:

This mojo generates build qualifier according to the rules outlined in http://help.eclipse.org/ganymede/topic/org.eclipse.pde.doc.user/tasks/pde_version_qualifiers.htm
  1. explicit -DforceContextQualifier command line parameter
  2. forceContextQualifier from ${project.baseDir}/build.properties
  3. a time stamp in the form YYYYMMDDHHMM (ie 200605121600)

The generated qualifier is assigned to buildQualifier project property. Unqualified project version is assigned to unqualifiedVersion project property. Unqualified version is calculated based on ${project.version} and can be used for any Tycho project (eclipse-update-site, eclipse-application, etc) and regular maven project. Different projects can use different formats to expand the timestamp, however (highly not recommended but possible).

Starting with version 0.16, it is now possible to use custom build timestamp generation logic. The primary usecase is to generate build version qualifier based on the timestamp of the last project commit. Here is example pom.xml snippet that enables custom timestamp generation logic

     ...
     <plugin>
        <groupId>org.eclipse.tycho</groupId>
        <artifactId>tycho-packaging-plugin</artifactId>
        <version>${tycho-version}</version>
        <dependencies>
          <dependency>
            <groupId>timestamp-provider-groupid</groupId>
            <artifactId>timestamp-provider-artifactid</artifactId>
            <version>timestamp-provider-version</version>
          </dependency>
        </dependencies>
        <configuration>
          <timestampProvider>custom</timestampProvider>
        </configuration>
     </plugin>
     ...

Attributes:

  • Requires a Maven project to be executed.
  • Binds by default to the lifecycle phase: validate.

Optional Parameters

Name Type Since Description
baseDir File - (no description)
Default value is: ${project.basedir}.
execution MojoExecution - (no description)
forceContextQualifier String - (no description)
format SimpleDateFormat - Specify a date format as specified by java.text.SimpleDateFormat. Timezone used is UTC.
Default value is: yyyyMMddHHmm.
timestampProvider String - Role hint of a custom build timestamp provider.

Parameter Details

baseDir:

(no description)
  • Type: java.io.File
  • Required: No
  • Default: ${project.basedir}

execution:

(no description)
  • Type: org.apache.maven.plugin.MojoExecution
  • Required: No
  • Expression: ${mojoExecution}

forceContextQualifier:

(no description)
  • Type: java.lang.String
  • Required: No
  • Expression: ${forceContextQualifier}

format:

Specify a date format as specified by java.text.SimpleDateFormat. Timezone used is UTC.
  • Type: java.text.SimpleDateFormat
  • Required: No
  • Default: yyyyMMddHHmm

timestampProvider:

Role hint of a custom build timestamp provider.
  • Type: java.lang.String
  • Required: No