從指令行產生 Ant Script
Ant Script 通常是使用「外掛程式開發環境 (PDE)」來產生的,但也可以用手動方式或從其他 Script 產生它們。
PDE 確實會顯現 Ant 作業,以產生各種建置 Script。建置 Script 產生機能會常駐在下列作業中。
同時也會列出每一項作業適用的引數。
- eclipse.fetch:產生一個從 CVS 儲存庫提取內容的 Ant Script。
Eclipse 提取是由檔案驅動,底下有這個檔案格式的說明(請參閱目錄檔格式)。
elements:以逗點區隔的項目清單,列出將提取的項目。項目被預期具有目錄檔格式中指定的格式 type@id;
install:將移出的特性和外掛程式專案層入的目錄;
directory:目錄檔的名稱;
scriptname:所產生的 Script 的名稱;
children:(選用)指定是否應該呼叫為包含的外掛程式和片段所產生的 Script。預設值設為 true;
cvspassfile:(選用)CVS 密碼檔的名稱。
- eclipse.buildScript:產生給定的元素的 build.xml 檔。
elements:將建置且以逗點區隔的項目清單。項目被預期具有目錄檔格式中指定的格式 type@id;
install:將建置的特性和外掛程式所在的目錄;
children:(選用)指定是否應該呼叫為包含的外掛程式和片段所產生的 Script。預設值設為 true;
devEntries:(選用)以逗點區隔的目錄清單,這些目錄將給與編譯類別路徑。
pluginPath:(選用)以逗點區隔的 URL 清單,這些 URL 都指向已安裝的外掛程式。若指定的話,這個清單必須包括要編譯的外掛程式的整個清單。
範例
<eclipse.fetch elements="plugin@org.eclipse.core.boot"
install="c:\toBuild"
directory="directory.txt"
scriptname="fetch.xml"/>
<eclipse.buildScript elements="plugin@org.eclipse.core.boot"
install="c:\toBuild"/>
目錄檔格式
目錄檔是用來指出外掛程式和特性所在的位置,以及指出應該提取的版本。它是 Java 內容檔,其字行格式為 "type@id=version, repositoryLocation, password"。
- type
:說明元素類型的字串。它必須是下列其中之一:plugin、fragment、feature;
- id
:元素所在的 CVS 模組名稱。請注意,feature/plugin/fragment.xml 必須位在這個模組的根目錄中;
- version
:儲存庫中現有的版本標示;
- repositoryLocation
:CVS 儲存庫位置;
- password
:(選用)要連接至這個儲存庫的密碼。
目錄檔的範例
feature@org.eclipse.jdt.source=v20030114, :pserver:anonymous@dev.eclipse.org:/home/eclipse,
plugin@org.eclipse.core.boot=v20021215a, :pserver:anonymous@dev.eclipse.org:/home/eclipse,
plugin@org.eclipse.core.resources=v20030114, :pserver:anonymous@dev.eclipse.org:/home/eclipse,
fragment@org.eclipse.core.resources.win32=v20020911, :pserver:anonymous@dev.eclipse.org:/home/eclipse,
使用目標檔
僅在 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 的參數。