Ant - 属性文件

  • 简述

    如果您使用的是少量属性,则直接在构建文件中设置属性是可以的。但是,对于大型项目,将属性存储在单独的属性文件中是有意义的。
  • 好处

    将属性存储在单独的文件中具有以下好处 -
    • 它允许您重复使用相同的构建文件,为不同的执行环境设置不同的属性。例如,可以为 DEV、TEST 和 PROD 环境单独维护构建属性文件。
    • 当您事先不知道某个属性(在特定环境中)的值时,它很有用。这允许您在属性值已知的其他环境中执行构建。
    没有硬性规定,但通常将属性文件命名为build.properties并放置在旁边build.xml文件。您可以根据部署环境创建多个构建属性文件——例如build.properties.devbuild.properties.test.
    构建属性文件的内容类似于普通的 java 属性文件。它们每行包含一个属性。每个属性都由一个名称和一个值对表示。
    名称和值对由等号 (=) 分隔。强烈建议使用适当的注释对属性进行注释。注释使用井号 (#) 字符列出。
    下面的例子展示了一个build.xml文件及其关联build.properties文件 -

    构建.xml

    下面给出的是 build.xml 文件的示例。
    
    
    <?xml version="1.0"?>
    
    <project name="Hello World Project" default="info">
    
       <property file="build.properties"/>
    
          <target name="info">
    
             <echo>Apache Ant version is ${ant.version} - You are at ${sitename} </echo>
    
          </target>
    
    </project>
    
    

    build.properties

    下面提到了 build.properties 文件的示例 -
    
    
    # The Site Name
    
    sitename=www.cainiaoya.com
    
    buildversion=3.3.2
    
    
    在上面的例子中,sitename是映射到网站名称的自定义属性。您可以用这种方式声明任意数量的自定义属性。
    上例中列出的另一个自定义属性是buildversion,在这种情况下,指的是构建的版本。
    除了上述之外,Ant 还带有许多预定义的构建属性,这些属性已在上一节中列出,但在下面再次给出以供您参考。
    序号 属性和描述
    1
    ant.file
    构建文件的完整位置。
    2
    ant.version
    Apache Ant 安装的版本。
    3
    basedir
    构建的 basedir,在 project 元素的 basedir 属性中指定。
    4
    ant.java.version
    Ant 使用的 JDK 版本。
    5
    ant.project.name
    项目的名称,在项目元素的名称属性中指定。
    6
    ant.project.default-target
    当前项目的默认目标。
    7
    ant.project.invoked-targets
    当前项目中调用的目标的逗号分隔列表。
    8
    ant.core.lib
    Ant jar 文件的完整位置。
    9
    ant.home
    Ant 安装的主目录。
    10
    ant.library.dir
    Ant 库文件的主目录——通常是 ANT_HOME/lib 文件夹。
    本章中的示例使用ant.version内置属性。