Az Ant parancsfájlok létrehozására általában a Bedolgozó fejlesztői
környezet (PDE) segítségével kerül sor, de lehetséges a létrehozásuk kézzel vagy más
parancsfájlokból is.
A PDE valójában Ant feladatokat vesz át a különböző összeépítési parancsfájlok
létrehozásához.
Az összeépítési parancsfájl létrehozási szolgáltatásai a
következő feladatokban találhatók. Az argumentumok listája is
megtalálható az egyes feladatoknál.
| elements: |
a lehívandó bejegyzés. Az elvárt formátum a type@azonosító[,verziószám], amint azt a könyvtárfájl formátum meghatározza; |
| buildDirectory: |
az a könyvtár, amelyben a lehívási parancsfájlok létrejönnek, és amelybe a szolgáltatás és bedolgozó projektek be lesznek jegyezve; |
| directory: |
a könyvtárfájl útvonala; |
| children: |
választható, megadja, hogy a tartalmazott bedolgozókhoz és töredékekhez el kell-e indítani a parancsfájl létrehozását. Az alapértelmezett értéke true (igaz); |
| cvspassfile: |
választható, a CVS jelszófájl neve; |
| fetchTag: |
választható, újradefiniálja a könyvtárfájlban megadott címkét a megadott értékkel; |
| configInfo: |
választható, a konfiguráció & jellel elválasztott listája a cél konfigurációt jelöli. Az alapértelmezés a platformfüggetlen beállítás; |
| recursiveGeneration: |
választható, meghatározza, hogy beágyazott szolgáltatásokhoz szükséges-e előállítani lehívási parancsfájlokat. Alapértelmezett érték: true (igaz). |
| elements: |
az összeépítendő bejegyzés. A bejegyzés elvárt formátuma type@azonosító[,verziószám], amint azt a könyvtárfájl formátum meghatározza; |
| buildDirectory : |
az összeépítendő szolgáltatásokat és bedolgozókat tartalmazó könyvtár. A bedolgozókat és szolgáltatásokat értelemszerűen plugins (bedolgozók) és features (szolgáltatások) mappákban kell elhelyezni; |
| children : |
választható, megadja, hogy a tartalmazott bedolgozókhoz és töredékekhez el kell-e indítani a parancsfájl létrehozását. Az alapértelmezett értéke true (igaz); |
| recursiveGeneration : |
választható, megadja, hogy a tartalmazott szolgáltatásokhoz el kell-e indítani a parancsfájl létrehozást. Az alapértelmezett értéke true (igaz); |
| devEntries : |
választható, a fordítási osztályútvonalhoz hozzáadandó könyvtárak vesszővel elválasztott listája; |
| buildingOSGi : |
választható, jelzi, hogy a cél
3.x vagy 2.1 kiadású. Alapértelmezett érték: true; |
| baseLocation : |
választható, olyan mappát jelöl, amely egy cél Eclipse telepítést tartalmaz features/ és plugins alkönyvtárakkal; |
| configInfo : |
választható, a konfiguráció & jellel elválasztott listája a cél konfigurációt jelöli. Az alapértelmezés a platformfüggetlen beállítás; |
| pluginPath : |
választható, olyan helyek platformfájl elválasztókkal elválasztott felsorolása, ahol további bedolgozók keresése történik; |
| archivesFormat : |
választható, a konfigurációk & jellel elválasztott listája és minden egyes konfiguráció várt kimeneti formátuma. A formátum a konfigurációtól egy kötőjellel (-) van elválasztva. A következő értékek támogatottak: folder, tar, zip, antZip, amelyek rendre a következőket jelentik: archiválás nélkül, archiválás tar használatával, a platformon elérhető zip használatával, ant zip használatával. Az alapértelmezett érték antZip; |
| product : |
választható, az összeépítés alatt álló RCP termék helyének '/' karakterrel elválasztott elérési útja. Az elérési út első szegmensének a .product fájlt tartalmazó bedolgozó azonosítójára kell utalnia; |
| signJars : |
választható, megmutatja, hogy az előállított parancsfájlok alá kell-e írják a szolgáltatások és bedolgozók jar fájljait. Az alapértelmezett érték a false. A sign (aláírási) feladat paramétereit a következő Ant tulajdonságok vezérlik: sign.alias, sign.keystore és sign.storepass, amelyek értelemszerűen az álnév, kulcstároló és jelszótároló paramétereknek vannak átadva az Ant signJar feladatból. Az alapértelmezett érték a false (hamis); |
| generateJnlp : |
választható, jelzi, hogy kell-e jnlp fájlt előállítani minden összeépített szolgáltatáshoz; |
| outputUpdateJars : |
választható, ha be van állítva, akkor bedolgozókat és szolgáltatásokat állít elő a frissítési webhely formátumában. Az alapértelmezett érték a false (hamis). Megjegyzés: a site.xml nem lesz előállítva és frissítve sem; |
| groupConfiguration
: |
választható, megadja, hogy az
összes összeépítés alatt álló konfigurációt egyetlen archívumba kell-e
csoportosítani; |
| generateVersionsLists : |
választható, megadja, hogy elő
kell-e állítani tulajdonságfájlokat, amelyek felsorolják az összeépített
szolgáltatások és bedolgozók verzióit; |
| filteredDependencyCheck : |
választható, a szolgáltatásokból
elérhető bedolgozókra és szolgáltatásokra korlátozza az összeépítés
során figyelembe venni kívánt bedolgozókat és szolgáltatásokat. |
| filterP2Base : |
választható, a
baseLocation tulajdonságból figyelembe venni kívánt bedolgozók és
szolgáltatások halmazát a p2 által telepítendőkre korlátozza; |
| generateFeatureVersionSuffix: | választható, megadja, hogy elő kell-e állítani a szolgáltatás version utótagját. Lásd még: Version Qualifiers; |
| generatedVersionLength : |
választható, az előállított
szolgáltatásváltozat utótag hossza. Alapértelmezett beállítás a 28. Lásd még: Version Qualifiers; |
| significantVersionDigits : |
választható, a
szolgáltatásváltozat utótagok előállításakor használandó jelentős számjegyek
száma.
Lásd még: Version Qualifiers; |
| forceContextQualifier : |
választható, az adott értéket
használja a .qualifier helyettesítésére a bedolgozók és szolgáltatások
által alkalmazott helyett. Lásd még: Version Qualifiers; |
| featureId : |
Az előállított szolgáltatás
azonosítója. |
| buildDirectory: |
a tartalmazandó szolgáltatásokat
és bedolgozókat (/features és /plugins
alkönyvtárakban) tartalmazó könyvtár. Az előállított szolgáltatás
a /features alkönyvtárba fog kerülni. |
| baseLocation : |
választható, telepített
szolgáltatásokat és bedolgozókat tartalmazó mappát jelöl; |
| productFile : |
választható; egy
termék fájl, amely az előállított szolgáltatás alapjául szolgál. |
| verify : |
Kell-e használni a
feloldót annak ellenőrzéséhez, hogy a megadott bedolgozók és
szolgáltatások elérhetők-e. Azt is meghatározza, hogy a
szolgáltatás helyesen fogja-e kezelni a platformfüggő töredékeket és
bedolgozókat, amelyek bekerülnek a JAR fájlba. Ha a szolgáltatásban
tartalmazni kívánt összes elem helyben elérhető, akkor a verify
tulajdonságnak True értéket kell megadni. Ha az elemeket lerakatból
kell lehívni, akkor a verify tulajdonságot állítsa False értékre, az
eredményül kapott szolgáltatással hívja le a szükséges bedolgozókat és
szolgáltatásokat, majd állítsa elő újra a tároló szolgáltatást verify =
True érték megadása mellett. |
| pluginPath : |
választható; a platformnak megfelelő elválasztóval elválasztott helyek listája, amelyeken további bedolgozókat lehet keresni. |
| configInfo : |
választható, a konfiguráció & jellel elválasztott listája a cél konfigurációt jelöli. Az alapértelmezés a platformfüggetlen beállítás; |
| pluginList : |
választható; az
előállított szolgáltatásban tartalmazni kívánt bedolgozó azonosítók
vesszővel elválasztott listája. (Támogatja attribútumok használatát, ezeket lásd
alább) |
| featureList : |
választható; az előállított
szolgáltatásban tartalmazni kívánt szolgáltatás azonosítók vesszővel
elválasztott listája. (Támogatja attribútumok használatát, ezeket lásd
alább) |
| fragmentList : |
választható; az előállított
szolgáltatásban tartalmazni kívánt töredék azonosítók vesszővel
elválasztott listája. (Támogatja attribútumok használatát, ezeket lásd
alább) |
| buildPropertiesFile : |
választható, a tulajdonságfájl
helye, amelynek tartalmát az előállított szolgáltatás build.properties
fájljaként kell használni. |
| includeLaunchers : |
választható,
szerepeljenek-e az equinox indítók vagy sem. Alapértelmezett érték:
true (igaz). |
Az eclipse.generateFeature feladat pluginList, featureList és fragmentList argumentumai mind támogatják az argumentumok használatát. Valamennyi argumentum a következő formájú:
List = <elem_azonosító>[;<attribútum>=<érték>]* [,<elem_azonosító>[;<attribútum>=<érték>]*]*
Minden attribútum=érték pár be lesz illesztve az előállított xml fájl adottelemébe. Példa:
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"/>
Az előzőleg leírt feladatok csak akkor működnek, ha az Eclipse fut. Egy olyan helyzetben, amikor az Ant parancsfájlokat Eclipse feladatok segítségével hajtja végre, a parancsfájlokat az Eclipse Ant Runner alkalmazás segítségével kell futtatni. Ennél az adott esetnél a parancssor a következő:
java -jar plugins/org.eclipse.equinox.launcher_<verzió>.jar -application org.eclipse.ant.core.antRunner -buildfile build.xml
Ne feledje, hogy az alkalmazás után lévő paramétereket kapja meg az Ant.