Ant、Ivy入门与集成

Apache Ant,是一个将软件编译、测试、部署等步骤联系在一起加以自动化的一个工具，大多用于Java环境中的软件开发。由Apache软件基金会所提供。

Apache Ivy是一个优秀的管理（记录、跟踪、解析和报告）项目依赖的工具，可与Apache Ant紧密集成。

整理日志比敲代码还累。

资源准备

本文中的演示实例是基于Eclipse插件（Ivy插件叫IvyDE，Ant插件一般都自带）来编写的。主要包括Ivy依赖管理、Ant自动化测试与打包、Ant与Ivy集成三个部分。相关资源下载地址：http://pan.baidu.com/s/1i3D2AFj

新建Java项目

为了温习Java的反射机制，特意在项目中编写了4个Java文件：Demo.java、IDemo.java、Test.java、JunitTest.java。目录结构如下：

Ivy管理依赖

为了满足后面的自动化测试，我加入了JunitTest,故需要引入Junit的相关Jar包。在项目根目录下新增ivysettings.xml、ivy.xml两个文件。

ivysettings.xml:

<?xml version="1.0" encoding="UTF-8"?>
<ivysettings>
	<settings defaultResolver="default"/>
	<property name="ivy.local.default.root"             value="${ivy.default.ivy.user.dir}/local" override="false"/>
	<property name="ivy.local.default.ivy.pattern"      value="[organisation]/[module]/[revision]/[type]s/[artifact].[ext]" override="false"/>
	<property name="ivy.local.default.artifact.pattern" value="[organisation]/[module]/[revision]/[type]s/[artifact].[ext]" override="false"/>
	
	<caches useOrigin="true"/>
	
	<resolvers>
		<!--本地库-->
		<filesystem name="local">
			<ivy pattern="${ivy.local.default.root}/${ivy.local.default.ivy.pattern}" />
			<artifact pattern="${ivy.local.default.root}/${ivy.local.default.artifact.pattern}" />
		</filesystem>
		
		<!--缓存库-->
		<filesystem name="cache">
			<ivy pattern="${ivy.default.ivy.user.dir}/cache/[organisation]/[module]/[artifact]-[revision].xml" />
			<artifact pattern="${ivy.default.ivy.user.dir}/cache/[organisation]/[module]/[type]s/[artifact]-[revision].[ext]" />
		</filesystem>
		
		<!--远程库 省略-->
		
		<chain name="default" returnFirst="true" checkmodified="true">
			<resolver ref="local"/>
			<resolver ref="cache"/>
		</chain>
	</resolvers>
</ivysettings>

注意：此配置生效需要在“C:\Users\****\.ivy2\cache”路径下存在ivy的缓存Jar包。

ivy.xml:

<?xml version="1.0" encoding="UTF-8"?>
<ivy-module version="2.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:noNamespaceSchemaLocation="http://ant.apache.org/ivy/schemas/ivy.xsd">
    <info
        organisation="com.netbug"
        module="reflect"
        status="integration">
	</info>
	<configurations>
		<conf name="default" visibility="public" description="runtime dependencies and master artifact can be used with this conf" extends="runtime"/>
		<conf name="compile" visibility="public" description="this is the default scope, used if none is specified. Compile dependencies are available in all classpaths."/>
		<conf name="runtime" visibility="public" description="this scope indicates that the dependency is not required for compilation, but is for execution. It is in the runtime and test classpaths, but not the compile classpath." extends="compile"/>
		<conf name="test" visibility="private" description="this scope indicates that the dependency is not required for normal use of the application, and is only available for the test compilation and execution phases." extends="runtime"/>
	</configurations>
	<dependencies>
		<!-- 单元测试相关 -->
		<dependency org="junit" name="junit" rev="4.10" conf="default" transitive="false" />
		<!-- json序列化相关 -->
		<dependency org="com.fasterxml.jackson.core" name="jackson-core" rev="2.3.1" conf="default" transitive="false"/>
		<dependency org="com.fasterxml.jackson.core" name="jackson-annotations" rev="2.3.1" conf="default" transitive="false"/>
		<dependency org="com.fasterxml.jackson.core" name="jackson-databind" rev="2.3.1" conf="default" transitive="false"/>
	</dependencies>
</ivy-module>

修改项目的ivy配置信息如下：注意ivysetting.xml。

右键ivy.xml，选择“Add Ivy Library…”。此时会出现如下界面：

点击“Finish”,项目的Build Path变化如下：

此时JunitTest.java编译应该就不会报错了。

Ant自动化测试与打包

首先将资源中的junit-4.10.jar复制到Ant插件安装目录的lib下，并配置Ant运行环境如下：

Ant的自动化测试需要另外提供junitJar包，如果不提供则会抛异常。

在项目根目录下新建“build.properties、build.xml”两个文件。对应的文件内容如下：

build.properties

