Delen via

Ant@1 - Ant v1-taak

  • Artikel

Gebruik deze taak om te bouwen met Apache Ant.

Syntaxis

# 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.

Invoer

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

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

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 dit niet is opgegeven, wordt het default doel gebruikt. Als er geen default doel is gedefinieerd, worden in 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. Elk testresultatenbestand dat overeenkomt met Test Results Files wordt gepubliceerd als een testuitvoering in Azure Pipelines.


testResultsFiles - testresultatenbestanden
string. Vereist wanneer publishJUnitResults = true. Standaardwaarde: **/TEST-*.xml.

Het bestandspad van de testresultaten. U kunt jokertekens gebruiken. Zie de bestandskoppelingspatronenvoor meer informatie. Bijvoorbeeld **/TEST-*.xml voor alle XML-bestanden waarvan de naam begint met TEST-.


titel van testRunTitle - testuitvoering
string. Facultatief. Gebruiken wanneer publishJUnitResults = true.

Geeft een naam op voor de testuitvoering.


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

Selecteert het hulpprogramma voor codedekking.

Als u de door Microsoft gehoste agentsgebruikt, worden de hulpprogramma's voor u ingesteld. Als u de on-premises Windows-agentgebruikt, 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 De installatie van Ant. 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 klasbestanden
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. Voorbeeld: target/classes,target/testClasses.


codeCoverageClassFilter - filters voor insluiting/uitsluiting van klassen
Invoeralias: classFilter. string. Facultatief. Gebruiken 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 met bronbestanden
Invoeralias: srcDirectories. string. Facultatief. Gebruiken 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. Voorbeeld: src/java,src/Test.


codeCoverageFailIfEmpty - mislukt wanneer de resultaten van de codedekking ontbreken
Invoeralias: failIfCoverageEmpty. boolean. Facultatief. Gebruiken wanneer codeCoverageTool != None. Standaardwaarde: false.

Mislukt de build als de codedekking geen resultaten heeft geproduceerd om te publiceren.


antHomeDirectory - ANT_HOME pad instellen
Invoeralias: antHomeUserInputPath. string.

Als deze optie is ingesteld, overschrijft u een bestaande ANT_HOME omgevingsvariabele met het opgegeven pad.


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

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


jdkVersionOption - JDK-versie
Invoeralias: jdkVersion. string. Facultatief. Gebruiken 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. Facultatief. Gebruiken wanneer jdkVersion != default. Toegestane waarden: x86, x64. Standaardwaarde: x64.

U kunt desgewenst de architectuur (x86, x64) van de JDK leveren.


Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties en algemene taakeigenschappenvoor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Gebruik deze taak om te bouwen met Apache Ant.

Vereisten

Voorwaarde Beschrijving
Pijplijntypen YAML, klassieke build, klassieke release
Wordt uitgevoerd op Agent, DeploymentGroup
eisen Zelf-hostende agents moeten mogelijkheden hebben die overeenkomen met de volgende eisen taken uit te voeren die gebruikmaken van deze taak: ant:
mogelijkheden Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen Welk dan ook
variabelen instellen Welk dan ook
Agentversie 1.89.0 of hoger
Taakcategorie Bouwen