Basis-ANT

安装

JDK 要求 1.4 及以上版本,推荐 1.7 及以上版本
确保 JAVA_HOME 已配置

  • 下载二进制版压缩包、解压
  • 配置 ANT_HOME 为 Ant 主目录;同时将 bin 目录添加到 PATH
  • 检查安装,命令行输入 ant,输出如下:
Buildfile: build.xml does not exist!
Build failed

使用

语法

Ant 的构建文件以 XML 文件编写。构建文件包含包含一个 project 和至少一个(默认的)target。targets 包含 task 元素,每个 task 元素包含 id 属性以便后续使用。task 元素即是一些执行动作,整个构建则由一系列的执行动作以及必要的属性配置构成。全局属性通过 property 元素配置。

  • property 也是一个 task,用来设置 键值对 形式的数据,便于重用设置
    • 系统属性
    • Ant 内置属性
    • 基本语法
    
    

1.6 之后所有 task 都可放到任何 target 外部声明;
当 task 处于 target 外部时,会在任何 target 执行之前计算

  • target 基本语法
    
    
    
    

    执行顺序 A -> B -> C ->D
  • task 基本语法:

  • Ant 内置了很多常用的 task

  • 当然用户也可以编写自己的 task

  • 示例文件



  
  
    simple example build file
  

  
  
  
  

  
  
    
    
    
    
    
  

  
  
    
    
  

  
    
    

    
    
  

  
    
    
    
  

以上示例包含几个 target 任务,默认任务为 dist

  • init 初始化动作,创建了一个 build 目录用于编译
  • compile 编译动作,将 src 目录的源码编译到 build 目录中,依赖于 init 任务
  • dist 打包发布,创建 dist/lib 目录,生成 jar 包,依赖于 compile 任务
  • clean 清理使用的目录

路径处理/ Path

编译 Java 代码时,通常会指定依赖的 jar 包,ANT 中主要有两种方式配置

  • 通过全局设置 指定路径,然后在 任务中引用该配置,可在多个任务中共享
 
    
    
    
  

  
    
      
    
  
  • 直接在 任务中指定路径

    
      
        
        
        
      
    
  

只在 javac 等其他任务中作为参数,并不是一个 task

资源 Resource

在 Ant 中,文件/文件夹被抽象为 [资源](http://ant.apache.org/manual/Types/
resources.html),便于文件访问。

内置的资源类型:

  • resource 基础资源类型,其他资源类型都基于此类型
  • file 代表可通过本地文件系统访问的文件
  • javaresource 可通过 Java 类加载器加载的资源
  • javaconstant 获取 Java 常量值,该常量签名必须为 public static
  • zipentry 代表 ZIP 压缩文件中的某个文件
  • tarentry 代表 TAR 压缩文件中的某个文件
  • gzipresource 非标准资源,为其他资源提供即时压缩的一层封装
  • bzip2resource 非标准资源,为其他资源提供即时压缩的封一层封装
  • url 代表 URL
  • string 代表 Java 字符串
  • propertyresource 代表 Ant 属性

资源集合 Resource Collections

包含资源的资源组

分类:

  • fileset, dirset, multirootfileset, filelist, 和 path (以及衍生的类型) 代表 file 资源
  • tarfileset,代表 file 或 tarentry
  • zipfileset,代表 file 或 zipentry
  • propertyset,代表 property 资源

内置的资源集合

有点类似 SQL 查询操作

  • resources 普通资源集合
  • files 与 fileset 类似的文件集合
  • restrict 根据指定条件限制包含的资源
  • sort 根据自然排序或指定排序器,将资源排序
  • first 获取第一个资源,可与 sort 结合使用,排序查找资源
  • last 获取最后一个资源
  • allbutfirst 除第一个以外的所有资源
  • allbutlast 出最后一个以外的所有资源
  • tokens 包含从资源中的 string 标记,可用来实现 Unix 函数(如 sort, grep 等)
  • 设置 Set operations
    • union 取指定资源集合的并集
    • intersect 取指定资源集合的交集
    • difference 取指定资源集合的差集
  • mappedresources 封装另一个资源集合并使用 mapper 映射内部资源
  • archives 接受任意数量的资源并假定它们是 ZIP 或 TAR 压缩文件。返回资源的内容
  • resourcelist 接受任意数量的资源,读取这些资源并返回一个行读取的资源

文件过滤

通过对资源、资源集合的操作,对构建的文件过滤、筛选;
以 fileset 、dirset 为例


  
  
  
    
  
  
  
  
    
    
  
  

项目实例

  • 背景
    Java Web 项目,通过 Jenkins 配置自动构建,同时调用 ant 脚本进行项目构建打包
  • 目的
    • 设置依赖库
    • 创建构建目录
    • 拷贝静态文件(页面、图片等不需编译文件,包括依赖库)到构建目录
    • 替换自定义配置的 jdbc 文件
    • 编译源代码
    • 生成 war 包


        
                simple example build file
        

        

        
        
        
        
        
        
        

        
        

        

                
                        
                
                
                        
                
                
                        
                
        

        
                
                
        

        
                
                
                
                
            
                
                

                
                        
                                
                                
                        
                

                
                        
                                
                                
                        
                

                
                
        

        
                
                
                
        

        
                
                

                
                        
                        
                
        

运行

Ant 提供两种方式运行:

  • 命令行
ant [options] [target [target2 [target3] ...]]

详细参数可使用 ant -h 查看
示例:
- ant 默认当前文件包含 build.xml,运行默认任务
- ant -buildfile anotherName.xml ,指定配置文件,运行默认任务
- ant -buildfile anotherName.xml dist,指定配置文件,运行指定任务

  • Java 调用
// 传统调用入口
java -Dant.home=c:\ant org.apache.tools.ant.Main [options] [target]
// 1.6 后引入
java -Dant.home=c:\ant org.apache.tools.ant.launch.Launcher [options] [target]

Ant 也可以通过 命令启动

```

    
        
    
    
    
    
    
    
    
    

```

对比两种方式,命令行更加方便,且可与其他工具配合使用。

你可能感兴趣的:(Basis-ANT)