tycho-p2-extras:mirror

Full name:

org.eclipse.tycho.extras:tycho-p2-extras-plugin:3.0.1:mirror

Description:

Maven plugin front-end for org.eclipse.equinox.p2.internal.repository.tools.MirrorApplication. Intended as a replacement for the p2.mirror ant task.

Attributes:

  • Requires a Maven project to be executed.
  • The goal is not marked as thread-safe and thus does not support parallel builds.

Optional Parameters

Name Type Since Description
<append> boolean - Whether to append to an existing destination repository. Note that appending an IU which already exists in the destination repository will cause the mirror operation to fail.
Default value is: true.
<compress> boolean - Whether to compress the destination repository metadata files (artifacts.xml, content.xml).
Default value is: true.
<currentModuleAsSource> boolean 1.1.0

Whether the current build p2 output should be added as source. Ignored for non-Tycho packaging types. Ignored if targetPlatformAsSource == false;


Default value is: true.
<destination> File - The destination directory to mirror to.
Default value is: ${project.build.directory}/repository.
<filter> Map - Filter properties. In particular, a platform filter can be specified by using keys osgi.os, osgi.ws, osgi.arch.
<followOnlyFilteredRequirements> boolean - Follow only requirements which match the filter specified.
Default value is: false.
<followStrictOnly> boolean - Set to true if only strict dependencies should be followed. A strict dependency is defined by a version range only including exactly one version (e.g. [1.0.0.v2009, 1.0.0.v2009]). In particular, plugins/features included in a feature are normally required via a strict dependency from the feature to the included plugin/feature.
Default value is: false.
<ignoreErrors> boolean 1.1.0

If set to true, mirroring continues to run in the event of an error during the mirroring process and will just log an info message.


Default value is: false.
<includeFeatures> boolean - Whether or not to include features.
Default value is: true.
<includeNonGreedy> boolean - Whether or not to follow non-greedy requirements.
Default value is: true.
<includeOptional> boolean - Whether or not to follow optional requirements.
Default value is: true.
<ius> List - (Optional) Which IUs to mirror. If omitted, all IUs available in the source repositories will be mirrored. An IU must specify an id and may specify a version. If version is omitted, the latest available version will be queried. By default, IUs required by the specified IUs will also be mirrored. See also followStrictOnly, followOnlyFilteredRequirements , includeOptional, includeNonGreedy, includeFeatures.
<keepNonXzIndexFiles> boolean 0.25.0

If xzCompress is true, whether jar or xml index files should be kept in addition to XZ-compressed index files. This fallback provides backwards compatibility for pre-Mars p2 clients which cannot read XZ-compressed index files.


Default value is: true.
<latestVersionOnly> boolean - Set to true to filter the resulting set of IUs to only include the latest version of each Installable Unit only. By default, all versions satisfying dependencies are included.
Default value is: false.
<mirrorMetadataOnly> boolean - Whether to mirror metadata only (no artifacts).
Default value is: false.
<name> String - The target repository name.
<source> List - Source repositori(es) to mirror from.
<targetPlatformAsSource> boolean 1.1.0

Whether to add the target-platform content as a source. Ignored for non-Tycho packaging types.


Default value is: false.
<xzCompress> boolean 0.25.0

Add XZ-compressed repository index files. XZ offers better compression ratios esp. for highly redundant file content.


Default value is: true.

Parameter Details

<append>

Whether to append to an existing destination repository. Note that appending an IU which already exists in the destination repository will cause the mirror operation to fail.
  • Type: boolean
  • Required: No
  • Default: true

<compress>

Whether to compress the destination repository metadata files (artifacts.xml, content.xml).
  • Type: boolean
  • Required: No
  • Default: true

<currentModuleAsSource>

Whether the current build p2 output should be added as source. Ignored for non-Tycho packaging types. Ignored if targetPlatformAsSource == false;

  • Type: boolean
  • Since: 1.1.0
  • Required: No
  • Default: true

<destination>

The destination directory to mirror to.
  • Type: java.io.File
  • Required: No
  • Default: ${project.build.directory}/repository

<filter>

Filter properties. In particular, a platform filter can be specified by using keys osgi.os, osgi.ws, osgi.arch.
  • Type: java.util.Map
  • Required: No

<followOnlyFilteredRequirements>

Follow only requirements which match the filter specified.
  • Type: boolean
  • Required: No
  • Default: false

<followStrictOnly>

Set to true if only strict dependencies should be followed. A strict dependency is defined by a version range only including exactly one version (e.g. [1.0.0.v2009, 1.0.0.v2009]). In particular, plugins/features included in a feature are normally required via a strict dependency from the feature to the included plugin/feature.
  • Type: boolean
  • Required: No
  • Default: false

<ignoreErrors>

If set to true, mirroring continues to run in the event of an error during the mirroring process and will just log an info message.

  • Type: boolean
  • Since: 1.1.0
  • Required: No
  • Default: false

<includeFeatures>

Whether or not to include features.
  • Type: boolean
  • Required: No
  • Default: true

<includeNonGreedy>

Whether or not to follow non-greedy requirements.
  • Type: boolean
  • Required: No
  • Default: true

<includeOptional>

Whether or not to follow optional requirements.
  • Type: boolean
  • Required: No
  • Default: true

<ius>

(Optional) Which IUs to mirror. If omitted, all IUs available in the source repositories will be mirrored. An IU must specify an id and may specify a version. If version is omitted, the latest available version will be queried. By default, IUs required by the specified IUs will also be mirrored. See also followStrictOnly, followOnlyFilteredRequirements , includeOptional, includeNonGreedy, includeFeatures.
  • Type: java.util.List
  • Required: No

<keepNonXzIndexFiles>

If xzCompress is true, whether jar or xml index files should be kept in addition to XZ-compressed index files. This fallback provides backwards compatibility for pre-Mars p2 clients which cannot read XZ-compressed index files.

  • Type: boolean
  • Since: 0.25.0
  • Required: No
  • Default: true

<latestVersionOnly>

Set to true to filter the resulting set of IUs to only include the latest version of each Installable Unit only. By default, all versions satisfying dependencies are included.
  • Type: boolean
  • Required: No
  • Default: false

<mirrorMetadataOnly>

Whether to mirror metadata only (no artifacts).
  • Type: boolean
  • Required: No
  • Default: false

<name>

The target repository name.
  • Type: java.lang.String
  • Required: No

<source>

Source repositori(es) to mirror from.
  • Type: java.util.List
  • Required: No

<targetPlatformAsSource>

Whether to add the target-platform content as a source. Ignored for non-Tycho packaging types.

  • Type: boolean
  • Since: 1.1.0
  • Required: No
  • Default: false

<xzCompress>

Add XZ-compressed repository index files. XZ offers better compression ratios esp. for highly redundant file content.

  • Type: boolean
  • Since: 0.25.0
  • Required: No
  • Default: true