Ant@1 – úloha Ant v1

Tuto úlohu použijte k sestavení pomocí 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.

Vstupy

buildFile - Soubor sestavení Ant
Vstupní alias: antBuildFile. string. Povinná hodnota. Výchozí hodnota: build.xml.

Relativní cesta z kořenového adresáře úložiště k souboru sestavení Ant.

Další informace o souborech sestavení najdete v tématu Použití Apache Ant.

options - Možnosti
string.

Poskytuje možnosti pro předání do příkazového řádku Ant. Můžete zadat vlastní vlastnosti (například -DmyProperty=myPropertyValue) a také použít předdefinované proměnné (například -DcollectionId=$(system.collectionId)). Alternativně jsou předdefinované proměnné již během sestavování nastaveny jako proměnné prostředí a je možné je předat přímo (například -DcollectionIdAsEnvVar=%SYSTEM_COLLECTIONID%).

Viz Spuštění Apache Ant.

targets - Cíle
string.

Volitelný seznam cílů oddělených mezerami, které se mají sestavit. Pokud není zadaný, default použije se cíl. Pokud není definován žádný default cíl, Ant 1.6.0 a novější sestaví všechny úkoly nejvyšší úrovně.

Viz Použití cílů Apache Ant.

publishJUnitResults - Publikování do Azure Pipelines
boolean. Výchozí hodnota: true.

Tuto možnost vyberte, pokud chcete publikovat výsledky testů JUnit vytvořené sestavením Ant do Azure Pipelines. Každý soubor Test Results Files výsledků testů se publikuje jako testovací běh ve službě Azure Pipelines.

testResultsFiles - Soubory výsledků testů
string. Vyžaduje se, když publishJUnitResults = true. Výchozí hodnota: **/TEST-*.xml.

Cesta k souboru výsledků testu. Je možné použít zástupné é ho. Další informace najdete v referenčních informacích o vzorech porovnávání souborů. Například pro všechny soubory XML, **/TEST-*.xml jejichž název začíná na TEST-.

testRunTitle - Název testovacího běhu
string. Nepovinný parametr. Použijte, když publishJUnitResults = true.

Poskytuje název testovacího běhu.

codeCoverageToolOptions - Nástroj pokrytí kódu
Vstupní alias: codeCoverageTool. string. Povolené hodnoty: None, Cobertura, JaCoCo. Výchozí hodnota: None.

Vybere nástroj pokrytí kódu.

Pokud používáte agenty hostované Microsoftem, jsou nástroje nastavené pro vás. Pokud používáte místního agenta windows, musíte zajistit, aby byl agent nastavený pro JaCoco nebo Cobertura.

• JaCoCo – ujistěte se, že je jacocoant.jar k dispozici ve složce lib instalace Ant. Přečtěte si další informace o úkolech JaCoCo Ant.
• Cobertura – ujistěte se, že proměnná prostředí COBERTURA_HOME odkazuje na umístění souborů .jar Cobertura. Přečtěte si další informace o Cobertuře s úkoly Ant.

Po výběru jednoho z těchto nástrojů se zobrazí následující argumenty:

codeCoverageClassFilesDirectories - Adresáře souborů tříd
Vstupní alias: classFilesDirectories. string. Vyžaduje se, když codeCoverageTool != None. Výchozí hodnota: ..

Seznam relativních cest oddělených čárkami od souboru sestavení Ant k adresářům obsahujícím soubory tříd a archivní soubory (.jaratd .war.). Pokrytí kódu je hlášeno pro soubory tříd v těchto adresářích. Příklad: target/classes,target/testClasses.

codeCoverageClassFilter - Filtry zahrnutí a vyloučení tříd
Vstupní alias: classFilter. string. Nepovinný parametr. Použijte, když codeCoverageTool != None.

Seznam filtrů oddělených čárkami pro zahrnutí nebo vyloučení tříd ze shromažďování pokrytí kódu. Příklad: +:com., +:org., . -:my.app*.

codeCoverageSourceDirectories - Adresáře zdrojových souborů
Vstupní alias: srcDirectories. string. Nepovinný parametr. Použijte, když codeCoverageTool != None.

Seznam relativních cest oddělených čárkami ze souboru sestavení Ant do adresářů zdrojového kódu. Sestavy pokrytí kódu je použijí ke zvýraznění zdrojového kódu. Příklad: src/java,src/Test.

codeCoverageFailIfEmpty - Selhání, když chybí výsledky pokrytí kódu
Vstupní alias: failIfCoverageEmpty. boolean. Nepovinný parametr. Použijte, když codeCoverageTool != None. Výchozí hodnota: false.

Sestavení selže, pokud pokrytí kódu nepřisoudí žádné výsledky pro publikování.

antHomeDirectory - Nastavení cesty ANT_HOME
Vstupní alias: antHomeUserInputPath. string.

Pokud je tato možnost nastavená, přepíše všechny existující ANT_HOME proměnné prostředí danou cestou.

javaHomeOption - Nastavit JAVA_HOME podle
Vstupní alias: javaHomeSelection. string. Povinná hodnota. Povolené hodnoty: JDKVersion (verze sady JDK), Path. Výchozí hodnota: JDKVersion.

Sady JAVA_HOME buď výběrem verze sady JDK, která se zjistí během sestavení, nebo ručním zadáním cesty sady JDK.

jdkVersionOption - Verze sady JDK
Vstupní alias: jdkVersion. string. Nepovinný parametr. Použijte, když javaHomeSelection = JDKVersion. Povolené hodnoty: default, 1.11 (JDK 11), 1.10 (JDK 10 (mimo podporu)), 1.9 (JDK 9 (mimo podporu)), 1.8 (JDK 8), 1.7 (JDK 7), 1.6 (JDK 6 (mimo podporu)). Výchozí hodnota: default.

Pokusí se zjistit cestu k vybrané verzi sady JDK a nastaví JAVA_HOME odpovídajícím způsobem.

jdkUserInputDirectory - Cesta sady JDK
Vstupní alias: jdkUserInputPath. string. Vyžaduje se, když javaHomeSelection = Path.

Nastaví JAVA_HOME na danou cestu.

jdkArchitectureOption - Architektura sady JDK
Alias vstupu: jdkArchitecture. string. Nepovinný parametr. Použijte, když jdkVersion != default. Povolené hodnoty: x86, x64. Výchozí hodnota: x64.

Volitelně poskytuje architekturu (x86, x64) sady JDK.

Možnosti ovládání úloh

Všechny úlohy mají kromě vstupů také možnosti ovládání. Další informace najdete v tématu Možnosti ovládacích prvků a běžné vlastnosti úlohy.

Výstupní proměnné

Žádné

Poznámky

Tuto úlohu použijte k sestavení pomocí Apache Ant.

Požadavky

Požadavek	Popis
Typy kanálů	YAML, klasický build, klasická verze
Běží na	Agent, DeploymentGroup
Požadavky	Agenti v místním prostředí musí mít funkce , které odpovídají následujícím požadavkům na spouštění úloh, které používají tuto úlohu: ant
Možnosti	Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů	Všechny
Nastavitelné proměnné	Všechny
Verze agenta	1.89.0 nebo vyšší
Kategorie úloh	Sestavení