Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Use esta tarefa para criar com o Apache Ant.
Sintaxe
# 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
-
arquivo de build 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 build ant.
Para obter mais informações sobre arquivos de build, consulte Usando o Apache Ant.
opções de options -
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 o build e podem ser passadas diretamente (por exemplo, -DcollectionIdAsEnvVar=%SYSTEM_COLLECTIONID%).
Consulte Executando o Apache Ant.
targets
-
target(s)
string.
Uma lista opcional separada por espaço de destinos a serem compilados. Se não for especificado, o destino default será usado. Se nenhum destino default for definido, o Ant 1.6.0 e posterior criarão todas as tarefas de nível superior.
Consulte usando destinos do Apache Ant.
publishJUnitResults
-
Publicar no Azure Pipelines
boolean. Valor padrão: true.
Selecione esta opção para publicar os resultados do teste JUnit produzidos pelo build do 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. Curingas podem ser usados. 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.
da ferramenta de cobertura de código do codeCoverageToolOptions -
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 os agentes hospedados pela Microsoft, as ferramentas serão configuradas para você. Se você estiver usando o agente do Windows local, verifique se o agente está configurado para JaCoco ou Cobertura.
- JaCoCo – verifique se jacocoant.jar está disponível na pasta lib da instalação do Ant. Saiba mais sobre tarefas do JaCoCo Ant.
- Cobertura – verifique se uma variável de ambiente COBERTURA_HOME aponta para o local dos arquivos cobertura .jar. Saiba mais sobre as tarefas Cobertura com Formiga.
Depois de selecionar uma dessas ferramentas, os seguintes argumentos serão exibidos:
diretórios de arquivos da Classe codeCoverageClassFilesDirectories -
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 build Ant para diretórios que contêm arquivos de classe e arquivos de arquivo morto (.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 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
-
Falhar quando os resultados da cobertura de código estiverem 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 a serem publicados.
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
-
definir JAVA_HOME por
Alias de entrada: javaHomeSelection.
string. Obrigatório 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 do JDK selecionada e define JAVA_HOME adequadamente.
jdkUserInputDirectory
-
caminho do JDK
Alias de entrada: jdkUserInputPath.
string. Necessário quando javaHomeSelection = Path.
Define JAVA_HOME para o caminho fornecido.
arquitetura do JDK jdkArchitectureOption -
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.
Opções de controle de tarefa
Todas as tarefas têm opções de controle além das suas entradas de tarefas. Para obter mais informações, consulte as opções de Controle de e as propriedades comuns da tarefa.
Variáveis de saída
Nenhum.
Observações
Use esta tarefa para criar com o Apache Ant.
Requisitos
| Requisito | Descrição |
|---|---|
| Tipos de pipeline | YAML, build clássico, versão clássica |
| Execuções em | Agent, DeploymentGroup |
| de demandas | Os agentes auto-hospedados devem ter recursos que correspondam às seguintes demandas de para executar trabalhos que usam esta tarefa: ant |
| recursos | Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho. |
| restrições de comando | Qualquer |
| variáveis settable | Qualquer |
| Versão do agente | 1.89.0 ou superior |
| Categoria de tarefa | Construir |