Ant - 属性文件
如果您使用少量属性,直接在构建文件中设置属性就可以了。 但是,对于大型项目,将属性存储在单独的属性文件中是有意义的。
优点
将属性存储在单独的文件中具有以下好处 −
它允许您重用相同的构建文件,不同的执行环境具有不同的属性设置。 例如,可以为 DEV、TEST 和 PROD 环境单独维护构建属性文件。
当您预先不知道属性的值(在特定环境中)时,它很有用。 这允许您在属性值已知的其他环境中执行构建。
没有硬性规定,但通常将属性文件命名为 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.w3ccoo.com buildversion=3.3.2
在上面的示例中,sitename 是一个映射到网站名称的自定义属性。 您可以以这种方式声明任意数量的自定义属性。
上例中列出的另一个自定义属性是 buildversion,在本例中,它指的是构建的版本。
除上述之外,Ant 还附带了许多预定义的构建属性,这些属性在上一节中列出,但在下面再次给出以供您参考。
序号 | 属性 & 描述 |
---|---|
1 | ant.file 构建文件的完整位置。 |
2 | ant.version Apache Ant 安装的版本。 |
3 | basedir 构建的 basedir,在项目元素的 basedir 属性中指定。 |
4 | ant.java.version The version of the JDK that is used by Ant. |
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 内置属性。