Gradle@3 - Gradle v3 görevi

Gradle sarmalayıcı betiği kullanarak derlemek için bu görevi kullanın.

Sözdizimi

# Gradle v3
# Build using a Gradle wrapper script.
- task: Gradle@3
  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.

Girişler

gradleWrapperFile - Gradle sarmalayıcı
Giriş diğer adı: wrapperScript. string. Gerekli. Varsayılan değer: gradlew.

derleme için kullanılacak depodaki gradlew sarmalayıcının konumunu belirtir. Windows'ta aracılar (Microsoft tarafından barındırılan aracılar dahil) gradlew.bat sarmalayıcısını kullanmalıdır. Linux veya macOS üzerindeki aracılar gradlew kabuk betiğini kullanabilir. Gradle Sarmalayıcıhakkında daha fazla bilgi edinin. Gradle sarmalayıcısı kök dizinde değilse sarmalayıcı betiğinin yolunu belirtin. Örneğin, subdir/gradlew.

workingDirectory - Çalışma dizini
Giriş diğer adı: cwd. string.

Gradle derlemesini çalıştırmak için çalışma dizinini belirtir. Çalışma dizini belirtilmezse görev depo kök dizinini kullanır.

options - Seçenekleri
string.

Gradle sarmalayıcıya geçirilecek komut satırı seçeneklerini belirtir. Daha fazla bilgi için bkz. Gradle Komut Satırı.

tasks - Görevler
string. Gerekli. Varsayılan değer: build.

Gradle'ın yürütülecek görevleri. Görev adlarının listesi boşluklarla ayrılmalıdır ve komut isteminden verilen gradlew tasks alınabilir.

Daha fazla bilgi için bkz. Gradle Derleme Betiği Temel.

publishJUnitResults - Azure Pipelines'da yayımlama
boolean. Varsayılan değer: true.

Gradle derlemesi tarafından üretilen JUnit test sonuçlarını Azure Pipelines'da yayımlar. Görev, Azure Pipelines'da test çalıştırması olarak Test Results Files eşleşen her test sonuçları dosyasını yayımlar.

Test sonuçları dosyalarınıtestResultsFiles -
string. publishJUnitResults = truegerekir. Varsayılan değer: **/TEST-*.xml.

Test sonuçlarının dosya yolu. Joker Karakterler kullanılabilir. Örneğin, adı **/TEST-*.xmlile başlayan tüm XML dosyaları için TEST-.

çalıştırma başlığını test
string. Opsiyonel. publishJUnitResults = trueolduğunda kullanın.

Bu derleme için JUnit test çalışması sonuçları için bir ad sağlar.

codeCoverageToolOption - Kod kapsamı aracı
Giriş diğer adı: codeCoverageTool. string. İzin verilen değerler: None, Cobertura, JaCoCo. Varsayılan değer: None.

Derlemenin test çalışmalarının kapsamına alınan kodu belirlemek için bir kod kapsamı aracı belirtir.

codeCoverageClassFilesDirectories - Sınıf dosyaları dizinleri
Giriş diğer adı: classFilesDirectories. string. codeCoverageTool != Nonegerekir. Varsayılan değer: build/classes/main/.

Sınıf dosyalarını ve arşiv dosyalarını (.jar, .war ve daha fazlası) içeren dizinlerin virgülle ayrılmış listesi. Bu dizinlerdeki sınıf dosyaları için kod kapsamı bildirilir. Normalde görev, Gradle derlemeleri için varsayılan sınıf dizini olan build/classes/java/main (Gradle 4+ için) altındaki sınıfları arar.

sınıf ekleme/dışlama filtrelericodeCoverageClassFilter -
Giriş diğer adı: classFilter. string. Opsiyonel. codeCoverageTool != Noneolduğunda kullanın.

Sınıfların kod kapsamını toplamasını içerecek veya hariç tutacak filtrelerin virgülle ayrılmış listesi. Örneğin: +:com.*,+:org.*,-:my.app*.*.

codeCoverageFailIfEmpty - Kod kapsamı sonuçları eksik olduğunda başarısız
Giriş diğer adı: failIfCoverageEmpty. boolean. Opsiyonel. codeCoverageTool != Noneolduğunda kullanın. Varsayılan değer: false.

Kod kapsamı yayımlamak için herhangi bir sonuç üretmediyse derleme başarısız olur.

