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。
預設值是 true;
|
baseLocation: |
選用,指出以 features/ 和 plugins/ 子目錄來包含目標 Eclipse 安裝的資料夾。 |
configInfo: |
選用,這是一份指出目標配置的配置清單(以 '&' 符號分隔)。 預設值是設為與平台無關; |
pluginPath: |
選用,這是從中尋找其他外掛程式的位置清單(以平台檔案分隔字元來分隔) |
archivesFormat: |
選用,這是一份配置及其預期輸出格式的清單(以 '&' 符號分隔)。 該格式在配置中會以橫線 (-) 區隔。支援的值如下:folder、tar、zip、antZip, 分別表示不保存、使用 tar 來建立保存檔、使用平台上可用的 info zip 版本、使用 ant zip。預設值為 antZip。 |
product: |
選用,這是所建置 RCP 產品的位置路徑(以 '/' 分隔)。 路徑的第一個區段必須參照含有 .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。(另請參閱版本限定元) |
generateFeatureVersionSuffix: | 選用,是否產生特性版本字尾。 |
groupConfiguration: |
選用,是否將所建置的所有配置分組到單一保存檔中。 |
generateVersionsLists: |
選用,是否產生列出所建置之特性和外掛程式版本的內容檔。 |
featureId: |
這個 ID 提供給產生的特性。 |
buildDirectory: |
要併入的特性和外掛程式(在子 /features 和 /plugins 目錄中)所在的目錄。
產生的特性會放在 /features 子目錄中。 |
baseLocation: |
選用,指出包含已安裝之特性和外掛程式的資料夾 |
productFile: |
選用,產生之特性的基礎產品檔。 |
verify: |
是否利用解析器來確認提供的外掛程式和特性可以使用。
另外,這也決定了特性是否能夠正確處理將用 JAR 壓縮的特定平台專用片段和外掛程式。
如果本端環境提供了要併入特性的所有元素,verify 便應該設為 True。
如果必須從儲存庫中提取這些元素,請將 verify 設為 False,利用產生的特性來提取必要的外掛程式和特性,再利用 verify = True 來重新產生儲存檔案特性。
|
pluginPath: |
選用,這是從中尋找其他外掛程式的位置清單(以平台檔案分隔字元來分隔) |
configInfo: |
選用,這是一份指出目標配置的配置清單(以 '&' 符號分隔)。預設值是設為與平台無關; |
pluginList: |
選用,這是一份將併入產生的特性之外掛程式 ID 的清單(以逗點分隔)。 |
featureList: |
選用,這是一份將併入產生的特性之特性 ID 的清單(以逗點分隔)。 |
fragmentList: |
選用,這是一份將併入產生的特性之片段 ID 的清單(以逗點分隔)。 |
<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 的參數。