Gradle@2 – Gradle v2 feladat

Buildelés Gradle burkolószkript használatával.

Syntax

# Gradle v2
# Build using a Gradle wrapper script.
- task: Gradle@2
  inputs:
    gradleWrapperFile: 'gradlew' # string. Alias: wrapperScript. Required. Gradle wrapper. Default: gradlew.
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #options: # string. Options. 
    tasks: 'build' # string. Required. Tasks. Default: build.
  # 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
    #codeCoverageToolOption: 'None' # 'None' | 'Cobertura' | 'JaCoCo'. Alias: codeCoverageTool. Code coverage tool. Default: None.
    codeCoverageClassFilesDirectories: 'build/classes/main/' # string. Alias: classFilesDirectories. Required when codeCoverageTool != None. Class files directories. Default: build/classes/main/.
    #codeCoverageClassFilter: # string. Alias: classFilter. Optional. Use when codeCoverageTool != None. Class inclusion/exclusion filters. 
    #codeCoverageFailIfEmpty: false # boolean. Alias: failIfCoverageEmpty. Optional. Use when codeCoverageTool != None. Fail when code coverage results are missing. Default: false.
    #codeCoverageGradle5xOrHigher: true # boolean. Alias: gradle5xOrHigher. Optional. Use when codeCoverageTool = JaCoCo. Gradle version >= 5.x. Default: true.
  # Advanced
    javaHomeOption: 'JDKVersion' # 'JDKVersion' | 'Path'. Alias: javaHomeSelection. Required. Set JAVA_HOME by. Default: JDKVersion.
    #jdkVersionOption: 'default' # 'default' | '1.17' | '1.11' | '1.10' | '1.9' | '1.8' | '1.7' | '1.6'. Alias: jdkVersion. Optional. Use when javaHomeSelection = JDKVersion. JDK version. Default: default.
    #jdkDirectory: # string. Alias: jdkUserInputPath. Required when javaHomeSelection = Path. JDK path. 
    #jdkArchitectureOption: 'x64' # 'x86' | 'x64'. Alias: jdkArchitecture. Optional. Use when jdkVersion != default. JDK architecture. Default: x64.
    #gradleOptions: '-Xmx1024m' # string. Alias: gradleOpts. Set GRADLE_OPTS. Default: -Xmx1024m.
  # Code Analysis
    #sonarQubeRunAnalysis: false # boolean. Alias: sqAnalysisEnabled. Run SonarQube or SonarCloud Analysis. Default: false.
    #sqGradlePluginVersionChoice: 'specify' # 'specify' | 'build'. Required when sqAnalysisEnabled = true. SonarQube scanner for Gradle version. Default: specify.
    #sonarQubeGradlePluginVersion: '2.6.1' # string. Alias: sqGradlePluginVersion. Required when sqAnalysisEnabled = true && sqGradlePluginVersionChoice = specify. SonarQube scanner for Gradle plugin version. Default: 2.6.1.
    #checkStyleRunAnalysis: false # boolean. Alias: checkstyleAnalysisEnabled. Run Checkstyle. Default: false.
    #findBugsRunAnalysis: false # boolean. Alias: findbugsAnalysisEnabled. Run FindBugs. Default: false.
    #pmdRunAnalysis: false # boolean. Alias: pmdAnalysisEnabled. Run PMD. Default: false.
    #spotBugsAnalysis: false # boolean. Alias: spotBugsAnalysisEnabled. Run SpotBugs. Default: false.
    #spotBugsGradlePluginVersionChoice: 'specify' # 'specify' | 'build'. Required when spotBugsAnalysisEnabled = true. Spotbugs plugin version. Default: specify.
    #spotbugsGradlePluginVersion: '4.7.0' # string. Required when spotBugsAnalysisEnabled = true && spotBugsGradlePluginVersionChoice = specify. Version number. Default: 4.7.0.

Bevitelek

gradleWrapperFile - Gradle burkoló
Bemeneti alias: wrapperScript. string. Kötelező. Alapértelmezett érték: gradlew.

Megadja a gradlew burkoló helyét a buildhez használni kívánt adattárban. A windowsos ügynököknek (beleértve a Microsoft által üzemeltetett ügynököket) a burkolót gradlew.bat kell használniuk. A Linux vagy macOS rendszerű ügynökök használhatják a rendszerhéjszkriptet gradlew . További információ a Gradle Burkolóról.

workingDirectory - Munkakönyvtár
Bemeneti alias: cwd. string.

