Difference between revisions of "Equinox/p2/Ant Tasks"

From Eclipsepedia

< Equinox‎ | p2
Jump to: navigation, search
(Modifying the Children of a Composite Repository)
(Creating a Composite Repository)
Line 83: Line 83:
  
 
==Creating a Composite Repository==
 
==Creating a Composite Repository==
The create composite repository tasks can be used to create an artifact or a metadata composite repository.  The composite repository can use an existing repository as an example and match its properties using the format attribute.
+
The create composite repository tasks can be used to create an artifact or a metadata composite repository.  An existing repository can be used as an example and the new repository will match the properties of the example.
<source lang=xml>
+
<p2.composite.artifact.repository.create compressed="true" name="My new Repo" location="file:///myNewRepo"  />
+
<p2.composite.metadata.repository.create compressed="false" name="My new Repo" location="file:///myNewRepo" />
+
</source>
+
  
Or alternatively multiple repositories can be created at once.
 
 
<source lang=xml>
 
<source lang=xml>
 
<p2.composite.repository.create>
 
<p2.composite.repository.create>

Revision as of 19:35, 6 March 2009

Contents

General Format

Repositories

The input format used by repositories in p2 Ant tasks:

<repository location="file:///Users/Pascal/Downloads/builds/transfer/files/updates/3.5-I-builds/I20090203-1200" append="true" compressed="true" 
	format="file:///Users/Pascal/Downloads/builds/transfer/files/updates/3.5-I-builds/I20090203-1200" kind="metadata" name="" remove="false" />

In general the location is always required, other attributes may not be used by individual tasks.

Attribute Type Default Description
location URI null The location of the repository
append boolean true Determines if the task should append to an existing repository or empty it first
compressed boolean true Determines if the repository should be compressed
format URI null Location of a repository to copy format from
kind "metadata" or "artifact" Both Specifies the type of the repository. Default is to add both a metadata and artifact repository
name String null The name of the repository
remove boolean false Defines if the repository be removed

Mirror Task

<p2.mirror source="file:///Users/Pascal/Downloads/builds/transfer/files/updates/3.5-I-builds/I20090203-1200">
   <repository kind="metadata" location="file:///Users/Pascal/tmp/mirrorTest9" name="RCP Repo" 
      format="file:///Users/Pascal/Downloads/builds/transfer/files/updates/3.5-I-builds/I20090211-0900"/>
   <repository kind="artifact" location="file:///Users/Pascal/tmp/mirrorTest9" name="RCP Repo" 
      format="file:///Users/Pascal/Downloads/builds/transfer/files/updates/3.5-I-builds/I20090211-0900"/>
   < source>
      <repository kind="artifact" location="file:///Users/"/>
      <fileset/>
   < /source>
   <iu id="org.eclipse.rcp.feature.group" version="3.5.0.v20090202-9RA1FwwFr-TNqU7GSg_iVTQ"/>
</p2.mirror>

Note: No space should precede source it is present due to a technical limitation in the wiki software

Validate Task

This task is used to validate an artifact repository using a comparator (the examples are using an md5 comparator.) A single use example:

<p2.composite.artifact.repository.validate comparatorID="org.eclipse.equinox.artifact.md5.comparator" location="file:///myfile"/>

An example task to validate multiple repositories using the same comparator:

<p2.composite.artifact.repository.validate comparatorID="org.eclipse.equinox.artifact.md5.comparator">
	<repository location="file:///myRepo"/>
	<repository location="file:///myRepo"/>
</p2.composite.artifact.repository.validate>

Creating a Composite Repository

The create composite repository tasks can be used to create an artifact or a metadata composite repository. An existing repository can be used as an example and the new repository will match the properties of the example.

<p2.composite.repository.create>
	<repository kind="metadata" compressed="true" location="file:///myNewRepo1" format="file:///anExampleRepo" name="My New Metadata Repo" />
	<repository kind="artifact" compressed="true" location="file:///myNewRepo2" format="file:///anExampleRepo" name="My New Artifact Repo" />
	<add>
		<repository location="http://eclipse.org/childRepo1"/>
		<repository location="http://eclipse.org/childRepo2"/>
	</add>
</p2.composite.repository.create>

Modifying the Children of a Composite Repository

It's also possible to add, or to remove children from a repository with an ant task.

<p2.composite.repository.children>
   <repository kind="metadata" location="file:///Users/Pascal/tmp/mirrorTest9"/>
   <repository kind="artifact" location="file:///Users/Pascal/tmp/mirrorTest9"/>
   <add>
      <repository kind="metadata" location="file:///childRepo"/>
   </add>
   <remove>
      <repository kind="artifact" location="file:///childRepo2"/>
    </remove>
</p2.composite.repository.children>

If the append attribute of the destination is set to false then existing children are removed before other operations are performed:

<p2.composite.repository.children>
	<destination kind="metadata" location="file:///Users/Pascal/tmp/mirrorTest9" append="False"/>
	<addChild kind="metadata" location="file:///childRepo"/>
</p2.composite.repository.children>