ant打包jar文件

        筆者之前在項目中使用的最多的打包工具要數fatjar了。打包的時候習慣於先指定可執行類，而後將全部引用的jar包以及源碼生成的class一塊兒打到 一個包裏面，運行程序的時候直接運行命令：java –jar jarname.jar。看似很方便。可是，這樣作有兩個缺點：1.將全部jar包都整合到一塊兒，致使jar包太大，通常最小几百k，最大十幾MB都有， 上傳至服務器時，耗時較長。2.每次更新jar包，引用的包又要從新打進去。其實引用的包根本就沒作更改，特別是引用的jar包較多時，打包時間較長。

         基於上面兩個缺點，筆者開始將源程序生成的class與引用的jar包分離。即：源程序單獨打一個jar包，引用的jar包放置在統一的lib目錄。在運 行程序的時候，使用shell腳本將lib下面的jar包都加入到環境變量之中。這樣運行的較最原始使用fatjar時期稍微方便了一些：不用每次都重複 打引用的jar包，而且此時jar包變得很小，上傳很方便。但時惟一不足的地方是須要本身寫shell，將引用的jar包加入環境變量。並 且，eclipse那個導出jar包的功能用着實在不習慣。

         參考了一些同事的作法：1.使用fatjar，classes、jars全打一塊兒。此方法果斷pass。2.使用eclipse的導出功能，導出jar包 以後。使用winrar修改jar包中的MANIFEST.MF文件，在其中加入Class-Path。此方法雖可行，但每次打包以後均需手動修改，麻煩 啊同志們。

         最後，看了不少開源軟件均使用ant打包，因而決定嘗試一下。捉摸了一段時間，寫了個例子。放在下面，供你們參考，也爲了使本身之後回顧。

工程目錄結構以下圖所示：

 

工程引用了三個jar包：helloant-201111232256.jar、google-201111261330.jar、android-201111262247.jar。

工程只寫了一個java文件SayHello.java，其內容以下：

package demo;
public class SayHello {
    public static void main(String[] args) {
        demo.HelloAnt.main(args);
        demo.Google.main(args);
        demo.Android.main(args);
    }
}

 

main函數中的三行引用了三個jar包中的類，做用分別爲打印Hello  Ant! Hello google！以及Helloandroid!

 

Ant對應的配置文件爲build.xml.

 

其內容以下：

<?xml version="1.0" encoding="UTF-8"?>
<!--project 用於定義一個ant工程，其中的三項name、default、basedir缺一不可。
做用分別爲：定義工程名、制定默認執行的任務、以及工程基礎的路徑型(它是計算其它路徑的基礎，通常狀況下使用.即在java工程根目錄便可)-->
<project name="sayhellousejarant" default="compile" basedir=".">
    <!--描述，我的以爲就是一提示做用，沒什麼實際用途-->
    <description>use jar test</description>
    <!--定義源文件路徑，其中的value換成location也行，使用value的時候，${src}獲得的就是src這個值，若是使用location，獲得的是src這個目錄的絕對路徑-->
    <property name="src" value="src" />
    <property name="classes" value="bin/classes" />

    <!--構造打包時Class-Path須要的路徑 -->
    <!--pathconvert用於對目錄進行組合 property即這個組合的名字，pathsep做用是各個文件之間的分隔符，
        若是不寫，在windows平臺默認是分號。但時在MANIFEST.MF這個文件中，各個jar包之間要用空格區分，
        所以。這裏就寫成空格了
    -->
    <pathconvert property="lib" pathsep=" ">
        <!--mapper,對路徑組合方式進行控制-->
        <mapper>
            <!--chainedmapper 做用是聯合多個mapper-->
            <chainedmapper>
                <!--過濾文件，將路徑去掉，只保留文件名-->
                <flattenmapper />
                <!--過濾+轉換器，將全部的文件名前面都加上一個lib，咱們知道lib目錄下面有jar包，
                    lib/*的做用實際上是將jar包名與路徑進行組合造成如：lib/google.jar這樣的相對路徑
                 -->
                <globmapper from="*" to="lib/*" />
            </chainedmapper>
        </mapper>
        <!--按照mapper定義的格式組合lib目錄下面的全部jar文件，造成諸如lib/jar1.jar lib/jar2.jar的字符串-->
        <fileset dir="lib">
            <include name="*.jar" />
        </fileset>
    </pathconvert>


    <!--同lib，此處再也不解釋-->
    <pathconvert property="lib2" pathsep=" ">
        <mapper>
            <chainedmapper>
                <flattenmapper />
                <globmapper from="*" to="lib2/*" />
            </chainedmapper>
        </mapper>
        <fileset dir="lib2">
            <include name="*.jar" />
        </fileset>
    </pathconvert>

    <!--單獨一個jar包，不在lib以及lib2目錄下，使用一個單獨的property定義，以便引用-->
    <property name="androidjar" value="android-201111262247.jar" />
    <!--組合各個路徑，構成MANIFEST.MF文件中Class-Path所需的字符串-->
    <property name="libs" value="${lib} ${lib2} ${androidjar}" />

    <!--打印一下剛纔構造好的字符串，看看是否符合要求-->
    <echo>libs   ${libs}</echo>

    <!-- 構造打包時Class-Path須要的路徑 結束-->

    <!--建立任務init，負責初始化一些條件-->
    <target name="init">
        <!-- 建立存放編譯後的class的目錄
            mkdir能夠建立多級目錄
        -->
        <mkdir dir="${classes}" />
    </target>

    <!--建立編譯任務，名字是compile,depends指定了comiple任務依賴init任務-->
    <target name="compile" depends="init" description="comile target">
        <!--javac，編譯，對應java中的javac命令。
        其中srcdir定義源文件路徑 destdir定義編譯後文件路徑，
        includeantruntime做用是指定編譯任務是否包含ant的classpath,無關緊要，不影響編譯，
        但不寫可能會出現警告，爲了眼不見心不煩，加上吧-->
        <javac srcdir="${src}" destdir="${classes}" includeantruntime="true">
            <!-- classpath 定義編譯須要的claspath -->
            <classpath>
                <fileset dir="lib">
                    <include name="*.jar" />
                </fileset>
                <fileset dir="lib2">
                    <include name="*.jar" />
                </fileset>
                <fileset dir=".">
                    <include name="${androidjar}" />
                </fileset>
            </classpath>
        </javac>
    </target>


    <!-- 建立時間戳 -->
    <tstamp />

    <!--定義jarfilename，準備進行打包操做。其中ant.project.name是ant默認的一個變量，值爲最上面定義的project的name
    ${DSTAMP}爲日期，格式爲20111123；${TSTAMP}爲時間，格式爲2256，表示22點56分。
        -->
    <property name="jarfilename" value="${ant.project.name}-${DSTAMP}${TSTAMP}.jar" />
    <!--打包開始，名字爲jar，依賴任務爲compile-->
    <target name="jar" depends="compile" description="make jar file">
        <!--jar操做，jarfile指定jar包存放路徑，basedir爲編譯後的class的目錄-->
        <jar jarfile="${jarfilename}" basedir="${classes}">
            <!--爲jar包指定manifest，固然，若是jar包不須要打成runnable的形式，manifest能夠不要-->
            <manifest>
                <!--指定main-class-->
                <attribute name="Main-Class" value="demo.SayHello" />
                <!--指定Class-Path-->
                <attribute name="Class-Path" value="${libs}">
                </attribute>
            </manifest>
        </jar>
    </target>

    <!--運行一下jar包，試試看效果-->
    <target name="run" depends="jar">
        <!--其實這裏就是運行jar命令，注意fork必定加上，否則不起做用-->
        <java jar="${jarfilename}" fork="true">
        </java>
    </target>


    <!-- 清理 -->
    <target name="clean">
        <!-- 能夠以遞歸的方式刪除目錄 -->
        <delete dir="${classes}" />
        <delete dir="." includes="${ant.project.name}*.jar" />
    </target>
</project>

 

 以後開始打包吧。

運行方式：能夠用eclipse自帶的，也可使用命令。

 

使用Eclipse自帶ant方式運行時注意選第二個ant build，在裏面選擇執行jar任務。

使用ant命令，須要先設置ant環境變量，以後在java project目錄下執行ant jar命令即可以打包了。另外還能夠運行ant、ant jar、ant run、ant clean等命令來執行編譯、打包、運行jar包、清理生存的文件等操做。

 

附Windows下設置ant環境變量的方式：

一、  設置 JAVA_HOME

二、  設置ANT_HOME 使其指向ant解壓得路徑，如c:\apache-ant-xxx

三、  在PATH中加入%ANT_HOME%/bin

四、  打開命令行，輸入ant –version看看能不能出來版本信息。能，設置好了。