Megjelenítés nélküli összeépítés személyre szabása

A megjelenítés nélküli összeépítések személyre szabásának több módja is van:

Ezeknek a fájloknak a pontos formátuma egymástól függ. Ezért a customTargets, allElements vagy customAssembly személyre szabások használatakor célszerű biztosítani, hogy a fájlokhoz használt sablonok mind ugyanabból a PDE/összeépítési változatból származzanak. A PDE összeépítési támogatás bedolgozó újabb változatai visszafelé kompatibilisek ezeknek az egyéni parancsfájloknak a régebbi változataival.

Ezeknek a parancsfájloknak a sablonváltozatai az org.eclipse.pde.build bedolgozóban érhetők el, a templates/headless-build mappában. A személyre szabások használatához egyszerűen másolja át a sablont az összeépítési konfiguráció könyvtárába, és szerkessze a megfelelő célokat.

customTargets.xml

A customTargets.xml parancsfájl az összeépítési folyamat felső szintű személyre szabásához használható. Az összeépítés nagyobb fázisai között meghívandó ant célokat biztosít. A következő lépésekhez elérhetők előzetes és utólagos célok is:

A customTargets.xml parancsfájl használatához egyszerűen másolja át a fájlt a PDE összeépítés bedolgozó templates könyvtárából az összeépítési konfiguráció könyvtárába, majd szerkessze a megfelelő ant célokat. A megjelenítés nélküli összeépítés automatikusan felismeri és használja a parancsfájlt.

Az customTargets.xml parancsfájl delegálást is biztosít az egyes összeépítési fázisok allElements.xml parancsfájljához.

allElements.xml

Az allElements.xml parancsfájl egyfajta delegációs parancsfájl, amely egy adott elem (általában egy szolgáltatás) különféle összeépítési lépéseinek futtatására szolgál. Ahogy a customTargets.xml fájl esetében is, a személyre szabási lépések használatához másolja át a sablont a PDE összeépítés bedolgozóból az összeépítési konfiguráció könyvtárába. Az Eclipse 3.4 változatban az összeépítendő cél elemet a build.properties felső szintű összeépítési konfigurációban lehet megadni a topLevelElementType és topLevelElementId tulajdonságokkal. Az elementType tulajdonságot feature értékre kell beállítani, és az elementId tulajdonságot pedig arra a szolgáltatás azonosítóra (feature-id), amelyet össze kíván építeni.

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

Az allElements.xml fájl biztosít célokat az összeépítés összeállítási és csomagolási fázisaihoz is. A defaultAssemble cél az összes platformra vonatkozó archívum összehívásához van meghívva. Igény szerint meg lehet határozni egyéni célokat is egyedi platformokhoz.

Egy adott platform egyéni céljának használatához határozzon meg egy "assemble.<element-id>[.<config>] tulajdonságot és a megfelelő célt. Ez a tulajdonság megadja a PDE/Build bedolgozónak, hogy az alapértelmezett cél helyett ezt az egyéni célt használja. Ezzel az egyéni céllal ezután adhat az archívumnak egy egyéni nevet, vagy végrehajthat az archívumon előzetes vagy utólagos feldolgozást.

Példa:

	<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

A customAssembly.xml fájl új a 3.4 kiadásban. Személyre szabási pontokat biztosít, amelyek az összeépítés összeállítási és csomagolási fázisában kerülnek meghívásra. A customTargets.xml és az allElements.xml fájlokhoz hasonlóan, a személyre szabások használatához másolja át a sablont a PDE/Build bedolgozóból az összeépítési konfiguráció könyvtárába.

A PDE összeépítés bedolgozó által előállított összeállítási és csomagolási parancsfájlok a következő műveleteket hajtják végre:

Az összeállítási parancsfájlok gyűjtik össze az összeépítés során lefordított szolgáltatásokat és bedolgozókat, a csomagolási parancsfájlok pedig az előre lefordított szolgáltatásokat és bedolgozókat. A customAssembly.xml parancsfájl a következő célokat a fenti lépések előtt vagy után biztosítja: