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）。

没有。