Skrypty programu Ant są najczęściej generowane przy użyciu środowiska PDE, ale można także generować je samodzielnie lub przy użyciu innych skryptów.
W praktyce środowisko PDE dostarcza zadania programu Ant do generowania dostępnych skryptów budowania.
Generowanie skryptów budowania realizuje niżej opisane zadania. Dla każdego zadania podano także jej argumenty.
| elements: |
pobierany wpis. Wpis powinien mieć format typ@id[,wersja] zgodnie z formatem pliku katalogów. |
| buildDirectory: |
katalog, do którego zostaną wygenerowane skrypty pobierania i w którym zostaną umieszczone pobrane projekty składników i wtyczek; |
| directory: |
ścieżka do pliku katalogów; |
| children: |
określa, czy ma być wywoływane generowanie skryptów dla zawartych wtyczek i fragmentów (argument opcjonalny). Wartość domyślna to true. |
| cvspassfile: |
nazwa pliku haseł CVS (argument opcjonalny); |
| fetchTag: |
zastępuje znacznik w pliku katalogów podaną wartością (argument opcjonalny); |
| configInfo: |
rozdzielona znakami ampersand lista konfiguracji stanowiąca konfigurację docelową (argument opcjonalny). Wartość domyślna jest niezależna od platformy. |
| recursiveGeneration: |
określa, czy dla składników zagnieżdżonych mają być generowane skrypty pobierania (argument opcjonalny). Wartość domyślna to true. |
| elements: |
budowany wpis. Wpis powinien mieć format typ@id[,wersja] zgodnie z formatem pliku katalogów. |
| buildDirectory: |
katalog zawierający składniki i wtyczki do zbudowania. Wtyczki i składniki muszą znajdować się odpowiednio w folderach plugins i features. |
| children: |
określa, czy ma być wywoływane generowanie skryptów dla zawartych wtyczek i fragmentów (argument opcjonalny). Wartość domyślna to true. |
| recursiveGeneration: |
określa, czy ma być wywoływane generowanie skryptów dla zawartych składników (argument opcjonalny). Wartość domyślna to true. |
| devEntries: |
rozdzielona przecinkami lista katalogów, które należy dodać do ścieżki klas kompilacji (argument opcjonalny); |
| buildingOSGi: |
wskazuje czy element docelowy jest w wersji 3.x. czy 2.1 (argument opcjonalny).Wartość domyślna to true; |
| baseLocation: |
wskazuje folder zawierający docelową instalację produktu Eclipse wraz z podkatalogami features/ i plugins/ (argument opcjonalny). |
| configInfo: |
rozdzielona znakami ampersand lista konfiguracji stanowiąca konfigurację docelową (argument opcjonalny). Wartość domyślna jest niezależna od platformy. |
| pluginPath: |
rozdzielona separatorami pliku platformy lista położeń zawierających dodatkowe wtyczki (argument opcjonalny). |
| archivesFormat: |
rozdzielona znakami ampersand lista konfiguracji i oczekiwanych formatów danych wyjściowych dla każdej konfiguracji (argument opcjonalny). Format jest oddzielany od konfiguracji znakiem myślnika (-). Obsługiwane są następujące formaty: folder, tar, zip, antZip, które mają odpowiednio znaczenia: nie twórz archiwum, używaj formatu tar do tworzenia archiwum, używaj formatu zip udostępnianego przez platformę, używaj formatu Ant zip do tworzenia archiwum. Wartość domyślna to antZip. |
| product: |
rozdzielona znakami "/" ścieżka do położenia budowanego produktu RCP (argument opcjonalny). Pierwszy segment ścieżki musi odwoływać się do identyfikatora wtyczki zawierającej plik .product. |
| signJars: |
określa, czy generowane skrypty muszą podpisywać pliki JAR składników i wtyczek (argument opcjonalny). Wartość domyślna to false. Parametry czynności podpisywania są kontrolowane przez następujące właściwości Ant: sign.alias, sign.keystore oraz sign.storepass i odpowiednio przekazywane parametrom: alias, keystore, storepass zadania signJar programu Ant. Wartością domyślną jest false. |
| generateJnlp: |
określa, czy plik JNLP powinien być generowany dla wszystkich budowanych składników (argument opcjonalny). |
| outputUpdateJars: |
jeśli jest ustawiony, powoduje generowanie wtyczek i składników w formacie serwisu aktualizacji (argument opcjonalny). Wartość domyślna to false. Należy pamiętać, że plik site.xml nie jest generowany ani aktualizowany. |
| groupConfiguration
: |
określa, czy wszystkie budowane konfiguracje mają być zebrane w jednym archiwum (argument opcjonalny). |
| generateVersionsLists: |
określa, czy mają być generowane pliki właściwości zawierające wykazy wersji zbudowanych składników i wtyczek (argument opcjonalny). |
| filteredDependencyCheck: |
ogranicza zestaw wtyczek i
składników uwzględnianych podczas budowania do tego, który jest dostępny ze składników (argument opcjonalny). |
| filterP2Base: |
ogranicza zestaw wtyczek i
składników uwzględnianych z położenia baseLocation do tych, które są
uwzględniane do zainstalowania przez system p2 (argument opcjonalny). |
| generateFeatureVersionSuffix: | określa, czy ma być generowany przyrostek wersji składnika (argument opcjonalny). Patrz także Kwalifikatory wersji. |
| generatedVersionLength: |
długość wygenerowanego przyrostka wersji składnika (argument opcjonalny). Domyślnie wynosi 28. Patrz także Kwalifikatory wersji. |
| significantVersionDigits: |
liczba cyfr znaczących wykorzystywana przy generowaniu przyrostków wersji składników (argument opcjonalny).
Patrz także Kwalifikatory wersji. |
| forceContextQualifier: |
używa podanej wartości do zastąpienia pola .qualifier przez wtyczkami i składnikami (argument opcjonalny). Patrz także Kwalifikatory wersji. |
| featureId: |
identyfikator nadawany generowanemu składnikowi. |
| buildDirectory: |
katalog zawierający dołączane składniki i wtyczki (w podkatalogach /features i /plugins).Wygenerowany składnik zostanie zapisany w podkatalogu /features. |
| baseLocation: |
wskazuje folder zawierający zainstalowane składniki i wtyczki (argument opcjonalny). |
| productFile: |
plik produktu stanowiący podstawę generowanego składnika (argument opcjonalny). |
| verify: |
określa, czy do sprawdzenia dostępności dostarczonych wtyczek i składników ma być użyty analizator.Od wartości argumentu zależy też możliwość poprawnego obsłużenia przez składnik zależnych od platformy fragmentów i wtyczek dostarczanych w archiwum JAR. Jeśli wszystkie elementy dołączane do składnika są dostępne lokalnie, wartością argumentu verify powinno być True.Jeśli elementy muszą być pobierane z repozytorium, należy dla argumentu verify ustawić wartość False, za pomocą wynikowego składnika pobrać wymagane wtyczki i składniki, a następnie ponownie wygenerować składnik zewnętrznych używając ustawienia verify = True. |
| pluginPath: |
rozdziela separatorami pliku platformy lista położeń zawierających dodatkowe wtyczki (argument opcjonalny) |
| configInfo: |
rozdzielona znakami ampersand lista konfiguracji stanowiąca konfigurację docelową (argument opcjonalny). Wartość domyślna jest niezależna od platformy. |
| pluginList: |
rozdzielona przecinkami lista
identyfikatorów wtyczek, które mają być dołączone do generowanego składnika
(argument opcjonalny). Obsługuje atrybuty. Informacje na ten temat zamieszczono poniżej. |
| featureList: |
rozdzielona przecinkami lista identyfikatorów składników, które mają być dołączone do generowanego składnika (argument opcjonalny). Obsługuje atrybuty. Informacje na ten temat zamieszczono poniżej. |
| fragmentList: |
rozdzielona przecinkami lista identyfikatorów fragmentów, które mają być dołączone do generowanego składnika (argument opcjonalny). Obsługuje atrybuty. Informacje na ten temat zamieszczono poniżej. |
| buildPropertiesFile: |
położenie pliku właściwości, który
ma być użyty jako plik build.properties generowanego składnika (argument
opcjonalny). |
| includeLaunchers: |
określa, czy mają być dołączone
programy uruchamiające Equinox (argument opcjonalny). Wartość domyślna to true. |
Argumenty pluginList, featureList i fragmentList zadania eclipse.generateFeature obsługują atrybuty. Argumenty mają następującą postać:
Lista = <identyfikator_elementu>[;<atrybut>=<wartość>]* [,<identyfikator_elementu>[;<atrybut>=<wartość>]*]*
Każda para atrybut=wartość zostanie wstawiona do wygenerowanego pliku xml odpowiadającego danemu elementowi. Przykład:
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:\do_zbudowania"
directory="katalog.txt"
configInfo="win32,win32,x86 & linux, motif, x86"
/>
<eclipse.buildScript elements="bundle@org.eclipse.osgi"
buildDirectory="c:\do_zbudowania"
archivesFormat="macosx, carbon, ppc - tar"/>
Czynności opisane poprzednio są dostępne tylko wtedy, gdy platforma Eclipse jest uruchomiona. W konkretnym scenariuszu wykonywania skryptów programu Ant przy użyciu zadań platformy Eclipse skrypty muszą być uruchamiane przy użyciu aplikacji Eclipse Ant Runner. Wiersz komend w tym konkretnym przypadku wygląda następująco:
java -jar plugins/org.eclipse.equinox.launcher_<wersja>.jar -application org.eclipse.ant.core.antRunner -buildfile build.xml
Należy zauważyć, że parametry występujące po nazwie aplikacji to parametry przekazywane do programu Ant.