Ant - 属性文件



如果只处理少量属性,直接在构建文件中设置属性是可以的。但是,对于大型项目,将属性存储在单独的属性文件中更合理。

优势

将属性存储在单独的文件中具有以下优势:

  • 它允许您重用相同的构建文件,并为不同的执行环境使用不同的属性设置。例如,可以为开发、测试和生产环境分别维护构建属性文件。

  • 当您事先不知道某个环境中属性的值时,它很有用。这允许您在知道属性值的其它环境中执行构建。

没有硬性规定,但属性文件通常命名为**build.properties**,并与**build.xml**文件放在一起。您可以根据部署环境创建多个构建属性文件,例如**build.properties.dev**和**build.properties.test**。

构建属性文件的内容类似于普通的Java属性文件。它们每行包含一个属性。每个属性由名称和值对表示。

名称和值对由等号 (=) 分隔。强烈建议对属性添加适当的注释。注释使用井号 (#) 字符列出。

以下示例显示了一个**build.xml**文件及其关联的**build.properties**文件:

build.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.tutorialspoint.com
buildversion=3.3.2

在上面的示例中,**sitename**是一个自定义属性,它映射到网站名称。您可以按照这种方式声明任意数量的自定义属性。

上面示例中列出的另一个自定义属性是**buildversion**,在本例中,它指的是构建的版本。

除此之外,Ant还带有一些预定义的构建属性,这些属性在上一节中列出,但为了方便参考,这里再次列出。

序号 属性和说明
1

ant.file

构建文件的完整位置。

2

ant.version

Apache Ant安装的版本。

3

basedir

构建的basedir,如项目元素的basedir属性中指定。

4

ant.java.version

Ant使用的JDK版本。

5

ant.project.name

项目名称,如项目元素的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**内置属性。

广告