Ant 简明教程
Ant - Property Files
如果只需使用少数几个属性,则直接在构建文件中设置属性就足够了。但是,对于大型项目而言,将属性存储在单独的属性文件中有意义。
Benefits
将属性存储在单独的文件中会带来以下好处:
-
它允许你对同一构建文件进行重复使用,针对不同的执行环境使用不同的属性设置。例如,可以在 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.tutorialspoint.com
buildversion=3.3.2
在上述示例中, sitename 是映射到网站名称的自定义属性。您可以用这种方式声明任意数量的自定义属性。
上述示例中列出的另一个自定义属性是 buildversion ,它在这种情况下指代构建版本。
除上述内容外,Ant 内含若干预定义构建属性,已在上一部分中列出,但在此再次列出以供参考。
Sr.No |
Properties & Description |
1 |
ant.file 构建文件的完整位置。 |
2 |
ant.version Apache Ant 安装的版本。 |
3 |
basedir 构建的 basedir,如 project 元素的 basedir 属性中指定。 |
4 |
ant.java.version Ant 使用的 JDK 版本。 |
5 |
ant.project.name 项目名称,如 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 内置属性。