Fork me on GitHub
Built by Maven

tycho-p2-repository:modify-composite-repository

Full name:

org.eclipse.tycho:tycho-p2-repository-plugin:6.0.0-SNAPSHOT:modify-composite-repository

Description:

Modifies the content or name of a composite P2-repository.

This can be used to create a new composite repository or to modify an already existing (remote) repository. The resulting repository metadata files (compositeArtifacts.xml/jar or compositeContent.xml/jar) are always written to a local directory. For a remote repository, a suitable other tool (such as SSH) must be used to copy these files subsequently back to the remote server.

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
<childCountLimit> int - The maximum number of children to keep in the composite repository.
If this limit is exceeded (after adding children) a corresponding count is removed from the beginning of the list of children. A value of zero or less, is considered as no-limit.
Default: 0
User Property: p2.composite.children.limit
<childrenToAdd> List<URI> - The children to append to the composite repository.
User Property: p2.composite.children.add
<childrenToRemove> List<URI> - The children to remove from the composite repository.
User Property: p2.composite.children.remove
<compress> boolean - Compress the repository index files content.xml and artifacts.xml.
Default: true
User Property: p2.repository.compress
<outputLocation> Path - Optional output location where the modified metadata files (artifact.xml/jar/xml.xz or content.xml/jar/xml.xz) are written to.
If not specified or equals to repository the source repository is modified in-place.
User Property: p2.repository.output
<repository> Repository - Location of the source repository to modify.
May be the Path of a local file or URL/URI to a remote repository.
If this is set to a remote URL the outputLocation must be set to a local path as remote locations cannot be written.
<repositoryKind> P2RepositoryKind - The kind of modified repository: Either artifact, metadata.
If artifact is specified, only the artifact.xml/jar/xml.xz files are modified, if metadata only content.xml/jar/xml.xz. By default (if blank) both are modified.
User Property: p2.repository.kind
<repositoryName> String - Optional repository name to set. An existing name is overwritten.
User Property: p2.repository.name
<validateChildren> boolean - Validate the existence of the repository and all added children.
Default: true
User Property: p2.composite.validate

Parameter Details

<childCountLimit>

The maximum number of children to keep in the composite repository.
If this limit is exceeded (after adding children) a corresponding count is removed from the beginning of the list of children. A value of zero or less, is considered as no-limit.
  • Type: int
  • Required: No
  • User Property: p2.composite.children.limit
  • Default: 0

<childrenToAdd>

The children to append to the composite repository.
  • Type: java.util.List<java.net.URI>
  • Required: No
  • User Property: p2.composite.children.add

<childrenToRemove>

The children to remove from the composite repository.
  • Type: java.util.List<java.net.URI>
  • Required: No
  • User Property: p2.composite.children.remove

<compress>

Compress the repository index files content.xml and artifacts.xml.
  • Type: boolean
  • Required: No
  • User Property: p2.repository.compress
  • Default: true

<outputLocation>

Optional output location where the modified metadata files (artifact.xml/jar/xml.xz or content.xml/jar/xml.xz) are written to.
If not specified or equals to repository the source repository is modified in-place.
  • Type: java.nio.file.Path
  • Required: No
  • User Property: p2.repository.output

<repository>

Location of the source repository to modify.
May be the Path of a local file or URL/URI to a remote repository.
If this is set to a remote URL the outputLocation must be set to a local path as remote locations cannot be written.
  • Type: org.apache.maven.model.Repository
  • Required: No

<repositoryKind>

The kind of modified repository: Either artifact, metadata.
If artifact is specified, only the artifact.xml/jar/xml.xz files are modified, if metadata only content.xml/jar/xml.xz. By default (if blank) both are modified.
  • Type: org.eclipse.tycho.p2maven.repository.P2RepositoryKind
  • Required: No
  • User Property: p2.repository.kind

<repositoryName>

Optional repository name to set. An existing name is overwritten.
  • Type: java.lang.String
  • Required: No
  • User Property: p2.repository.name

<validateChildren>

Validate the existence of the repository and all added children.
  • Type: boolean
  • Required: No
  • User Property: p2.composite.validate
  • Default: true