Ant Script 通常是使用「外掛程式開發環境 (PDE)」來產生的,但也可以用手動方式或從其他 Script 產生它們。
PDE 確實會顯現 Ant 作業,以產生各種建置 Script。建置 Script 產生機能會常駐在下列作業中。
同時也會列出每一項作業適用的引數。
elements:會提取的項目。預期的格式為目錄檔格式中指定的 type@id 格式;
buildDirectory:提取 Script 會在這個目錄下產生,而且特性和外掛程式專案也會移出到這個目錄下;
directory:通往目錄檔案的路徑;
children:(選用)指定是否應該呼叫為包含的外掛程式和片段所產生的 Script。預設值設為 true;
cvspassfile:(選用)CVS 密碼檔的名稱;
fetchTag:(選用)可以置換目錄檔中由某個給定值所提供的標示;
configInfo:(選用)指出目標配置,且以 '&' 符號區隔的配置清單。預設值是設為與平台無關;
recursiveGeneration:(選用)指定是否應產生巢狀特性的提取 Script。預設值會設為 true。
elements:要從儲存庫提取的項目。 項目預期的格式為目錄檔格式中指定的 type@id 格式;
buildDirectory:要建置的特性和外掛程式所在的目錄;
children:(選用)指定是否應該呼叫為包含的外掛程式和片段所產生的 Script。預設值設為 true;
recursiveGeneration:(選用)可指定是否應呼叫產生所含特性的 Script。 預設值設為 true;
devEntries:(選用)要提供給編譯類別路徑,並以逗點區隔的目錄清單;
buildingOSGi:(選用)指出目標是 3.x. 或 2.1;
baseLocation:(選用)指出含有已安裝的特性和資料夾的資料夾;
configInfo:(選用),以 '&' 符號區隔的配置清單,這份清單會指出目標配置。 預設值是設為與平台無關;
pluginPath:(選用)以逗點區隔的 URL 清單,這些 URL 都指向已安裝的外掛程式。如果指定,這份清單必須併入整個要編譯的外掛程式清單;
archivesFormat:(選用)以 '&' 符號區隔的配置清單,以及每一個配置預期的輸出格式。該格式在配置中會以橫線 (-) 區隔。支援的值如下:folder、tar、zip、antZip, 分別表示不保存、使用 tar 來建立保存檔、使用平台上可用的 info zip 版本、使用 ant zip。預設值為 antZip。
product:(選用)以 '/' 區隔的路徑,指向要建置之 RPC 產品的位置。路徑的第一個區段必須參照含有 .product 檔之外掛程式的外掛程式 ID。
signJars:(選用)指出產生的 Script 是否必須簽章特性和外掛程式的 JAR。預設值是 false。簽章作業的參數係由下列 Ant 內容控制: sign.alias、sign.keystore 和 sign.storepass,會分別傳給 Ant signJar 作業的 alias、keystore 和 storepass 參數。預設值是 False。
generateJnlp:(選用)指出是否應對所有要建置的特性產生 jnlp 檔。
outputUpdateJars:(選用)如果設定,則以更新網站格式產生外掛程式和特性。預設值是 false。請注意,site.xml 不會產生也不會更新。
forceContextQualifier:(選用)使用給定的值來取代外掛程式和特性使用的 .qualifier。
<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"/>
僅在 Eclipse 執行中時,先前說明的作業才能運作。在使用 Eclipse 作業執行 Ant Script 的特殊實務中, 必須使用「Eclipse Ant 執行器」應用程式來執行 script。這個特殊實例的指令行如下:
java -cp startup.jar org.eclipse.core.launcher.Main -application org.eclipse.ant.core.antRunner -buildfile build.xml
請注意,出現在應用程式之後的參數是傳給 Ant 的參數。