Näyttöpäätteettömän koonnin mukautus

Näyttöpäätteetöntä koontia on mahdollista mukauttaa seuraavilla tavoilla:

Näiden tiedostojen sisällön tarkka muoto määräytyy muiden tiedostojen mukaan. Käytettäessä customTargets-, allElements- tai customAssembly-mukautuksia on tämän vuoksi suositeltavaa varmistaa, että näissä tiedostoissa käytettävät mallipohjat ovat peräisin samasta PDE-/koontiversiosta. Uudet PDE-/koontiversiot ovat taaksepäinyhteensopivia näiden mukautuskomentosarjojen vanhojen versioiden kanssa.

Näiden komentosarjojen mallipohjaversiot ovat käytettävissä templates/headless-build-kansion org.eclipse.pde.build-lisäosassa. Voit käyttää mukautusta kopioimalla mallipohjan koontikokoonpanon hakemistoon ja muokkaamalla tarvittavia kohteita.

customTargets.xml

customTargets.xml-komentosarja on tarkoitettu koontiprosessin ylimmän tason mukautukseen. Se sisältää ant-kohteita, joita kutsutaan koonnin päävaiheiden välillä. Kullekin seuraavista koontivaiheista on käytettävissä edeltäviä ja seuraavia kohteita:

Voit käyttää customTargets.xml-komentosarjaa kopioimalla sen PDE-/koontimallipohjien hakemistosta koontikokoonpanon hakemistoon ja muokkaamalla tarvittavia ant-kohteita. Näyttöpäätteetön koonti havaitsee komentosarjan ja käyttää sitä automaattisesti.

customTargets.xml-komentosarjassa on myös delegointi allElements.xml-komentosarjaan kunkin koontivaiheen osalta.

allElements.xml

allElements.xml-komentosarja on eräänlainen delegointikomentosarja, jota käytetään eri koontivaiheiden ajoon tietyssä elementissä (yleensä tuoteominaisuudessa). Voit käyttää näitä mukautusvaiheita customTargets.xml-komentosarjan tavoin kopioimalla mallipohjan PDE-/koontihakemistosta koontikokoonpanon hakemistoon. Eclipse 3.4 -ympäristössä koottavan kohde-elementin voi määrittää ylimmän tason koontikokoonpanon build.properties-tiedostossa käyttämällä ominaisuuksia topLevelElementType ja topLevelElementId. elementType-asetuksen arvoksi on annettava feature ja elementId-asetuksen arvoksi koottava tuoteominaisuuden tunnus.

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

allElements.xml-komentosarja sisältää myös kohteita, joita käytetään koonnin koonti- ja pakkausvaiheen aikana. defaultAssemble-kohdetta kutsutaan kaikkien käyttöympäristöjen arkistojen koontia varten. Voit halutessasi määrittää mukautettuja kohteita yksittäisiä käyttöympäristöjä varten.

Jos haluat käyttää mukautettua kohdetta tietyn käyttöympäristön yhteydessä, määritä ominaisuus "assemble.<element-id>[.<config>] ja sitä vastaava kohde. PDE/koonti käyttää tämän ominaisuuden perusteella oletuskohteen asemesta mukautettua kohdetta. Tämän mukautetun kohteen avulla voi antaa arkistolle mukautetun nimen tai käsitellä arkistoa etukäteen tai jälkikäteen.

Esimerkki:

	<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

customAssembly.xml-komentosarja on uusi versiossa 3.4. Se sisältää mukautuskohtia, joita kutsutaan koonnin koonti- ja pakkausvaiheiden aikana. Kuten with customTargets.xml- ja allElements.xml-komentosarjojen yhteydessä, voit käyttää mukautusta kopioimalla mallipohjan PDE-/koontihakemistosta koontikokoonpanon hakemistoon.

PDE-/koontitoiminnon muodostamat koonti- ja pakkauskomentosarjat toteuttavat seuraavat toimet:

Koontikomentosarjat keräävät koonnin aikana käännetyt tuoteominaisuudet ja lisäosat. Pakkauskomentosarjat keräävät esikäännetyt binaariset tuoteominaisuudet ja lisäosat. customAssembly.xml-komentosarja sisältää seuraavat kohteet ennen edellä kuvattuja vaiheita tai niiden jälkeen: