Ant-komentosarjat muodostetaan tavallisesti lisäosien kehitysympäristön (PDE:n) avulla, mutta niitä voi muodostaa myös käsin tai muista komentosarjoista.
PDE antaa käyttöön Ant-tehtäviä, joilla voidaan muodostaa erilaisia koontikomentosarjoja.
Koontikomentosarjojen muodostustoiminnot löytyvät seuraavista tehtävistä. Lisäksi luetellaan jokaisen tehtävän argumentit.
elements: |
noudettava merkintä. Käytettävän muodon tulee olla laji@tunnus, kuten Hakemistotiedoston muoto -kohdassa on määritetty. |
buildDirectory: |
hakemisto, johon noutokomentosarjat muodostetaan ja johon tuoteominaisuudet ja lisäosaprojektit kuitataan ulos; |
directory: |
hakemistotiedoston polku; |
children: |
valinnainen; määrittää, aloitetaanko lisättyjen lisäosien ja fragmenttien komentosarjojen muodostus. Oletusarvo on true. |
cvspassfile: |
valinnainen; CVS-salasanatiedoston nimi; |
fetchTag: |
valinnainen; korvaa annetun arvon perusteella hakemistotiedostoon määritetyn tunnisteen; |
configInfo: |
valinnainen; et-merkein erotettu kokoonpanoluettelo, joka osoittaa kohteena olevan kokoonpanon. Oletusarvona on käyttöympäristöstä riippumattomuus. |
recursiveGeneration: |
valinnainen; määrittää, muodostetaanko noutokomentosarjoja sisäkkäisille tuoteominaisuuksille. Oletusarvo on true. |
elements : |
koottava merkintä. Merkinnän muodon tulee olla laji@tunnus, kuten Hakemistotiedoston muoto -kohdassa on määritetty. |
buildDirectory: |
hakemisto, johon koottavat tuoteominaisuudet ja lisäosat sijoitetaan; |
children: |
valinnainen; määrittää, aloitetaanko lisättyjen lisäosien ja fragmenttien komentosarjojen muodostus. Oletusarvo on true. |
recursiveGeneration: |
valinnainen; määrittää, aloitetaanko lisättyjen tuoteominaisuuksien komentosarjojen muodostus. Oletusarvo on true. |
devEntries: |
valinnainen; pilkuin erotettu hakemistoluettelo, joka annetaan käännöksen luokkapolulle. |
buildingOSGi: |
valinnainen; osoittaa, onko kohteena versio 3.x vai 2.1. Oletusarvo on true. |
baseLocation: |
valinnainen; osoittaa kansion, joka sisältää Eclipse-kohdeasennuksen, jossa onfeatures/- ja plugins/-alihakemistot. |
configInfo: |
valinnainen; et-merkein erotettu kokoonpanoluettelo, joka osoittaa kohteena olevan kokoonpanon. Oletusarvona on käyttöympäristöstä riippumattomuus. |
pluginPath: |
valinnainen; käyttöympäristön tiedostoerottimilla erotettu luettelo sijainneista, joista voi etsiä lisää lisäosia. |
archivesFormat: |
valinnainen; et-merkein erotettu kokoonpanoluettelo, ja kunkin kokoonpanon oletettu tulosmuoto. Muoto erotetaan yhdysmerkillä (-) kokoonpanosta. Tuetut arvot ovat folder, tar, zip ja antZip, joiden merkitykset ovat ei arkistointia, tar-arkiston luonti, käyttöympäristössä olevan info zip -tiedoston version käyttö ja ant zip -tiedoston käyttö. Oletusarvo on antZip. |
product: |
valinnainen; vinoviivoin erotettu polku koottavan RCP-tuotteen sijaintipaikkaan. Polun ensimmäisen osan on viitattava .product-tiedoston sisältävän lisäosan tunnukseen. |
signJars: |
valinnainen; osoittaa, täytyykö muodostettujen komentosarjojen allekirjoittaa tuoteominaisuuksien ja lisäosien jar-arkistot. Oletusarvo on false. Allekirjoitustehtävän parametreja ohjaavat ant-ominaisuudet sign.alias, sign.keystore ja sign.storepass, joiden merkitykset ovat välitys alias-, keystore- ja storepass-parametreille ant-ohjelman signJar-tehtävästä. Oletusarvo on false. |
generateJnlp: |
valinnainen; osoittaa, muodostetaanko jnlp-tiedosto kaikille koottaville tuoteominaisuuksille. |
outputUpdateJars: |
valinnainen; jos määritetään, muodostaa lisäosat ja tuoteominaisuudet päivityssivuston muodossa. Oletusarvo on false. Huomaa, että site.xml-tiedostoa ei muodosteta eikä päivitetä. |
forceContextQualifier: |
valinnainen; korvaa lisäosien ja tuoteominaisuuksien käyttämän .qualifier-arvon annetulla arvolla. (Lisätietoja on ohjeessa Versiotarkenteet) |
generateFeatureVersionSuffix: | valinnainen; määrittää, muodostetaanko tuoteominaisuuden version loppuliite. |
groupConfiguration: |
valinnainen; määrittää, ryhmitetäänkö kaikki koottavat kokoonpanot samaan arkistoon. |
generateVersionsLists: |
valinnainen; määrittää, muodostetaanko koottujen tuoteominaisuuksien ja lisäosien versiot luettelevat ominaisuustiedostot. |
featureId: |
Muodostettavalle tuoteominaisuudelle annettava tunnus. |
buildDirectory: |
hakemisto, jossa sisällytettävät tuoteominaisuudet ja lisäosat (alihakemistoissa /features ja /plugins) sijaitsevat. Muodostettava tuoteominaisuus sijoitetaan /features-alihakemistoon. |
baseLocation: |
valinnainen; osoittaa kansion, jossa asennetut tuoteominaisuudet ja lisäosat ovat. |
productFile: |
valinnainen; tuotetiedosto, jonka perusteella muodostettava tuoteominaisuus muodostetaan. |
verify: |
Määrittää, käytetäänkö selvitystoimintoa tarkistamaan, että määritetyt lisäosat ja tuoteominaisuudet ovat käytettävissä. Määrittää myös, pystyykö tuoteominaisuus käsittelemään käyttöympäristökohtaisia fragmentteja ja JAR-arkistoituja lisäosia oikein. Jos kaikki tuoteominaisuuteen sisällytettävät ominaisuudet ovat käytettävissä paikallisesti, verify-ominaisuuden arvoksi tulee määrittää True. Jos elementit tulee noutaa tietovarastosta, määritä verify-ominaisuuden arvoksi False, nouda edellytetyt lisäosat ja tuoteominaisuudet tästä seuraavan tuoteominaisuuden avulla ja muodosta säilö uudelleen käyttämällä merkintää verify = True. |
pluginPath: |
valinnainen; käyttöympäristön tiedostoerottimilla erotettu luettelo sijainneista, joista voi etsiä lisää lisäosia. |
configInfo: |
valinnainen; et-merkein erotettu kokoonpanoluettelo, joka osoittaa kohteena olevan kokoonpanon. Oletusarvona on käyttöympäristöstä riippumattomuus. |
pluginList: |
valinnainen; pilkuin erotettu luettelo muodostettavaan tuoteominaisuuteen sisällytettävistä lisäosien tunnuksista. |
featureList: |
valinnainen; pilkuin erotettu luettelo muodostettavaan tuoteominaisuuteen sisällytettävistä tuoteominaisuuksien tunnuksista. |
fragmentList: |
valinnainen; pilkuin erotettu luettelo muodostettavaan tuoteominaisuuteen sisällytettävistä fragmenttien tunnuksista. |
<eclipse.fetch elements="bundle@org.eclipse.osgi"
buildDirectory="c:\toBuild"
directory="directory.txt"
configInfo="win32,win32,x86 & linux, motif, x86"
/>
<eclipse.buildScript elements="bundle@org.eclipse.osgi"
buildDirectory="c:\toBuild"
archivesFormat="macosx, carbon, ppc - tar"/>
Edellä kuvattuja tehtäviä voi tehdä vain, jos Eclipse-ohjelmisto on käynnissä. Jos Ant-komentosarjojen suorituksessa käytetään Eclipse-tehtäviä, komentosarjat täytyy ajaa Eclipse Ant Runner -sovelluksen avulla. Tällaisessa tapauksessa komentorivi on seuraava:
java -cp startup.jar org.eclipse.core.launcher.Main -application org.eclipse.ant.core.antRunner -buildfile build.xml
Huomaa, että sovelluksen jäljessä olevat parametrit välitetään Ant-ohjelmaan.