使用Eclipse Ant plugin操作流程

http://jerry17768java.blogspot.com/search/label/Ant%E4%BD%BF%E7%94%A8

目前Ant工具已經內崁為Eclipse IDE的一部份，因此我們不需要額外再安裝Ant plugin套件，
其使用方法極為簡單，完整的操作流程可參考下列說明：

1. 開啟您的Eclipse IDE，建立一個TestProject的專案之後，於src/jcode/test套件目錄底下
   新增HelloTest類別且於程式進入點的main()函式，加入以下的一段程式代碼：

public static void main(String[] args) {   System.out.println("Hello, everybody!");     }

2. 把滑鼠指標移至TestProject的圖示，然後點擊滑鼠右鍵，出現上下文選單(context menu)點取Export項目，

   畫面帶出如下圖的"Export"對話方塊，選擇"Ant Buildfiles"圖示，來產出TestProject的build.xml文件檔： 

  

3. 打開build.xml文檔，並且對該文件進行局部性的修改，其修改過的程式代碼以 紅色粗體字表示。

<?xml version="1.0" encoding="UTF-8" standalone="no"?>

<project   basedir= "."   default= "build"   name= "TestProject" >

     <property   environment= "env" />

     <property   name= "ECLIPSE_HOME"   value= "../../../eclipse-sdk-helios" />

     <property   name= "debuglevel"   value= "source,lines,vars" />

     <property   name= "target"   value= "1.6" />

     <property   name= "source"   value= "1.6" />

       <property name="dist" location="dist"/>

   

     <path   id= "TestProject.classpath" >

         <pathelement   location= "bin" />

         <pathelement   location= "../../../jar-lib/ojdbc14.jar" />

     </path>

     <target   name= "init" >

         <mkdir   dir= "bin" />    

         <copy   includeemptydirs= "false"   todir= "bin" >

             <fileset   dir= "src" >

                 <exclude   name= "**/*.launch" />

                 <exclude   name= "**/*.java" />

             </fileset>

         </copy>

     </target>

     <target   name= "clean" >

         <delete   dir= "bin" />

     </target>

     <target   depends= "clean"   name= "cleanall" />

     <!--target depends="build-subprojects,build-project" name="build"/-->

   

       <target depends="dist" name="build"/>

   

     <target   name= "build-subprojects" />

     <target   depends= "init"   name= "build-project" >

         <echo   message= "${ant.project.name}: ${ant.file}" />

         <javac   debug= "true"   debuglevel= "${debuglevel}"   destdir= "bin" source= "${source}"   target= "${target}" >

             <src   path= "src" />

             <classpath   refid= "TestProject.classpath" />

         </javac>

     </target>

   

       <target name="dist" depends="build-subprojects,build-project"description="generate the distribution" >

        <!-- 創建放置jar檔目錄 -->

        <mkdir dir="${dist}/lib"/>

        

        <!-- 把build目錄內的所有檔案結構打包成一個TestProject.jar檔  -->

        <jar jarfile="${dist}/lib/${ant.project.name}.jar"basedir="bin"/>

      </target>

   

     <target   description= "Build all projects which reference this project. Useful to propagate changes."   name= "build-refprojects" />

     <target   description= "copy Eclipse compiler jars to ant lib directory"   name= "init-eclipse-compiler" >

         <copy   todir= "${ant.library.dir}" >

             <fileset   dir= "${ECLIPSE_HOME}/plugins" includes= "org.eclipse.jdt.core_*.jar" />

         </copy>

         <unzip   dest= "${ant.library.dir}" >

             <patternset   includes= "jdtCompilerAdapter.jar" />

             <fileset   dir= "${ECLIPSE_HOME}/plugins" includes= "org.eclipse.jdt.core_*.jar" />

         </unzip>

     </target>

     <target   description= "compile project with Eclipse compiler" name= "build-eclipse-compiler" >

         <property   name= "build.compiler" value= "org.eclipse.jdt.core.JDTCompilerAdapter" />

         <antcall   target= "build" />

     </target>

</project>

4. 將滑鼠指標移動到build.xml圖示，單點滑鼠右鍵後選取"Run As -> 1 Ant Build"項目執行，會於"Console"輸出Ant的腳本代碼：

Buildfile:  D:\works\TestProject\build.xml

build-subprojects :

init :

build-project :

     [ echo ] TestProject: D:\works\TestProject\build.xml

dist :

    [ mkdir ] Created dir: D:\works\TestProject\dist\lib

      [ jar ] Building jar: D:\works\TestProject\dist\lib\TestProject.jar

build :

BUILD SUCCESSFUL

Total time: 526 milliseconds

張貼者： Jerry Chan 於  下午4:07  0 意見

以電子郵件傳送這篇文章  BlogThis！  分享至 Twitter  分享至 Facebook 

標籤： Ant使用

Ant的手動安裝設定

Ant本身並非是一個Windows的程式，因此安裝過程需要一些手動安裝步驟。

1. 首先，到apache ant的官方網站 http://ant.apache.org/bindownload.cgi下載ant的程式套件壓縮檔

2. 再來，將Ant程式套件的zip檔解壓縮到Windows的指定目錄 e.g., C:\myant\
   zip檔內會包含依據版本資訊命名"apache-ant"的子目錄結構。
3. 然後，你需要設定一些環境變數以讓你的command console知道如何去找到Ant的執行檔
   以及讓Ant知道在那裡可以找到java執行檔

