ant环境的搭建

Ant 是apache 工程的一个子工程，是一个基于Java的build工具。Ant 类似于make工具，但没有传统的make工具的缺点。传统的make往往只能限制在某一平台上使用，ant本身用java类实现，要构建的工程的配置文件用xml格式描述，可以很方便实现多平台编译。

版本

• JDK1.6.0.21

• Ant1.8.1

安装JDK

无论用什么开发工具，JDK(Java Development Kit)都是必不可少的。从 官网上下载完JDK后，直接安装即可。我把JDK安装到了目录C:\Java\jdk1.6.0_21中。

安装成功后，必须要设置环境变量，这和使用IDE开发有所不同。

需要设置一下三项环境变量。

• JAVA_HOME = C:\Java\jdk1.6.0_21
• PATH = %JAVA_HOME%\bin;
• CLASSPATH = .;%JAVA_HOME%\lib\tools.jar;%JAVA_HOME%\lib\dt.jar （注意： 开头的点和;不能少）

• JAVA_HOME

指的是java的安装目录,系统本身是不需要配置这项的,但是其他软件比如tomcat就会从这里找java如果你不配置他们就找不到java了

• PATH

指的是系统查找执行文件的位置,比如如果你想直接在<开始-运行>里运行某个项目,这个东西必须在path目录里,不然系统会说找不到

• CLASSPATH

这个指的是java程序自动查找class的位置,就如path一样,如果你发现什么时候运行时说找不到某个class,你就需要考虑这个了

以上3个变量不区分大小写,这是windows平台

liunx平台大同小异,除了一些分隔符比如windows平台使用的"\"liunx平台是使用"/",其他都一样.

安装Ant

从这里下载最新版本的ant，下载后的ant为一个压缩包。压缩的格式可以选择zip，tar.gz 或tar.bz2。由于我是在windows下开发，所以选择了zip格式。下载后直接解压缩到C盘就可以了。当然可以放到其他任意位置。

同样，设置环境变量时必须的步骤。详细的安装参考ant在线手册。

• ANT_HOME=c:\ant
• PATH=c:\ant\bin

上述设置完成后，就可以使用ant了。

建立build.xml

用Ant编译规模较大的工程非常方便，每个工程都对应一个build.xml文件，这个文件包含与这个工程有关的路径信息和任务。下面是一个build.xml的例子：

?

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

65

66

67

68

69

70

71

72

73

74

75

76

77

78

79

80

81

82

83

84

85

86

87

88

89

90

91

92

93

94

95

96

97

98

99

100

101

102

<?xmlversion="1.0"encoding="UTF-8"?>

   

<projectname="dev"basedir="."default="dist">

   

  <targetname="init">

   

   

  <propertyname="app.name"value="Chess"/>

        <propertyname="app.vendor"value="Nokia"/>

        <propertyname="app.midlet"value="GameMIDlet"/>

        <propertyname="app.project"value="antdemo"/>

        <propertyname="app.description"value="A demo for ant development"/>

   

    <propertyname="app.price"value="10"/>

   

   

    <propertyname="LIB_PATH"value="../lib"/>

    <propertyname="compile.classpath" value="${LIB_PATH}/nokia60.zip"/>

    <propertyname="proguard.classpath"value="${LIB_PATH}/proguard.jar;${compile.classpath}"/>

  </target>

   

  <!--       -->

  <targetname="clean"depends="init">

    <mkdirdir="dist"/>

    <deletefile="dist/${app.project}.jad"/>

    <deletefile="dist/${app.project}.jar"/>

    <deletedir="temp"/>

  </target>

  <targetname="compile"depends="clean">

    <mkdirdir="temp/classes"/>

    <javacsrcdir="src"destdir="temp/classes"bootclasspath="${compile.classpath}"target="1.1"encoding="UTF-8"/>

  </target>

  <targetname="obfuscate"depends="compile">

    <jarjarfile="temp/${app.project}_tmp.jar"basedir="temp/classes"/>

    <javafork="yes"classname="proguard.ProGuard"classpath="${proguard.classpath}">

      <argline="-libraryjars ${proguard.classpath}"/>

      <argline="-injars temp/${app.project}_tmp.jar"/>

      <argline="-outjar temp/${app.project}_obf.jar"/>

      <argline="-defaultpackage ''"/>

      <argline="-dontusemixedcaseclassnames"/>

      <argline="-keep public class ${app.midlet}"/>

      <argline = "-overloadaggressively"/> 

      <argline="-keepclasseswithmembers public class ${app.midlet} {public void startApp();public void destroyApp(boolean);}"/> 

    </java>

    <mkdirdir="temp/obfuscate"/>

    <unjarsrc="temp/${app.project}_obf.jar"dest="temp/obfuscate"/>

    <!--

      <mkdir dir="temp/obfuscate"/>

      <copy todir="temp/obfuscate">

      <fileset dir="temp/classes"/>

      </copy>

    -->

  </target>

  <targetname="preverify"depends="obfuscate">

    <mkdirdir="temp/build"/>

    <execexecutable="${LIB_PATH}/preverify.exe">

      <argline="-classpath ${compile.classpath} -d temp/build temp/obfuscate"/>

    </exec>

  </target>

  <targetname="copyres"depends="preverify">

    <mkdirdir="temp/res"/>

    <copytodir="temp/res">

      <filesetdir="res"includes="manifest.mf, *.png"/>

    </copy>

    <copytodir="temp/build">

      <filesetdir="res"excludes="manifest.mf, project.jad, *.png"/>

    </copy>

  </target>

  <targetname="replaceres"depends="copyres">

    <replacefile="temp/res/manifest.mf"encoding="UTF-8">

      <replacefiltertoken="@NAME@"value="${app.name}"/>

      <replacefiltertoken="@VENDOR@"value="${app.vendor}"/>

      <replacefiltertoken="@MIDLET@"value="${app.midlet}"/>

    </replace>

  </target>

  <targetname="pngcrush"depends="replaceres">

    <execexecutable="${LIB_PATH}/pngcrush.exe">

      <argline="-d temp/build temp/res/*.png"/>

    </exec>

  </target>

  <targetname="dist"depends="pngcrush">

    <jarjarfile="dist/${app.project}.jar"basedir="temp/build"manifest="temp/res/manifest.mf"manifestencoding="UTF-8"/>

    <taskdefname="filesize"classname="ant.FileSizeTask"classpath="${LIB_PATH}/FileSizeTask.jar"/>

    <filesizefile="dist/${app.project}.jar"property="size"/>

    <copytofile="dist/${app.project}.jad"file="res/project.jad"/>

    <replacedir="dist"includes="${app.project}.jad"encoding="UTF-8">

      <replacefiltertoken="@NAME@"value="${app.name}"/>

      <replacefiltertoken="@VENDOR@"value="${app.vendor}"/>

      <replacefiltertoken="@MIDLET@"value="${app.midlet}"/>

      <replacefiltertoken="@JAR@"value="${app.project}"/>

      <replacefiltertoken="@FILESIZE@"value="${size}"/>

      <replacefiltertoken="@DESCRIPTION@"value="${app.description}"/>

      <replacefiltertoken="@PRICE@"value="${app.price}"/>

    </replace>

    <!--

      <copy todir="bin">

      <fileset dir="dist" includes="${app.project}.*"/>

      <fileset dir="temp/res" includes="manifest.mf"/>

      </copy>

    -->

  </target>

