Android Gradle eklentisi 8.11 sürüm notları

JCenter deposu 31 Mart 2021'de salt okunur hale geldi. Daha fazla bilgi için JCenter hizmet güncellemesi başlıklı makaleyi inceleyin.

Android Studio derleme sistemi Gradle'a dayanır ve Android Gradle eklentisi, Android uygulamaları oluşturmaya özel çeşitli özellikler ekler. Android Gradle eklentisi (AGP) genellikle Android Studio ile birlikte güncellense de eklenti (ve Gradle sisteminin geri kalanı) Android Studio'dan bağımsız olarak çalışabilir ve ayrı ayrı güncellenebilir.

Bu sayfada, Gradle araçlarınızı nasıl güncel tutacağınız ve son güncellemelerde neler olduğu açıklanmaktadır. Geçmiş Android Gradle eklentisi sürümlerinin sürüm notları için geçmiş sürüm notlarına bakın.

Android Gradle eklentisinin bu sürümünde düzeltilen sorunları görmek için kapatılan sorunlar bölümüne bakın.

Android Gradle eklentisindeki yaklaşan ve uyumluluğu bozacak değişikliklerin üst düzey bir özeti için Android Gradle eklentisi yol haritası başlıklı makaleyi inceleyin.

Android derlemelerinizi Gradle ile yapılandırma hakkında ayrıntılı bilgi için aşağıdaki sayfalara bakın:

Gradle derleme sistemi hakkında daha fazla bilgi için Gradle kullanıcı kılavuzu'na bakın.

Android Gradle eklentisini güncelleme

Android Studio'yu güncellediğinizde Android Gradle eklentisini otomatik olarak mevcut en son sürüme güncellemeniz istenebilir. Güncellemeyi kabul edebilir veya projenizin derleme koşullarına göre manuel olarak bir sürüm belirtebilirsiniz.

Eklenti sürümünü Android Studio'daki File > Project Structure > Project menüsünde veya üst düzey build.gradle.kts dosyasında belirtebilirsiniz. Eklenti sürümü, söz konusu Android Studio projesinde oluşturulan tüm modüller için geçerlidir. Aşağıdaki örnekte, build.gradle.kts dosyasından eklenti 8.11.0 sürümüne ayarlanır:

Kotlin

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

Groovy

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

Dikkat: Sürüm numaralarında 'com.android.tools.build:gradle:8.11.+' gibi dinamik bağımlılıklar kullanmamalısınız. Bu özelliği kullanmak, beklenmedik sürüm güncellemelerine ve sürüm farklılıklarını çözmede zorluğa neden olabilir.

Belirtilen eklenti sürümü indirilmemişse Gradle, projenizi bir sonraki derlemenizde veya Android Studio menü çubuğundan File > Sync Project with Gradle Files'ı (Projeyi Gradle Dosyalarıyla Senkronize Et) tıkladığınızda indirir.

Gradle'ı güncelleme

Android Studio'yu güncellediğinizde Gradle'ı da mevcut en son sürüme güncellemeniz istenebilir. Güncellemeyi kabul edebilir veya projenizin derleme gereksinimlerine göre manuel olarak bir sürüm belirtebilirsiniz.

Aşağıdaki tabloda, Android Gradle eklentisinin her sürümü için hangi Gradle sürümünün gerekli olduğu listelenmiştir. En iyi performans için hem Gradle'ın hem de eklentinin mümkün olan en son sürümünü kullanmanız gerekir.

Eklenti sürümüGerekli minimum Gradle sürümü
8.118.13
8.108.11.1
8.98.11.1
8.88.10.2
8.78.9
8.68.7
8.58.7
8.48.6
8.38.4
8.28.2
8.18.0
8.08.0

Eski sürümler