#Tue, 14 Jul 2015 09:46:09 +0800
custom=true
build.dir=build
build.classes.dir=build/classes
build.lib.dir=build/lib
build.report.dir=build/report

build.xml

<?xml version="1.0" encoding="UTF-8"?>
<project name="ant-test-project" default="default" xmlns:ivy="antlib:org.apache.ivy.ant">
	<description>
            description
    </description>
	<property file="build.properties">
	</property>
	<path id="cachepath">
		<fileset dir="lib" includes="**/*.jar">
		</fileset>
	</path>
	<target name="default" depends="jar" description="description" if="basedir">

	</target>

	<target name="property" description="Inside And Custom Property">
		<echo message="basedir：${basedir}" />
		<echo message="ant.file：${ant.file}" />
		<echo message="ant.project.name：${ant.project.name}" />
		<echo message="ant.version：${ant.version}" />
		<echo message="ant.java.version：${ant.java.version}" />
	</target>

	<target name="clean">
		<delete dir="${build.dir}">
		</delete>
	</target>

	<target name="init" depends="property,clean">
		<mkdir dir="${build.dir}" />
		<mkdir dir="${build.classes.dir}" />
		<mkdir dir="${build.lib.dir}" />
		<mkdir dir="${build.report.dir}" />
	</target>

	<target name="compile" depends="init">
		<javac srcdir="src" destdir="${build.classes.dir}" includeantruntime="true" classpathref="cachepath">
		</javac>
		<echo message="源文件编译成功！" />
	</target>
	<target name="compile.test" depends="compile">
		<javac srcdir="test" destdir="${build.classes.dir}" includeantruntime="true" classpathref="cachepath">
		</javac>
		<echo message="测试源文件编译成功！" />
	</target>

	<target name="test" depends="compile.test">
		<echo message="Junit测试开始！" />
		<junit printsummary="true" showoutput="true" fork="true">
			<classpath>
				<pathelement path="${build.classes.dir}" />
			</classpath>
			<formatter type="xml" />
			<batchtest todir="${build.report.dir}">
				<fileset dir="${build.classes.dir}">
					<include name="**/JunitTest.*" />
				</fileset>
			</batchtest>
		</junit>
		<echo message="Junit测试结束！" />
	</target>

	<target name="java" depends="test">
		<java classname="com.netbug.reflect.Test" classpath="${build.classes.dir}">
		</java>
		<echo message="组件运行成功！" />
	</target>

	<target name="jar" depends="java">
		<jar destfile="${build.dir}/com.netbug.reflect.jar">
			<fileset dir="${build.classes.dir}">
				<exclude name="**/JunitTest.*" />
			</fileset>
			<manifest>
				<attribute name="Main-class" value="com.netbug.reflect.Test" />
			</manifest>
		</jar>
		<echo message="组件打包成功！" />
	</target>
</project>

此时的项目目录结构如下：

右键“build.xml”-“Run AS Ant Build”，在根目录的build文件下会生成打包文件：com.***.reflect.jar以及自动化测试报告“report/TEST-com.netbug.reflect.JunitTest.xml”

Ant与Ivy集成

首先将资源中的ivy-2.3.0.jar复制到Ant插件安装目录的lib下，并配置Ant运行环境如下：

Ant与ivy集成需要另外提供ivy.jar包，如果不提供则会抛异常。

其后对build.xml做相应修改如下：

• 注释掉cachepath

	<!-- <path id="cachepath">
		<fileset dir="lib" includes="**/*.jar">
		</fileset>
	</path>  -->

• 新增init.ivy target

	<target name="init.ivy" description="init ivy">
		<ivy:settings file="ivysettings.xml" id="ivy.instance" />
		<ivy:cachepath pathid="cachepath" conf="*" type="jar,bundle,war,maven-plugin" />
		<ivy:retrieve conf="*" type="jar,bundle,war,maven-plugin" pattern="${build.lib.dir}/[conf]/[artifact].[ext]" />
		<ivy:report todir="${build.report.dir}" />
		<echo message="Ivy初始化成功" />
	</target>

• 修改compile target基于init、init.ivy两个target

	<target name="compile" depends="init,init.ivy">
		<javac srcdir="src" destdir="${build.classes.dir}" includeantruntime="true" classpathref="cachepath">
		</javac>
		<echo message="源文件编译成功！" />
	</target>

右键“build.xml”-“Run AS Ant Build”，在根目录的build文件下会生成打包文件：com.***.reflect.jar、自动化测试报告“report/TEST-com.netbug.reflect.JunitTest.xml”以及“ivy依赖报告”。

最终的项目目录结构如下：

参考资料链接

http://www.blogjava.net/aoxj/archive/2009/08/03/289522.html

http://www.blogjava.net/zhangzhong1018/articles/142411.html

http://www.cnblogs.com/cyjch/archive/2012/03/28/2420761.html

http://blog.csdn.net/lisonghua/article/details/4770260

http://my.oschina.net/u/134516/blog/195569

Best Wishes For You!