Ant

Ant 构建运行程序可以处理 Ant build.xml 文件。

测试框架支持

TeamCity Ant 运行器支持 JUnit 和 TestNG 框架。当测试由脚本中的 junit 和 testng 任务直接运行时，TeamCity 将实时报告测试结果。

通过在您的 Ant 脚本中使用 <parallel> 标签，可以使 JUnit 和 TestNG 任务并行运行。 TeamCity 支持这一点，并应正确地并发记录并行进程。

报告和日志记录

TeamCity 从 Ant 收集关于已执行的活动的详细数据，提供结构化的错误报告，并报告测试。然而，您可以启动一个没有特定报告或关闭 TeamCity 特定日志记录的构建：

要禁用 Ant 中的 TeamCity 特定报告，使用 teamcity.ant.listener.enabled=false 构建配置参数
要禁用 JUnit 报告，使用 teamcity.ant.junit-support.enabled=false 系统属性
要禁用 TestNG 报告，请使用 teamcity.ant.testng-support.enabled=false 系统属性

Ant 运行设置

Ant 参数

选项	描述
构建.xml文件的路径	如果您选择了这个选项，您可以键入项目的 Ant 构建脚本文件的路径。路径是相对于项目根目录的。或者，点击使用 VCS 仓库浏览器选择文件。
构建文件内容	如果您选择此选项，点击输入构建文件内容链接并在文本区域内输入您的自定义构建文件的源码。请注意，该文本区域可以调整大小。使用隐藏链接来关闭文本区域。
工作目录	如果与检出目录不同，指定构建工作目录。
目标	使用此文本字段来以空格分隔的字符串列表形式指定有效的 Ant 目标。可用目标可以通过点击字段旁边的图标在网络用户界面中查看，并通过检查相应的框进行添加。如果此字段留空，将运行构建脚本文件中指定的默认目标。
Ant 主目录路径	指定您的自定义 Ant 分发版的路径。如果您打算使用与 TeamCity 捆绑的 Ant 发行版，那么您不需要指定此参数。请注意，如果您希望在构建中运行 JUnit4 测试，应该使用 Ant 1.7。
附加的 Ant 命令行参数	如有需要，您可以指定额外的命令行参数，以空格分隔列出。例如，您可以指定 ant-net-tasks Tool（见下文）。

ant-net-tasks 工具

Ant 构建运行程序附带一个捆绑工具，ant-net-tasks，它包含了执行网络任务所需的 jar 文件，例如 FTP，sshexec，scp 和 mail。
它还包含可以用于 REST 请求的 missing link Ant task。

要使用此工具，请在运行器设置的额外的 Ant 命令行参数中指定 -lib "%teamcity.tool.ant-net-tasks%"。

Java 参数

选项	描述
JDK	选择一个 JDK。本节详述了可用的选项。默认值为 `JAVA_HOME` 环境变量或代理自身的 Java。
JDK 主目录路径	当上方选择了 <Custom> 时，此选项便可用。使用此字段来指定用于运行构建的自定义 JDK 的路径。如果该字段为空，则会从代理机器的 `JAVA_HOME` 环境变量或在构建代理配置文件（ `buildAgent.properties` ）中指定的 `env.JAVA_HOME` 属性读取JDK Home的路径。如果这些值未被指定，TeamCity 将使用构建代理进程本身的 Java home。
JVM 命令行参数	附加的 JVM 命令行参数允许您设置初始和最大堆大小，启用额外的日志记录，选择所需的字节码验证器模式等等。您可以指定标准的（例如以 `-` 开始，例如 `-verbose：[class\|module\|gc\|jni]` 或 `--dry-run` ）和非标准的（例如以 `-X` 开始，例如 `-Xmx<size>` 或 `-XstartOnFirstThread` ）JVM 选项。要指定多个命令行参数，使用空格作为分隔符。例如： -verbose:gc -Xdiag -Xcomp -Xmx512m -Xms256m

选项

描述

JDK

选择一个 JDK。本节详述了可用的选项。默认值为 JAVA_HOME 环境变量或代理自身的 Java。

JDK 主目录路径

当上方选择了 <Custom> 时，此选项便可用。使用此字段来指定用于运行构建的自定义 JDK 的路径。如果该字段为空，则会从代理机器的 JAVA_HOME 环境变量或在构建代理配置文件（ buildAgent.properties ）中指定的 env.JAVA_HOME 属性读取JDK Home的路径。如果这些值未被指定，TeamCity 将使用构建代理进程本身的 Java home。

JVM 命令行参数

附加的 JVM 命令行参数允许您设置初始和最大堆大小，启用额外的日志记录，选择所需的字节码验证器模式等等。

您可以指定标准的（例如以 - 开始，例如 -verbose：[class|module|gc|jni] 或 --dry-run ）和非标准的（例如以 -X 开始，例如 -Xmx<size> 或 -XstartOnFirstThread ）JVM 选项。

要指定多个命令行参数，使用空格作为分隔符。例如：

-verbose:gc -Xdiag -Xcomp -Xmx512m -Xms256m

测试参数

测试重新排序的工作方式如下：TeamCity 提供应该优先运行的测试（测试类），然后，当 JUnit 任务开始时，它会检查是否包含这些测试。如果至少包含一个测试，TeamCity 将生成一个新的只包含已包含测试的文件集，并在所有其他文件集之前进行处理。它还修补其他文件集，以排除添加到自动生成的文件集中的测试。此后，JUnit 就如常启动并运行。

选项	描述
缩短测试失败反馈时间：	使用以下两种选项，指示 TeamCity 先运行某些测试。首先运行最近失败的测试 —— 如果选中，TeamCity 将首先运行在之前完成或正在运行的构建中失败的测试，以及具有高失败率的测试（即所谓的闪烁测试）。首先运行新的和修改过的测试 - 如果勾选此选项，TeamCity将首先运行在正在构建的更改列表中添加或修改的测试。

选项

描述

缩短测试失败反馈时间：

使用以下两种选项，指示 TeamCity 先运行某些测试。

首先运行最近失败的测试 —— 如果选中，TeamCity 将首先运行在之前完成或正在运行的构建中失败的测试，以及具有高失败率的测试（即所谓的闪烁测试）。
首先运行新的和修改过的测试 - 如果勾选此选项，TeamCity将首先运行在正在构建的更改列表中添加或修改的测试。

Docker 设置

在这个部分，您可以指定一个将被用于运行构建步骤的 Docker 镜像。

Code Coverage（代码覆盖率）

要了解如何配置代码覆盖率选项，请参阅配置 Java 代码覆盖率页面。

JUnit 5 支持

TeamCity Ant 运行器如果这些测试在 <junitlauncher> 任务中声明，那么它目前不会在 "测试" 构建结果选项卡下显示测试。使用 <junit> 任务，或将您的项目迁移到 Gradle（TeamCity 的 Gradle runner 完全支持 JUnit 5）。

最后修改日期： 16日 7月 2024年