通过

Ant@1 - Ant v1 任务

  • 项目

使用此任务通过 Apache Ant 进行生成。

语法

# Ant v1
# Build with Apache Ant.
- task: Ant@1
  inputs:
    buildFile: 'build.xml' # string. Alias: antBuildFile. Required. Ant build file. Default: build.xml.
    #options: # string. Options. 
    #targets: # string. Target(s). 
  # JUnit Test Results
    #publishJUnitResults: true # boolean. Publish to Azure Pipelines. Default: true.
    testResultsFiles: '**/TEST-*.xml' # string. Required when publishJUnitResults = true. Test results files. Default: **/TEST-*.xml.
    #testRunTitle: # string. Optional. Use when publishJUnitResults = true. Test run title. 
  # Code Coverage
    #codeCoverageToolOptions: 'None' # 'None' | 'Cobertura' | 'JaCoCo'. Alias: codeCoverageTool. Code coverage tool. Default: None.
    codeCoverageClassFilesDirectories: '.' # string. Alias: classFilesDirectories. Required when codeCoverageTool != None. Class files directories. Default: ..
    #codeCoverageClassFilter: # string. Alias: classFilter. Optional. Use when codeCoverageTool != None. Class inclusion/exclusion filters. 
    #codeCoverageSourceDirectories: # string. Alias: srcDirectories. Optional. Use when codeCoverageTool != None. Source files directories. 
    #codeCoverageFailIfEmpty: false # boolean. Alias: failIfCoverageEmpty. Optional. Use when codeCoverageTool != None. Fail when code coverage results are missing. Default: false.
  # Advanced
    #antHomeDirectory: # string. Alias: antHomeUserInputPath. Set ANT_HOME path. 
    javaHomeOption: 'JDKVersion' # 'JDKVersion' | 'Path'. Alias: javaHomeSelection. Required. Set JAVA_HOME by. Default: JDKVersion.
    #jdkVersionOption: 'default' # 'default' | '1.11' | '1.10' | '1.9' | '1.8' | '1.7' | '1.6'. Alias: jdkVersion. Optional. Use when javaHomeSelection = JDKVersion. JDK version. Default: default.
    #jdkUserInputDirectory: # string. Alias: jdkUserInputPath. Required when javaHomeSelection = Path. JDK path. 
    #jdkArchitectureOption: 'x64' # 'x86' | 'x64'. Alias: jdkArchitecture. Optional. Use when jdkVersion != default. JDK architecture. Default: x64.

输入

buildFile - Ant 生成文件
输入别名：antBuildFile。 string。 必填。 默认值：build.xml。

存储库根目录到 Ant 生成文件的相对路径。

有关生成文件的详细信息，请参阅 使用 Apache Ant。


options - 选项
string。

提供传递给 Ant 命令行的选项。 可以提供自己的属性（例如，-DmyProperty=myPropertyValue），也可以使用内置变量（例如，-DcollectionId=$(system.collectionId)）。 或者，内置变量已在生成过程中设置为环境变量，可以直接传递（例如，-DcollectionIdAsEnvVar=%SYSTEM_COLLECTIONID%）。

请参阅 运行 Apache Ant。


targets - Target（s）
string。

要生成的目标的可选空格分隔列表。 如果未指定，将使用 default 目标。 如果未定义 default 目标，Ant 1.6.0 及更高版本将生成所有顶级任务。

请参阅使用 Apache Ant 目标 。


publishJUnitResults - 发布到 Azure Pipelines
boolean。 默认值：true。

选择此选项可将 Ant 生成生成的 JUnit 测试结果发布到 Azure Pipelines。 每个与 Test Results Files 匹配的测试结果文件都将发布为 Azure Pipelines 中的测试运行。


testResultsFiles - 测试结果文件
string。 publishJUnitResults = true时是必需的。 默认值：**/TEST-*.xml。

测试结果文件路径。 可以使用通配符。 有关详细信息，请参阅 文件匹配模式参考。 例如，**/TEST-*.xml 名称以 TEST-开头的所有 XML 文件。