Meghatározza a Gradle-build futtatásához a munkakönyvtárat. A feladat az adattár gyökérkönyvtárát használja, ha a munkakönyvtár nincs megadva.

options - Lehetőségek
string.

Megadja a Gradle burkolónak átadott parancssori beállításokat. További információt a Gradle parancssorában talál.

tasks - Feladatok
string. Kötelező. Alapértelmezett érték: build.

A Gradle végrehajtásához szükséges feladat(ok). A feladatnevek listáját szóközök szerint kell elválasztani, és a parancssorból gradlew tasks ki lehet venni.

További információt a Gradle buildszkript alapjai című témakörben talál.

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

Közzéteszi a Gradle-build által előállított JUnit-teszteredményeket az Azure Pipelinesban. A feladat az egyes teszteredmény-fájlokat Test Results Files tesztfuttatásként teszi közzé 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ájlelérési útja. Helyettesítő karakterek használhatók. 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 build JUnit-teszteset-eredményeinek nevét adja meg.

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

Kódlefedettségi eszközt ad meg a build tesztesetei által lefedett kód meghatározásához.

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

Osztályfájlokat és archív fájlokat (.jar, .war stb.) tartalmazó könyvtárak vesszővel tagolt listája. A kódlefedettség az ezekben a könyvtárakban lévő osztályfájlokra vonatkozik. A tevékenység általában a (Gradle 4+) alatt build/classes/java/main keres osztályokat, amely a Gradle-buildek alapértelmezett osztálykönyvtára.

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

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.

Sikertelen a buildelés, ha a kódlefedettség nem eredményezett közzétételi eredményt.

codeCoverageGradle5xOrHigher - Gradle-verzió >= 5.x
Bemeneti alias: gradle5xOrHigher. boolean. Választható. Használja a következőt: codeCoverageTool = JaCoCo. Alapértelmezett érték: true.

Állítsa ezt "igaz" értékre, ha a >gradle-verzió = 5.x.

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 egy JDK-verzió kiválasztásával, amelyet a feladat a buildelés során észlel, vagy manuálisan beír egy JDK-elérési utat.

jdkVersionOption - JDK-verzió
Bemeneti alias: jdkVersion. string. Választható. Használja a következőt: javaHomeSelection = JDKVersion. Engedélyezett értékek: default, 1.17 (JDK 17), 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 a JAVA_HOME.

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

Biztosítja a JDK architektúrát (x86 vagy x64).

gradleOptions - GRADLE_OPTS beállítása
Bemeneti alias: gradleOpts. string. Alapértelmezett érték: -Xmx1024m.

Beállítja a GRADLE_OPTS környezeti változót, amely parancssori argumentumok küldésére szolgál a JVM elindításához. A xmx jelölő megadja a JVM számára elérhető maximális memóriát.

sonarQubeRunAnalysis - A SonarQube vagy a SonarCloud-elemzés futtatása
Bemeneti alias: sqAnalysisEnabled. boolean. Alapértelmezett érték: false.

Ez a beállítás a Gradle-feladat 1-es verziójáról módosult a SonarQube és a SonarCloud piactéri bővítmények használatára. Engedélyezze ezt a lehetőséget a SonarQube vagy a SonarCloud-elemzés futtatásához, miután végrehajtotta a feladatokat a Feladatok mezőben. A Gradle-tevékenység előtt hozzá kell adnia egy Elemzési konfiguráció előkészítése feladatot is az egyik bővítményből a buildelési folyamathoz.

sqGradlePluginVersionChoice - SonarQube scanner Gradle-verzióhoz
string. Akkor szükséges, ha sqAnalysisEnabled = true. Engedélyezett értékek: specify (Adja meg a verziószámot) build (Használja a build.gradle-ben alkalmazott beépülő modult). Alapértelmezett érték: specify.

Megadja a Használni kívánt SonarQube Gradle beépülő modul verzióját. Deklarálja a verziót a Gradle konfigurációs fájlban, vagy adjon meg egy verziót ezzel a sztringgel.

sonarQubeGradlePluginVersion - SonarQube scanner a Gradle beépülő modul verziójához
Bemeneti alias: sqGradlePluginVersion. string. Akkor szükséges, ha sqAnalysisEnabled = true && sqGradlePluginVersionChoice = specify. Alapértelmezett érték: 2.6.1.

A SonarQube Gradle beépülő modul verziószámát tartalmazza.

checkStyleRunAnalysis - Checkstyle futtatása
Bemeneti alias: checkstyleAnalysisEnabled. boolean. Alapértelmezett érték: false.