codeCoverageGradle5xOrHigher - Gradle sürümü >= 5.x
Giriş diğer adı: gradle5xOrHigher. boolean. Opsiyonel. codeCoverageTool = JaCoCoolduğunda kullanın. Varsayılan değer: true.

Gradle sürümü >= 5.x ise bunu 'true' olarak ayarlayın.

javaHomeOption - göre JAVA_HOME ayarlama
Giriş diğer adı: javaHomeSelection. string. Gerekli. İzin verilen değerler: JDKVersion (JDK Sürümü), Path. Varsayılan değer: JDKVersion.

Görevin derlemeler sırasında keşfettiği bir JDK sürümünü seçerek veya el ile bir JDK yolu girerek JAVA_HOME ayarlar.

JDK sürüm
Giriş diğer adı: jdkVersion. string. Opsiyonel. javaHomeSelection = JDKVersionolduğunda kullanın. İzin verilen değerler: default, 1.17 (JDK 17), 1.11 (JDK 11), 1.10 (JDK 10 (destek dışı)), 1.9 (JDK 9 (destek dışı)), 1.8 (JDK 8), 1.7 (JDK 7), 1.6 (JDK 6 (destek dışı)). Varsayılan değer: default.

Seçili JDK sürümünün yolunu bulmayı ve JAVA_HOME uygun şekilde ayarlamayı dener.

JDK yolujdkDirectory -
Giriş diğer adı: jdkUserInputPath. string. javaHomeSelection = Pathgerekir.

JAVA_HOME verilen yola ayarlar.

jdkArchitectureOption - JDK mimarisi
Giriş diğer adı: jdkArchitecture. string. Opsiyonel. jdkVersion != defaultolduğunda kullanın. İzin verilen değerler: x86, x64. Varsayılan değer: x64.

JDK mimarisini (x86 veya x64) sağlar.

gradleOptions - Ayarla GRADLE_OPTS
Giriş diğer adı: gradleOpts. string. Varsayılan değer: -Xmx1024m.

JVM'yi başlatmak için komut satırı bağımsız değişkenleri göndermek için kullanılan GRADLE_OPTS ortam değişkenini ayarlar. xmx bayrağı, JVM için kullanılabilir en yüksek belleği belirtir.

sonarQubeRunAnalysis - SonarQube veya SonarCloud Analysis çalıştırma
Giriş diğer adı: sqAnalysisEnabled. boolean. Varsayılan değer: false.

Bu seçenek, Gradle görevinin 1. sürümünden sonarQube ve sonarCloud market uzantılarını kullanacak şekilde değiştirilmiştir. Görevler alanındaki görevleri yürüttkten sonra SonarQube veya SonarCloud analiz çalıştırmak için bu seçeneği etkinleştirin. Bu Gradle görevinden önce uzantılardan birinden derleme işlem hattına Çözümleme Yapılandırması Hazırlama görevi de eklemeniz gerekir.

