Ant@1 – úloha Ant v1

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

Syntaxe

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

možnosti options -
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ž nastavené jako proměnné prostředí během sestavení a lze je předat přímo (například -DcollectionIdAsEnvVar=%SYSTEM_COLLECTIONID%).

Viz spuštění Apache Ant.

cíle targets -
string.

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

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

publishJUnitResults - publikování do služby 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 výsledků testů odpovídající Test Results Files se publikuje jako testovací běh v Azure Pipelines.

testResultsFiles - soubory výsledků testů
string. Požadováno při publishJUnitResults = true. Výchozí hodnota: **/TEST-*.xml.

Cesta k souboru výsledků testu. Lze použít zástupné znaky. Další informace naleznete v vzory porovnávání souborů odkaz. Například **/TEST-*.xml pro všechny soubory XML, jejichž název začíná TEST-.

testRunTitle - název testovacího spuštění
string. Volitelný. Používá se při publishJUnitResults = true.

Poskytuje název testovacího spuštění.

nástroje pro pokrytí kódu codeCoverageToolOptions -
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, nastaví se pro vás nástroje. Pokud používáte místní 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 úkolů JaCoCo Ant.
• Cobertura – ujistěte se, že proměnná prostředí COBERTURA_HOME odkazuje na umístění .jar souborů Cobertura. Přečtěte si další informace o Cobertura s úkoly Ant.

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

codeCoverageClassFilesDirectories - adresářů souborů tříd
Vstupní alias: classFilesDirectories. string. Požadováno při codeCoverageTool != None. Výchozí hodnota: ..

Čárkami oddělený seznam relativních cest ze souboru sestavení Ant na adresáře obsahující soubory tříd a archivní soubory (.jar, .waratd.). Pokrytí kódu je hlášeno pro soubory tříd v těchto adresářích. Například: target/classes,target/testClasses.

codeCoverageClassFilter - filtry zahrnutí/vyloučení třídy
Vstupní alias: classFilter. string. Volitelný. Používá se při codeCoverageTool != None.

Čárkami oddělený seznam filtrů, které mají zahrnout nebo vyloučit třídy ze shromažďování pokrytí kódu. Například: +:com., +:org., -:my.app*..

codeCoverageSourceDirectories - adresářů zdrojových souborů
Vstupní alias: srcDirectories. string. Volitelný. Používá se při codeCoverageTool != None.

Čárkami oddělený seznam relativních cest 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. Například: src/java,src/Test.

codeCoverageFailIfEmpty - selhání, pokud chybí výsledky pokrytí kódu
Vstupní alias: failIfCoverageEmpty. boolean. Volitelný. Používá se při codeCoverageTool != None. Výchozí hodnota: false.

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

antHomeDirectory - Nastavit ANT_HOME cestu
Vstupní alias: antHomeUserInputPath. string.

Pokud je 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é. Povolené hodnoty: JDKVersion (verze JDK), Path. Výchozí hodnota: JDKVersion.

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

verze sady JDK
Vstupní alias: jdkVersion. string. Volitelný. Používá se při 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 odpovídajícím způsobem nastaví JAVA_HOME.

cesty JDK jdkUserInputDirectory -
Vstupní alias: jdkUserInputPath. string. Požadováno při javaHomeSelection = Path.

Nastaví JAVA_HOME na danou cestu.

architektury sady JDK
Vstupní alias: jdkArchitecture. string. Volitelný. Používá se při 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 naleznete v tématu Možnosti ovládacího prvku a běžné vlastnosti úloh.

Výstupní proměnné

Žádné.

Poznámky

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

Požadavky

Požadavek	Popis
Typy kanálů	YAML, klasické sestavení, klasická verze
Běží na	Agent, DeploymentGroup
požadavky	Agenti v místním prostředí musí mít schopnosti, které odpovídají následujícím požadavkům ke 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ů	Jakýkoliv
nastavitelné proměnné	Jakýkoliv
Verze agenta	1.89.0 nebo vyšší
Kategorie úkolu	Stavět