Az Ant parancsfájlok létrehozására általában a Plug-in Development Environment
(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 látható
az egyes feladatoknál.
elements: |
a beolvasandó bejegyzés. A bejegyzéseknek típus@azonosító formátumban kell lenniük, ahogy 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 kerülnek; |
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 igaz; |
cvspassfile: |
választható, a CVS jelszófájl neve; |
fetchTag: |
választható, felülbírá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élzott 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 beolvasási parancsfájlokat. Az alapértelmezett érték az igaz. |
elements: |
az összeépítendő bejegyzés. A bejegyzésnek típus@azonosító formátumban kell lennie, ahogy azt a könyvtárfájl formátuma meghatározza; |
buildDirectory : |
az a könyvtár, ahol az összeépítendő szolgáltatások és bedolgozók találhatók; |
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 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 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 verziójú. Az
alapértelmezett érték a true; |
baseLocation : |
választható; megad egy mappát, amely tartalmazza a cél eclipse telepítést a features/ és plugins/ alkönyvtárakkal. |
configInfo : |
választható, a konfiguráció & jellel elválasztott listája a célzott konfigurációt jelöli. Az alapértelmezés a platformfüggetlen beállítás; |
pluginPath : |
választható; a platformnak megfelelő elválasztóval elválasztott helyek listája, amelyeken további bedolgozókat lehet keresni. |
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: mappa, 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 az 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ő szegmense a .product fájlt tartalmazó bedolgozó bedolgozó azonosítójára kell utaljon. |
signJars : |
választható, megmutatja, hogy az előállított parancsfájlok alá kell-e írják a jar fájlokat szolgáltatásokhoz és bedolgozókhoz. Az alapértelmezett érték a false. Az 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. |
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. Megjegyzés: a site.xml nem lesz előállítva és frissítve sem. |
forceContextQualifier : |
választható, az adott értéket
használja a .qualifier helyettesítésére a bedolgozók és szolgáltatások
által. (Lásd még: Verzió minősítők) |
generateFeatureVersionSuffix: | választható; megadja, hogy elő kell-e állítani a szolgáltatás verzió utótagját. |
groupConfiguration
: |
választható; megadja,
hogy az összes összeépített 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. |
featureId : |
Az előállított szolgáltatás
azonosítója. |
buildDirectory: |
az a könyvtár, amelyik a
tartalmazni kívánt szolgáltatásokat és bedolgozókat tartalmazza (a
/features és /plugins alkönyvtárakban). 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élzott 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. |
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. |
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. |
<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. Az Ant parancsfájlok Eclipse feladatok segítségével történő végrehajtásának adott esetében 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 -cp startup.jar org.eclipse.core.launcher.Main -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.