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; Lisäosat ja tuoteominaisuudet on sijoitettava mainitussa järjestyksessä plugins- ja features-kansioihin; |
| 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ä. |
| groupConfiguration: |
valinnainen; määrittää, ryhmitetäänkö kaikki koottavat kokoonpanot samaan arkistoon. |
| generateVersionsLists: |
valinnainen; määrittää, muodostetaanko koottujen tuoteominaisuuksien ja lisäosien versiot luettelevat ominaisuustiedostot. |
| filteredDependencyCheck : |
valinnainen, rajoittaa koonnin aikana huomioon otettavien lisäosien ja tuoteominaisuuksien joukon niin, että se on käytettävissä tuoteominaisuuksista käsin; |
| filterP2Base : |
valinnainen, rajoittaa baseLocation-sijainnista huomioon otettavien lisäosien ja tuoteominaisuuksien joukon p2-asennuksessa huomioon otettaviin kohteisiin; |
| generateFeatureVersionSuffix: | valinnainen; määrittää, muodostetaanko tuoteominaisuuden version loppuliite. Lisätietoja on ohjeaiheessa Versiotarkenteet; |
| generatedVersionLength : |
valinnainen, muodostetun tuoteominaisuusversion loppuliitteen pituus. Oletusarvo on 28. Lisätietoja on ohjeaiheessa Versiotarkenteet; |
| significantVersionDigits : |
valinnainen, merkitsevien numeroiden määrä tuoteominaisuusversion loppuliitteiden muodostuksessa.
Lisätietoja on ohjeaiheessa Versiotarkenteet; |
| forceContextQualifier: |
valinnainen; korvaa lisäosien ja tuoteominaisuuksien käyttämän .qualifier-arvon annetulla arvolla. Lisätietoja on ohjeaiheessa Versiotarkenteet; |
| 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. (Tukee määritteitä, katso jäljempänä) |
| featureList: |
valinnainen; pilkuin erotettu luettelo muodostettavaan tuoteominaisuuteen sisällytettävistä tuoteominaisuuksien tunnuksista. (Tukee määritteitä, katso jäljempänä) |
| fragmentList: |
valinnainen; pilkuin erotettu luettelo muodostettavaan tuoteominaisuuteen sisällytettävistä fragmenttien tunnuksista. (Tukee määritteitä, katso jäljempänä) |
| buildPropertiesFile : |
valinnainen, sen ominaisuustiedoston sijainti, jonka sisältöä käytetään muodostetun tuoteominaisuuden build.properties-tiedostona. |
| includeLaunchers : |
valinnainen, määrittää, sisällytetäänkö equinox-aloitustoiminnot. Oletusarvo on true. |
eclipse.generateFeature-tehtävän argumentit pluginList, featureList ja fragmentList tukevat määritteitä. Näiden argumenttien muoto on seuraavanlainen:
List = <element-id>[;<attribute>=<value>]* [,<element-id>[;<attribute>=<value>]*]*
Kukin määrite-/arvopari lisätään muodostettuun xml-tiedostoon annettua elementtiä vastaavasti. Esimerkki:
featureList = org.eclipse.feature;optional=true
pluginList = org.eclipse.plugin.A;unpack=true
fragmentList=org.eclipse.fragment.a;os=win32,org.eclipse.fragment.b;os=linux;ws=gtk;arch=x86
<feature ...>
...
<includes id="org.eclipse.feature" version="0.0.0" optional="true" />
...
<plugin id="org.eclipse.plugin.A" version="0.0.0" unpack="true" />
<plugin id="org.eclipse.fragment.a" version="0.0.0" os="win32" fragment="true" />
<plugin id="org.eclipse.fragment.b" version="0.0.0" os="linux" ws="gtk" arch="x86" fragment="true" />
...
</feature>
<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 -jar plugins/org.eclipse.equinox.launcher_<version>.jar -application org.eclipse.ant.core.antRunner -buildfile build.xml
Huomaa, että sovelluksen jäljessä olevat parametrit välitetään Ant-ohjelmaan.