Det er flere måter å tilpasse et headless-bygg på:
Nøyaktig format for innholdet i disse filene avhenger av hverandre. Ved bruk av customTargets-, allElements- eller customAssembly-tilpasninger anbefales det derfor at malene som brukes for disse filene, alle kommer fra samme versjon av PDE/Build. Nye versjoner av PDE/Build er bakoverkompatible med gamle versjoner av disse tilpasningsskriptene.
Malversjonene av disse skriptene er tilgjengelige i plugin-modulen org.eclipse.pde.build under mappen templates/headless-build. For å bruke tilpasningen kopierer du bare malen til byggekonfigurasjonskatalogen og redigerer relevante mål.
Skriptet customTargets.xml er for toppnivåtilpasning av byggeprosessen. Det sørger for ant-mål som kalles mellom hovedfasene i byggingen. Det finnes pre- og post-mål rundt hvert av følgende byggetrinn:
For å bruke skriptet customTargets.xml kopierer du det bare fra PDE/Build-malkatalogen til byggekonfigurasjonskatalogen og redigerer relevante mål. Skriptet blir oppdaget automatisk og brukes av headless-bygget.
Skriptet customTargets.xml sørger også for delegering til skriptet allElements.xml for hver av byggefasene.
Skriptet allElements.xml er en type delegeringsskript som brukes til å kjøre forskjellige byggetrinn på et gitt element (vanligvis en funksjon). Som med customTargets.xml må du for å bruke disse tilpasningstrinnene kopiere malen fra PDE/Build til konfigurasjonskatalogen. I Eclipse 3.4 kan målelementet som skal bygges, spesifiseres i filen for toppnivåbyggekonfigurasjon, build.properties, ved hjelp av egenskapene topLevelElementType og topLevelElementId. elementType bør defineres til feature og elementId til funksjons-IDen du ønsker å bygge.
<target name="allElementsDelegator">
<ant antfile="${genericTargets}" target="${target}">
<property name="type" value="${topLevelElementType}" />
<property name="id" value="${topLevelElementId}" />
</ant>
</target>
allElements.xml sørger også for mål som brukes under sammensetnings- og pakkefasen av byggingen. Målet defaultAssemble blir kalt for å sette sammen arkivene for alle plattformer. Om ønskelig kan tilpassede mål defineres for individuelle plattformer.
For å bruke et tilpasset mål for en gitt plattform definerer du egenskapen "assemble.<element-id>[.<config>] og et tilsvarende mål. Egenskapen ber PDE/Build bruke dette tilpassede målet i stedet for standardmålet. Dette tilpassede målet kan så brukes til å gi arkivet et tilpasset navn eller utføre pre- eller post-behandling på arkivet.
Eksempel:
<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 er nytt i 3.4. Det sørger for tilpasningspunkter som blir kalt opp under sammensetnings- og pakkefasene av byggingen. Som med customTargets.xml og allElements.xml må du for å bruke denne tilpasningen kopiere malen fra PDE/Build til byggekonfigurasjonskatalogen.
Sammensetnings- og byggeskript generert av PDE/Build utfører følgende handlinger:
Sammensetningsskriptene tar seg av innsamling av funksjoner og plugin-moduler som er kompilert under byggingen, og pakkeskriptene tar seg av innsamling av eventuelle forkompilerte binærfunksjoner og -plugin-moduler. Skriptet customAssembly.xml sørger for følgende må før eller etter hvert av trinnene ovenfor: