Een RPC-toepassing bouwen van een productconfiguratiebestand

PDE Build wordt geleverd met infrastructuur voor het bouwen van een volledige RPC-toepassing van een productconfiguratiebestand. 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 productbuild, waarbij wordt aangenomen dat alle plugins en features (zowel te bouwen als vooraf gebouwd) waarnaar door het productbestand wordt verwezen lokaal beschikbaar zijn op schijf.

Basisinstellingen

De eerste stap van het instellen van de build bestaat uit het maken van de directory waarin de build wordt geplaatst. Deze directory wordt ook de builddirectory genoemd en zal de te bouwen plugins en features bevatten, evenals de gegenereerde artefacten. Vervolgens kopieert u uw plugins en features naar respectievelijk de subdirectory "plugins" en de subdirectory "features". Er wordt verwacht dat het productconfiguratiebestand zich in een van deze plugins/features bevindt.

De tweede stap van het instellen van een build bestaat uit het kopiëren van het sjabloonbestand build.properties van org.eclipse.pde.build/templates/headless-build naar een nieuwe directory, die de buildconfiguratiedirectory (ook wel de configuratiedirectory genoemd) zal zijn. Bewerk het gekopieerde bestand build.properties en stel de volgende eigenschappen in:

Overzicht van de directorystructuur

<buildDirectory>/
plugins/
pluginToBuildA
pluginToBuildB
myProduct.product
...
features/
featureToBuild
...

<buildConfiguration>/
build.properties

<baseLocation>
plugins/
org.eclipse.core.runtime
org.eclipse.ui
...
features/
org.eclipse.rcp
org.eclipse.platform.launchers
...

De build uitvoeren

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 argumenten instellen in de opdrachtregel:
Voer de toepassing antRunner uit met behulp van de volgende opdracht:
java -jar <eclipseInstall>/startup.jar -application org.eclipse.ant.core.antRunner -buildfile <<eclipseInstall>/plugins/org.eclipse.pde.build_<version>/scripts/productBuild/productBuild.xml> -Dbuilder=<pad naar de buildconfiguratiemap>

Geavanceerde scenario's

Achter de schermen wordt door deze installatie een feature gegenereerd die de plugins of features bevat die in het productconfiguratiebestand zijn opgegeven.  Deze gegenereerde feature wordt vervolgens gebruikt om een normale feature op basis van een naamloze build aan te sturen.Als u de build nog verder wilt aanpassen, i.e. ophalen uit een repository, raadpleegt u Geavanceerde PDE-buildonderwerpen voor meer informatie.