Megosztás a következőn keresztül:


Ant@1 – Ant v1 feladat

Ezzel a feladattal az Apache Ant használatával hozhat létre.

Szinopszis

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

Bemenetek

buildFile - Ant buildfájl
Bemeneti alias: antBuildFile. string. Szükséges. 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 Anthasználata.


options - Beállítások
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óké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 Antfuttatása.


targets - Cél(ok)
string.

Nem kötelező, szóközzel elválasztott lista a létrehozandó célokról. Ha nincs megadva, a default cél lesz használva. Ha nincs definiálva default cél, az Ant 1.6.0 és újabb verziói az összes legfelső szintű feladatot összeállítják.

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 Test Results Files megfelelő teszteredmény-fájl az Azure Pipelines tesztfuttatásaként lesz közzétéve.


testResultsFiles - teszteredmény-fájlok
string. publishJUnitResults = trueesetén kötelező. Alapértelmezett érték: **/TEST-*.xml.

A teszteredmények fájljának elérési útja. Helyettesítő karakterek is használhatók. További információ: fájlmegfeleltetési minták hivatkozása. Például **/TEST-*.xml minden olyan XML-fájlhoz, amelynek a neve TEST-kezdődik.


testRunTitle - tesztelési cím
string. Opcionális. Használja a publishJUnitResults = true.

Megadja a tesztfuttatás nevét.


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ökethasználja, akkor az eszközök be vannak állítva Önnek. Ha a helyszíni Windows-ügynökhaszná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-feladatok .
  • 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 Ant-feladatokkal.

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. codeCoverageTool != Noneesetén kötelező. Alapértelmezett érték: ..

A relatív útvonalak 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éldául: target/classes,target/testClasses.


codeCoverageClassFilter - osztálybevonási/kizárási szűrők
Bemeneti alias: classFilter. string. Opcionális. Használja a codeCoverageTool != None.

A vesszővel tagolt szűrők listája, amelyek osztályokat foglalnak bele vagy zárnak ki 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. Opcionális. Használja a 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éldául: src/java,src/Test.


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

A build meghiúsul, ha a kódlefedettség nem hozott 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. Szükséges. Engedélyezett értékek: JDKVersion (JDK-verzió), Path. Alapértelmezett érték: JDKVersion.

Beállítja JAVA_HOME a buildek 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. Opcionális. Használja a 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 kijelölt JDK-verzió elérési útját, és ennek megfelelően állítja be JAVA_HOME.


JDK-elérési út jdkUserInputDirectory -
Bemeneti alias: jdkUserInputPath. string. javaHomeSelection = Pathesetén kötelező.

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


jdkArchitectureOption - JDK-architektúra
Bemeneti alias: jdkArchitecture. string. Opcionális. Használja a 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ők és gyakori feladattulajdonságok.

Kimeneti változók

Nincs.

Megjegyzések

Ezzel a feladattal az Apache Ant használatával hozhat létre.

Követelmények

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