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 czynności programu Ant do generowania dostępnych skryptów budowania. Generowanie skryptów budowania realizują niżej opisane czynności. Dla każdej czynności podano także jej argumenty.
elements: |
pobierany wpis. Wpis powinien mieć format typ@id 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 zgodnie z formatem pliku katalogów. |
buildDirectory : |
katalog zawierający składniki i wtyczki do zbudowania; |
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 klasy 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 : |
rozdziela 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ścią domyślną jest 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 czynności 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ścią domyślną jest false. Należy pamiętać, że plik site.xml nie jest generowany ani aktualizowany |
forceContextQualifier : |
używa podanej wartości do zastąpienia pola .qualifier przez wtyczkami i składnikami (argument opcjonalny). (patrz także Kwalifikatory wersji) |
generateFeatureVersionSuffix: | określa, czy ma być generowany przyrostek wersji składnika (argument opcjonalny). |
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. |
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). |
featureList : |
rozdzielona przecinkami lista identyfikatorów składników, które mają być dołączone do generowanego składnika (argument opcjonalny). |
fragmentList : |
rozdzielona przecinkami lista identyfikatorów fragmentów, które mają być dołączone do generowanego składnika (argument opcjonalny). |
<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"/>
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 czynności 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 -cp startup.jar org.eclipse.core.launcher.Main -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.