tycho-p2-extras:mirror

Full name:

org.eclipse.tycho.extras:tycho-p2-extras-plugin:5.0.0-SNAPSHOT: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 thread-safe and supports 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: true
<compress> boolean - Whether to compress the destination repository metadata files (artifacts.xml, content.xml).
Default: 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: true
<destination> File - The destination directory to mirror to.
Default: ${project.build.directory}/repository
<filter> Map<String,String> - 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: 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: 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: false
<includeFeatures> boolean - Whether or not to include features.
Default: true
<includeNonGreedy> boolean - Whether or not to follow non-greedy requirements.
Default: true
<includeOptional> boolean - Whether or not to follow optional requirements.
Default: true
<ius> List<Iu> - (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: 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: false
<mirrorMetadataOnly> boolean - Whether to mirror metadata only (no artifacts).
Default: false
<name> String - The target repository name.
<source> List<Repository> - Source repositori(es) to mirror from. See also targetPlatformAsSource and currentModuleAsSource
<targetPlatformAsSource> boolean 1.1.0

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


Default: false
<xzCompress> boolean 0.25.0

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


Default: 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<java.lang.String, java.lang.String>
  • 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<org.eclipse.tycho.plugins.p2.extras.Iu>
  • 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. See also targetPlatformAsSource and currentModuleAsSource
  • Type: java.util.List<org.eclipse.tycho.plugins.p2.extras.Repository>
  • 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