Delen via


Ant@1 - Ant v1-taak

Gebruik deze taak om te bouwen met 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.

Invoerwaarden

buildFile - Ant-buildbestand
Invoeralias: antBuildFile. string. Vereist. Standaardwaarde: build.xml.

Het relatieve pad van de hoofdmap van de opslagplaats naar het Ant-buildbestand.

Zie Apache Ant gebruiken voor meer informatie over buildbestanden.


options - Opties
string.

Biedt opties om door te geven aan de Ant-opdrachtregel. U kunt uw eigen eigenschappen opgeven (bijvoorbeeld -DmyProperty=myPropertyValue) en ook ingebouwde variabelen gebruiken (bijvoorbeeld -DcollectionId=$(system.collectionId)). De ingebouwde variabelen zijn ook al ingesteld als omgevingsvariabelen tijdens de build en kunnen rechtstreeks worden doorgegeven (bijvoorbeeld -DcollectionIdAsEnvVar=%SYSTEM_COLLECTIONID%).

Zie Apache Ant uitvoeren.


targets - Doel(en)
string.

Een optionele, door spaties gescheiden lijst met doelen die moeten worden gebouwd. Als u dit niet opgeeft, wordt het default doel gebruikt. Als er geen default doel is gedefinieerd, worden met Ant 1.6.0 en hoger alle taken op het hoogste niveau gebouwd.

Zie Apache Ant-doelen gebruiken.


publishJUnitResults - Publiceren naar Azure Pipelines
boolean. Standaardwaarde: true.

Selecteer deze optie om JUnit-testresultaten te publiceren die zijn geproduceerd door de Ant-build naar Azure Pipelines. Elke overeenkomende Test Results Files testresultatenbestand wordt gepubliceerd als testuitvoering in Azure Pipelines.


publishJUnitResults - Publiceren naar Azure Pipelines/TFS
boolean. Standaardwaarde: true.

Selecteer deze optie om JUnit-testresultaten te publiceren die zijn geproduceerd door de Ant-build naar Azure Pipelines. Elke overeenkomende Test Results Files testresultatenbestand wordt gepubliceerd als testuitvoering in Azure Pipelines.


testResultsFiles - Bestanden met testresultaten
string. Vereist wanneer publishJUnitResults = true. Standaardwaarde: **/TEST-*.xml.

Het bestandspad van de testresultaten. Jokertekens kunnen worden gebruikt. Zie de naslaginformatie over bestandsmatchingspatronen voor meer informatie. Bijvoorbeeld **/TEST-*.xml voor alle XML-bestanden waarvan de naam begint met TEST-.


testRunTitle - Titel van testuitvoering
string. Optioneel. Gebruik wanneer publishJUnitResults = true.

Geeft een naam op voor de testuitvoering.


codeCoverageToolOptions - Hulpprogramma voor codedekking
Invoeralias: codeCoverageTool. string. Toegestane waarden: None, Cobertura, JaCoCo. Standaardwaarde: None.

Selecteert het hulpprogramma voor codedekking.

Als u de door Microsoft gehoste agents gebruikt, zijn de hulpprogramma's voor u ingesteld. Als u de on-premises Windows-agent gebruikt, moet u ervoor zorgen dat de agent is ingesteld voor JaCoco of Cobertura.

  • JaCoCo - zorg ervoor dat jacocoant.jar beschikbaar is in de lib-map van Ant-installatie. Meer informatie over JaCoCo Ant-taken.
  • Cobertura: zorg ervoor dat een omgevingsvariabele COBERTURA_HOME verwijst naar de locatie van de Cobertura .jar bestanden. Meer informatie over Cobertura met Ant-taken.

Nadat u een van deze hulpprogramma's hebt geselecteerd, worden de volgende argumenten weergegeven:


codeCoverageClassFilesDirectories - Mappen met klassebestanden
Invoeralias: classFilesDirectories. string. Vereist wanneer codeCoverageTool != None. Standaardwaarde: ..

De door komma's gescheiden lijst met relatieve paden van het Ant-buildbestand naar mappen met klassebestanden en archiefbestanden (.jar, .war, enzovoort). Codedekking wordt gerapporteerd voor klassebestanden in deze mappen. Bijvoorbeeld: target/classes,target/testClasses.


codeCoverageClassFilter - Klasseinsluitings-/uitsluitingsfilters
Invoeralias: classFilter. string. Optioneel. Gebruik wanneer codeCoverageTool != None.

De door komma's gescheiden lijst met filters om klassen op te nemen of uit te sluiten van het verzamelen van codedekking. Bijvoorbeeld: +:com., +:org., -:my.app*..


codeCoverageSourceDirectories - Mappen van bronbestanden
Invoeralias: srcDirectories. string. Optioneel. Gebruik wanneer codeCoverageTool != None.

De door komma's gescheiden lijst met relatieve paden van het Ant-buildbestand naar broncodemappen. Codedekkingsrapporten gebruiken deze om broncode te markeren. Bijvoorbeeld: src/java,src/Test.


codeCoverageFailIfEmpty - Mislukt wanneer codedekkingsresultaten ontbreken
Invoeralias: failIfCoverageEmpty. boolean. Optioneel. Gebruik wanneer codeCoverageTool != None. Standaardwaarde: false.

De build mislukt als de codedekking geen resultaten heeft opgeleverd om te publiceren.


antHomeDirectory - ANT_HOME pad instellen
Invoeralias: antHomeUserInputPath. string.

Indien ingesteld, wordt een bestaande ANT_HOME omgevingsvariabele met het opgegeven pad overschreven.


javaHomeOption - JAVA_HOME instellen op
Invoeralias: javaHomeSelection. string. Vereist. Toegestane waarden: JDKVersion (JDK-versie), Path. Standaardwaarde: JDKVersion.

Stelt JAVA_HOME door een JDK-versie te selecteren die tijdens builds wordt gedetecteerd of door handmatig een JDK-pad in te voeren.


jdkVersionOption - JDK-versie
Invoeralias: jdkVersion. string. Optioneel. Gebruik wanneer javaHomeSelection = JDKVersion. Toegestane waarden: default, 1.11 (JDK 11), 1.10 (JDK 10 (niet ondersteund)), 1.9 (JDK 9 (niet ondersteund)), 1.8 (JDK 8), 1.7 (JDK 7), 1.6 (JDK 6 (niet ondersteund)). Standaardwaarde: default.

Probeert het pad naar de geselecteerde JDK-versie te detecteren en stelt JAVA_HOME dienovereenkomstig in.


jdkUserInputDirectory - JDK-pad
Invoeralias: jdkUserInputPath. string. Vereist wanneer javaHomeSelection = Path.

Hiermee stelt u JAVA_HOME in op het opgegeven pad.


jdkArchitectureOption - JDK-architectuur
Invoeralias: jdkArchitecture. string. Optioneel. Gebruik wanneer jdkVersion != default. Toegestane waarden: x86, x64. Standaardwaarde: x64.

Optioneel levert de architectuur (x86, x64) van de JDK.


Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Besturingsopties en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Gebruik deze taak om te bouwen met Apache Ant.

Vereisten

Vereiste Beschrijving
Pijplijntypen YAML, klassieke build, klassieke release
Wordt uitgevoerd op Agent, DeploymentGroup
Eisen Zelf-hostende agents moeten mogelijkheden hebben die voldoen aan de volgende vereisten om taken uit te voeren die deze taak gebruiken: ant
Functies Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen Alle
Instelbare variabelen Alle
Agentversie 1.89.0 of hoger
Taakcategorie Build