Du kan anpassa ett konsollöst bygge på flera sätt:
Det exakta formatet för innehållet i dessa filer beror på varandra. Därför, när du använder anpassningar av customTargets, allElements eller customAssembly, rekommenderas det att du säkerställer att de mallar som används för dessa filer kommer från samma version av PDE/Build. Nya versioner av PDE/Build bakåtkompatibla med äldre versioner av dessa anpassningsskript.
Mallversioner av dessa skript är tillgängliga i insticksprogrammet org.eclipse.pde.build under mappen templates/headless-build. Om du vill använda anpassningen, kopierar du helt enkelt mallen till byggkonfigurationskatalogen och redigerar rätt mål.
Skriptet customTargets.xml är för anpassning av byggprocessen på toppnivå. Det tillhandahåller ant-mål som anropas mellan byggets primära faser. Det finns för- och eftermål tillgängliga runt följande byggsteg:
Om du vill använda skriptet customTargets.xml, kopierar du helt enkelt den från PDE/Build-mallkatalogen till byggkonfigurationskatalogen och redigerar rätt ant-mål.Skriptet upptäcks automatiskt och används av det konsollösa bygget.
Skriptet customTargets.xml tillhandahåller även delegation till skriptet allElements.xml för de olika byggfaserna.
Skriptet allElements.xml är en typ av delegeringsskript som används för att köra de olika byggstegen för ett givet element (vanligen en funktion). Som med customTargets.xml, om du vill använda dessa anpassningssteg, kopierar du mallen från PDE/Build till byggkonfigurationskatalogen. I Eclipse 3.4 kan det målelement som byggs anges i byggkonfigurationsfilen configuration build.properties på den översta nivån med egenskaperna topLevelElementType och topLevelElementId. ElementType ska anges till feature och elementId ska anges till det funktions-ID du vill bygga.
<target name="allElementsDelegator">
<ant antfile="${genericTargets}" target="${target}">
<property name="type" value="${topLevelElementType}" />
<property name="id" value="${topLevelElementId}" />
</ant>
</target>
AllElements.xml tillhandahåller även mål som används under sammanslagnings- och paketeringsfasen i bygget. Målet defaultAssemble anropas för att slå samman arkiven för alla plattformar. Om du vill, kan du definiera anpassade mål för enskilda plattformar.
Om du vill använda ett anpassat mål för en given plattform, definierar du en egenskap "assemble.<element-id>[.<config>] och ett motsvarande mål. Egenskaper talar om för PDE/Build att använda detta anpassade mål i stället för standardmålet. Detta anpassade mål kan sedan användas för att ge arkivet ett anpassat namn eller utföra för- eller efterbearbetning av arkivet.
Exempel:
<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>
Skriptet customAssembly.xml är nytt i 3.4. Det tillhandahåller anpassningspunkter som anropas under sammanslagnings- och paketeringsfaserna i bygget. Som med customTargets.xml och allElements.xml, om du vill använda dessa anpassningssteg, kopierar du mallen från PDE/Build till byggkonfigurationskatalogen.
Sammanslagnings- och paketeringsskripten som genereras av PDE/Build utför följande åtgärder:
Sammanslagningsskripten hanterar insamlingen av de funktioner och insticksprogram som kompilerades under bygget och paketskripten hanterar med insamlingen av alla förkompilerade binära funktioner och insticksprogram. Skriptet customAssembly.xml tillhandahåller följande mål före eller efter ovanstående steg: