Een naamloze build aanpassen

Er zijn meerdere methoden voor het aanpassen van een naamloze build:

De precieze indelingen van de inhoud van deze bestanden zijn allemaal onderling afhankelijk. Bij het werken met aanpassingen van customTargets, allElements of customAssembly wordt daarom aanbevolen ervoor te zorgen dat de sjablonen die worden gebruikt voor deze bestanden alle afkomstig zijn uit dezelfde versie van PDE/Build. Nieuwe versies van PDE/Build zijn achterwaarts compatibel met oudere versies van deze aanpassingsscripts.

Sjabloonversies van deze scripts zijn beschikbaar in de plugin org.eclipse.pde.build in de map templates/headless-build. Om de aanpassing te gebruiken, hoeft u alleen de sjabloon te kopiëren naar de configuratiedirectory van uw build en de desbetreffende doelen te wijzigen.

customTargets.xml

Het script customTargets.xml gebruikt u voor aanpassingen van het buildproces op het hoogste niveau. Het bevat ant-doelen die worden aangeroepen tussen de hoofdfases van de build. Er zijn doelen vooraf en achteraf beschikbaar rond elk van de volgende buildstappen:

Om het script customTargets.xml te gebruiken, hoeft u het alleen te kopiëren van de PDE/Build-sjablonendirectory naar de configuratiedirectory van uw build en de desbetreffende ant-doelen te wijzigen. Het script wordt automatisch herkend en gebruikt door de naamloze build.

Het script customTargets.xml biedt ook delegatie voor het script allElements.xml voor elke fase van de build.

allElements.xml

Het script allElements.xml is een soort delegatiescript dat wordt gebruikt om de verschillende buildstappen uit te voeren voor een bepaald element (meestal een feature). Net als bij het script customTargets.xml kopieert u de sjabloon van PDE/Build naar de configuratiedirectory van uw build om deze aanpassingsstappen te gebruiken. In Eclipse 3.4 kan het doelelement dat wordt gegenereerd, worden opgegeven in het buildconfiguratiebestand build.properties op het hoogste niveau met de eigenschappen topLevelElementType en topLevelElementId. Als elementtype moet u feature instellen en als element-ID het feature-ID dat u wilt genereren.

 	<target name="allElementsDelegator">
 		<ant antfile="${genericTargets}" target="${target}">
	 		<property name="type" value="${topLevelElementType}" />
	 		<property name="id" value="${topLevelElementId}" />
 		</ant>
 	</target>

Het script allElements.xml bevat ook doelen die worden gebruikt tijdens de fase waarin de build wordt geassembleerd en in een pakket wordt opgenomen. Het doel defaultAssemble wordt aangeroepen om de archieven te assembleren voor alle platformen. Desgewenst kunt u aangepaste doelen definiëren voor afzonderlijke platformen.

Om een aangepast doel te gebruiken voor een bepaald platform, definieert u een eigenschap "assemble.<element-id>[.<config>] en een bijbehorend doel. De eigenschap bepaalt dat PDE/Build dit aangepaste doel gebruikt in plaats van het standaarddoel. Dit aangepaste doel kan vervolgens worden gebruikt om het archief een aangepaste naam te geven of verwerking vooraf of achteraf uit te voeren voor het archief.

Voorbeeld:

	<property name="assemble.org.foo.feature.id.linux.gtk.x86" value="true" />
 	<target name="assemble.org.foo.feature.id.linux.gtk.x86">
 		<property name="archiveName" value="acme-RCP-${buildId}-linux.gtk.x86.tar.gz" />
 		<-- custom pre assemble steps for linux.gtk.x86-->
 		<ant antfile="${assembleScriptName}" dir="${buildDirectory}"/>
 		<-- custom post assemble steps for linux.gtk.x86-->
 	</target>

customAssembly.xml

Het script customAssembly.xml is nieuw in 3.4. Het bevat aanpassingspunten die worden aangeroepen tijdens de fases waarin de build wordt geassembleerd en in een pakket wordt opgenomen. Net als bij customTargets.xml en allElements.xml kopieert u de sjabloon van PDE/Build naar de configuratiedirectory van uw build om deze aanpassing te gebruiken.

De volgende acties worden uitgevoerd door de door PDE/Build gegenereerde scripts voor het assembleren en in een pakket opnemen van de build:

De assemblagescripts zorgen voor het verzamelen van de features en plugins die zijn gecompileerd tijdens het bouwen en de scripts voor het in een pakket opnemen van een build zorgen voor het verzamelen van eventuele vooraf gecompileerde binaire features en plugins. Het script customAssembly.xml bevat de volgende doelen vóór of na elk van bovenstaande stappen: