1. 程式人生 > >mingyuan's workspace

mingyuan's workspace

        筆者以前在專案中使用的最多的打包工具要數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環境變數的方式:

1、  設定 JAVA_HOME

2、  設定ANT_HOME 使其指向ant解壓得路徑,如c:\apache-ant-xxx

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

4、  開啟命令列,輸入ant –version看看能不能出來版本資訊。能,設定好了。

 Java工程檔案以及build.xml可以在這裡找到,本文件可以在這裡找到。

2011年11月26-2011年11-27日,於北京。