Ant@1 - Tarefa Ant v1

Use esta tarefa para construir com o 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 - arquivo de compilação do Ant
Alias de entrada: antBuildFile. string. Obrigatório. Valor padrão: build.xml.

O caminho relativo da raiz do repositório para o arquivo de compilação Ant.

Para obter mais informações sobre arquivos de compilação, consulte Usando o Apache Ant.

options - Opções
string.

Fornece opções para passar para a linha de comando Ant. Você pode fornecer suas próprias propriedades (por exemplo, -DmyProperty=myPropertyValue) e também usar variáveis internas (por exemplo, -DcollectionId=$(system.collectionId)). Como alternativa, as variáveis internas já estão definidas como variáveis de ambiente durante a compilação e podem ser passadas diretamente (por exemplo, -DcollectionIdAsEnvVar=%SYSTEM_COLLECTIONID%).

Consulte Executando o Apache Ant.

targets - Alvo(s)
string.

Uma lista opcional e separada por espaço de destinos a serem criados. Se não for especificado, o destino default será usado. Se nenhum destino default for definido, o Ant 1.6.0 e posterior criará todas as tarefas de nível superior.

Consulte Usando destinos Apache Ant.

publishJUnitResults - Publicar no Azure Pipelines
boolean. Valor padrão: true.

Selecione esta opção para publicar os resultados do teste JUnit produzidos pela compilação Ant no Azure Pipelines. Cada arquivo de resultados de teste correspondente Test Results Files será publicado como uma execução de teste no Azure Pipelines.

testResultsFiles - Arquivos de resultados de teste
string. Necessário quando publishJUnitResults = true. Valor padrão: **/TEST-*.xml.

O caminho do arquivo de resultados do teste. É possível utilizar curingas. Para obter mais informações, consulte a referência de padrões de correspondência de arquivo . Por exemplo, **/TEST-*.xml para todos os arquivos XML cujo nome começa com TEST-.

testRunTitle - Título da execução de teste
string. Opcional. Use quando publishJUnitResults = true.

Fornece um nome para a execução de teste.

codeCoverageToolOptions - Ferramenta de cobertura de código
Alias de entrada: codeCoverageTool. string. Valores permitidos: None, Cobertura, JaCoCo. Valor padrão: None.

Seleciona a ferramenta de cobertura de código.

Se você estiver usando o agentes hospedados pela Microsoft, as ferramentas serão configuradas para você. Se você estiver usando o agente local Windows, deverá garantir que o agente esteja configurado para JaCoco ou Cobertura.

• JaCoCo - certifique-se de que jacocoant.jar está disponível na pasta lib da instalação Ant. Saiba mais sobre tarefas do JaCoCo Ant.
• Cobertura - certifique-se de que uma variável de ambiente COBERTURA_HOME aponte para o local dos arquivos do Cobertura .jar. Saiba mais sobre as tarefas Cobertura com Ant.

Depois de selecionar uma dessas ferramentas, os seguintes argumentos aparecem:

codeCoverageClassFilesDirectories - Diretórios de arquivos de classe
Alias de entrada: classFilesDirectories. string. Necessário quando codeCoverageTool != None. Valor padrão: ..

A lista separada por vírgulas de caminhos relativos do arquivo de construção Ant para diretórios contendo arquivos de classe e arquivos de arquivo (.jar, .war, etc.). A cobertura de código é relatada para arquivos de classe nesses diretórios. Por exemplo: target/classes,target/testClasses.

codeCoverageClassFilter - Filtros de inclusão/exclusão de classe
Alias de entrada: classFilter. string. Opcional. Use quando codeCoverageTool != None.

A lista separada por vírgulas de filtros para incluir ou excluir classes da cobertura de código de coleta. Por exemplo: +:com., +:org., -:my.app*..

codeCoverageSourceDirectories - Diretórios de arquivos de origem
Alias de entrada: srcDirectories. string. Opcional. Use quando codeCoverageTool != None.

A lista separada por vírgulas de caminhos relativos do arquivo de construção Ant para diretórios de código-fonte. Os relatórios de cobertura de código os usarão para destacar o código-fonte. Por exemplo: src/java,src/Test.

codeCoverageFailIfEmpty - Falha quando os resultados da cobertura de código estão faltando
Alias de entrada: failIfCoverageEmpty. boolean. Opcional. Use quando codeCoverageTool != None. Valor padrão: false.

Falha na compilação se a cobertura do código não produziu nenhum resultado para publicar.

antHomeDirectory - Definir ANT_HOME caminho
Alias de entrada: antHomeUserInputPath. string.

Se definido, substitui qualquer variável de ambiente ANT_HOME existente com o caminho fornecido.

javaHomeOption - set JAVA_HOME por
Alias de entrada: javaHomeSelection. string. Obrigatório. Valores permitidos: JDKVersion (Versão JDK), Path. Valor padrão: JDKVersion.

Define JAVA_HOME selecionando uma versão do JDK que será descoberta durante as compilações ou inserindo manualmente um caminho JDK.

jdkVersionOption - versão JDK
Alias de entrada: jdkVersion. string. Opcional. Use quando javaHomeSelection = JDKVersion. Valores permitidos: default, 1.11 (JDK 11), 1.10 (JDK 10 (sem suporte)), 1.9 (JDK 9 (sem suporte)), 1.8 (JDK 8), 1.7 (JDK 7), 1.6 (JDK 6 (sem suporte)). Valor padrão: default.

Tenta descobrir o caminho para a versão selecionada do JDK e define JAVA_HOME de acordo.

jdkUserInputDirectory - caminho JDK
Alias de entrada: jdkUserInputPath. string. Necessário quando javaHomeSelection = Path.

Define JAVA_HOME para o caminho determinado.

jdkArchitectureOption - arquitetura JDK
Alias de entrada: jdkArchitecture. string. Opcional. Use quando jdkVersion != default. Valores permitidos: x86, x64. Valor padrão: x64.

Opcionalmente, fornece a arquitetura (x86, x64) do JDK.

Nenhum.