</project>

每个build.xml文件都包含一个project和至少一个target。target包含任务元素，任务是一段可执行代码，每个任务元素都有一个id属性，以便于在文件中引用。Ant有内置任务集可供使用，如上面文件中用到的property、javac和war,分别完成设置属性、编译和打包任务。当然如果需要的话也可以写自己的任务。

build.xml的根元素是progject,它有三个属性name default basedir,其中default是必需的。name指定工程的名字，basedir表示工程的基路径，设置为"."表示build.xml所在的路径。default表示默认的target，运行ant时如果不指定target，则用default指定的target.

property任务用来设置属性，一个工程可以设置很多属性，属性有名字和值，属性设置后可以在后面引用。

<property name="dist.name" value="struts_demo"/>设置一个名字为dist.name的属性，其值为struts_demo，后面使用时用${dist.name}引用，表示字符串struts_demo.

<property name="src" location="src"/>设置一个名字为src的属性，它的值是一个路径，用location设置。如果location内容以/或\或D:\ C:\之类开始，表示绝对路径，否则表示相对路径，相对于project中设置的basedir.

使用path或classpath可以设置类的路径，后面引用时用id设置的值

构建工程最常用的ant内置任务：

• mkdir： 创建目录，dir=要创建的目录
• delete: 删除文件或文件夹 dir=要删除的文件或文件夹
• javac: 编译java源文件，java源文件放在srcdir指定的文件夹中，生成的.class文件按照 package语句组织目录，存放在destdir指定的文件夹中。要注意源文件的目录组织要与package语句相一致

上面的build.xml例子中，target中的属性depends表示在执行本target之前必须要做的target, 例如dist 的depends=compile,意思是在用dist打包之前必须先用compile编译。这样当执行dist时首先执行compile

运行Ant

使用ant.bat可以直接运行ant,如果不带任何参数，ant会在当前路径下搜索build.xml文件，如果找到，就运行project的default指定的target.也可以带参数来选择build.xml文件和要运行的target

对于上面的例子,假定build.xml所在的目录为D:\struts_demo\ ,则下面三种执行方式效果是一样的：

   1.   cd c:\demo        ant   2.   ant -buildfile d:\struts_demo\build.xml   3.   ant -buildfile d:\struts_demo\build.xml    dist

如果执行ant -buildfile d:\struts_demo\build.xml compile,则执行compile target。

对于熟悉了windows下开发的朋友们，是不是有点麻烦。没关系，别忘了windows也是支持批处理的，熟悉DOS的一定不会忘记autorun.bat。 写个自己的bat文件吧。只有两行就足够了。

call antpause

------------------------------补充----------------------

现在build有几种选择，用得最多恐怕还是ANT，当然Maven异军突起。有赶超前辈之势，虽然看资料说Maven多优秀，解决了ANT的问题（但是也带来新的问题），但是，我还是喜欢ANT. 

 

使用ANT一定要写build脚本，就是build.xml。 但是“简单”的脚本也有很多学问。还是在老外的严谨的“治技术”的思想下才认识到的。把我自己体会记录在这里。 

 

下面给出一个例子: 

Build.xml代码  

?

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

65

66

67

<projectname="project"default="dist"basedir=".">  

  

    <propertyenvironment="env"/>  

  

    <propertyname="root"value="."/>  

  

    <conditionproperty="isUnix">  

  

        <osfamily="unix"/>  

  

    </condition>   

  

    <conditionproperty="isWindows">  

  

        <osfamily="windows"/>  

  

    </condition>   

  

    <conditionproperty="systempropsfile"value="${basedir}/unixbuild.properties"else="${basedir}/build.properties">  

  

        <osfamily="unix"/>  

  

    </condition>  

  

    <propertyfile="${systempropsfile}"/>     

  

    <pathid="build.path">  

  

        <filesetdir="${web.library.dir}">  

  

            <includename="**/*.jar"/>  

  

        </fileset>  

  

    </path>        

  

    <targetname="init"description="">  

  

        <echomessage="####   S T A R T SAMPLE BUILDING   ####"/>  

  

        <tstamp/>  

  

        <echomessage="Started on ${TODAY} at ${TSTAMP}"/>  

  

        <echomessage="The base directory: ${basedir}"/>  

  

        <echomessage="Using properties file: ${systempropsfile}"/>  

  

    </target>   

  

    <targetname="clean"depends="init">  

  

        <deletedir="${dist.dir}/${project.war}"/>  

  

        <deletedir="${build.dir}"/>  

  

        <mkdirdir="${dist.dir}"/>  

  

        <mkdirdir="${build.dir}"/>  

  

    </target>       

  

....................  

  

....................    

  

</project>

1. 首先说第一行: 项目名称，这个最好用一个比较有意义的名字。而basedir变量是ANT的默认变量，指build.xml的绝对路径。 当然不写也可以直接使用，但是仍然建议显式的定义一下比较好。 

2. 5~11行是处理不同平台的不同情况。如果脚本里针对不同平台调用不同的其他的脚本，这几行就很有必要了。 

3. 13~16行，还是处理不同平台的情况，但是只针对properties文件，之所以有properties文件，是因为我们在不同平台下必须指定不同的目录。如果我在windows下可以指定c:/dev/project目录做为build目录，而且在linux下就不应该这么指定.所以必须加载不同的properties文件，有时在linux下还要考虑目录权限问题,如果想修改目录，把这些目录变量集中放在一个properties目录里找起来也很方便。 

4. 24~30行，显示一些提示信息，这当然不是必须的，但却是必要的。例如我这里就显示日期和当前使用的properties文件。这些信息对于生成日志和检查错误很有用。 

5. 32~37行，是清除以前产生的文件，在一次build开始一般都有清除的工作要做，所以一般的build里都有这个target.这里面有一个技巧，就是为什么不直接删除目录，还是先删除文件，再删除目录呢？是不是多此一举呢？ 不是！因为很有可能这个目录是不能删除的，而文件一般都是可以删除的，你马上是可以产生出来文件。但是目录就不同了，可能有些目录你不可控的情况出现。只要删除文件一般也就够了。 

6. 后面的target就根据自己的需要处理吧，一般没有什么好说的。 

 

下面给出两个properties文件的内容: 

Unixbuild.properties代码  

#########################  

###  Global Settings  ###  

#########################  

  

###  Project base directories  ###  

source.dir=${basedir}/src  

dist.dir=${env.HOME}/project/  

build.dir=${dist.dir}/build/  

web.library.dir=${basedir}/WebContent/WEB-INF/lib  

build.web.library.dir=${build.dir}/WEB-INF/lib   

web.classes.dir=${basedir}/WebContent/WEB-INF/classes  

build.web.classes.dir=${build.dir}/WEB-INF/classes    

web.content.dir=${basedir}/WebContent   

web.info.dir=${basedir}/WebContent/WEB-INF  

build.web.info.dir=${build.dir}/WEB-INF    

build.output.dir=${dist.dir}/out/  

project.war=project.war  

Build.properties代码  

#########################  

###  Global Settings  ###  

#########################  

  

###  Project base directories  ###  

source.dir=${basedir}/src  

dist.dir=c:/dev/project/  

build.dir=${dist.dir}/build/  

web.library.dir=${basedir}/WebContent/WEB-INF/lib  

build.web.library.dir=${build.dir}/WEB-INF/lib   

web.classes.dir=${basedir}/WebContent/WEB-INF/classes  

build.web.classes.dir=${build.dir}/WEB-INF/classes    

web.content.dir=${basedir}/WebContent    

web.info.dir=${basedir}/WebContent/WEB-INF  

build.web.info.dir=${build.dir}/WEB-INF   

build.output.dir=${dist.dir}/out/  

project.war=project.war  

 

 

这两个文件差别就是那7行部分，就是因为上面我提到的目录权限问题，所以linux下的默认目录不要指定到/home下等不能保证用户有权限的目录