Compartilhar via


Ant@1 - Tarefa Ant v1

Use essa tarefa para compilar 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.
# 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/TFS. 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 - Arquivo de build ant
Alias de entrada: antBuildFile. string. Obrigatórios. Valor padrão: build.xml.

O caminho relativo da raiz do repositório para o arquivo de build Ant.

Para obter mais informações sobre arquivos de build, 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 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 o build e podem ser passadas diretamente (por exemplo, -DcollectionIdAsEnvVar=%SYSTEM_COLLECTIONID%).

Confira Executando o Apache Ant.


targets - Destino(s)
string.

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

Confira Usando destinos do Apache Ant.


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

Selecione esta opção para publicar os resultados de teste do JUnit produzidos pelo build ant no Azure Pipelines. Cada correspondência de arquivo de resultados de teste com Test Results Files será publicada como uma execução de teste no Azure Pipelines.


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

Selecione esta opção para publicar os resultados de teste do JUnit produzidos pelo build ant no Azure Pipelines. Cada correspondência de arquivo de resultados de teste com Test Results Files será publicada como uma execução de teste no Azure Pipelines.


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

O caminho do arquivo de resultados do teste. Caracteres curinga podem ser usados. Para obter mais informações, consulte a referência de padrões de correspondência de arquivos. 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 estiver usando os agentes hospedados pela Microsoft, as ferramentas serão configuradas para você. Se você estiver usando o agente do Windows local, deverá garantir que o agente esteja configurado para JaCoco ou Cobertura.

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

Depois de selecionar uma dessas ferramentas, os seguintes argumentos serão exibidos:


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

A lista separada por vírgulas de caminhos relativos do arquivo de build Ant para diretórios que contêm arquivos de classe e arquivos de arquivo (.jar, .waretc.). A cobertura de código é informada 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 coleta de cobertura de código. 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 build Ant para diretórios de código-fonte. Os relatórios de cobertura de código os usarão para realçar o código-fonte. Por exemplo: src/java,src/Test.


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

Falha no build se a cobertura de código não produzir resultados para publicação.


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

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


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

Define JAVA_HOME selecionando uma versão do JDK que será descoberta durante builds ou inserindo manualmente um caminho JDK.


jdkVersionOption - Versão do 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 adequadamente.


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

Define JAVA_HOME para o caminho fornecido.


jdkArchitectureOption - Arquitetura do JDK
Alias de entrada: jdkArchitecture. string. Opcional. Use quando jdkVersion != default. Valores Permitidos: x86 e x64. Valor padrão: x64.

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


Opções de controle da tarefa

Todas as tarefas têm opções de controle além de suas entradas de tarefa. Para obter mais informações, consulte Opções de controle e propriedades comuns da tarefa.

Variáveis de saída

Nenhum.

Comentários

Use essa tarefa para compilar com o Apache Ant.

Requisitos

Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
Executa em Agent, DeploymentGroup
Demandas Os agentes auto-hospedados devem ter recursos que correspondam às seguintes demandas para executar trabalhos que usam esta tarefa: ant
Funcionalidades Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis configuráveis Qualquer
Versão do agente 1.89.0 ou superior
Categoria da tarefa Build