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 : a lerakatból beolvasandó 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ú;
baseLocation : választható, telepített szolgáltatásokat és mappákat tartalmazó mappát jelöl;
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 telepített bedolgozókra mutató URL-ek vesszővel elválasztott listája. Ha meg van adva, ennek a listának tartalmaznia kell a lefordítandó bedolgozók teljes listáját;
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.
<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.