Ant 使用指南 - 点滴记忆*记忆点滴
收藏本站

Ant 使用指南



三、ANT的组成(主要由三部分组成:Project、Target、Task)

1、Project(项目)。基本属性:name、default、basedir。一个build.xml只能存在一个Project工程。

name :项目名称

default :缺省开始执行的Target

basedir :用于计算所有其他路径的基路径。

  

例1:<project name="dev" basedir="." default="dist">

  

2、Target。一个项目可以定义一个或多个Target、一个Target是一系列你想要执行的任务,如编译任务、打包任务、混淆任务。

   

Target的基本属性: name:target的名字,depends:该target依赖关系,description: target的描述信息。

  

例2:<target name="clean" depends="init" description="Clean dist and temp directories">

  

Ant在执行时以Target为单位,Target的depends属性又决定了哪个Target先执行,因此我们可以通过Target来构造编译顺序。

  

例3:<target name="copy" >
       <target name="javac" depends="copy">

       <target name="jar" depends="javac">

执行顺序是从下至上,依次执行,如果某个Target没有depends属性,那么就顺序执行。

  

例4:一个完整的Target:

<target name="compile" depends="replacesrc"   description="Compiling Java source files">

     <javac   srcdir="temp/src"  

             destdir="temp/build"

             debug="on"

             deprecation="false"

             optimize="true">

     <classpath refid="classpath"/>

     </javac>
</target>

3、Task。Ant执行的一系列任务是由Target构成的,而Target又是由数个小的Task构成的,task任务是最小的运行单位,我们可以把copy、delete、mkdir等操作认为是一个小任务。

(1)copy任务。

A.拷贝单个文件:

<copy file="Demo/manifest.mf" todir="temp/build/META-INF" />
解释:把一个文件拷贝到拷贝相关文件夹中。

B.拷贝文件夹:

<copy todir="temp/build">
     <fileset dir="temp/classes"/>
   </copy>
     解释:把temp/build目录下的所有文件,拷贝到temp/classes目录中去

C.替换拷贝
<copy todir="temp/build">
   <fileset dir="temp/classes" includes="*.class" />
   <filterset>
        <filter token="@Time@" value="${app.time}"/>
   </filterset>
</copy>
   解释:   <filterset>过滤集,可以将temp/classes文件夹下的存在@Time@标记的文件,替换为变量${app.time}值。这样在完成拷贝的同时也完成了替换任务。

(2)mkdir任务和delete任务

A.单独的delete和mkdir任务
      <delete dir="temp/src"/>
      <delete file="temp/build/Thumbs.db" />
      <mkdir dir="temp/src"/>
   
    B. 带有条件的删除任务
       <delete>
         <fileset dir="store" includes="*.*"/>
         <fileset dir="source" excludes="*.java"/> 

       </delete>       
       解释:include表示要删除哪些文件;而excludes表示排除的文件;

(3)replace替换任务

A.替换某一文件中的字符串

<replace file ="base/testing.txt">
token="@temp@"
value="${newstring}"
</replace>

解释:token是需要替换的标记;value是新值,将testing.txt文件中的@temp@替换为新值。

B.替换某个文件夹中存在特定标记的文件

<replace dir="temp" token="@CHARSET@" value="${webapp.charset}"/>  

解释:temp目录中文件,如果有存在@CHARSET@标记的,将被替换为${webapp.charset}变量值。

C.批量替换

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

<replacefilter token="@NAME@" value="${app.name}"/>
     <replacefilter token="@VENDOR@" value="${app.vendor}"/>
     <replacefilter token="@MIDLET@" value="${app.midlet}"/>
     <replacefilter token="@JAR@" value="${app.project}"/>
     <replacefilter token="@FILESIZE@" value="${size}"/>
     <replacefilter token="@DESCRIPTION@" value="${app.description}"/>             <replacefilter token="@PRICE@" value="${app.price}"/>

</replace>

(4) javac任务 ,编译源程序

<target name="Compile" description="Compile Java source files">

<javac srcdir="src" destdir="temp/classes" bootclasspath="${compile.classpath}"

 target="1.1"

debug="on"

deprecation="on"

includes="*.java"

optimize="true"

encoding="UTF-8"/>  

</target>

解释:bootclasspath参数(启动类库):它已经包含了jre/lib目录下的rt.jar,以及我们自定义的类库。如果使用classpath参数,仅指我们定义的类库;

(5) java任务 。为运行Java应用程序,需要使用java任务

A.运行一个类

<target name="run" description="Run the program">

     <java classname="${main}" classpath="${classpath}"/>

</target>

解释:classname表示要运行的主类。

 

B.运行某一特定类,并加上运行参数。

<java fork="true" classname="proguard.ProGuard" classpath="${proguard.classpath}">

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

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

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

             <arg line="-defaultpackage ''"/>

             <arg line="-dontusemixedcaseclassnames"/>

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

</java>

 

解释:fork参数:为true时,在新的JVM实例中运行,不影响当前JVM工作

如何减少文件的size?

使用3.3.2版本的proguard.jar,然后在混淆参数中添加两行代码:

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

这样可以保证startApp和destroyApp不被打上Final修饰符,同时还能更大的压缩代码,不过要求Midlet类中startApp和destroyApp方法保持上面的形式。

(6)JAR任务

将编译好的CLASS文件打成JAR包,这是JAR任务的工作:

<target name="jar" depends="Compile" description="Build jar file">

<jar jarfile="dist/${name}.jar"

       basedir="${tmp/class}"

manifest="tmp/res/manifest.mf"

manifestencoding="UTF-8">

   <fileset dir="res" includes="*.*"/> <!-- 将res目录中的文件也打进JAR包 -->

</jar>

</target>

         

(7)exec任务,用以调用外部程序

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

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

</exec>

 

四、ANT的参数部分:

  

-quiet(不显示大多数build信息)

-verbose(显示构建过程的每个操作的详细信息)

-buildfile filename.xml 构建特定的xml文件

-Dproperty=value 设定特别的外部参数,外部参数可以传递给内部变量

-find filename.xml 它会让ANT自动查找当前的目录、父目录中的xml文件,直到失败

  

例:

ant -buildfile test.xml

  

使用当前目录下的test.xml运行Ant

  

ant -buildfile test.xml dist

  

使用当前目录下的test.xml运行Ant,执行一个叫做dist的target。

  

ant -buildfile test.xml -Dbuild=build/classes dist

  

使用当前目录下的test.xml运行Ant,执行一个叫做dist的target,并设定build变量的值为build/classes。

  

五、自定义TASK

  

ANT已经内置了不少task,像copy、replace、javac等等,但是有时候还需要一些特定的任务来完成操作,比如在生成JAD文件 时,需要一个Midlet-Jar-Size的参数,得到JAR文件的大小,但是通过内部的task无法实现,因此可以自己编写类来实现此功能,但必须保 证该类是从Task类继承过来的。

  

例:

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

<filesize file="${Base}/Demo_Build/${jarName}" property="size" />

   <replace dir="store" includes="${jadName}" encoding="UTF-8">

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

</replace>

  

解释:taskdef:自定义任务,name:任务名  

编写Ant 自定义任务很简单,Ant 能够使用生成文件中指定的对应属性的值来调用这个方法,这个方法的名称需要是 set 加上属性的名称,因此在下面的例子中,我们需要名为 setFile() 和 setTofile() 的两个方法。

当 Ant 遇到生成文件中的一个属性设置时,它会寻找相关任务中具有适当名称的方法(称为 setter 方法)。

生成文件中的属性是作为字符串来指定的,因此我们的 setter 方法的参数可以是一个字符串。在这样的情况下,Ant 将在展开值所引用的任何属性之后,使用该属性的字符串值来调用我们的方法。

但有时我们想把属性的值看作是一种不同的类型。这里的示例任务就是这种情况,其中的属性值引用文件系统上的文件,而不只是引用任意的字符串。可以通过将方法参数声明为 java.io.File 类型来容易地做到这点。

Ant 将接受属性的字符串值,并把它解释为一个文件,然后传递给我们的方法。Ant 能够对其他类型执行类似的转换,比如 boolean 和 int 类型。但如果提供具有相同名称但是具有不同参数的两个方法,Ant 将使用更明确的那一个方法,因此文件类型将优先于字符串类型。

例:一个排序的task任务

public class FileSorter extends Task {

private File file, tofile;

// ant在进行任务处理时会调用execute()方法

     public void execute() throws BuildException {

         System.out.println("Sorting file="+file);

         try {

             BufferedReader from =

                 new BufferedReader(new FileReader(file));

             BufferedWriter to =

                 new BufferedWriter(new FileWriter(tofile));

             List allLines = new ArrayList();

             // read in the input file

             String line = from.readLine();

             while (line != null) {

                 allLines.add(line);

                 line = from.readLine();

             }

             from.close();

             // sort the list

             Collections.sort(allLines);

             // write out the sorted list

             for (ListIterator i=allLines.listIterator(); i.hasNext(); ) {

                 String s = (String)i.next();

                 to.write(s); to.newLine();

             }

             to.close();

         } catch (FileNotFoundException e) {

             throw new BuildException(e);

         } catch (IOException e) {

             throw new BuildException(e);

         }

     }

     // file参数

     public void setFile(File file) {

         this.file = file;

     }

     // tofile参数

     public void setTofile(File tofile) {

         this.tofile = tofile;

     }

}

 

使用这个自定义任务:

<taskdef name="filesorter"   classname=" FileSorter" classpath="filesorter"/>

    <target name="main">

         <filesorter file="input.txt" tofile="output.txt"/>

    </target>

  

解释:file和tofile分别是程序入口、出口

    留下足迹