建立專案建置器 Ant 建置檔

為了瞭解專案建置器的運作方式,我們將使用一個程式檔和一個 Ant 建置檔(組成一個類別檔)來建立一個簡單的專案。 雖然這個範例使用 Java,您應該注意,專案建置器可用於所有的專案、Java 或其他方面。

  1. 建立一個命名為 HW 的 Java 專案。
  2. 建立一個命名為 HelloWorld 並包含一個 main 方法的 Java 程式檔。
  3. 在 main 方法中置入一個 System.out.println() 陳述式,使它列印您選擇的問候語。
  4. 儲存變更。
  5. 建立一個命名為 projectBuilder.xml 的檔案,在 Ant 編輯器中開啟它,輸入下列內容,然後儲存變更。
      <?xml version="1.0" encoding="UTF-8"?>
       <project name="HW.makejar" default="makejar" basedir=".">
          <target name ="makejar" description="Create a jar for the HW project">
             <jar jarfile="HelloWorld.jar" includes="*.class" basedir="bin"/>
    	</target>
    </project>
    
  6. 在其中一個導覽視圖中,選取 HW 專案,然後從其快速功能表中選擇內容
  7. 在專案內容對話框中,選取建置器,再按一下新建...
  8. 選擇配置類型對話框中,選取 Ant 建置,按一下確定
  9. 這時會開啟外部工具對話框。 請將名稱設為 Makejar。在「主要」標籤中,按一下建置檔瀏覽工作區...,再將位置設定成上面建立的 projectBuilder.xml 建置檔。 之後,按一下基本目錄瀏覽工作區...,再將基本目錄設成 HW 專案。

    「外部工具」對話框的「主要」標籤

  10. 重新整理標籤中,我們確定要在建立 HelloWorld.jar 時會在 Eclipse 中看到它。依預設,當專案建置器執行完成時,並不會重新整理,所以請勾選完成時重新整理資源,然後,在限定範圍的變數清單中,選取包含所選資源的專案。 由於重新整理可能代價很高,因此通常您應該重新整理其中包含受建置檔影響的所有資源的最小實體。

    外部工具對話框的重新整理標籤

  11. 目標標籤中,您可以指定執行這個專案建置器的時間及其目標。依預設,default 目標會設為在「清除」「手動建置」之後執行。您可以指定其他目標和其他觸發程式。您可以在自動建置期間執行您的專案建置器,但不建議您這麼做,因為效能會降低。

    「外部工具」對話框的「目標」標籤

  12. 套用變更,然後按一下確定
  13. 回到專案內容對話框,您會看到一個命名為 Makejar 的專案建置器,它設定成在預設的 Java 建置器之後執行。請按一下確定來儲存專案建置器並關閉對話框。
    附註:您可以變更順序,使您的 Ant 建置檔在 Java 建置器之前執行,不過,在這個例子,這並無意義。

    專案內容對話框

Java 建置器會執行內部 Eclipse Java 編譯器,然後再由該編譯器負責為您的程式檔編製索引,以便使用搜尋、重構和許多其他特性。因此,您無法利用專案建置器來取代內部的 Eclipse Java 編譯器。您可以停用 Java 建置器,且您可以針對您所定義的專案建置器來控制「Java 建置器」的執行時間。

相關作業
建立 Ant 建置檔
編輯 Ant 建置檔
儲存及重複使用 Ant 選項
執行 Ant 建置檔
將 Ant 建置檔當作專案建置器
執行專案建置器
外部工具
非 Ant 專案建置器
獨立式外部工具