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 type@id[,version], 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 type@id[,version], jak jej specifikuje formát souboru adresáře. |
| buildDirectory : |
Adresář, kde budou umístěny funkce a moduly plug-in, které se mají sestavit. Moduly plug-in a funkce musejí být umístěny ve složkách plugins resp. features. |
| 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 aktualizace. Výchozí hodnota je false. Pamatujte, že site.xml se negeneruje ani neaktualizuje. |
| 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. |
| filteredDependencyCheck : |
Volitelné, omezení sady modulů plug-in a funkcí
uvažovaných během sestavení na ty, které budou dosažitelné z funkcí. |
| filterP2Base : |
Volitelné, omezení sady modulů plug-in a funkcí
uvažovaných z baseLocation na ty, které jsou uvažovány jako nainstalované pomocí p2. |
| generateFeatureVersionSuffix: | Volitelné, určuje, zda bude generována přípona verze funkce. Viz také Kvalifikátory verzí; |
| generatedVersionLength : |
Volitelné, délka generované přípony verze funkce. Standardně je nastavena na 28. Viz také Kvalifikátory verzí; |
| significantVersionDigits : |
Volitelné, počet významných číslic použitých při generování přípon verzí funkce.
Viz také Kvalifikátory verzí; |
| forceContextQualifier : |
Volitelné, používá
zadanou hodnotu k nahrazení .qualifier moduly plug-in a funkcemi. Viz také Kvalifikátory verzí; |
| 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 vyhodnocovací modul. 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ěli byste ověřit nastavení hodnoty 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. (Podporuje atributy, viz níže) |
| featureList : |
Volitelné, seznam ID funkcí oddělených čárkami, které mají být zahrnuty do generované funkce. (Podporuje atributy, viz níže) |
| fragmentList : |
Volitelné, seznam ID fragmentů oddělených čárkami, které mají být zahrnuty do generované funkce. (Podporuje atributy, viz níže) |
| buildPropertiesFile : |
Volitelné, umístění souboru vlastností, jehož obsah by měl být použit jako soubor build.properties generované funkce. |
| includeLaunchers : |
Volitelné, zda mají být zahrnuty spouštěcí programy equinox či nikoli, výchozí hodnota je "true". |
Všechny argumenty pluginList, featureList a fragmentList úlohy eclipse.generateFeature podporují atributy. Všechny tyto atributy mají formu:
List = <element-id>[;<attribute>=<value>]* [,<element-id>[;<attribute>=<value>]*]*
Každý atribut=dvojice hodnot bude vložen do vygenerovaného xml odpovídajícího danému prvku. Příklad:
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"/>
Ú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 -jar plugins/org.eclipse.equinox.launcher_<version>.jar -application org.eclipse.ant.core.antRunner -buildfile build.xml
Všimněte si, že parametry, které se uvádějí za aplikací, jsou parametry, které se předávají nástroji Ant.