整體建置機制是由建置器配置來驅動的,建置器配置含有 build.properties 檔。
buildDirectory |
建置作業所在的目錄。 |
configs |
要建置的配置清單。
配置是一份作業系統、視窗系統和架構(用逗點分隔)的清單(用 '&' 符號分隔)。
如果未指定任何配置,就會建置不關聯於特定平台的配置。
範例:
configs = win32, win32, x86 & linux, gtk, ppc |
baseLocation |
目標 Eclipse 安裝的位置。
在預設範本中,這個值是 ${base}/eclipse。
(請參閱下列基本內容)。
這個目錄預期會包含 plugins/ 和 features/ 子目錄,分別含有二進位外掛程式和特性。 |
baseos |
baseLocation 所指定之 Eclipse 的作業系統 |
basews |
baseLocation 所指定之 Eclipse 的視窗系統 |
basearch |
baseLocation 所指定之 Eclipse 的架構 |
pluginPath |
用來尋找其他外掛程式和特性的位置清單(用平台路徑分隔字元分隔)。 |
skipBase |
如果設定的話,會自動下載基本 Eclipse 來作為目標 |
base |
將下載基本 Eclipse 的目標位置。
這應該是 baseLocation 的母項,因此,baseLocation = ${base}/eclipse。 |
eclipseURL |
Eclipse 下載網站的 URL |
eclipseBuildId |
要下載之 Eclipse 的建置 ID |
eclipseBaseURL |
要下載之 ZIP 的實際 URL。在預設範本中,這個值如下:eclipseBaseURL = ${eclipseURL}/eclipse-platform-${eclipseBuildId}-win32.zip |
runPackager |
設定是否需要執行套裝程式。如果您的建置結果必須包含來自 baseLocation 的二進位特性和外掛程式。 |
product |
產品配置檔。如果您在建置產品,請設定這個內容。
它會控制建置結果的品牌行銷。 |
archiveNamePrefix |
最終保存檔的名稱字首。當在個別配置的基礎上設定保存檔名稱時,在 allElements.xml 中使用這個內容。
依預設,這個值是 ${buildId} |
archivePrefix |
保存檔根資料夾的名稱,Eclipse 建置的這個內容是 "eclipse"。 |
buildType | 建置類型,通常是 I、N、M 等之類的東西。 |
buildLabel | 建置的標籤。在預設範本中,這個值是 ${buildType}.${buildId} |
collectingFolder |
收集建置輸出的資料夾。在預設範本中,這個值是 ${archivePrefix}。 |
groupConfigurations |
是否將所有配置分組成單一保存檔。 |
archivesFormat |
所建置之不同配置的保存格式。
這是一份配置及其保存格式的清單(以 '&' 符號分隔)。
格式用橫線 (-) 分隔。
範例:archivesFormat = win32, win32, x86 - antzip & linux, gtk, ppc - tar |
OutputUpdateJars |
當設定時,以更新網站的 JAR 格式來產生外掛程式和特性。 |
zipArgs |
當保存格式是 ZIP 時,要傳給 ZIP 執行檔的引數。 |
tarArgs |
當保存格式是 TAR 時,要傳給 TAR 執行檔的引數。 |
generateJnlp |
設為 true 會產生 JAR 保存檔的 JNLP Manifest。 |
jnlp.codebase |
網站 URL。這應該是在輸出中,用來作為所有相對 URL 之根的 URL。 |
jnlp.j2se |
J2SE 版本 |
signJars |
設為 true 會簽章特性和外掛程式的 JAR。 |
sign.alias |
傳給 Ant signJar 作業的別名。 |
sign.keystore |
傳給 Ant signJar 作業的金鑰儲存庫。 |
sign.storepass |
傳給 Ant signJar 作業的 storepass。 |
forceContextQualifier |
當取代外掛程式和特性版本中的限定元時,便使用這個內容值。
如果設定的話,就會用它來取代對映檔或時間戳記的標示。 |
generateFeatureVersionSuffix |
設為 true 會產生特性版本字尾 |
generateVersionsLists |
設為 true 會產生列出所建置的特性和外掛程式之最終版本號碼的內容檔。
這會在建置器目錄中,建立 finalFeaturesVersions.properties 和 finalPluginsVersions.properties 檔。 |
skipMaps |
如果設定的話,請勿嘗試從 CVS 提取對映檔 |
mapsRepo |
要從中提取對映檔的 CVS 儲存庫。範例::pserver:anonymous@example.com/path/to/repo |
mapsRoot |
在 CVS 儲存庫中,通往對映檔所在目錄的路徑 |
mapsCheckoutTag |
用來移出對映檔的 CVS 標示 |
tagMaps |
設為 true 會在提取對映檔之後,標示這些對映檔 |
mapsTagTag |
在提取對映檔之後,用來標示這些對映檔的標示。 |
skipFetch |
設為 true 會跳過整個提取階段。 |
fetchTag |
從 CVS 提取特性和外掛程式時所用的標示。
這個內容會置換對映檔的值。 |
logExtension |
產生之日誌檔的副檔名。只在使用預設 JDT 編譯器時,才適用。預設值是 ".log"。 |
javacDebugInfo |
是否將除錯資訊併入輸出 JAR 中。
這會傳給 Ant javac 作業。
如果未設定,預設值是 on。
|
javacFailOnError |
如果發生編譯錯誤,是否使建置失敗。這會傳給 Ant javac 作業。
如果未設定,預設值是 true。 |
javacVerbose |
是否啟用編譯器的詳細模式。
這會傳給 Ant javac 作業。
如果未設定,預設值是 false。 |
compilerArg |
設定要直接傳給編譯器的特定引數。 |
javacSource |
當外掛程式未指定任何設定時,所用的 Java 原始程式相容性層次。
如果未設定,預設值是 1.3。 |
javacTarget |
當外掛程式未指定任何設定時,所用的目標 .class 相容性層次。
如果未設定,預設值是 1.2。 |
bootclasspath |
當外掛程式本身未指定任何設定時,所用的 bootclasspath。
這是一份 JAR 清單,以平台路徑分隔字元分隔。
如果未設定,就會使用符合 ${java.home}/jre/lib/*.jar 的檔案集。 |
<Execution Environment> |
設定可用來建置的每個 JRE 的內容。 這些內容會比對個別軟體組所指定的「執行環境」。 這些值應該指定使用這個環境時,編譯所針對的 JAR。 請參閱控制編譯環境。 |