在Windows XP的對話框中，你可以存取環境變數藉由"開始選單"與右擊"我的電腦"圖示。
稍後會帶出"系統屬性"對話方塊。請選取"進階"按鈕：

並且點擊"環境變數"按鈕。

4. 最後，你需要使用"新增"按鈕加入兩個新的變數分別如下：

• ANT_HOME是ant套件解壓縮後所放置的根目錄所在位置
• JAVA_HOME表示Java SDK安裝所在根目錄

而且你還需要編輯變數：

• 於PATH變數增加%ANT_HOME%/bin的路徑

5. 完成以上步驟之後，打開你的command console輸入ant按Enter鍵，若輸出以下的訊息字串時,代表Ant的安裝設定成功。

張貼者： Jerry Chan 於  上午11:05  1 意見

以電子郵件傳送這篇文章  BlogThis！  分享至 Twitter  分享至 Facebook 

標籤： Ant使用

Apache Ant的快速入門

1. ANT定義

Ant(Another Neat Tool)是一組Java類別庫與命令列工具，它的建立檔案(build file)是由XML組成，而每一個建立檔案會包含一個計畫(Project)與一個以上的目標(target)，在每一個目標內會包含一組要執行的任務(task)。一個Ant建立檔案會由計畫、目標、任務、屬性(properties)、路徑(paths)等相關元素所組成。 

2. ANT的組成元素

計畫(Project)

在Ant腳本中是為上層的元素，它有三個選擇性的屬性可以設定，分別name、default、basedir 

• name是專案的名稱
• default代表當在專案中不存在任何target時，專案就會直接使用default設置的target
• basedir即buildfile文件所在之根目錄

目標(Target)

每一個專案定義零到多個目標，一個目標也就是一組你想要執行的任務，並且當您要啟動Ant時，可以選擇想要執行的目標只要沒有給定任何目標，專案就會使用預定目標  我們也可以運用if/unless條件式來決定該執行那一個目標，一個目標可以相依於其他目標，也就是需要等被依賴的目標執行完成，該目標才能接續執行。 

任務(Tasks)

一個任務是由一個可執行的代碼所組成，它包含了多重屬性。 

屬性(Properties)

一個屬性是由一個名稱和一個值組成，名稱以大小寫作為區別，舉例來說，有一個builddir的屬性擁有build值，  而且使用在屬性標籤表示式會是${builddir}/classes，當執行Ant buildfile時會輸出build/classes的結果，一般而言屬性不是變數,通常以字串常數的型態呈現。

• 例子，設置test.dist屬性為"dist"值：

          <property name="test.dist" value="dist"/>

路徑(Paths)

路經結構是由classpath、pathelement、fileset、dirset與filelist等元素分別組合而成。 

• classpath是類別參考路徑
• pathelement用來指定目錄或jar文檔
• fileset是一群檔案的組合
• dirset是一群目錄的組合
• filelist定義為檔案的集合

   <classpath>

     <pathelement  path= "${classpath}" />

     <fileset  dir= "lib" >

       <include  name= "**/*.jar" />

     </fileset>

     <pathelement  location= "classes" />

     <dirset  dir= "${build.dir}" >

       <include  name= "apps/**/classes" />

       <exclude  name= "apps/**/*Test*" />

     </dirset>

     <filelist  refid= "other_jars" />

   </classpath>

3.第一支簡單的ANT BUILDFILE文件

首先， 我們必須依據所屬的應用程式專案建立自己的buildfile文件，可以參考以下的範例說明：

• 建立簡單buildfile文件範例

<project  name= "TestProject"  default= "dist"  basedir= "." >   

   <!--  為 build 文件設定全域性屬性  -->

   <property  name= "src"  location= "src" />

   <property  name= "build"  location= "build" />

   <property  name= "dist"   location= "dist" />

   <target  name= " init " >   

     <!--  建立 build 的目錄結構  -->

     <mkdir  dir= "${build}" />

   </target>

   <target  name= "compile"  depends= "init"  description= "compile the source "  >

     <!--  從 src 目錄編繹 java 代碼 , 且將編譯好的 class 代碼移動到 build 目錄   -->

     <javac  srcdir= "${src}"  destdir= "${build}" />

   </target>

   <target  name= "dist"  depends= "compile"  description= "generate the distribution"  >

     <!--  創建放置 jar 檔目錄  -->

     <mkdir  dir= "${dist}/lib" />

     <!--  把 build 目錄內的所有檔案結構打包成一個 TestProject.jar 檔   -->

     <jar  jarfile= "${dist}/lib/${ant.project.name}.jar"  basedir= "${build}" />

   </target>

   <target  name= "clean"   description= "clean up"  >

     <!--  刪除 build 與 dist 樹狀結構目錄   -->

     <delete  dir= "${build}" />

     <delete  dir= "${dist}" />

   </target>

</project>

在撰寫完成buildfile文件之後，需要 安裝Ant工具或者使用 Eclipse IDE內建的Ant plugin來執行我們剛才所建立的buildfile文件。

• Ant腳本輸出:

Buildfile:  D:\Works\TestProject\TestProject.xml

init :

    [ mkdir ] Created dir: D:\Works\TestProject\build

compile :

    [ javac ] Compiling 1 source file to  D:\Works\TestProject\build

dist :

    [ mkdir ] Created dir: D:\Works\TestProject\dist\lib

      [ jar ] Building jar: D:\Works\TestProject\dist\lib\TestProject.jar

張貼者： Jerry Chan 於  下午5:53  0 意見