tycho-p2-director:archive-products

Full name:

org.eclipse.tycho:tycho-p2-director-plugin:4.0.10:archive-products

Description:

Creates archives with the product installations.

Attributes:

Requires a Maven project to be executed.
The goal is thread-safe and supports parallel builds.
Binds by default to the lifecycle phase: package.

Optional Parameters

Name	Type	Since	Description
`<forkedProcessTimeoutInSeconds>`	`int`	`-`	Kill the forked process after a certain number of seconds. If set to 0, wait forever for the process, never timing out. Default: `0` User Property: `p2.timeout`
`<formats>`	`Map<String,String>`	`-`	Maps os to format. By default a zip file will be created for windows, and tar.gz for linux/mac. For example, the following configuration will create zip product archives for Linux `<formats> <linux>zip</linux> </formats>` Supported formats "zip" "tar.gz" "tgz" "bzip2" "gzip" "snappy" "snappy" "xz"
`<parallel>`	`boolean`	`-`	Controls if products are allowed to be build in parallel
`<products>`	`List<Product>`	`-`	Selection of products to be installed and configuration per product. If the project contains more than one product file, you need to choose for which ones you want to create distribution archives. If you choose to install more than one product, you need to specify the `attachId` (which becomes a part of the classifier) to make the classifiers unique. Example: <plugin> <groupId>org.eclipse.tycho</groupId> <artifactId>tycho-p2-director-plugin</artifactId> <version>${tycho-version}</version> <executions> <execution> <id>create-distributions</id> <goals> <goal>materialize-products</goal> <goal>archive-products</goal> </goals> </execution> </executions> <configuration> <products> <product> <!-- select product with ID product.id; the archives get the classifiers "<os>.<ws>.<arch>" --> <id>product.id</id> </product> <product> <!-- select product with ID other.product.id for the classifiers "other-<os>.<ws>.<arch>" --> <id>other.product.id</id> <attachId>other</attachId> </product> </products> </configuration> </plugin> The following snippet shows the optional parameters which can be specified per product: <configuration> <products> <product> <id>product.id</id> <!-- optional parameters --> <rootFolder></rootFolder> <rootFolders> <macosx></macosx> <linux></linux> <freebsd></freebsd> <win32></win32> </rootFolders> </product> ... </products> </configuration> Details on the product-specific configuration parameters: `rootFolder` - The path where the installed product shall be stored in the archive, e.g. "eclipse". By default, the product is stored in the archive root. `rootFolders` - OS-specific installation root folders, overriding `rootFolder`. Allowed children are `<macosx>`, `<win32>`, `<linux>` and `<freebsd>` or any other OS supported by p2. Since 0.18.0
`<storeCreationTime>`	`boolean`	`-`	Controls if for `.tar.gz` archives the creation-time is stored as `LIBARCHIVE.creationtime` attribute in each entry. Currently `GNU tar` does not support that attributes and emits warnings about the `unknown extended header keyword 'LIBARCHIVE.creationtime'` when extracting such archive. Default: `true`

Parameter Details

<forkedProcessTimeoutInSeconds>

Kill the forked process after a certain number of seconds. If set to 0, wait forever for the process, never timing out.

Type: int
Required: No
User Property: p2.timeout
Default: 0

<formats>

Maps os to format. By default a zip file will be created for windows, and tar.gz for linux/mac. For example, the following configuration will create zip product archives for Linux

<formats>
  <linux>zip</linux>
</formats>

Supported formats

"zip"
"tar.gz"
"tgz"
"bzip2"
"gzip"
"snappy"
"snappy"
"xz"

Type: java.util.Map<java.lang.String, java.lang.String>
Required: No

<parallel>

Controls if products are allowed to be build in parallel

Type: boolean
Required: No

<products>

Selection of products to be installed and configuration per product.

If the project contains more than one product file, you need to choose for which ones you want to create distribution archives. If you choose to install more than one product, you need to specify the attachId (which becomes a part of the classifier) to make the classifiers unique. Example:

<plugin>
  <groupId>org.eclipse.tycho</groupId>
  <artifactId>tycho-p2-director-plugin</artifactId>
  <version>${tycho-version}</version>
  <executions>
    <execution>
      <id>create-distributions</id>
      <goals>
        <goal>materialize-products</goal>
        <goal>archive-products</goal>
      </goals>
    </execution>
  </executions>
  <configuration>
    <products>
      <product>
        <!-- select product with ID product.id; the archives get the classifiers "<os>.<ws>.<arch>" -->
        <id>product.id</id>
      </product>
      <product>
        <!-- select product with ID other.product.id for the classifiers "other-<os>.<ws>.<arch>" -->
        <id>other.product.id</id>
        <attachId>other</attachId>
      </product>
    </products>
  </configuration>
</plugin>

The following snippet shows the optional parameters which can be specified per product:

  <configuration>
    <products>
      <product>
        <id>product.id</id>
        <!-- optional parameters -->
        <rootFolder></rootFolder>
        <rootFolders>
          <macosx></macosx>
          <linux></linux>
          <freebsd></freebsd>
          <win32></win32>
        </rootFolders>
      </product>
      ...
    </products>
  </configuration>

Details on the product-specific configuration parameters:

rootFolder - The path where the installed product shall be stored in the archive, e.g. "eclipse". By default, the product is stored in the archive root.
rootFolders - OS-specific installation root folders, overriding rootFolder. Allowed children are <macosx>, <win32>, <linux> and <freebsd> or any other OS supported by p2. Since 0.18.0

Type: java.util.List<org.eclipse.tycho.plugins.p2.director.Product>
Required: No

<storeCreationTime>

Controls if for .tar.gz archives the creation-time is stored as LIBARCHIVE.creationtime attribute in each entry. Currently GNU tar does not support that attributes and emits warnings about the unknown extended header keyword 'LIBARCHIVE.creationtime' when extracting such archive.

Type: boolean
Required: No
Default: true