Aus Repositorys abrufen

Die von PDE Build zur Verfügung gestellte Infrastruktur stellt Schritte zum Abruf des Quellcodes und der vordefinierten Plug-ins aus einem Repository als Bestandteil des Buildprozesses bereit (siehe Tasks eclipse.fetch und Eigenschaften für Abrufsteuerung). Zwei Möglichkeiten stehen zur Auswahl: Das automatische Abrufen der Quelle durch PDE Build oder das manuelle Abrufen des Quellcodes.

Erster Automatisierungsschritt - die Zuordnungsdatei

Anhand der Kennung eines Features oder Plug-ins, das gebuildet werden muss, kann die Buildinfrastruktur alle enthaltenen Features und Plug-ins aus dem Repository abrufen.

Mithilfe von Zuordnungsdateien ruft die PDE die Daten von den entsprechenden Positionen ab. Eine Zuordnungsdatei ist eine Java-Eigenschaftsdatei, die die IDs von Features und Plug-ins einer Position und einem Tag in einem Repository zuordnet. Das Format der Zuordnungsdateien ist offen, der Teil key ist jedoch durch PDE Build festgelegt:

<elementType>@<elementID>[,<elementVersion>] = <Spezifischer Inhalt für Repository>

Hierbei steht elementType für bundle, feature, plugin oder fragment und elementId sowie elementVersion geben die Spezifikationen des Elements an.

Zuordnungsdateieintrag für CVS

Das Format eines Zuordnungsdateieintrags für den Abruf von Inhalt aus CVS lautet wie folgt:
<key> = CVS, [,args]
Hierbei steht args für eine durch Kommas getrennte Liste mit Paaren aus je einem Schlüssel und einem Wert ('key'/Wert, siehe unten): Beispiel:
plugin@com.ibm.icu,3.6.1=CVS,tag=v200704191630,cvsRoot=:pserver:anonymous@dev.eclipse.org:/cvsroot/tools,path=org.eclipse.orbit/com.ibm.icu/bin,prebuilt=true

Zuordnungseinträge im alten Format
In Eclipse 3.2 und früher sah das Zuordnungsdateiformat für CVS wie folgt aus:
<elementType>@<elementID> = CVS, <TAG>, <CVSROOT>[,<PASSWORD>[,<PATH>[,<CVSPASSFILE>]]]
In dem Fall, dass einige optionale Argumente nicht festgelegt sind, sind trotzdem noch die Kommas erforderlich, um die folgenden Argumente abzutrennen. Dieses Format sollte als veraltet verstanden werden und es wird das Schlüssel/Wert-Format vorgezogen.

Zuordnungsdateieintrag für Ant GET

Das Format eines Zuordnungsdateieintrags für den Abruf von Inhalt von eine beliebigen URL, die von Ant GET unterstützt wird, lautet wie folgt:

<key> = GET, <url> [,args]
Hierbei steht url für die URL zum Abruf von Daten und args für eine optionale, durch Kommas getrennte Liste mit Paaren aus einem Schlüssel und einem Wert ('key'/Wert, siehe unten): Beispiel:
plugin@com.ibm.icu,3.4.5=GET,http://download.eclipse.org/tools/orbit/downloads/drops/S200705301823/bundles/com.ibm.icu_3.4.5.jar, unpack=true

Dateizuordnungseintrag für einen p2-Abruf

Es wurde eine neue Erweiterung zu PDE/Build hinzugefügt, die Benutzern das Abrufen von Artefakten aus p2-Repositorys ermöglicht. Sie können jetzt einen Eintrag zu Ihrer Zuordnungsdatei für die Buildeingabe hinzufügen und PDE/Build ruft das Artefakt ab und schließt es in den Build ein. Die Zuordnungsdatei muss die Kennung (ID) und die Version der installierbaren Einheit (IU, Installable Unit) sowie die URI des Repositorys enthalten, in dem sich die installierbare Einheit befindet. Dabei wird vorausgesetzt, dass sich die Repositorys für Metadaten und für Artefakte an derselben Position befinden.

Das Format eines Dateizuordnungseintrags zum Abrufen von Inhalten über p2 lautet wie folgt:

<elementtyp>@<elementID> = p2IU, id=<id>, version=<version>, repository=<repository>
Features mit P2 abrufen

Im Helios-Release können Features mit P2 abgerufen werden, indem die installierbare Einheit angegeben wird, die die JAR-Datei des Features darstellt. Die Seite mit Feature-Metadaten enthält nähere Angaben zur Struktur von P2-Metadaten für Features.

Beispiele:
plugin@my.bundle.id,1.0.0=p2IU,id=my.bundle.id,version=1.0.0,repository=http://example.eclipse.org/repo
feature@my.feature.id = p2IU,id=my.feature.id.feature.jar, version=1.0.0,repository=http://example.eclipse.org/repo

Zuordnungsdateieintrag für sonstige Repositorys

PDE Build verfügt über einen Erweiterungspunkt, an dem Generatoren zum Abrufen der Scripts für unterschiedliche Repositorys integriert werden können. Wenn die Eclipse-Installation ein Produktpaket enthält, das eine Scriptgeneratorerweiterung für eine andere Art von Repository bereitstellt, können Sie dieses Repository verwenden, indem Sie es in den Einträgen der Zuordnungsdatei angeben und das Format einhalten, das vom Erweiterungsprovider angegeben wird.

Abrufen der CVS-Quelle konfigurieren

Wenn Sie das Abrufen der Quelle aus dem CVS konfigurieren möchten, gehen Sie wie folgt vor:

Zuordnungsdateien vom CVS abrufen

Zuordnungsdateien werden in der Regel in einem Repository gespeichert. PDE Build stellt zum Abrufen dieser Zuordnungsdateien aus einem CVS-Repository eine Standardinfrastruktur bereit. Wenn Sie diese Funktion aktivieren möchten, ändern Sie die folgenden Eigenschaften in der Datei 'build.properties' Ihrer Konfiguration im Konfigurationsverzeichnis: Das Abrufen der Zuordnungsdateien erfolgt vor dem Erstellen des Builds.  Scripts zum Abrufen aller Features und Plug-ins, die in dem Feature enthalten sind, das Sie builden, werden generiert und während der Abrufphase des Builds ausgeführt. 

Automatisch aus anderen Repositorys abrufen

Wenn  Sie die Zuordnungsdateien automatisch aus dem Repository abrufen, müssen Sie die Datei 'customTarget.xml' aus 'org.eclipse.pde.build/templates/headless-build' in das Konfigurationsverzeichnis kopieren.  Das Ziel  'getMapFiles' wird zum Abrufen der Zuordnungsdateien verwendet; es muss zum Abrufen aus dem Repository geändert werden.

Quellcode manuell abrufen

Sie können angepasste Abrufziele schreiben, um Plug-ins und Features abzurufen, die von 'preSetup'- oder 'postSetup'-Zielen in der Datei 'customTargets.xml' aufgerufen werden können.  Die Features und Plug-ins müssen in die Unterverzeichnisse ${buildDirectory}/features und ${buildDirectory}/plugins abgerufen werden.