使用构建文件属性控制Ant脚本的行为

使用构建文件属性控制Ant脚本的行为

您可以控制 IntelliJ IDEA 执行 Ant 脚本的方式。如果要在后台执行，请更改分配给构建过程的内存量，或者设置其他执行选项，则需要打开“构建文件属性（Build File Properties）”对话框。

打开构建文件属性对话框的操作步骤如下：

1. 在 Ant 构建工具窗口中，选择所需的构建文件。
2. 执行以下操作之一：在选择的上下文菜单上，选择“属性（Properties）”。点击 Ant Build 工具栏上的按钮。按 Alt+Enter。

定义其他Ant类路径

Ant 构建脚本需要独立于 IntelliJ IDEA 的类路径，或者需要额外的库才能正常运行。本节介绍如何将目录和存档添加到类路径中，并更改 Ant 加载资源的顺序。

以下是配置 Ant 类路径的操作步骤：

1. 打开“构建文件属性（Build File Properties）”对话框。
2. 选择“其他类路径（Additional Classpath）”选项卡。
3. 单击“添加（Add）”，然后在“选择路径（Select Path）”对话框中选择要添加到类路径的档案或目录。如果要添加整个目录的内容，请单击“将所有内容添加到目录（Add All In Directory）” 按钮，然后在“选择路径（Select Path）”对话框中选择所需的目录 。
4. 使用“上移（Move Up）”和“下移（Move Down）”按钮可更改类路径项的顺序。

定义Ant执行选项

使用“构建文件属性（Build File Properties）”对话框，您可以控制 IntelliJ IDEA 如何启动 Ant 构建过程。特别是，您可以定义应使用哪个版本的 Ant，添加命令行参数以及指定用于运行 Ant 的 SDK。

定义 Ant 执行选项的操作步骤如下：

1. 打开“构建文件属性（Build File Properties）”对话框。
2. 选择“执行（Execution）”选项卡。
3. 在“使用Ant运行（Run With Ant）”部分中，指定是否要使用项目默认或自定义 Ant 版本。如果要使用自定义 Ant 版本而不是捆绑的版本，请从下拉列表中选择它，或者单击省略号按钮并通过添加类路径来配置 Ant 。
4. 在“Ant命令行（Ant command line）”字段中，使用标准的 Ant 语法键入命令行参数：在破折号前加参数，并用空格分隔。对于冗长的命令行，请单击，并在“Ant命令行（Ant command line）”对话框中键入文本。
5. 在“JDK下运行（Run under JDK）”字段中，指定要用于 Ant 进程的 SDK：从列表中选择 SDK，或单击省略号按钮并配置单个 SDK。

定义Ant过滤器

默认情况下， Ant 构建工具窗口显示构建文件的所有目标。筛选使您可以根据需要显示或隐藏目标。默认筛选器仅显示主要目标。您可以更改此行为，并使用应用过滤器时应该可见的自定义目标集来配置您自己的过滤器。

为构建目标配置自定义过滤器的操作步骤如下：

1. 打开“构建文件属性（Build File Properties）”对话框。
2. 在“过滤器（Filters）”选项卡中，清除要隐藏的构建目标旁边的复选框，然后选中要显示的目标旁边的复选框。现在，当您按过滤器按钮来应用过滤器时，只会显示筛选器列表中选定的目标。

定义运行时属性

使用“构建文件属性（Build File Properties）”对话框的“属性（Properties）”选项卡在运行时将属性传递给构建脚本。指定的值等同于命令行启动程序 -D 选项后定义的值。 

除了明文值之外，还可以使用在运行时计算的宏（macros）。当您必须将特定路径和其他不同的信息传递给构建脚本时，这样的宏很有用。宏是用美元符号包围的字符串。“构建文件属性（Build File Properties）”对话框提供了可用于选定生成文件的宏的完整列表，以及显示的预览，以及在运行时如何计算这些宏。

定义运行时属性的操作步骤如下：

1. 打开“构建文件属性（Build File Properties）”对话框。
2. 在“属性（Properties）”选项卡中，单击“添加（Add）”。
3. 在名称列中，输入属性名称。
4. 在“值（Value）”列中，输入所需的值。如果您使用宏作为属性值，请输入所需宏的名称。如果您不知道名称，请单击该按钮，从“宏（Macros）”对话框中选择所需的宏，然后单击“确定”。
5. 使用“添加（Add）”和“删除（Remove）”按钮组成完整的属性列表。

在后台执行生成文件

默认情况下，在构建过程中，Ant 会显示一个显示构建进度的模式对话框。可以在后台执行构建，并利用这段时间来处理其他事情。

启用构建文件的后台执行：

1. 打开“构建文件属性（Build File Properties）”对话框。
2. 选中“后台制作（Make build in background）”选项。