Ophalen uit repository's

De infrastructuur van PDE Build biedt mogelijkheden voor het ophalen van broncode en vooraf gegenereerde plugins uit een repository als onderdeel van het buildproces (zie de taak eclipse.fetch en de eigenschappen voor besturing van het ophaalproces). Er zijn twee mogelijkheden: PDE Build de broncode automatisch laten ophalen of de broncode handmatig ophalen.

Eerste stap voor automatisering, het toewijzingsbestand

Gegeven het ID van de feature of plugin die moet worden gebouwd, is de build-infrastructuur in staat om alle opgenomen features en plugins op te halen uit een repository.

PDE gebruikt toewijzingsbestanden om vast te stellen waaruit zaken moeten worden opgehaald. Een toewijzingsbestand is een Java-eigenschappenbestand dat feature- en plugin-ID's aan een locatie en code toewijst in een repository. De indeling van toewijzingsbestanden is uitbreidbaar. Alleen het key-gedeelte is vastomlijnd in PDE Build:

<elementType>@<elementID>[,<elementVersion>] = <repo-specifieke content>

waarbij elementType een bundel, feature, plugin of fragment is en elementId en elementVersion de specifieke aanduiding vormen van het element.

Toewijzingsbestandsinvoer voor CVS

De indeling van een toewijzingsbestand om content uit CVS op te halen is als volgt:
<key> = CVS, [,args]
waarbij args een door komma's gescheiden lijst van key/value-paren is, zoals hieronder wordt beschreven: Voorbeeld:
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

Toewijzingsitems oude stijl
In Eclipse 3.2 en eerdere versies was de indeling van toewijzingsbestanden voor CVS:
<elementType>@<elementID> = CVS, <TAG>, <CVSROOT>[,<PASSWORD>[,<PATH>[,<CVSPASSFILE>]]]
Als optionele argumenten niet worden opgegeven, is het nog steeds vereist om de volgende argumenten te scheiden met komma's. Deze indeling wordt beschouwd als gedeprecieerd en de indeling sleutel/waarde wordt geprefereerd.

Toewijzingsbestandsinvoer voor Ant GET

De indeling van een toewijzingsbestand om content op te halen van een URL die wordt ondersteund door Ant GET is als volgt:

<key> = GET, <url> [,args]
waarbij url het URL-adres is waarvandaan de gegevens worden opgehaald en args een optionele door gescheiden lijst van key/value-paren, zoals hieronder wordt beschreven: Voorbeeld:
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

Toewijzingsbestandsinvoer voor een ophaalbewerking van p2

Er is een nieuwe extensie toegevoegd aan PDE/Build waarmee gebruikers artefacten op kunnen halen uit p2-repository's. U kunt nu een item toevoegen een uw toewijzingsbestand voor invoer van de build en PDE/Build haalt het artefact op en neemt deze op in de build. In de invoer voor het toewijzingsbestand moeten het ID en de versie van de installeerbare eenheid (IU) zijn opgenomen, alsmede de URI van de repository waar de IU kan worden gevonden. Er wordt aangenomen dat de metagegevens en artefactrepository's zijn samengevoegd.

De indeling van een toewijzingsbestand om content op te halen via p2 is als volgt:

<elementType>@<elementID> = p2IU, id=<id>, version=<versie>, repository=<repository>
Features ophalen met p2

In de Helios-release kunnen features met p2 worden opgehaald door de installeerbare eenheid op te geven die het JAR-bestand van de feature vertegenwoordigt. Zie de pagina metagegevens van feature voor meer informatie over de structuur van p2-metagegevens voor features.

Voorbeelden:
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

Toewijzingsbestandsinvoer voor andere repository's

PDE Build biedt een extensiepunt waar scriptgenerators voor ophaalbewerkingen voor verschillende repository's kunnen worden ingeplugd. Als uw Eclipse-installatie een bundel omvat met een scriptgenerator-extensie voor een ander type repository, kunt u die repository gebruiken door deze op te geven in uw toewijzingsbestandinvoer volgens de indeling die is aangegeven door de provider van de extensie.

Instellingen definiëren voor het ophalen van de bron uit CVS

Voor het definiëren van instellingen voor het ophalen van de bron uit CVS gaat u als volgt te werk:

De toewijzingsbestanden ophalen uit CVS

Toewijzingsbestanden worden doorgaans opgeslagen in een repository. PDE Build biedt een standaardinfrastructuur om deze toewijzingsbestanden op te halen uit een CVS-repository. Om deze functie in te schakelen, wijzigt u de volgende eigenschappen in het bestand build.properties van de configuratie in de configuratiedirectory: Het ophalen van de toewijzingsbestanden uit CVS vindt plaats tijden de pre-buildfase van de build.  Scripts voor het ophalen van alle features en plugins die zijn opgenomen in de feature die u bouwt, worden gegenereerd en uitgevoerd tijdens de ophaalfase van de build. 

Automatisch ophalen uit andere repository's

Als  u de toewijzingsbestanden automatisch uit de repository ophaalt, moet u het bestand customTarget.xml uit org.eclipse.pde.build/templates/headless-build naar uw configuratiedirectory kopiëren.  Het doel  getMapFiles wordt gebruikt om de toewijzingsbestanden op te halen. Dit moet worden gewijzigd als u uit de repository wilt ophalen.

Broncode handmatig ophalen

U kunt aangepaste ophaaldoelen schrijven om uw plugins en features op te halen. Deze kunnen worden aangeroepen vanuit de doelen preSetup of postSetup in het bestand customTargets.xml.  Features en plugins moeten worden opgehaald naar respectievelijk ${buildDirectory}/features en ${buildDirectory}/plugins.