Tilpasse et headless-bygg

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.

customTargets.xml

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.

allElements.xml

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>

customAssembly.xml

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: