Android Gradle eklentisi 8.5 sürüm notları

JCenter deposu 31 Mart 2021'de salt okunur hale geldi. Daha fazla bkz. JCenter hizmet güncellemesi.

Android Studio derleme sistemi Gradle, Android Gradle ise eklentisi, Android uygulamaları oluşturmaya özel çeşitli özellikler ekler. Her ne kadar Android Gradle eklentisi (AGP) Android ile genellikle kilit adımlarında güncellenir Studio'da eklenti (ve Gradle sisteminin geri kalanı) ve ayrı olarak güncellenir.

Bu sayfada, Gradle araçlarınızı güncel veya güncelleme tarihi ve son güncellemelerde neler olduğu. Eski Android sürümleri için sürüm notları Gradle eklentisi sürümleri için bkz. geçmiş sürüm notlarını inceleyin.

Android Gradle eklentisinin bu sürümünde nelerin düzeltildiğini öğrenmek için şuraya bakın: kapanan sorunlar.

Android Gradle'da yaklaşan zarar veren değişikliklerin üst düzey bir özeti için eklentisi için Android Gradle eklentisi yol haritası.

Android derlemelerinizi Gradle ile yapılandırmayla ilgili ayrıntılar için şu sayfaları inceleyin:

Gradle derleme sistemi hakkında daha fazla bilgi için Gradle kullanıcı rehberi.

Android Gradle eklentisini güncelleme

Android Studio'yu güncellediğinizde, uygulamanın otomatik olarak Android Gradle eklentisini mevcut en son sürüme güncelleyin. Siz güncellemeyi kabul etmeyi veya ona göre manuel olarak bir sürüm en iyi uygulamaları paylaşacağız.

Eklenti sürümünü şurada belirtebilirsiniz: Dosya > Proje Yapı > Android Studio'daki Proje menüsünü veya üst düzey build.gradle.kts dosyası olabilir. Eklenti sürümü tüm modüllerin kullanımını destekler. Aşağıdaki örnek önceki sürümden 8.5.0 sürümüne build.gradle.kts dosyası:

Kotlin

plugins {
    id("com.android.application") version "8.5.0" apply false
    id("com.android.library") version "8.5.0" apply false
    id("org.jetbrains.kotlin.android") version "1.9.23" apply false
}

Eski

plugins {
    id 'com.android.application' version '8.5.0' apply false
    id 'com.android.library' version '8.5.0' apply false
    id 'org.jetbrains.kotlin.android' version '1.9.23' apply false
}

Dikkat: Sürümde dinamik bağımlılıkları kullanmamalısınız. sayılar, örneğin 'com.android.tools.build:gradle:8.5.+'. Bu özelliğin kullanılması, beklenmedik sürüm güncellemelerine ve zorluklara neden olabilir sürüm farklılıklarını çözümleme.

Belirtilen eklenti sürümü indirilmemişse Gradle söz konusu sürümü indirir tıklayın veya File (Dosya) > Projeyi Gradle Dosyalarıyla Senkronize Etme diğer videoları da arattır.

Gradle'ı güncelle

Android Studio'yu güncellediğinizde ayrıca Gradle'ı mevcut en son sürüme güncelleyin. Şunu kabul edebilirsiniz: projenizin derlemesine göre bir sürümü güncelleyin veya manuel olarak belirtin gereksinimlerini karşılayın.

Aşağıdaki tabloda, her uygulama için Gradle sürümü sürümünü indirin. En iyi performans için Gradle ve eklentinin mümkün olan en son sürümünü kullanın.

Eklenti sürümüGerekli minimum Gradle sürümü
8,58,7
8,48,6
8,38,4
8,28,2
8.18.0
8.08.0
7,47,5

Eski sürümler

Eklenti sürümüGerekli Gradle sürümü
7,37,4
7.27.3.3
7.17.2
7,07,0
4.2.0 ve sonraki sürümler6.7.1
4.1.0 ve sonraki sürümler6.5 ve üzeri
4.0.0 ve sonraki sürümler6.1.1 ve sonraki sürümler
3.6.0 - 3.6.45.6.4 ve sonraki sürümler
3.5,0 - 3.5.45.4.1 ve sonraki sürümler
3.4.0 - 3.4.35.1.1 ve sonraki sürümler
3.3.0 - 3.3.34.10.1 ve üzeri
3.2.0 - 3.2.14.6 ve üzeri
3.1.0 ve sonraki sürümler4.4 ve üzeri
3.0.0 ve sonraki sürümler4.1 ve üzeri
2.3.0 ve sonraki sürümler3.3 ve üzeri
2.1.3 - 2.2.32.14.1 - 3,5
2.0.0 - 2.1.22,10 - 2:13
1.5.02.2.1 - 2.13
1.2.0 - 1.3.12.2.1 - 2.9
1.0.0 - 1.1.32.2.1 - 2.3

Gradle sürümünü Dosya > Proje Yapısı > Proje menüsünü kullanarak veya komut satırını kullanarak Gradle sürümünüzü güncelleyin. Tercih edilen yöntem, Gradle Sarmalayıcı gradlew komut dosyalarını güncelleyen komut satırı aracı. Aşağıdakiler örneği, Gradle Sarmalayıcı'yı kullanarak Gradle sürümünü 8.5 olarak ayarlar. Unutmayın, hem Gradle'ı hem de Gradle Wrapper (daha fazla bilgi için bkz. Gradle Sarmalayıcı'yı yeni sürüme geçirme).

gradle wrapper --gradle-version 8.5

Ancak bu işlem bazı durumlarda başarısız olabilir (örneğin, AGP'yi yeni güncellediyseniz) ve artık mevcut Gradle sürümüyle uyumlu değil. Böyle durumlarda şu sayfadaki Gradle dağıtım referansını düzenlemeniz gerekir: gradle/wrapper/gradle-wrapper.properties dosyası yükleyin. Aşağıdakiler Gradle sürümünü gradle-wrapper.properties dosyası yükleyin.

...
distributionUrl = https\://services.gradle.org/distributions/gradle-8.5-bin.zip
...

Android Gradle eklenti ve Android Studio uyumluluğu

Android Studio derleme sistemi Gradle, Android Gradle ise eklentisi (AGP), Android uygulamaları oluşturmaya özel çeşitli özellikler ekler. İlgili içeriği oluşturmak için kullanılan aşağıdaki tabloda her sürüm için AGP sürümünün Android Studio'ya gidin.

Android Studio sürümü Gerekli AGP sürümü
Koala | 1.1.2024 3,2-8,5
Denizanası | 1.3.2023 3,2-8,4
İguana | 1.2.2023 3,2-8,3
Kirpi | 1.1.2023 3,2-8,2
Zürafa | 1.3.2022 3,2-8,1
Flamingo | 1.2.2022 3,2-8,0

Eski sürümler

Android Studio sürümü Gerekli AGP sürümü
Elektrikli Yılan balığı | 1.1.2022 3,2-7,4
Yunus | 1.3.2021 3,2-7,3
Sincap | 1.2.2021 3,2-7,2
Yaban arısı | 1.1.2021 3,2-7,1
Kutup Tilkisi | 1.3.2020 3,1-7,0

Android Gradle eklentisindeki yenilikler hakkında bilgi edinmek için şu sayfaya bakın: Android Gradle eklentisi sürüm notları.

Android API düzeyi için minimum araç sürümleri

Android Studio ve AGP'nin belirli bir API'yi destekleyen minimum sürümleri vardır seviyesinde olmalıdır. Android Studio veya AGP'nin, projenin targetSdk veya compileSdk’ı beklenmeyen sorunlara neden olabilir. Biz üzerinde çalışmak için Android Studio ve AGP'nin en son önizleme sürümünü kullanmanızı öneririz. Android OS'in önizleme sürümlerini hedefleyen projeler için kullanılabilir. Şunları yapabilirsiniz: yükleme Android Studio'nun kararlı sürümüyle birlikte sürümlerini önizleme.

Android Studio ve AGP'nin minimum sürümleri şunlardır:

API seviyesi Minimum Android Studio sürümü Minimum AGP sürümü
VanillaIceCream önizlemesi Denizanası | 1.3.2023 8,4
34 Kirpi | 1.1.2023 8.1.1
33 Flamingo | 1.2.2022 7.2

Sürüm oluşturma değişiklikleri (Kasım 2020)

Android Gradle eklentisine (AGP) ilişkin sürüm numaralandırmasını temel Gradle oluşturma aracıyla yakından eşleşir.

Önemli değişiklikler şunlardır:

  • AGP artık semantik sürüm oluşturmayı kullanacak ve zarar veren değişiklikler en iyi şekilde yararlanabilirsiniz.

  • Her yıl yayınlanan AGP'nin ana sürümü, Gradle ana yayını oldu.

  • AGP 4.2'den sonraki sürüm 7.0 sürümü olacaktır ve yeni sürüme geçirilmesi gerekecektir Gradle 7.x sürümüne geri yükleyin. AGP'nin her ana sürümü için büyük bir sürümünü yükseltmenizi öneririz.

  • API'lerin desteği yaklaşık bir yıl önce sonlandırılacaktır. eşzamanlı olarak kullanıma sunulur. Desteği sonlandırılmış API'ler yaklaşık bir yıl sonra, proje yöneticisinin güncelleyin.

Uyumluluk

Android Gradle eklentisi 8.5'in sağladığı maksimum API düzeyi API düzeyi 34'tür. Uyumlulukla ilgili diğer bilgileri aşağıda bulabilirsiniz:

Minimum sürüm Varsayılan sürüm Notlar
Gradle 8,7 8,7 Daha fazla bilgi edinmek için Gradle'ı güncelleme sayfasına göz atın.
SDK Derleme Araçları 34.0.0 34.0.0 SDK Derleme Araçları'nı yükleyin veya yapılandırın.
NDK Yok 26.1.10909125 NDK'nın farklı bir sürümünü yükleyin veya yapılandırın.
JDK 17 17 Daha fazla bilgi edinmek için JDK sürümünü ayarlama bölümüne bakın.

Yama sürümleri

Android Studio Koala'daki yama sürümlerinin listesi aşağıda verilmiştir ve Android Gradle eklentisi 8.5.

Android Studio Koala | 2024.1.1 Yaması ve AGP 8.5.1 (Temmuz 2024)

Bu küçük güncelleme şunları içerir: bu hata düzeltmelerine göz atın.