Skripty Ant se typicky generují pomocí vývojového prostředí modulů plug-in (PDE), ale rovněž je lze
generovat ručně nebo z jiných skriptů.
Prostředí PDE ve skutečnosti odkrývá úlohy Ant pro generování různých skriptů sestavení. Systémové prostředky pro generování skriptů sestavení se nachází v následujících úlohách. Pro každou úlohu jsou rovněž uvedeny argumenty.
| elements: |
Položka, která bude načtena. Očekává se, že položky budou mít formát typ@id, jak jej specifikuje formát souboru adresáře. |
| buildDirectory: |
Adresář, do kterého se vygenerují skripty načtení a do kterého budou zapůjčeny funkce a projekty modulů plug-in; |
| directory: |
Cesta k souboru adresáře; |
| children: |
Volitelné, určuje, zda se má vyvolat generování skriptů pro obsažené moduly plug-in a fragmenty. Výchozí hodnota je true. |
| cvspassfile: |
Volitelné, název souboru hesel CVS; |
| fetchTag: |
Volitelné, daná hodnota potlačí značku poskytnutou v souboru adresáře; |
| configInfo: |
Volitelné, seznam konfigurací oddělených znaky ampersand označující zaměřenou konfiguraci. Výchozí nastavení je nezávislé na platformě. |
| recursiveGeneration: |
Volitelné, uveďte, zda se mají pro vnořené funkce generovat skripty načtení. Výchozí hodnota je true. |
| elements : |
Položka k sestavení. Očekává se, že položka bude mít formát typ@id, jak jej specifikuje formát souboru adresáře. |
| buildDirectory : |
Adresář, kde budou umístěny funkce a moduly plug-in; |
| children : |
Volitelné, určuje, zda se má vyvolat generování skriptů pro obsažené moduly plug-in a fragmenty. Výchozí hodnota je true. |
| recursiveGeneration : |
Volitelné, určuje, zda se má vyvolat generování skriptu pro obsažené funkce. Výchozí hodnota je true. |
| devEntries : |
Volitelné, seznam adresářů oddělených čárkami, které se mají dát do cesty ke třídě kompilace; |
| buildingOSGi : |
Volitelné, označuje, zda je cílovou verzí 3.x. nebo 2.1. Výchozí hodnota je true; |
| baseLocation : |
Volitelné, označuje složku obsahující cílovou instalaci Eclipse s podadresáři features/ a plugins/. |
| configInfo : |
Volitelné, seznam konfigurací oddělených znaky ampersand označuje zaměřenou konfiguraci. Výchozí nastavení je nezávislé na platformě. |
| pluginPath : |
Volitelné, seznam umístění oddělených oddělovačem souborů specifickým pro platformu, v nichž se mají hledat přídavné moduly plug-in |
| archivesFormat : |
Volitelné, seznam konfigurací oddělených znakem ampersand a očekávaný výstupní formát pro každou z nich. Formát je od konfigurace oddělen pomlčkou (-). Podporované hodnoty jsou: folder, tar, zip, resp. antZip, což znamená nearchivovat, k vytvoření archivu použít soubor tar, použít verzi info zip dostupnou na platformě, použít ant zip . Výchozí hodnota je antZip. |
| product : |
Volitelné, cesta k umístění sestavovaného produktu RCP, oddělená '/'. První segment cesty musí odkazovat na ID modulu plug-in id obsahujícího soubor .product. |
| signJars : |
Volitelné, označuje, zda generované skripty musí podepsat soubory JAR pro funkce a moduly plug-in. Výchozí hodnota je false. Parametry pro úlohu podepsání jsou řízeny následujícími vlastnostmi ant: sign.alias, sign.keystore resp. sign.storepass se předávají do parametrů alias, parametry keystore a storepass z nástroje ant úloha signJar. Výchozí hodnota je false. |
| generateJnlp : |
Volitelné, označuje, zda se má soubor jnlp generovat pro všechny sestavované funkce. |
| outputUpdateJars : |
Volitelné, je-li nastaven, generuje moduly plug-in a funkce ve formátu webu s aktualizacemi. Výchozí hodnota je false. Uvědomte si, že site.xml není ani generován, ani aktualizován. |
| forceContextQualifier : |
Volitelné, používá
zadanou hodnotu k nahrazení .qualifier moduly plug-in a funkcemi. (Viz také Kvalifikátory verzí) |
| generateFeatureVersionSuffix: | Volitelné, určuje, zda bude generována přípona verze funkce. |
| groupConfiguration
: |
Volitelné, určuje, zda budou všechny sestavované konfigurace seskupeny do jediného archivu. |
| generateVersionsLists : |
Volitelné, určuje, zda budou generovány soubory vlastností se seznamem verzí funkcí a modulů plug-in, které byly sestaveny. |
| featureId : |
ID, které bude poskytnuto generované funkci. |
| buildDirectory: |
Adresář, kde jsou umístěny funkce
a moduly plug-in (v podadresářích /features a /plugins), které mají být zahrnuty. Generovaná funkce bude umístěna do podadresáře /features. |
| baseLocation : |
Volitelné, označuje složku, který obsahuje instalované funkce a moduly plug-in |
| productFile : |
Volitelné, soubor produktu, na kterém bude založena generovaná funkce. |
| verify : |
Určuje, zda bude k ověření dostupnosti poskytnutých modulů plug-in a funkcí použit resolver. Rovněž určuje, zda bude funkce schopna správně ošetřit fragmenty pro specifickou platformu a moduly plug-in, které budou archivovány do souboru JAR. Jsou-li všechny prvky zahrnuté ve funkci dostupné lokálně, měla by být hodnota nastavena na true. Pokud prvky vyžadují načtení z úložiště, nastavte verify na hodnotu false, použijte výslednou funkci k načtení požadovaných modulů plug-in a funkcí a potom regenerujte kontejner s použitím verify = True. |
| pluginPath : |
Volitelné, seznam umístění oddělených oddělovačem souborů specifickým pro platformu, v nichž se mají hledat přídavné moduly plug-in |
| configInfo : |
Volitelné, seznam konfigurací oddělených znaky ampersand označuje zaměřenou konfiguraci. Výchozí nastavení je nezávislé na platformě. |
| pluginList : |
Volitelné, seznam ID modulů plug-in oddělených čárkami, které mají být zahrnuty do generované funkce. |
| featureList : |
Volitelné, seznam ID funkcí oddělených čárkami, které mají být zahrnuty do generované funkce. |
| fragmentList : |
Volitelné, seznam ID fragmentů oddělených čárkami, které mají být zahrnuty do generované funkce. |
<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"/>
Úlohy popsané v předchozí části fungují pouze tehdy, je-li platforma Eclipse spuštěna. V konkrétním scénáři provádění skriptů Ant pomocí úloh platformy Eclipse se skripty musí spouštět s použitím aplikace Eclipse Ant Runner. Příkazový řádek je v rámci tohoto konkrétního příkladu následující:
java -cp startup.jar org.eclipse.core.launcher.Main -application org.eclipse.ant.core.antRunner -buildfile build.xml
Vezměte na vědomí, že parametry, které se uvádějí za aplikací, jsou parametry, které se předávají nástroji Ant.