tarefa Ant@1 - Ant v1

Utilize esta tarefa para criar com o Apache Ant.

Syntax

# 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.

Entradas

buildFile - Ficheiro de compilação do Ant
Alias de entrada: antBuildFile. string. Obrigatório. Valor predefinido: build.xml.

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

Para obter mais informações sobre a compilação de ficheiros, consulte Utilizar o Apache Ant.

options - Opções
string.

Fornece opções para passar para a linha de comandos do Ant. Pode fornecer as suas próprias propriedades (por exemplo, -DmyProperty=myPropertyValue) e também utilizar variáveis incorporadas (por exemplo, -DcollectionId=$(system.collectionId)). Em alternativa, as variáveis incorporadas já estão definidas como variáveis de ambiente durante a compilação e podem ser transmitidas diretamente (por exemplo, -DcollectionIdAsEnvVar=%SYSTEM_COLLECTIONID%).

Veja Executar o Apache Ant.

targets - Destino(s)
string.

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

Veja Utilizar alvos do Apache Ant.

publishJUnitResults - Publicar nos Pipelines do Azure
boolean. Valor predefinido: true.

Selecione esta opção para publicar os resultados do teste JUnit produzidos pela compilação do Ant no Azure Pipelines. Cada correspondência Test Results Files de ficheiros de resultados de teste será publicada como uma execução de teste no Azure Pipelines.

testResultsFiles - Ficheiros de resultados de teste
string. Necessário quando publishJUnitResults = true. Valor predefinido: **/TEST-*.xml.

O caminho do ficheiro de resultados do teste. Podem ser utilizados carateres universais. Para obter mais informações, veja a referência de padrões de correspondência de ficheiros. Por exemplo, **/TEST-*.xml para todos os ficheiros XML cujo nome começa com TEST-.

testRunTitle - Título da execução de teste
string. Opcional. Utilize 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, , CoberturaJaCoCo. Valor predefinido: None.

Seleciona a ferramenta de cobertura do código.

Se estiver a utilizar os agentes alojados na Microsoft, as ferramentas são configuradas automaticmente. Se estiver a utilizar o agente do Windows no local, tem de garantir que o agente está configurado para JaCoco ou Cobertura.

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

Depois de selecionar uma destas ferramentas, são apresentados os seguintes argumentos:

codeCoverageClassFilesDirectories - Diretórios de ficheiros de classe
Alias de entrada: classFilesDirectories. string. Necessário quando codeCoverageTool != None. Valor predefinido: ..

A lista separada por vírgulas de caminhos relativos do ficheiro de compilação do Ant para diretórios que contêm ficheiros de classe e ficheiros de arquivo (.jar, .war, etc.). A cobertura do código é comunicada para ficheiros de classe nestes diretórios. Por exemplo: target/classes,target/testClasses.

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

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

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

A lista separada por vírgulas de caminhos relativos do ficheiro de compilação ant para diretórios de código fonte. Os relatórios de cobertura do código irão utilizá-los para realçar o código fonte. Por exemplo: src/java,src/Test.

codeCoverageFailIfEmpty - Falha quando os resultados da cobertura do código estão em falta
Alias de entrada: failIfCoverageEmpty. boolean. Opcional. Utilize quando codeCoverageTool != None. Valor predefinido: false.

Falha na compilação se a cobertura do código não produzir resultados para publicar.

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

Se estiver definido, substitui qualquer variável de ambiente de ANT_HOME existente pelo caminho especificado.

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

Define JAVA_HOME ao selecionar uma versão do JDK que será detetada durante as compilações ou ao introduzir manualmente um caminho JDK.

jdkVersionOption - Versão do JDK
Alias de entrada: jdkVersion. string. Opcional. Utilize 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 predefinido: default.

Tenta detetar o caminho para a versão do JDK selecionada e define JAVA_HOME em conformidade.

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

Define JAVA_HOME para o caminho especificado.

jdkArchitectureOption - Arquitetura do JDK
Alias de entrada: jdkArchitecture. string. Opcional. Utilize quando jdkVersion != default. Valores permitidos: x86, x64. Valor predefinido: x64.

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

Opções de controlo de tarefas

Todas as tarefas têm opções de controlo para além das entradas de tarefas. Para obter mais informações, veja Opções de controlo e propriedades de tarefas comuns.

Variáveis de saída

Nenhum.

Observações

Utilize esta tarefa para criar com o Apache Ant.

Requisitos

Requisito	Description
Tipos de pipeline	YAML, Compilação clássica, Versão clássica
É executado em	Agent, DeploymentGroup
Exigências	Os agentes autoalojados têm de ter capacidades que correspondam às seguintes exigências para executar tarefas que utilizem esta tarefa: ant
Capacidades	Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa.
Restrições de comandos	Qualquer
Variáveis de definição	Qualquer
Versão do agente	1.89.0 ou superior
Categoria da tarefa	Compilação