Ophalen uit repository's

De infrastructuur die door PDE Build wordt geleverd, biedt als onderdeel van het bouwproces stappen om de te bouwen broncode op te halen uit een repository. Er zijn twee mogelijkheden: PDE Build de broncode automatisch laten ophalen of de broncode handmatig ophalen.

Automatisch broncode ophalen uit CVS

Met het ID van een feature die moet worden gebouwd, kan de buildinfrastructuur alle opgenomen features en plugins uit CVS ophalen.

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 een toewijzingsbestandinvoer voor het ophalen uit CVS is:

<elementType>@<elementID> = CVS, <TAG>, <CVSROOT>[,<PASSWORD>[,<PATH>[,<CVSPASSFILE>]]]

waar elementType een bundel, feature, plugin of fragment is.  Als het pad niet is opgegeven, wordt de elementnaam in plaats daarvan gebruikt als CVS-module, bijvoorbeeld: 

plugin@org.foo.bar=CVS,v20060501,:pserver:anonymous@cvs.example.org:/cvsroot/foo

zal de plugin org.foo.bar die is gelabeld met de code v20060501 ophalen uit cvs.eclipse.org/cvsroot/foo/org.foo.bar.

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

PDE Build biedt een extensiepunt waar scriptgenerators voor ophaalbewerkingen voor verschillende repository's kunnen worden ingeplugd.  Wanneer uw eclipse-installatie een bundel bevat die een scriptgeneratorextensie biedt voor een ander type repository, kunt u deze repository gebruiken door deze op te geven in uw toewijzingsbestandinvoer:  

<elementType>@<elementID> = <REPOSITORY>, <TAG>, [...] 

De indeling van de toewijzingsinvoer na TAG (code) is afhankelijk van de extensie.

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