PDE Build wordt geleverd met infrastructuur voor het automatiseren van het bouwen van features. De meeste van de instellingen die noodzakelijk zijn voor een dergelijke build kunnen worden gemaakt via een paar wijzigingen van de sjabloon build.properties die met PDE Build wordt meegeleverd. In de volgende sectie richten we ons op het instellen van een eenvoudige build, waarbij wordt aangenomen dat alle plugins en features (zowel te bouwen als vooraf gebouwd) waarnaar vanuit de feature wordt verwezen, al lokaal beschikbaar zijn op schijf.
De eerste stap van het instellen van de build bestaat uit het maken van de directory voor de buildconfiguratie. Dit is de directory voor de bestanden waarmee de naamloze build wordt bestuurd en aangepast.
Het hoofdbestand voor het besturen van de build is het buildconfiguratiebestand build.properties op het hoogste niveau. Bij het instellen van een nieuwe build kopieert u het sjabloonbestand van de bundel org.eclipse.pde.build naar uw eclipse-installatie die u gebruikt om uw build uit te voeren. Het sjabloonbestand bevindt zich onder org.eclipse.pde.build/templates/headless-build/build.properties.
Naar deze directory wordt verwezen door de builder-eigenschappen die doorgaans worden ingesteld op de ant-opdrachtregel.
De eigenschap buildDirectory geeft de directory aan waarin door PDE/Build scripts worden gegenereerd en de werkelijke build wordt uitgevoerd. Plugins en features die worden gebouwd, moeten in de subdirectory's ${buildDirectory}/plugins en ${buildDirectory}/features worden geplaatst. Als bundels en features worden opgehaald uit een repository (raadpleeg Ophalen uit repository's) worden deze hier ook geplaatst.
Deze directory kan dezelfde zijn als de directory van de buildconfiguratie of kan een andere directory zijn. Het is raadzaam een afzonderlijke directory te gebruiken, vooral als de buildconfiguratie in CVS wordt bewaard en u deze niet wilt vervuilen met gegenereerde buildartefacten.
Om een standaardbuild van een feature in te stellen, moet u het buildconfiguratiebestand build.properties wijzigen en de volgende eigenschappen instellen:
In eerdere versies van PDE/Build was ook een allElements.xml-bestand vereist. In 3.4 is dit niet langer het geval. Het allElements.xml-bestand kan nog steeds worden gebruikt, maar is alleen vereist als u bepaalde aspecten van uw build wilt aanpassen. Raadpleeg Een naamloze build aanpassen.
Als u de build wilt uitvoeren, gebruikt u de toepassing org.elipse.ant.core.antRunner. Wanneer u Eclipse met deze toepassing aanroept om een build uit te voeren, moet u twee parameters instellen in de opdrachtregel:
-buildfile=</path/to/build.xml>: Dit is het pad naar de build.xml die is verstrekt door PDE Build. Deze bevindt zich in de directory org.eclipse.pde.build/scripts. Dit is het buildscript dat het gehele buildproces aanstuurt.-Dbuilder=</path/to/configuration folder>:
Dit is het pad naar de buildconfiguratiemap.Voer de toepassing antRunner uit met behulp van de volgende opdracht:
java -jar
<eclipseInstall>/plugins/org.eclipse.equinox.launcher_<versie>.jar
-application org.eclipse.ant.core.antRunner -buildfile
<<eclipseInstall>/plugins/org.eclipse.pde.build_<versie>/scripts/build.xml>
-Dbuilder=<pad naar de buildconfiguratiemap>Zodra de build is voltooid, kunt u het resultaat bekijken in de builddirectory in de map genaamd I.TestBuild (deze naam kan worden geconfigureerd door de eigenschap buildLabel in te stellen).
Als u de build nog verder wilt aanpassen, i.e. ophalen uit een repository, raadpleegt u Geavanceerde PDE-buildonderwerpen voor meer informatie.