Android Gradle eklentisi hakkında

Android Studio derleme sistemi, Gradle'ı temel alır ve Android Gradle eklentisi, Android uygulamaları oluşturmaya özgü çeşitli özellikler ekler.

Bu sayfada, Gradle araçlarınızı nasıl güncel tutacağınız açıklanmaktadır. Android Gradle eklentisiyle ilgili sürüm notları için sürüm notları sayfasını inceleyin.

Android Gradle eklentisinde yapılacak zarar veren değişikliklerin genel bir özeti için Android Gradle eklentisi yol haritasına bakın.

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

• Derlemenizi yapılandırma
• Android Gradle eklentisi DSL referansı
• Gradle DSL referansı
• Gradle performans kullanıcı rehberi

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

android skills add agp-9-upgrade

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 etmeyi veya projenizin derleme gereksinimlerine göre manuel olarak bir sürüm belirtmeyi seçebilirsiniz.

Eklenti sürümünü Android Studio'da Dosya > Proje Yapısı > Proje menüsünden veya üst düzey build.gradle.kts dosyasından 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, eklenti build.gradle.kts dosyasından 9.4.0 sürümüne ayarlanmaktadır:

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

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

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

Belirtilen eklenti sürümü indirilmemişse Gradle, projenizi bir sonraki derlemenizde veya Android Studio menü çubuğundan Dosya > Projeyi Gradle Dosyalarıyla Senkronize Et'i tıkladığınızda bu sürümü indirir.

Gradle'ı güncelleme

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

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

Gradle sürümünü Android Studio'da Dosya > Proje Yapısı > Proje menüsünden belirtebilir 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 sarmalayıcı kullanılarak Gradle sürümü 9.6.0 olarak ayarlanmıştır. Hem Gradle'ı hem de Gradle sarmalayıcısını yükseltmek için bu komutu iki kez çalıştırmanız gerektiğini unutmayın (Daha fazla bilgi için Gradle sarmalayıcısını yükseltme bölümünü inceleyin).

gradle wrapper --gradle-version 9.6.0

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ü 9.6.0 olarak ayarlanmıştır.

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

Android Gradle eklentisi ve Android Studio uyumluluğu

Android Studio derleme sistemi Gradle'ı temel alı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 gerektiği listelenmiştir.

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

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

Belirli bir API düzeyini destekleyen minimum Android Studio ve AGP sürümleri vardır. Projenizin targetSdk veya compileSdk için gereken Android Studio ya da AGP sürümlerinden daha eski sürümler kullanmak beklenmedik sorunlara yol açabilir. Android OS'in önizleme sürümlerini hedefleyen projeler üzerinde ç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 aşağıdaki gibidir: