• ant语法和规范


    一、前言:

           以前在做JavaEE项目的时候曾经听说过这个名字,但是由于没有用到,所以也没有去学习。最近在研究Android打包的时候,看了下build.xml文件,甚是迷糊,于是学习一下,稍有心得。

    二、什么是ant?

            ant是一种基于Java的打包工具,非常类似于Linux下的makefile。ant有自己的语法和规范,通常用xml来承载。ant可以集成代码生成、编译、打包等功能(需要说明一下,ant本身并不具备这些功能,只是调用者),使用ant能做到编译、打包一系列流程的自动化,就像生产流水线,一条指令,全程自动生产。

    ant工具是使用Java语言编写的,所以依赖jdk,安装ant必须先安装好jdk。同样ant很多扩展的自定义的功能同样可以使用Java编写,后续会详细介绍。

    三、ant的基本语法和规范

                ant的构建脚本是使用xml文件承载的,缺省命名为build.xml。进入其文件所在目录,可以在cmd中直接使用ant命令调用(前提是先配好bin目录的环境变量)。

           我们先来看一下build.xml文件的基本结构:

    [html] view plain copy
     
    1. <?xml version="1.0" encoding="UTF-8"?>  
    2. <project name="test" default="build">  
    3.       <property name="file.dir" value="D://"/>  
    4.         <property file="local.properties" />  
    5.         <loadproperties srcFile="project.properties" />  
    6.         <import file="rules.xml" optional="true" />  
    7.         <target name="build">  
    8.              <echo>runing...</echo>  
    9.         </target>  
    10.        <target name="debug" depends="build">  
    11.              <echo level="info">${file.dir} debugging...</echo>  
    12.        </target>  
    13. </project>  

    project    根标签。name属性表示项目名称,没什么作用;default属性表示默认执行命令,cmd命令行中使用antant  default属性值(本例是ant build) 两种方式等效。

    property  定义类标签。可以定义一些常量值,需要注意:定义后理论不能再修改(其实可以通过第三方库修改)。比如第3行定义了一个file.dir的变量,值为”D://“,引用时使用 ${file.dir}调用。第4行,是引入一个properties文件(里面定义了很多property),相当于导包。

    loadproperties  引用标签。功能和第4行<property file=""/>等同,表示引入一个properties定义集群。好处是便于封装和管理。

    import  引入标签。和loadproperties不同的是,import是引入另一个构建文件,包括变量和执行命令。

    target  执行标签。可以在cmd命令行中直接ant + target执行,比如以上脚本可以执行: ant build 和 ant debug。target标签中有个depends属性,表示执行命令依赖。如果要执行debug命令,会自动先执行depends里面的命令。以上脚本执行 ant debug,实际是执行了 ant build 和 ant debug

    echo  日志标签。表示日志输出,能在cmd命令中打印显示,level属性表示:日志级别。 比较特殊的是echo中可以引用变量,用法同变量调用方式${name}。

    以上就是ant最基本的语法规范,我们执行下ant debug命令看看结果。

    分析以上执行过程:cmd进入build.xml所在目录,执行target名为debug的命令,由于debug依赖于build,所以先执行build命令,打印出runing... 然后再执行debug命令下的语句,打印出D:// debugging... (注意其中引用了一个变量),执行完毕!

    四、ant的常用语法

            1、文件语句

            文件操作是ant中最常用的基本操作,包括创建、复制、删除、遍历等。由于ant涉及最多的就是文件操作,所以它的api相对来说非常丰富,让我们来逐一介绍和学习。

            创建:mkdir标签。 传入一个文件路径,直接创建出一个文件目录。然而不知为何ant没有提供创建文件的功能。

    [html] view plain copy
     
    1. <mkdir dir="D:/test"/><span style="font-family: Arial, Helvetica, sans-serif; background-color: rgb(255, 255, 255);">      </span>  

            删除:delete标签。删除文件或文件夹。

    [html] view plain copy
     
    1. <delete file="D:/test/example.txt"/>  
    2. <delete dir="D:/test"/>  

                 移动:move标签。包括文件重命名、文件移动、文件目录移动。

    [html] view plain copy
     
    1. <!-- 重命名 -->  
    2. <move file="D:/test/example1.txt" tofile="D:/test/example2.txt"/>  
    3. <!-- 移动文件至新目录,新目录会自动创建 -->  
    4. <move file="D:/test/example2.txt" todir="D:/test2"/>  
    5. <!-- 文件夹移动 -->  
    6. <move dir="D:/test/example2.txt" todir="D:/test2"/>  


                 复制:copy标签。文件复制。

    [html] view plain copy
     
    1. <!-- 文件复制,指定新文件名 -->  
    2. <copy file="D:/test/example.txt" tofile="D:/test/example2.txt"/>  
    3. <!-- 文件复制,指定新文件目录 -->  
    4. <copy file="D:/test/example.txt" todir="D:/test/new/"/>  
    5. <!-- 文件夹复制,指定新文件夹 -->  
    6. <copy dir="D:/test/" todir="D:/test/new/"/>  

            2、条件语句

    
    

                 condition标签,配合istrue或者isfalse使用。

    [html] view plain copy
     
    1. <condition property="check">  
    2.     <istrue value="false" />  
    3. </condition>  
    4. <target name="build" if="check">  
    5.     <echo>build running...</echo>  
    6. </target>  


            稍微解释下以上语句:在执行名为build的target任务时,由于target中含有if的标签,所以需要判断名为check的条件语句的值,但是istrue=false的语句表示条件不符合,echo并不会执行。如果改成istrue=true,echo将执行。当然以上语句等价于:

    [html] view plain copy
     
    1. <condition property="check">  
    2.     <isfalse value="true" />  
    3. </condition>  
    4. <target name="build" if="check">  
    5.     <echo>build running...</echo>  
    6. </target>  

                     需要注意下,istrue和isfalse两种标签不能同时存在。

              除了直接使用istrue指定条件语句的值,还能动态地使用equals比较变量,比如:

    [html] view plain copy
     
    1. <property name="id" value="99"></property>  
    2.     <condition property="check">  
    3.         <equals arg1="${id}" arg2="100"/>  
    4.     </condition>  
    5.     <target name="build" if="check">  
    6.         <echo>build running...</echo>  
    7.     </target>  


            3、循环语句
            ant本身并没有提供循环语句,但是我们可以借助于ant-contrib.jar使用循环语句,举个简单的例子:

    [html] view plain copy
     
    1.    <property name="ant-contrib" value="E:\Android\android-sdk\tools\lib\ant-contrib-1.0b3.jar"></property>  
    2.    <taskdef name="foreach" classname="net.sf.antcontrib.logic.ForEach" classpath="${ant-contrib}"/>  
    3. <target name="build">  
    4.     <foreach list="1,2,3,4,5,6,7,8,9" param="number" delimiter="," target="log"/>    
    5. </target>  
    6. <target name="log">  
    7.     <echo>foreach running: ${number}</echo>  
    8. </target>  

           以上语句稍微有些复杂,我们一句句来理。第一句property定义一个变量,即扩展jar包ant-contrib-1.0b3.jar所在的文件位置。第二句taskdef标签,表示定义自定义名为foreach的标签,需要引用类名和类路径,这是使用foreach的前提条件,必须先定义好。然后我们就可以在target任务中愉快地使用for循环了。
           接下来我们来看foreach语句的内容,list标签 + delimiter标签构成循环的条件,这里是循环9次,每次循环创建一个名为number的数字变量,同时执行log任务打印一句话,结果如下:



            4、自定义语句

            ant的魅力所在之处就是强大的自定义语句,比如上面的foreach语句。ant官方库只定义了一些简单的语句,但是在实际项目中远远不足以满足我们的需要,比如新建一个文件。这里我们就用自定义语句来实现下。

            ant的原理是每个语句标签映射一个java类文件,每个标签里的属性则映射java类的变量,有点类似spring中xml映射javabean。每个ant标签映射的java类文件不是随意编写的,有一定的规范。

            在ant安装目录下的lib文件目录中有个名为ant.jar的包,这个就是ant的规范标准库,自定义语句Java类都需要依赖它来编译,同时每个语句必须继承其中名为Task.java的基类,复写execute方法执行自定义操作。

    [java] view plain copy
     
    1. package com.ant.test;  
    2.   
    3. import java.io.File;  
    4. import java.io.IOException;  
    5.   
    6. import org.apache.tools.ant.BuildException;  
    7. import org.apache.tools.ant.Task;  
    8.   
    9. public class FileCreater extends Task{  
    10.   
    11.     private String fileName;  
    12.       
    13.     public void setName(String fileName){  
    14.         this.fileName = fileName;  
    15.     }  
    16.       
    17.     @Override  
    18.     public void execute() throws BuildException {  
    19.         try {  
    20.             new File(fileName).createNewFile();  
    21.         } catch (IOException e) {  
    22.             log("create file '" + fileName + "' failed!");  
    23.         }  
    24.         log("create file '" + fileName + "' successful!");  
    25.         super.execute();  
    26.     }  
    27. }  

             上面定义了创建文件的自定位标签,把这个java文件打成jar包,然后就可以在build.xml使用了,xml内容如下:

    [html] view plain copy
     
    1.    <property name="fileJar" value="D:/file.jar"></property>  
    2.    <taskdef name="filecreater" classname="com.ant.test.FileCreater" classpath="${fileJar}"/>  
    3. <target name="build">  
    4.     <filecreater name="D:/test.txt"/>    
    5. </target>  

             以上执行的操作是创建一个路径为D:/test.txt的文件。filecreater是映射FileCreater.java的自定义标签,name属性传入文件路径名,会自动 反射调用FileCreater.java中的setName方法注入参数值。在FileCreater.java中有个log打印输出方法,可以在cmd中输出,极大方便我们的调试。执行结果如下:


    ------------------------------------------------------------------------------------------------>

    好了,ant相关的就先写到这里,权当抛砖引玉^-^

    http://blog.csdn.net/MegatronKings/article/details/48012125

  • 相关阅读:
    经典小程序源码及其下载地址
    关闭ios虚拟键盘的几种方法
    从零开始学ios开发(十八):Storyboards(下)
    iOS应用程序生命周期(前后台切换,应用的各种状态)详解
    从零开始学ios开发(十九):Application Settings and User Defaults(上)
    关于IOS中的delegate必须知道的事情
    ios多线程和进程的区别(转载)
    ios各种手势,很有意思
    IOS中GPS定位偏移纠正(适用于Google地图)
    [iOS]深入浅出 iOS 之多线程 NSThread
  • 原文地址:https://www.cnblogs.com/luolizhi/p/5514170.html
Copyright © 2020-2023  润新知