<rt id="bn8ez"></rt>
<label id="bn8ez"></label>

  • <span id="bn8ez"></span>

    <label id="bn8ez"><meter id="bn8ez"></meter></label>

        明月松間照 清泉石上流


                                            ——— 兵臨城下   貓科動物
    posts - 70, comments - 137, trackbacks - 0, articles - 23
      BlogJava :: 首頁 :: 新隨筆 :: 聯系 :: 聚合  :: 管理

    ANT的安裝/配置筆記

    Posted on 2007-07-04 22:53 兵臨城下 閱讀(149) 評論(0)  編輯  收藏 所屬分類: J2EE

    內容摘要:
    ANT是一個基于JAVA的自動化腳本引擎,腳本格式為XML。除了做JAVA編譯相關任務外,ANT還可以通過插件實現很多應用的調用。

    1. ANT的基本概念:
    2. ANT的安裝:解包,設置路徑
    3. ANT的使用:最好的學習只不過是一個簡單實用的例子起步……

    ANT的基本概念:Java的Makefile

    當一個代碼項目大了以后,每次重新編譯,打包,測試等都會變得非常復雜而且重復,因此c語言中有make腳本來幫助這些工作的批量完成。在Java 中應用是平臺無關性的,當然不會用平臺相關的make腳本來完成這些批處理任務了,ANT本身就是這樣一個流程腳本引擎,用于自動化調用程序完成項目的編譯,打包,測試等。除了基于JAVA是平臺無關的外,腳本的格式是基于XML的,比make腳本來說還要好維護一些。

    每個ant腳本(缺省叫build.xml)中設置了一系列任務(target):比如對于一個一般的項目可能需要有以下任務。

    • 任務1:usage 打印本腳本的幫助信息(缺省)
    • 任務2:clean <-- init 清空初始化環境
    • 任務3:javadoc <-- build <-- init 生成JAVADOC
    • 任務4:jar <-- build <-- init 生成JAR
    • 任務5:all <-- jar + javadoc <-- build <-- init 完成以上所有任務:jar javadoc
    而多個任務之間往往又包含了一定了依賴關系:比如把整個應用打包任務(jar)的這個依賴于編譯任務(build),而編譯任務又依賴于整個環境初始化任務(init)等。

    注:我看到很多項目的ant腳本中的命名基本上都是一致的,比如:編譯一般叫build或者compile;打包一般叫jar或war;生成文檔一般命名為javadoc或javadocs;執行全部任務all。在每個任務的中,ANT會根據配置調用一些外部應用并配以相應參數執行。雖然ANT可調用的外部應用種類非常豐富,但其實最常用的就2,3個:比如javac javadoc jar等。

    ANT的安裝

    解包后在系統可執行路徑中加入指向ant的bin的路徑就可以了,比如可以在GNU/Linux上把以下配置加入/etc/profile中:
    export ANT_HOME=/home/ant
    export JAVA_HOME=/usr/java/j2sdk1.4.1
    export PATH=$PATH:$JAVA_HOME/bin:$ANT_HOME/bin

    這樣執行ant 后,如果不指定配置文件ant會缺省找build.xml這個配置文件,并根據配置文件執行任務,缺省的任務設置可以指向最常用的任務,比如: build,或指向打印幫助信息:usage,告訴用戶有那些腳本選項可以使用。

    ANT的使用

    最好的學習過程就是看懂那些open source項目中的build.xml腳本,然后根據自己的需要簡化成一個更簡單的,ANT和APACHE上很多非常工程派的項目:簡單易用,而且適應性非常強,因為這些項目的建立往往來源于開發人員日常最直接的需求。
    以下是的一個WebLucene應用的例子:修改自JDOM的build.xml:

    <project default="usage" basedir=".">

      <!-- =================================================================== -->
      <!-- Initialization target                                               -->
      <!-- =================================================================== -->
      <target name="init">
        <tstamp/>
        <property file="${basedir}/build.properties" />
        <property name="Name" value="ProjectFullName"/>
        <property name="name" value="project_name"/>
        <property name="version" value="0.2"/>
        <property name="year" value="2003"/>

        <echo message="----------- ${Name} ${version} [${year}] ------------"/>

        <property name="debug" value="off"/>
        <property name="optimize" value="on"/>
        <property name="deprecation" value="on"/>

        <property name="src.dir" value="./src/WEB-INF/src"/>
        <property name="lib.dir" value="./src/WEB-INF/lib"/>
        <property name="packages" value="com.chedong.*,org.apache.lucene.*"/>

        <property name="build.src" value="./src/WEB-INF/build"/>
        <property name="build.dest" value="./src/WEB-INF/classes"/>
        <property name="build.javadocs" value="./src/doc"/>
       
        <path id="classpath">
            <pathelement path="${jsdk_jar}"/>
            <fileset dir="${lib.dir}">
               <include name="**/*.jar"/>
            </fileset>
        </path>
       
        <filter token="year" value="${year}"/>
        <filter token="version" value="${version}"/>
        <filter token="date" value="${TODAY}"/>
        <filter token="log" value="true"/>
        <filter token="verbose" value="true"/>
      </target>

      <!-- =================================================================== -->
      <!-- Help on usage                                                       -->
      <!-- =================================================================== -->
      <target name="usage" depends="init">
        <echo message="${Name} Build file"/>
        <echo message="-------------------------------------------------------------"/>
        <echo message=""/>
        <echo message=" available targets are:"/>
        <echo message=""/>
        <echo message="   jar      --> generates the ${name}.jar file"/>
        <echo message="   build    --> compiles the source code"/>
        <echo message="   javadoc  --> generates the API documentation"/>
        <echo message="   clean    --> cleans up the directory"/>
        <echo message=""/>
        <echo message=" Please rename build.properties.default to build.properties"/>
        <echo message=" and edit build.properties to specify JSDK 2.3 classpath."/>
        <echo message=""/>
        <echo message=" See the comments inside the build.xml file for more details."/>
        <echo message="-------------------------------------------------------------"/>
        <echo message=""/>
        <echo message=""/>
      </target>

      <!-- =================================================================== -->
      <!-- Prepares the source code                                            -->
      <!-- =================================================================== -->
      <target name="prepare-src" depends="init">
        <!-- create directories -->
        <mkdir dir="${build.src}"/>
        <mkdir dir="${build.dest}"/>
       
        <!-- copy src files -->
        <copy todir="${build.src}">
          <fileset dir="${src.dir}"/>
        </copy>
      </target>

      <!-- =================================================================== -->
      <!-- Compiles the source directory                                       -->
      <!-- =================================================================== -->
      <target name="build" depends="prepare-src">
        <javac srcdir="${build.src}"
               destdir="${build.dest}"
               debug="${debug}"
               optimize="${optimize}">
          <classpath refid="classpath"/>
        </javac>
      </target>

      <!-- =================================================================== -->
      <!-- Creates the class package                                           -->
      <!-- =================================================================== -->
      <target name="jar" depends="build">
        <jar jarfile="${lib.dir}/${name}.jar"
             basedir="${build.dest}"
             includes="**"/>
      </target>

      <!-- =================================================================== -->
      <!-- Creates the API documentation                                       -->
      <!-- =================================================================== -->
      <target name="javadoc" depends="build">
        <mkdir dir="${build.javadocs}"/>
        <javadoc packagenames="${packages}"
                 sourcepath="${build.src}"
                 destdir="${build.javadocs}"
                 author="true"
                 version="true"
                 use="true"
                 splitindex="true"
                 windowtitle="${Name} API"
                 doctitle="${Name}">
          <classpath refid="classpath"/>
        </javadoc>
      </target>

      <!-- =================================================================== -->
      <!-- Clean targets                                                       -->
      <!-- =================================================================== -->
      <target name="clean" depends="init">
        <delete dir="${build.src}"/>
        <delete dir="${build.dest}/org"/>
        <delete dir="${build.dest}/com"/>
        <delete>
          <fileset dir="${build.dest}" includes="**/*.class"/>
        </delete>
      </target>
    </project>
    <!-- End of file -->

    缺省任務:usage 打印幫助文檔,告訴有那些任務選項:可用的有build, jar, javadoc和clean.

    初始化環境變量:init
    所有任務都基于一些基本環境變量的設置初始化完成,是后續其他任務的基礎,在環境初始化過程中,有2點比較可以方便設置:

    1 除了使用卻缺省的property設置了JAVA源路徑和輸出路徑外,引用了一個外部的build.properties文件中的設置,
    <property file="${basedir}/build.properties" />
    這樣大部分簡單配置用戶只要會看懂build.properties就可以了,畢竟XML比起key value的屬性文件還是要可讀性差一些。用build.properties也可以方便其他用戶從編譯的細節中解放出來。

    2 CLASSPATH設置:使用了其中的:
        <path id="classpath">
            <pathelement path="${jsdk_jar}"/>
            <fileset dir="${lib.dir}">
               <include name="**/*.jar"/>
            </fileset>
        </path>
    則相當于設置了:CLASSPATH=/path/to/resin/lib/jsdk23.jar; /path/to/project/lib/*.jar;

    文件復制:prepare-src
    創建臨時SRC存放目錄和輸出目錄。
      <!-- =================================================================== -->
      <!-- Prepares the source code                                            -->
      <!-- =================================================================== -->
      <target name="prepare-src" depends="init">
        <!-- create directories -->
        <mkdir dir="${build.src}"/>
        <mkdir dir="${build.dest}"/>
       
        <!-- copy src files -->
        <copy todir="${build.src}">
          <fileset dir="${src.dir}"/>
        </copy>
      </target>

    編譯任務:build
    編譯時的CLASSPATH環境通過一下方式找到引用一個path對象
    <classpath refid="classpath"/>

    打包任務:jar
    對應用打包生成項目所寫名的.jar文件
      <!-- =================================================================== -->
      <!-- Creates the class package                                           -->
      <!-- =================================================================== -->
      <target name="jar" depends="build">
        <jar jarfile="${lib.dir}/${name}.jar"
             basedir="${build.dest}"
             includes="**"/>
      </target>

    生成JAVADOC文檔任務: javadoc
      <!-- =================================================================== -->
      <!-- Creates the API documentation                                       -->
      <!-- =================================================================== -->
      <target name="javadoc" depends="build">
        <mkdir dir="${build.javadocs}"/>
        <javadoc packagenames="${packages}"
                 sourcepath="${build.src}"
                 destdir="${build.javadocs}"
                 author="true"
                 version="true"
                 use="true"
                 splitindex="true"
                 windowtitle="${Name} API"
                 doctitle="${Name}">
          <classpath refid="classpath"/>
        </javadoc>
      </target>

    清空臨時編譯文件:clean
      <!-- =================================================================== -->
      <!-- Clean targets                                                       -->
      <!-- =================================================================== -->
      <target name="clean" depends="init">
        <delete dir="${build.src}"/>
        <delete dir="${build.dest}/org"/>
        <delete dir="${build.dest}/com"/>
        <delete>
          <fileset dir="${build.dest}" includes="**/*.class"/>
        </delete>
      </target>

    TODO:
    更多任務/擴展:(樣例)
    • 測試任務:JUnit測試
    • 代碼風格檢查任務:CheckStyle,Jalopy等
    • 郵件警報任務:可以把以上這些任務的輸出警告發送到制定的用戶列表中,這個任務可以設置每天自動運行。  
    主站蜘蛛池模板: 久久综合国产乱子伦精品免费| 亚洲精品天堂无码中文字幕| 国产精品成人69XXX免费视频| 午夜成人免费视频| 亚洲精品第一综合99久久| 最好看的中文字幕2019免费| 亚洲黄色中文字幕| 国产h视频在线观看网站免费| 亚洲中文无码av永久| 永久免费毛片在线播放| 亚洲综合成人婷婷五月网址| 最近中文字幕无免费视频| 国产亚洲精品影视在线| 日本免费中文字幕在线看| 337P日本欧洲亚洲大胆精品| 夜色阁亚洲一区二区三区| 一区二区三区免费在线视频| 国产亚洲精久久久久久无码77777 国产亚洲精品成人AA片新蒲金 | 亚洲第一极品精品无码久久| 国产一级淫片a免费播放口| 精品国产亚洲一区二区三区| 无码A级毛片免费视频内谢| 亚洲色av性色在线观无码| a毛片基地免费全部视频| 亚洲Aⅴ在线无码播放毛片一线天| 国产精品国产午夜免费福利看 | 色播在线永久免费视频| 日韩色日韩视频亚洲网站| 亚洲精品视频在线观看你懂的 | 日韩毛片免费无码无毒视频观看| 亚洲国产欧洲综合997久久| 亚洲国产黄在线观看| 无码av免费网站| 亚洲AV成人无码网天堂| 亚洲Av综合色区无码专区桃色 | 亚洲中文久久精品无码1| 免费一级毛片在线播放| 久热免费在线视频| 亚洲人成网站免费播放| 国产亚洲午夜高清国产拍精品| 亚洲一区二区三区免费观看|