Android Gradle eklentisi hakkında

Android Studio derleme sistemi Gradle'a dayanır ve Android Gradle eklentisi, Android uygulamaları oluşturmaya özel ç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ına bakın.

Android Gradle eklentisinde yapılacak olan ve geriye dönük uyumsuzluğa neden olabilecek değişikliklerin genel 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:

• Derlemenizi yapılandırma
• Android Gradle eklentisi DSL referansı
• Gradle DSL referansı
• Gradle performansıyla ilgili kullanıcı kılavuzu

Gradle derleme sistemi hakkında daha fazla bilgi için Gradle kullanıcı kılavuzuna 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 Dosya > Proje Yapısı > Proje 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 alınan eklenti sürümü 9.0 olarak ayarlanır:

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

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

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

Belirtilen eklenti sürümü indirilmemişse Gradle, projeyi bir sonraki derlemenizde veya Android Studio menü çubuğundan Dosya > Projeyi Gradle Dosyalarıyla Senkronize Et'i 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.

Gradle sürümünü Android Studio'daki File > Project Structure > Project 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 Wrapper kullanılarak Gradle sürümü 9.1.0 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 bölümüne bakın).

gradle wrapper --gradle-version 9.1.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ında Gradle dağıtım referansını düzenlemeniz gerekir. Aşağıdaki örnekte, gradle-wrapper.properties dosyasında Gradle sürümü 9.1.0 olarak ayarlanmıştır.

...
distributionUrl = https\://services.gradle.org/distributions/gradle-9.1.0-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 Gradle eklentisindeki yenilikler hakkında bilgi edinmek için Android Gradle eklentisi sürüm notlarını inceleyin.

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: