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.