tycho-p2-director:materialize-products

Full name:

org.eclipse.tycho:tycho-p2-director-plugin:3.0.1:materialize-products

Description:

Creates product installations for the products defined in the project.

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
<directorRuntime> DirectorMojo$DirectorRuntimeType - Runtime in which the director application is executed. Can be:
  • internal - to use the director application from Tycho's embedded OSGi runtime (default)
  • standalone - to create and use a stand-alone installation of the director application. This option is needed if the product to be installed includes artifacts with meta-requirements (e.g. to a non-standard touchpoint action). Requires that the source parameter is set to repository.

Default value is: internal.
<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 value is: 0.
User property is: p2.timeout.
<installFeatures> boolean - Include the feature JARs in installation. (Technically, this sets the property org.eclipse.update.install.features to true in the p2 profile.)
Default value is: true.
<products> List -

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

<profile> String - The name of the p2 profile to be created.
Default value is: DefaultProfile.
<profileNames> List - (no description)
<profileProperties> Map - Additional profile properties to set when materializing the product
<source> DirectorMojo$InstallationSource - Source repositories to be used in the director calls. Can be:
  • targetPlatform - to use the target platform as source (default)
  • repository - to use the p2 repository in target/repository/ as source. With this option, the build implicitly verifies that it would also be possible to install the product from that repository with an external director application.

Default value is: targetPlatform.

Parameter Details

<directorRuntime>

Runtime in which the director application is executed. Can be:
  • internal - to use the director application from Tycho's embedded OSGi runtime (default)
  • standalone - to create and use a stand-alone installation of the director application. This option is needed if the product to be installed includes artifacts with meta-requirements (e.g. to a non-standard touchpoint action). Requires that the source parameter is set to repository.
  • Type: org.eclipse.tycho.plugins.p2.director.DirectorMojo$DirectorRuntimeType
  • Required: No
  • Default: internal

<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

<installFeatures>

Include the feature JARs in installation. (Technically, this sets the property org.eclipse.update.install.features to true in the p2 profile.)
  • Type: boolean
  • Required: No
  • Default: true

<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
  • Required: No

<profile>

The name of the p2 profile to be created.
  • Type: java.lang.String
  • Required: No
  • Default: DefaultProfile

<profileNames>

(no description)
  • Type: java.util.List
  • Required: No

<profileProperties>

Additional profile properties to set when materializing the product
  • Type: java.util.Map
  • Required: No

<source>

Source repositories to be used in the director calls. Can be:
  • targetPlatform - to use the target platform as source (default)
  • repository - to use the p2 repository in target/repository/ as source. With this option, the build implicitly verifies that it would also be possible to install the product from that repository with an external director application.
  • Type: org.eclipse.tycho.plugins.p2.director.DirectorMojo$InstallationSource
  • Required: No
  • Default: targetPlatform