Gradle sürümiçin SonarQube tarayıcısını sqGradlePluginVersionChoice -
string. sqAnalysisEnabled = truegerekir. İzin verilen değerler: specify (Sürüm numarasını belirtin), build (build.gradle'ınıza uygulanan eklentiyi kullanın). Varsayılan değer: specify.

Kullanılacak SonarQube Gradle eklenti sürümünü belirtir. Gradle yapılandırma dosyasında sürümü bildirin veya bu dizeyle bir sürüm belirtin.

Gradle eklentisi sürümüiçin sonarQubeGradlePluginVersion - SonarQube tarayıcısı
Giriş diğer adı: sqGradlePluginVersion. string. sqAnalysisEnabled = true && sqGradlePluginVersionChoice = specifygerekir. Varsayılan değer: 2.6.1.

SonarQube Gradle eklentisinin sürüm numarasını içerir.

Checkstyleçalıştırma checkStyleRunAnalysis -
Giriş diğer adı: checkstyleAnalysisEnabled. boolean. Varsayılan değer: false.

Checkstyle aracını varsayılan Güneş denetimleriyle çalıştırır. Sonuçlar derleme yapıtları olarak karşıya yüklenir.

findBugsRunAnalysis - FindBugs Çalıştırma
Giriş diğer adı: findbugsAnalysisEnabled. boolean. Varsayılan değer: false.

Koddaki hataları aramak için FindBugs statik analiz aracını kullanır. Sonuçlar derleme yapıtları olarak karşıya yüklenir. Gradle 6.0'da, bu eklentikaldırıldı. Bunun yerine SpotBugs eklentisini kullanın.

PMDçalıştırma pmdRunAnalysis -
Giriş diğer adı: pmdAnalysisEnabled. boolean. Varsayılan değer: false.

Koddaki hataları aramak için PMD Java statik analiz aracını kullanır. Sonuçlar derleme yapıtları olarak karşıya yüklenir.

SpotBugsspotBugsAnalysis - Çalıştırma
Giriş diğer adı: spotBugsAnalysisEnabled. boolean. Varsayılan değer: false.

spotBugs true çalıştırır. Bu eklenti Gradle v5.6 veya sonraki sürümlerle çalışır. SpotBugs Gradle eklentisini kullanarakhakkında daha fazla bilgi edinin. Eklenti beklenmeyen bir şekilde çalışabilir veya önceki bir Gradle sürümüyle hiç çalışmayabilir.

spotBugsGradlePluginVersionChoice - Spotbugs eklentisi sürümü
string. spotBugsAnalysisEnabled = truegerekir. İzin verilen değerler: specify (Sürüm numarasını belirtin), build (build.gradle'ınıza uygulanan eklentiyi kullanın). Varsayılan değer: specify.

Kullanılacak SpotBugs Gradle eklenti sürümünü belirtir. Sürüm Gradle yapılandırma dosyasında bildirilebilir veya bu dizede belirtilebilir.

spotbugsGradlePluginVersion - Sürüm numarası
string. spotBugsAnalysisEnabled = true && spotBugsGradlePluginVersionChoice = specifygerekir. Varsayılan değer: 4.7.0.

SpotBugs Gradle eklentisinin sürüm numarasınıiçerir.

Görev denetim seçenekleri

Tüm görevlerin, görev girişlerine ek olarak denetim seçenekleri vardır. Daha fazla bilgi için bkz. Denetim seçenekleri ve ortak görev özellikleri.

Çıkış değişkenleri

Yok.

Açıklamalar

SonarQube analizi yapılandırması, SonarQube veya SonarCloud uzantılarına, Prepare Analysis Configuration görevinde taşındı.

Gradle sarmalayıcı betiği kullanarak derlemek için bu görevi kullanın.

Gradle projemden nasıl sarmalayıcı oluşturabilirim?

Gradle sarmalayıcı, derleme aracısı JVM dışında derleme aracısı üzerinde herhangi bir yazılım yapılandırmasına gerek kalmadan depoda denetlenen tam Gradle ortamını indirmesine ve yapılandırmasına olanak tanır.

1. build.gradle dosyasının bulunduğu kök proje dizininden aşağıdaki komutu vererek Gradle sarmalayıcısını oluşturun:

   jamal@fabrikam> gradle wrapper

2. Gradle sarmalayıcınızı uzak deponuza yükleyin.

   Gradle sarmalayıcısı tarafından oluşturulan bir ikili yapıt vardır (gradle/wrapper/gradle-wrapper.jarkonumunda bulunur). Bu ikili dosya küçüktür ve güncelleştirilmesini gerektirmez. Derleme aracısı üzerinde Gradle yapılandırma çalıştırmasını değiştirmeniz gerekiyorsa, gradle-wrapper.propertiesgüncelleştirirsiniz.

   Depo şöyle görünmelidir:

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

Bağımlılıkları indirirken zaman aşımlarını nasıl düzeltebilirim?

Bağımlılıkları indirirken Read timed out gibi hataları düzeltmek için Gradle 4.3+ kullanıcıları -Dhttp.socketTimeout=60000 -Dhttp.connectionTimeout=60000'e Options ekleyerek zaman aşımını değiştirebilir. Bu, zaman aşımını 10 saniyeden 1 dakikaya artırır.

Örnekler

Gradle ile Java uygulamanızı derleme

Gereksinimler

Gereksinim	Açıklama
İşlem hattı türleri	YAML, Klasik derleme
Üzerinde çalışır	Agent, DeploymentGroup
Talep	Hiç kimse
Özellikleri	Bu görev, işteki sonraki görevler için herhangi bir talebi karşılamaz.
Komut kısıtlamaları	Herhangi biri
Ayarlanabilir değişkenleri	Herhangi biri
Aracı sürümü	1.91.0 veya üzeri
Görev kategorisi	İnşa et