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:
- Zorg dat er een cvs.exe aanwezig is in het zoekpad van uw systeem.
(Download CVS van ).
- Maak een map met de naam "maps" in de builddirectory.
- Maak een bestand met de extensie .map in de map "maps".
- Vul dit toewijzingsbestand met alle elementen die uit een repository moeten worden opgehaald.
- Bewerk het bestand build.properties in de configuratiemap en schakel de regel skipFetch=true uit. Als deze eigenschap is ingeschakeld, slaat PDE Build de gehele ophaalfase namelijk over. Als u wilt dat de code die in de toewijzingsbestanden is opgegeven, wordt genegeerd, kunt u de eigenschap fetchTag op een specifieke waarde instellen. Dit is handig wanneer u elke nacht een build van HEAD maakt in plaats van de gelabelde versies.
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:
- skipMaps: schakel deze eigenschap uit. Als deze eigenschap is ingeschakeld, haalt PDE Build de toewijzingsbestanden niet op.
- mapsRepo =
:pserver:anonymous@example.com/path/to/repo. De CVS-repository waaruit de toewijzingsbestanden worden opgehaald.
- mapsRoot =
/path/to/maps. Het pad in de CVS-repository naar de directory
met de toewijzingsbestanden.
- mapsCheckoutTag =
HEAD. De CVS-code die wordt gebruikt om de toewijzingsbestanden uit te checken.
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.