Eklenti sürümüGerekli Gradle sürümü
7.47,5
7.37.4
7.27.3.3
7.17.2
7,07,0
4.2.0+6.7.1
4.1.0 ve üzeri6.5+
4.0.0 ve üzeri6.1.1+
3.6.0 - 3.6.45.6.4+
3.5.0 - 3.5.45.4.1+
3.4.0 - 3.4.35.1.1 ve üzeri
3.3.0 - 3.3.34.10.1 ve üzeri
3.2.0 - 3.2.14.6+
3.1.0 ve üzeri4.4+
3.0.0+4.1 ve üzeri
2.3.0+3.3+
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ü Android Studio'daki File > Project Structure > Project menüsünden belirleyebilir veya komut satırını kullanarak Gradle sürümünüzü güncelleyebilirsiniz. Tercih edilen yöntem, gradlew komut dosyalarını güncelleyen Gradle Wrapper komut satırı aracını kullanmaktır. Aşağıdaki örnekte, Gradle Wrapper kullanılarak Gradle sürümü 8.13 olarak ayarlanır. Hem Gradle'ı hem de Gradle Wrapper'ı yükseltmek için bu komutu iki kez çalıştırmanız gerektiğini unutmayın (daha fazla bilgi için Gradle Wrapper'ı Yükseltme başlıklı makaleye bakın).

gradle wrapper --gradle-version 8.13

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ğilse. Bu durumda, gradle/wrapper/gradle-wrapper.properties dosyasındaki Gradle dağıtım referansını düzenlemeniz gerekir. Aşağıdaki örnekte, gradle-wrapper.properties dosyasında Gradle sürümü 8.13 olarak ayarlanır.

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

Android Gradle eklentisi ve Android Studio uyumluluğu

Android Studio derleme sistemi Gradle'a dayanır ve Android Gradle eklentisi (AGP), Android uygulamaları oluşturmaya özgü çeşitli özellikler ekler. Aşağıdaki tabloda, Android Studio'nun her sürümü için hangi AGP sürümünün gerekli olduğu listelenmiştir.

Android Studio sürümü Gerekli AGP sürümü
Narwhal Feature Drop | 2025.1.2 4.0-8.12
Narwhal | 2025.1.1 3.2-8.11
Meerkat Feature Drop | 2024.3.2 3.2-8.10
Meerkat | 2024.3.1 3,2-8,9
Ladybug Feature Drop | 2024.2.2 3,2-8,8
Ladybug | 2024.2.1 3,2-8,7
Koala Feature Drop | 2024.1.2 3,2-8,6
Koala | 2024.1.1 3,2-8,5
Jellyfish | 2023.3.1 3.2-8.4
Iguana | 2023.2.1 3,2-8,3
Hedgehog | 2023.1.1 3.2-8.2
Giraffe | 2022.3.1 3.2-8.1
Flamingo | 2022.2.1 3,2-8,0

Eski sürümler

Android Studio sürümü Gerekli AGP sürümü
Electric Eel | 2022.1.1 3,2-7,4
Dolphin | 2021.3.1 3,2-7,3
Chipmunk | 2021.2.1 3,2-7,2
Bumblebee | 2021.1.1 3.2-7.1
Arctic Fox | 2020.3.1 3,1-7,0

Android Gradle eklentisindeki yenilikler hakkında bilgi edinmek için Android Gradle eklentisi sürüm notları'na bakın.

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

Belirli bir API düzeyini destekleyen Android Studio ve AGP'nin minimum sürümleri vardır. Projenizin targetSdk veya compileSdk tarafından gerekli olan Android Studio ya da AGP sürümlerinden daha eski sürümleri kullanmak beklenmedik sorunlara yol açabilir. Android işletim sisteminin önizleme sürümlerini hedefleyen projelerde çalışmak için Android Studio ve AGP'nin en son önizleme sürümünü kullanmanızı öneririz. Android Studio'nun önizleme sürümlerini kararlı bir sürümle birlikte yükleyebilirsiniz.

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

API seviyesi Minimum Android Studio sürümü Minimum AGP sürümü
36,0 Meerkat | 2024.3.1 Patch 1 8.9.1
35 Koala Feature Drop | 2024.2.1 8.6.0
34 Hedgehog | 2023.1.1 8.1.1
33 Flamingo | 2022.2.1 7.2

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

