「PDE 建置」隨附了自動建置特性的基礎架構。 您只需要稍微修改 PDE 建置所提供的 build.properties 範本,便可以完成這類建置大部分必要的設定。 下一節的焦點是設定簡式建置,它假設本端磁碟提供了建置中的特性所參照的所有外掛程式和特性(即將建置和預先建置都包括在內)。
設定建置的第一步是建立建置配置目錄。這是控制並自訂遠端控制建置的檔案所存放的目錄。
控制建置的主要檔案是最上層的建置配置檔 build.properties。在設定新的建置時,請在要用來執行建置的 Eclipse 安裝中,從 org.eclipse.pde.build 軟體組複製範本檔。範本檔位於 org.eclipse.pde.build/templates/headless-build/build.properties 下。
builder 內容會參照這個目錄,且通常會在 ant 指令行中設定。
buildDirectory 內容會指定「PDE/建置」會在其中產生 Script 並執行實際建置的目錄。要建置的外掛程式和特性應該放在 ${buildDirectory}/plugins 和 ${buildDirectory}/features 子目錄中。 如果要從儲存庫提取軟體組和特性(請參閱從儲存庫提取),其也會放在此處。
這個目錄可能會與建置配置目錄相同,也可以是不同的目錄。您可能想要使用個別的目錄,特別是如果建置配置是以 CVS 保存,而您不要它受已產生的建置構件影響。
如果要設定基本特性建置,您需要編輯建置配置檔 build.properties,並設定下列內容:
舊版的「PDE/建置」也需要有 allElements.xml 檔,但 3.4 版則不再需要。您仍然可以使用 allElements.xml,但只有在想要自訂建置的某些層面時才需要。請參閱自訂遠端控制建置。
如果要執行建置,您將使用 org.elipse.ant.core.antRunner 應用程式。 當利用這個應用程式呼叫 Eclipse 來執行建置時,您必須在指令行設定兩個引數:
-buildfile=</path/to/build.xml>:這是 PDE 建置所提供之 build.xml 的路徑。
它在 org.eclipse.pde.build/scripts 目錄中。這是驅動整個建置程序的建置 Script。-Dbuilder=</path/to/configuration folder>:這是通往建置配置資料夾的路徑。
請利用下列指令來執行 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 建置」主題,以取得相關資訊。