Ant@1 – Ant v1 feladat

Ezzel a feladattal építhet az Apache Anttal.

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.

Bevitelek

buildFile - Ant buildfájl
Bemeneti alias: antBuildFile. string. Kötelező. Alapértelmezett érték: build.xml.

A relatív elérési út az adattár gyökerétől az Ant buildfájlig.

További információ a buildfájlokról: Az Apache Ant használata.

options - Lehetőségek
string.

Lehetőséget biztosít az Ant parancssornak való továbbításra. Megadhat saját tulajdonságokat (például -DmyProperty=myPropertyValue), és beépített változókat is használhat (például -DcollectionId=$(system.collectionId)). Másik lehetőségként a beépített változók már környezeti változókként vannak beállítva a buildelés során, és közvetlenül átadhatók (például -DcollectionIdAsEnvVar=%SYSTEM_COLLECTIONID%).

Lásd: Apache Ant futtatása.

targets - Cél(ok)
string.

A létrehozandó célok választható, szóközzel elválasztott listája. Ha nincs megadva, a default cél lesz használva. Ha nincs default megadva cél, az Ant 1.6.0-s és újabb verziói az összes legfelső szintű feladatot elkészítik.

Lásd: Apache Ant-célok használata.

publishJUnitResults - Közzététel az Azure Pipelinesban
boolean. Alapértelmezett érték: true.

Ezt a lehetőséget választva közzéteheti az Ant-build által létrehozott JUnit-teszteredményeket az Azure Pipelinesban. Minden teszteredmény-fájlegyeztetés Test Results Files tesztfuttatásként lesz közzétéve az Azure Pipelinesban.

testResultsFiles - Eredményfájlok tesztelése
string. Akkor szükséges, ha publishJUnitResults = true. Alapértelmezett érték: **/TEST-*.xml.

A teszteredmények fájl elérési útja. Helyettesítő karakterek használhatók. További információt a fájlegyeztetési minták referenciájában talál. Például az összes olyan XML-fájl esetében, **/TEST-*.xml amelynek a neve a következővel TEST-kezdődik: .

testRunTitle - Futtatási cím tesztelése
string. Választható. Használja a következőt: publishJUnitResults = true.

A tesztfuttatás nevét adja meg.

codeCoverageToolOptions - Kódlefedettségi eszköz
Bemeneti alias: codeCoverageTool. string. Engedélyezett értékek: None, Cobertura, JaCoCo. Alapértelmezett érték: None.

Kiválasztja a kódlefedettségi eszközt.

Ha a Microsoft által üzemeltetett ügynököket használja, akkor az eszközök be vannak állítva. Ha a helyszíni Windows-ügynököt használja, győződjön meg arról, hogy az ügynök be van állítva a JaCoco vagy a Cobertura esetében.

• JaCoCo – győződjön meg arról, hogy jacocoant.jar elérhető az Ant-telepítés lib mappájában. További információ a JaCoCo Ant-feladatokról.
• Cobertura – Győződjön meg arról, hogy egy környezeti változó COBERTURA_HOME a Cobertura .jar fájlok helyére mutat. További információ a Cobertura és az Ant feladatokról.

Miután kiválasztotta az alábbi eszközök egyikét, a következő argumentumok jelennek meg:

codeCoverageClassFilesDirectories - Osztályfájlok könyvtárai
Bemeneti alias: classFilesDirectories. string. Akkor szükséges, ha codeCoverageTool != None. Alapértelmezett érték: ..

A relatív elérési utak vesszővel tagolt listája az Ant buildfájltól az osztályfájlokat és archív fájlokat (.jar, .warstb.) tartalmazó könyvtárakig. A kódlefedettség az ezekben a könyvtárakban lévő osztályfájlokra vonatkozik. Példa: target/classes,target/testClasses.

codeCoverageClassFilter - Osztálybefoglalási/kizárási szűrők
Bemeneti alias: classFilter. string. Választható. Használja a következőt: codeCoverageTool != None.

A szűrők vesszővel tagolt listája, amely tartalmazza vagy kizárja az osztályokat a kódlefedettség gyűjtéséből. Például: +:com., +:org., -:my.app*..

codeCoverageSourceDirectories - Forrásfájlok könyvtárai
Bemeneti alias: srcDirectories. string. Választható. Használja a következőt: codeCoverageTool != None.

A relatív elérési utak vesszővel tagolt listája az Ant buildfájltól a forráskódkönyvtárakig. A kódlefedettségi jelentések ezeket használják a forráskód kiemeléséhez. Példa: src/java,src/Test.

codeCoverageFailIfEmpty - Sikertelen, ha hiányoznak a kódlefedettségi eredmények
Bemeneti alias: failIfCoverageEmpty. boolean. Választható. Használja a következőt: codeCoverageTool != None. Alapértelmezett érték: false.

A build meghiúsul, ha a kódlefedettség nem eredményezett közzétételi eredményt.

antHomeDirectory - ANT_HOME elérési út beállítása
Bemeneti alias: antHomeUserInputPath. string.

Ha be van állítva, felülbírálja a meglévő ANT_HOME környezeti változókat a megadott elérési úttal.

javaHomeOption - JAVA_HOME beállítása
Bemeneti alias: javaHomeSelection. string. Kötelező. Engedélyezett értékek: JDKVersion (JDK-verzió), Path. Alapértelmezett érték: JDKVersion.

Beállítja JAVA_HOME a buildelés során felderítendő JDK-verzió kiválasztásával vagy egy JDK-elérési út manuális beírásával.

jdkVersionOption - JDK-verzió
Bemeneti alias: jdkVersion. string. Választható. Használja a következőt: javaHomeSelection = JDKVersion. Engedélyezett értékek: default, 1.11 (JDK 11), 1.10 (JDK 10 (támogatáson kívül)), 1.9 (JDK 9 (támogatáson kívül)), 1.8 (JDK 8), 1.7 (JDK 7), 1.6 (JDK 6 (támogatáson kívül)). Alapértelmezett érték: default.

Megpróbálja felderíteni a kiválasztott JDK-verzió elérési útját, és ennek megfelelően állítja be JAVA_HOME.

jdkUserInputDirectory - JDK elérési útja
Bemeneti alias: jdkUserInputPath. string. Akkor szükséges, ha javaHomeSelection = Path.

Beállítja a JAVA_HOME a megadott elérési útra.

jdkArchitectureOption - JDK-architektúra
Bemeneti alias: jdkArchitecture. string. Választható. Használja a következőt: jdkVersion != default. Engedélyezett értékek: x86, x64. Alapértelmezett érték: x64.

Opcionálisan biztosítja a JDK architektúráját (x86, x64).

Feladatvezérlési lehetőségek

Minden feladathoz tartoznak vezérlési lehetőségek is a feladat bemenetei mellett. További információ: Vezérlési beállítások és gyakori feladattulajdonságok.

Kimeneti változók

Nincsenek.

Megjegyzések

Ezzel a feladattal építhet az Apache Anttal.

Követelmények

Követelmény	Leírás
Folyamattípusok	YAML, klasszikus build, klasszikus kiadás
Futtatás	Ügynök, DeploymentGroup
Igények	A saját üzemeltetésű ügynököknek olyan képességekkel kell rendelkezniük , amelyek megfelelnek az alábbi követelményeknek a feladatot használó feladatok futtatásához: ant
Képességek	Ez a feladat nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek.
Parancskorlátozások	Bármelyik
Változók beállítása	Bármelyik
Ügynök verziója	1.89.0 vagy újabb
Feladatkategória	Build