Android Gradle eklentisi (AGP) için sürüm numaralandırmasını, temel Gradle derleme aracıyla daha uyumlu olacak şekilde güncelliyoruz.

Önemli değişiklikler:

  • AGP artık anlamsal sürüm oluşturmayı kullanacak ve önemli sürümlerde uyumluluğu bozan değişiklikler yapılacak.

  • Gradle'ın ana sürümüyle uyumlu olacak şekilde yılda bir ana AGP sürümü yayınlanacaktır.

  • AGP 4.2'den sonraki sürüm 7.0 olacak ve Gradle 7.x sürümüne yükseltme gerektirecek. AGP'nin her ana sürümü, temel Gradle aracında ana sürüm yükseltmesi gerektirir.

  • API'ler yaklaşık bir yıl önceden kullanımdan kaldırılacak ve aynı anda yerine kullanılabilecek işlevler sunulacaktır. Desteği sonlandırılan API'ler yaklaşık bir yıl sonra, sonraki büyük güncelleme sırasında kaldırılacaktır.

Uyumluluk

Android Gradle eklentisi 8.11'in desteklediği maksimum API düzeyi, API düzeyi 36'dır. Diğer uyumluluk bilgileri:

Minimum sürüm Varsayılan sürüm Notlar
Gradle 8.13 8.13 Daha fazla bilgi edinmek için Gradle'ı güncelleme başlıklı makaleyi inceleyin.
SDK Build Tools 35.0.0 35.0.0 SDK oluşturma araçlarını yükleyin veya yapılandırın.
NDK Yok 27.0.12077973 NDK'nın farklı bir sürümünü yükleyin veya yapılandırın.
JDK 17 17 Daha fazla bilgi için JDK sürümünü ayarlama konusuna bakın.

Çözülen sorunlar

Android Gradle eklentisi 8.11.0

Çözülen Sorunlar
Android Gradle eklentisi
Yalıtılmış proje: DeclarativeSchemaModel serileştirme hatası
İstek: zipAlignEnabled'ın desteğinin sonlandırılmasıyla ilgili olarak, bu özelliğin neden desteğinin sonlandırıldığını ve bunun yerine ne kullanılması gerektiğini açıklayın.
[AGP 8.9.0+] BuiltinKotlinCompilation, tüm Kotlin derleyici eklentilerine sunulur
AGP 8.11'i oluştururken Kotlin bağımlılıklarını 2.1.20 sürümüne güncelleyin.
Gradle dağıtımı güncellenirken com.android.internal.version-check zorunlu kılınmıyor
Proguard dosyası mevcut olmadığında derleme başarısız oluyor
Dexer (D8)
AutoClosable desugaring, Android Studio'daki AGP derlemelerini bozuyor
Lint
Lint kuralı BuildListAdds, buildList'te plusAssign (+=) operatörünün kullanımını algılamıyor
UseSdkSuppress, test yardımcı kodunda yanlış pozitifleri önler
Üye ve uzantı arasında olası çakışma konusunda uyarı
Uzantı işlevi alıcısı null değer atanabilirse "MemberExtensionConflict" lint sorunu için yanlış pozitif
`WrongGradleMedthod` incelemesi yanlış pozitif
Veri sınıfının yapay üye çağrısı için SyntheticAccessor yanlış pozitif
Etiketlenebilir ifadede bildirilen sorun için TestMode.SUPPRESSIBLE hatası
AGP 8.11.0-alpha03 sürümünden itibaren yeni MemberExtensionConflict lint sorunları - nasıl çözülür?
"libs.versions.toml" dosyasındaki Lint incelemesi, desteklenmeyen bir AGP sürümüne yükseltme yapılmasını öneriyor.
Shrinker (R8)
AGP 8.9.0'a güncelledikten sonra imzalı AAB oluşturulamıyor
JavaFuzzer kodu işlenirken R8, min-api 24 ile kilitleniyor