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.