Ant@1 – Ant v1-uppgift

  • Artikel

Använd den här uppgiften för att skapa med 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.

Indata

buildFile - Ant-byggfil
Indataalias: antBuildFile. string. Krävs. Standardvärde: build.xml.

Den relativa sökvägen från lagringsplatsens rot till Ant-byggfilen.

Mer information om byggfiler finns i Använda Apache Ant.


options - Alternativ
string.

Innehåller alternativ för att skicka till ant-kommandoraden. Du kan ange egna egenskaper (till exempel -DmyProperty=myPropertyValue) och även använda inbyggda variabler (till exempel -DcollectionId=$(system.collectionId)). Alternativt har de inbyggda variablerna redan angetts som miljövariabler under bygget och kan skickas direkt (till exempel -DcollectionIdAsEnvVar=%SYSTEM_COLLECTIONID%).

Se Köra Apache Ant.


targets - Mål
string.

En valfri, blankstegsavgränsad lista över mål som ska skapas. Om inget default anges används målet. Om inget default mål har definierats skapar Ant 1.6.0 och senare alla uppgifter på den översta nivån.

Se Använda Apache Ant-mål.


publishJUnitResults - Publicera till Azure Pipelines
boolean. Standardvärde: true.

Välj det här alternativet om du vill publicera JUnit-testresultat som skapats av Ant-versionen till Azure Pipelines. Varje matchning Test Results Files av testresultatfilen publiceras som en testkörning i Azure Pipelines.


publishJUnitResults - Publicera till Azure Pipelines/TFS
boolean. Standardvärde: true.

Välj det här alternativet om du vill publicera JUnit-testresultat som skapats av Ant-versionen till Azure Pipelines. Varje matchning Test Results Files av testresultatfilen publiceras som en testkörning i Azure Pipelines.


testResultsFiles - Testresultatfiler
string. Krävs när publishJUnitResults = true. Standardvärde: **/TEST-*.xml.

Sökvägen till testresultatfilen. Jokertecken kan användas. Mer information finns i referensen för filmatchningsmönster. Till exempel **/TEST-*.xml för alla XML-filer vars namn börjar med TEST-.


testRunTitle - Testkörningsrubrik
string. Valfritt. Använd när publishJUnitResults = true.

Anger ett namn för testkörningen.


codeCoverageToolOptions - Kodtäckningsverktyg
Indataalias: codeCoverageTool. string. Tillåtna värden: None, Cobertura, JaCoCo. Standardvärde: None.

Väljer kodtäckningsverktyget.

Om du använder microsofts värdbaserade agenter konfigureras verktygen åt dig. Om du använder den lokala Windows-agenten måste du se till att agenten har konfigurerats för JaCoco eller Cobertura.

  • JaCoCo – se till att jacocoant.jar är tillgängligt i mappen lib i Ant-installationen. Läs mer om JaCoCo Ant-uppgifter.
  • Cobertura – se till att en miljövariabel COBERTURA_HOME pekar på platsen för Cobertura-.jar filer. Läs mer om Cobertura med Ant-uppgifter.

När du har valt något av dessa verktyg visas följande argument:


codeCoverageClassFilesDirectories - Kataloger för klassfiler
Indataalias: classFilesDirectories. string. Krävs när codeCoverageTool != None. Standardvärde: ..

Den kommaavgränsade listan över relativa sökvägar från Ant-byggfilen till kataloger som innehåller klassfiler och arkivfiler (.jar, .warosv.). Kodtäckning rapporteras för klassfiler i dessa kataloger. Exempel: target/classes,target/testClasses.


codeCoverageClassFilter - Filter för klassinkludering/exkludering
Indataalias: classFilter. string. Valfritt. Använd när codeCoverageTool != None.

Den kommaavgränsade listan med filter som ska inkludera eller exkludera klasser från att samla in kodtäckning. Exempel: +:com., +:org., -:my.app*..


codeCoverageSourceDirectories - Källfilskataloger
Indataalias: srcDirectories. string. Valfritt. Använd när codeCoverageTool != None.

Den kommaavgränsade listan över relativa sökvägar från Ant-byggfilen till källkodskataloger. Rapporter för kodtäckning använder dessa för att markera källkoden. Exempel: src/java,src/Test.


codeCoverageFailIfEmpty - Misslyckas när kodtäckningsresultat saknas
Indataalias: failIfCoverageEmpty. boolean. Valfritt. Använd när codeCoverageTool != None. Standardvärde: false.

Det går inte att skapa versionen om kodtäckningen inte gav några resultat att publicera.


antHomeDirectory - Ange ANT_HOME sökväg
Indataalias: antHomeUserInputPath. string.

Om inställningen anges åsidosätter den befintliga ANT_HOME miljövariabeln med den angivna sökvägen.


javaHomeOption - Ange JAVA_HOME efter
Indataalias: javaHomeSelection. string. Krävs. Tillåtna värden: JDKVersion (JDK-version), Path. Standardvärde: JDKVersion.

Anger JAVA_HOME antingen genom att välja en JDK-version som ska identifieras under byggen eller genom att manuellt ange en JDK-sökväg.


jdkVersionOption - JDK-version
Indataalias: jdkVersion. string. Valfritt. Använd när javaHomeSelection = JDKVersion. Tillåtna värden: default, 1.11 (JDK 11), 1.10 (JDK 10 (stöds inte)), 1.9 (JDK 9 (stöds inte)), 1.8 (JDK 8), 1.7 (JDK 7), 1.6 (JDK 6 (stöds inte)). Standardvärde: default.

Försök att identifiera sökvägen till den valda JDK-versionen och uppsättningarna JAVA_HOME därefter.


jdkUserInputDirectory - JDK-sökväg
Indataalias: jdkUserInputPath. string. Krävs när javaHomeSelection = Path.

Anger JAVA_HOME till den angivna sökvägen.


jdkArchitectureOption - JDK-arkitektur
Indataalias: jdkArchitecture. string. Valfritt. Använd när jdkVersion != default. Tillåtna värden: x86, x64. Standardvärde: x64.

Du kan också tillhandahålla JDK-arkitekturen (x86, x64).


Kontrollalternativ för aktivitet

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Inga.

Kommentarer

Använd den här uppgiften för att skapa med Apache Ant.

Krav

Krav Beskrivning
Pipelinetyper YAML, klassisk version, klassisk version
Körs på Agent, DeploymentGroup
Krav Lokalt installerade agenter måste ha funktioner som matchar följande krav för att köra jobb som använder den här uppgiften: ant
Funktioner Den här aktiviteten uppfyller inte några krav för efterföljande uppgifter i jobbet.
Kommandobegränsningar Valfri
Inställningsbara variabler Valfri
Agentversion 1.89.0 eller senare
Uppgiftskategori Build