Gradle@3 - Gradle v3 görevi

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

Syntax

# 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.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. Gereklidir. Varsayılan değer: gradlew.

gradlew Derleme için kullanılacak depo içinde sarmalayıcının konumunu belirtir. Windows'da aracılar (Microsoft tarafından barındırılan aracılar dahil) sarmalayıcıyı gradlew.bat kullanmalıdır. Linux veya macOS üzerindeki aracılar kabuk betiğini kullanabilir gradlew . Gradle Sarmalayıcı hakkında daha fazla bilgi edinin.


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

Gradle derlemesinin çalıştırılacak çalışma dizinini belirtir. Çalışma dizini belirtilmezse görev depo kök dizinini kullanır.


options - Seçenekler
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örev
string. Gereklidir. 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 gradlew tasks çıkarılarak alınabilir.

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


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 eşleşen Test Results Files her test sonuçları dosyasını yayımlar.


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

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


testRunTitle - Test çalıştırması başlığı
string. İsteğe bağlı. olduğunda publishJUnitResults = truekullanı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.

Derlemeye yönelik test çalışmalarının kapsadığı kodu belirlemek için bir kod kapsamı aracı belirtir.


codeCoverageClassFilesDirectories - Sınıf dosyaları dizinleri
Giriş diğer adı: classFilesDirectories. string. olduğunda codeCoverageTool != Nonegereklidir. 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 (Gradle 4+ için) altındaki build/classes/java/main sınıfları arar.


codeCoverageClassFilter - Sınıf ekleme/dışlama filtreleri
Giriş diğer adı: classFilter. string. İsteğe bağlı. olduğunda codeCoverageTool != Nonekullanı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 olur
Giriş diğer adı: failIfCoverageEmpty. boolean. İsteğe bağlı. olduğunda codeCoverageTool != Nonekullanı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. İsteğe bağlı. olduğunda codeCoverageTool = JaCoCokullanın. Varsayılan değer: true.

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


javaHomeOption - JAVA_HOME ayarlama ölçütü
Giriş diğer adı: javaHomeSelection. string. Gereklidir. İ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 JDK yolunu el ile girerek JAVA_HOME ayarlar.


jdkVersionOption - JDK sürümü
Giriş diğer adı: jdkVersion. string. İsteğe bağlı. olduğunda javaHomeSelection = JDKVersionkullanın. İzin verilen değerler: default, 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.


jdkDirectory - JDK yolu
Giriş diğer adı: jdkUserInputPath. string. olduğunda javaHomeSelection = Pathgereklidir.

verilen yola JAVA_HOME ayarlar.


jdkArchitectureOption - JDK mimarisi
Giriş diğer adı: jdkArchitecture. string. İsteğe bağlı. olduğunda jdkVersion != defaultkullanın. İzin verilen değerler: x86, x64. Varsayılan değer: x64.

JDK mimarisini (x86 veya x64) sağlar.


gradleOptions - GRADLE_OPTS ayarla
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. bayrağı, xmx JVM için kullanılabilir bellek üst sınırını belirtir.


sonarQubeRunAnalysis - SonarQube veya SonarCloud Analizi ç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ştirildi. Görevler alanındaki görevleri yürüttkten sonra SonarQube veya SonarCloud analizini çalıştırmak için bu seçeneği etkinleştirin. Ayrıca, bu Gradle görevinden önce uzantılardan birinden derleme işlem hattına Bir Çözümleme Yapılandırması Hazırlama görevi eklemeniz gerekir.


sqGradlePluginVersionChoice - Gradle sürümü için SonarQube tarayıcısı
string. olduğunda sqAnalysisEnabled = truegereklidir. İ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.


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

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


checkStyleRunAnalysis - Checkstyle'ı çalıştırma
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 eklenti kaldırıldı. Bunun yerine SpotBugs eklentisini kullanın.


pmdRunAnalysis - PMD çalıştırma
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.


spotBugsAnalysis - SpotBugs çalıştırma
Giriş diğer adı: spotBugsAnalysisEnabled. boolean. Varsayılan değer: false.

çalıştırıldığında trueçalışırspotBugs. Bu eklenti Gradle v5.6 veya sonraki sürümlerle çalışır. SpotBugs Gradle eklentisini kullanma hakkı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. olduğunda spotBugsAnalysisEnabled = truegereklidir. İ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 sürüm bu dizede belirtilebilir.


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

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


Görev denetimi 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 analizinin yapılandırması, görevdeki Prepare Analysis ConfigurationSonarQube veya SonarCloud uzantılarına taşındı.

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

Gradle projemden bir sarmalayıcı oluşturmak Nasıl yaparım??

Gradle sarmalayıcı, derleme aracısının depoda denetlenen tam Gradle ortamını JVM dışında derleme aracısının kendisinde herhangi bir yazılım yapılandırması olmadan 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 (konumunda gradle/wrapper/gradle-wrapper.jarbulunur). Bu ikili dosya küçük ve güncelleştirilmesini gerektirmez. Derleme aracısının Gradle yapılandırma çalıştırmasını değiştirmeniz gerekiyorsa, güncelleştirmeniz gradle-wrapper.propertiesgerekir.

    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 yaparım? düzeltebilirsiniz?

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

Örnekler

Gradle ile Java uygulamanızı oluşturma

Gereksinimler

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