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:
Hierbei steht args für eine durch Kommas getrennte Liste
mit Paaren aus je einem Schlüssel und einem Wert ('key'/Wert,
siehe unten):
- tag: Das CVS-Tag für die Entnahme.
- cvsRoot: Eine CVS-Verbindungszeichenfolge.
- path: Ein optionales CVS-Modul und ein Pfad, aus dem der
Ordner mit dem Element abgerufen werden soll. Der Elementname
wird standardmäßig als Modulname verwendet.
- prebuilt: Eine optionaler Boolescher Wert, der angibt, ob
das heruntergeladene Element vordefiniert ist. Der Standardwert lautet
'false'.
- cvsPassFile: Ein Optionspfad zu einer cvs-Kennwortdatei.
- password: Ein optionales Kennwort, mit dem eine Verbindung
zu CVS hergestellt wird.
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):
- unpack: Wenn Sie dies auf 'true' setzen, geben Sie an, dass
das heruntergeladene Element dekomprimiert werden soll.
- verbose: Wenn Sie dies auf 'true' setzen, zeigen Sie
während des Herunterladens ausführliche Fortschrittsinformationen an. Der Standardwert lautet "false".
- ignoreerrors: Wenn Sie dies auf 'true' setzen, werden beim
Transport Fehler protokolliert. Der Standardwert lautet "false".
- usetimestamp: Wenn dies auf 'true' gesetzt ist, wird eine
Datei auf der Basis eine Zeitmarke der lokalen Kopie (nur für HTTP-URLs)
unter dieser Bedingung heruntergeladen. Der Standardwert lautet "false".
- username: Der Benutzername für die HTTP-Authentifizierung
"BASIC".
- password: Das Kennwort zur Ausführung des Herunterladens.
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
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>
- id: Kennung (ID) der installierbaren Einheit (IU).
- version: Version der installierbaren Einheit (optional). Wird kein Wert angegeben, wird die höchste Version, die verfügbar ist, abgerufen.
- repository: Position (URI) des Repositorys, in dem sich die installierbare Einheit befindet.
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:
- Stellen Sie sicher, dass sich in Ihrem Systemsuchpfad die Datei 'cvs.exe' befindet.
(Laden Sie das CVS von hier herunter.)
- Erstellen Sie einen Ordner mit der Bezeichnung 'maps' im Buildverzeichnis.
- Erstellen Sie eine Datei mit der Erweiterung '.map' im Ordner 'maps'.
- Füllen Sie diese Zuordnungsdatei mit allen Elementen, die aus einem Repository abgerufen werden müssen.
- Bearbeiten Sie die Datei 'build.properties' aus dem Konfigurationsordner, und entfernen Sie die Kommentarzeichen aus der Zeile skipFetch=true. Wenn diese Eigenschaft eingestellt ist, überspringt PDE Build die gesamte Abrufphase. Wenn das in den Zuordnungsdateien angegebene Tag ignoriert werden soll, können Sie für die Eigenschaft fetchTag eine bestimmten Wert einstellen. Dies ist sinnvoll, wenn ein Build allabendlich von HEAD anstatt von den mit Tags versehenen Versionen erfolgt.
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:
- skipMaps: Entfernen Sie die Kommentarzeichen für diese Eigenschaft. Wenn diese Eigenschaft eingestellt ist, ruft PDE Build keine Zuordnungsdateien ab.
- mapsRepo = :pserver:anonymous@example.com/path/to/repo. Das CVS-Repository, aus dem die Zuordnungsdateien abgerufen werden sollen.
- mapsRoot = /path/to/maps. Der Pfad im CVS-Repository zu dem Verzeichnis, in dem die Zuordnungsdateien enthalten sind.
- mapsCheckoutTag = HEAD. Das CVS-Tag, das zum Entnehmen der Zuordnungsdateien verwendet werden soll.
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.