A Checkstyle eszközt az alapértelmezett Sun-ellenőrzésekkel futtatja. Az eredmények buildösszetevőkként lesznek feltöltve.

findBugsRunAnalysis - Kereséskeresési hibák futtatása
Bemeneti alias: findbugsAnalysisEnabled. boolean. Alapértelmezett érték: false.

A FindBugs statikus elemző eszközzel megkeresi a kód hibáit. Az eredmények buildösszetevőkként lesznek feltöltve. A Gradle 6.0-ban ez a beépülő modul el lett távolítva. Használja inkább a SpotBugs beépülő modult.

pmdRunAnalysis - A PMD futtatása
Bemeneti alias: pmdAnalysisEnabled. boolean. Alapértelmezett érték: false.

A PMD Java statikus elemzési eszközével megkeresi a kód hibáit. Az eredmények buildösszetevőkként lesznek feltöltve.

spotBugsAnalysis - SpotBugs futtatása
Bemeneti alias: spotBugsAnalysisEnabled. boolean. Alapértelmezett érték: false.

Akkor fut spotBugs , ha true. Ez a beépülő modul a Gradle 5.6-os vagy újabb verziójával működik. További információ a SpotBugs Gradle beépülő modul használatáról. Előfordulhat, hogy a beépülő modul váratlanul működik, vagy egyáltalán nem működik egy korábbi Gradle-verzióval.

spotBugsGradlePluginVersionChoice - Spotbugs beépülő modul verziója
string. Akkor szükséges, ha spotBugsAnalysisEnabled = true. Engedélyezett értékek: specify (Adja meg a verziószámot) build (Használja a build.gradle-ben alkalmazott beépülő modult). Alapértelmezett érték: specify.

Megadja a használni kívánt SpotBugs Gradle beépülő modul verzióját. A verzió deklarálható a Gradle konfigurációs fájlban, vagy a verziót ebben a sztringben adhatja meg.

spotbugsGradlePluginVersion - Verziószám
string. Akkor szükséges, ha spotBugsAnalysisEnabled = true && spotBugsGradlePluginVersionChoice = specify. Alapértelmezett érték: 4.7.0.

A SpotBugs Gradle beépülő modul verziószámát tartalmazza.

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

Megjegyzés

A feladat egy újabb verziója érhető el a Gradle@3.

A SonarQube-elemzés konfigurációja a feladat Prepare Analysis ConfigurationSonarQube- vagy SonarCloud-bővítményeibe lett áthelyezve.

Ezzel a feladattal Gradle burkolószkript használatával hozhat létre.

Hogyan generálni egy burkolót a Gradle-projektemből?

A Gradle burkoló lehetővé teszi a buildügynök számára, hogy letöltse és konfigurálja az adattárba beadott pontos Gradle-környezetet anélkül, hogy magának a buildügynöknek a JVM-től eltérő szoftverkonfigurációja volna.

1. Hozza létre a Gradle burkolót úgy, hogy kiadja a következő parancsot a build.gradle gyökérprojekt könyvtárából:

   jamal@fabrikam> gradle wrapper

2. Töltse fel a Gradle-burkolót a távoli adattárba.

   Van egy bináris összetevő, amelyet a gradle burkoló hoz létre (a helyen gradle/wrapper/gradle-wrapper.jartalálható). Ez a bináris fájl kicsi, és nem igényel frissítést. Ha módosítania kell a Gradle-konfiguráció futtatását a buildügynökön, frissítse a következőt gradle-wrapper.properties: .

   Az adattárnak a következőképpen kell kinéznie:

|-- gradle/
    `-- wrapper/
        `-- gradle-wrapper.jar
        `-- gradle-wrapper.properties
|-- src/
|-- .gitignore
|-- build.gradle
|-- gradlew
|-- gradlew.bat

Hogyan kijavítja az időtúllépéseket a függőségek letöltésekor?

Az olyan hibák kijavításához, mint a Read timed out függőségek letöltésekor, a Gradle 4.3+ felhasználói módosíthatják az időtúllépést a következőhöz Optionshozzáadva-Dhttp.socketTimeout=60000 -Dhttp.connectionTimeout=60000: . Ez 10 másodpercről 1 percre növeli az időtúllépést.

Példák

Java-alkalmazás létrehozása a Gradle használatával

Követelmények

Követelmény	Leírás
Folyamattípusok	YAML, klasszikus build
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: java
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.91.0 vagy újabb
Feladatkategória	Build