Ant@1 – Ant v1-uppgift

Använd den här uppgiften för att skapa med 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 - Ant build-fil
Indataalias: antBuildFile. string. Obligatoriskt. Standardvärde: build.xml.

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

Mer information om byggfiler finns i Using Apache Ant.

options - alternativ
string.

Innehåller alternativ för att skicka till Ant-kommandoraden. Du kan ange dina 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, utrymmesavgränsad lista över mål som ska skapas. Om det inte anges används det default 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 Targets.

publishJUnitResults - Publicera i 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 testresultatfil som matchar Test Results Files 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örningstitel
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 Microsoft-värdbaserade agenterkonfigureras verktygen åt dig. Om du använder den lokala Windows-agentenmåste du se till att agenten har konfigurerats för antingen 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: ..

Kommaavgränsad lista ö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. Till exempel: target/classes,target/testClasses.

codeCoverageClassFilter - filter för inkludering/exkludering av klass
Indataalias: classFilter. string. Valfritt. Använd när codeCoverageTool != None.

Kommaavgränsad lista över filter som ska inkludera eller exkludera klasser från insamling av kodtäckning. Till exempel: +:com., +:org., -:my.app*..

codeCoverageSourceDirectories - Kataloger för källfiler
Indataalias: srcDirectories. string. Valfritt. Använd när codeCoverageTool != None.

Kommaavgränsad lista över relativa sökvägar från Ant-byggfilen till källkodskataloger. Kodtäckningsrapporter använder dessa för att markera källkoden. Till 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 om kodtäckningen inte gav några resultat att publicera.

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

Om det anges åsidosätter du alla befintliga ANT_HOME miljövariabler med den angivna sökvägen.

javaHomeOption - Ange JAVA_HOME efter
Indataalias: javaHomeSelection. string. Obligatoriskt. 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 versioner 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 (utan support)), 1.9 (JDK 9 (support saknas)), 1.8 (JDK 8), 1.7 (JDK 7), 1.6 (JDK 6 (support saknas)). Standardvärde: default.

Försöker identifiera sökvägen till den valda JDK-versionen och anger 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:s arkitektur (x86, x64).

Ingen.