建置特性

「PDE 建置」隨附了自動建置特性的基礎架構。 您只需要稍微修改 PDE 建置所提供的 build.properties 範本,便可以完成這類建置大部分必要的設定。 下一節的焦點是設定簡式建置,它假設本端磁碟提供了建置中的特性所參照的所有外掛程式和特性(即將建置和預先建置都包括在內)。

基本設定

建置配置目錄

設定建置的第一步是建立建置配置目錄。這是控制並自訂遠端控制建置的檔案所存放的目錄。

控制建置的主要檔案是最上層的建置配置檔 build.properties。在設定新的建置時,請在要用來執行建置的 Eclipse 安裝中,從 org.eclipse.pde.build 軟體組複製範本檔。範本檔位於 org.eclipse.pde.build/templates/headless-build/build.properties 下。

builder 內容會參照這個目錄,且通常會在 ant 指令行中設定。

buildDirectory

buildDirectory 內容會指定「PDE/建置」會在其中產生 Script 並執行實際建置的目錄。要建置的外掛程式和特性應該放在 ${buildDirectory}/plugins 和 ${buildDirectory}/features 子目錄中。 如果要從儲存庫提取軟體組和特性(請參閱從儲存庫提取),其也會放在此處。

這個目錄可能會與建置配置目錄相同,也可以是不同的目錄。您可能想要使用個別的目錄,特別是如果建置配置是以 CVS 保存,而您不要它受已產生的建置構件影響。

起始內容

如果要設定基本特性建置,您需要編輯建置配置檔 build.properties,並設定下列內容:

舊版的「PDE/建置」也需要有 allElements.xml 檔,但 3.4 版則不再需要。您仍然可以使用 allElements.xml,但只有在想要自訂建置的某些層面時才需要。請參閱自訂遠端控制建置。

執行建置

如果要執行建置,您將使用 org.elipse.ant.core.antRunner 應用程式。 當利用這個應用程式呼叫 Eclipse 來執行建置時,您必須在指令行設定兩個引數:

請利用下列指令來執行 antRunner 應用程式:


java -jar <eclipseInstall>/plugins/org.eclipse.equinox.launcher_<version>.jar -application org.eclipse.ant.core.antRunner -buildfile <<eclipseInstall>/plugins/org.eclipse.pde.build_<version>/scripts/build.xml> -Dbuilder=<path to the build configuration folder>

建置完成之後,您可以在名稱為 I.TestBuild(您可以設定 buildLabel 內容來配置這個名稱)之資料夾的建置目錄中取得結果。

進階實務

如果建置需要進一步的自訂,也就是從儲存庫中進行提取,請參閱「進階 PDE 建置」主題,以取得相關資訊。