testRunTitle - 测试运行游戏
string。 可选。 当 publishJUnitResults = true时使用。

提供测试运行的名称。


codeCoverageToolOptions - 代码覆盖率工具
输入别名：codeCoverageTool。 string。 允许的值：None、Cobertura、JaCoCo。 默认值：None。

选择代码覆盖率工具。

如果使用 Microsoft 托管的代理，则会为你设置这些工具。 如果使用本地 Windows 代理，则必须确保为 JaCoco 或 Cobertura 设置代理。

  • JaCoCo - 确保在 Ant 安装的 lib 文件夹中提供jacocoant.jar。 详细了解 JaCoCo Ant 任务。
  • Cobertura - 确保环境变量COBERTURA_HOME指向 Cobertura .jar 文件位置。 详细了解如何使用 Ant 任务 Cobertura。

选择其中一个工具后，将显示以下参数：


codeCoverageClassFilesDirectories - 类文件目录
输入别名：classFilesDirectories。 string。 codeCoverageTool != None时是必需的。 默认值：.。

从 Ant 生成文件到包含类文件和存档文件的目录（.jar、.war等）的相对路径的逗号分隔列表。 这些目录中的类文件报告代码覆盖率。 例如： target/classes,target/testClasses。


codeCoverageClassFilter - 类包含/排除筛选器
输入别名：classFilter。 string。 可选。 当 codeCoverageTool != None时使用。

要包含或排除类的筛选器列表（以逗号分隔），用于收集代码覆盖率。 例如：+:com.、+:org.、-:my.app*.。


codeCoverageSourceDirectories - 源文件目录
输入别名：srcDirectories。 string。 可选。 当 codeCoverageTool != None时使用。

从 Ant 生成文件到源代码目录的相对路径的逗号分隔列表。 代码覆盖率报告将使用这些报告突出显示源代码。 例如： src/java,src/Test。


当缺少代码覆盖率结果时，codeCoverageFailIfEmpty - 失败
输入别名：failIfCoverageEmpty。 boolean。 可选。 当 codeCoverageTool != None时使用。 默认值：false。

如果代码覆盖率未生成任何要发布的结果，则生成失败。


antHomeDirectory - 设置ANT_HOME路径
输入别名：antHomeUserInputPath。 string。

如果已设置，请使用给定路径替代任何现有ANT_HOME环境变量。


javaHomeOption - 按 设置JAVA_HOME
输入别名：javaHomeSelection。 string。 必填。 允许的值：JDKVersion（JDK 版本），Path。 默认值：JDKVersion。

通过选择在生成期间发现的 JDK 版本或手动输入 JDK 路径来设置JAVA_HOME。


jdkVersionOption - JDK 版本
输入别名：jdkVersion。 string。 可选。 当 javaHomeSelection = JDKVersion时使用。 允许的值：default、1.11（JDK 11）、1.10（不受支持）、1.9（jDK 9（不受支持））、1.8（JDK 8）、1.7（JDK 7）、1.6（JDK 6（不支持））。 默认值：default。

尝试发现所选 JDK 版本的路径，并相应地设置JAVA_HOME。


jdkUserInputDirectory - JDK 路径
输入别名：jdkUserInputPath。 string。 javaHomeSelection = Path时是必需的。

将JAVA_HOME设置为给定路径。


jdkArchitectureOption - JDK 体系结构
输入别名：jdkArchitecture。 string。 可选。 当 jdkVersion != default时使用。 允许的值：x86、x64。 默认值：x64。

（可选）提供 JDK 的体系结构（x86，x64）。


任务控制选项

除任务输入之外，所有任务都具有控制选项。 有关详细信息，请参阅 控件选项和常见任务属性。

输出变量

没有。

注解

使用此任务通过 Apache Ant 进行生成。

要求

要求 说明
管道类型 YAML，经典版本，经典版本
运行时间 代理，DeploymentGroup
需求 自承载代理必须具有与以下 要求 运行使用此任务的作业 功能：
功能 此任务不满足作业中后续任务的任何要求。
命令限制 任何
Settable 变量 任何
代理版本 1.89.0 或更高版本
任务类别 建造