整體建置機制是由建置器配置來驅動的,建置器配置含有 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。 請參閱控制編譯環境。 |