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:
- 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ı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.11 | 8.13 |
| 8.10 | 8.11.1 |
| 8.9 | 8.11.1 |
| 8.8 | 8.10.2 |
| 8.7 | 8.9 |
| 8.6 | 8.7 |
| 8.5 | 8.7 |
| 8.4 | 8.6 |
| 8.3 | 8.4 |
| 8.2 | 8.2 |
| 8.1 | 8.0 |
| 8.0 | 8.0 |
Eski sürümler
| Eklenti sürümü | Gerekli Gradle sürümü |
|---|---|
| 7.4 | 7,5 |
| 7.3 | 7.4 |
| 7.2 | 7.3.3 |
| 7.1 | 7.2 |
| 7,0 | 7,0 |
| 4.2.0+ | 6.7.1 |
| 4.1.0 ve üzeri | 6.5+ |
| 4.0.0 ve üzeri | 6.1.1+ |
| 3.6.0 - 3.6.4 | 5.6.4+ |
| 3.5.0 - 3.5.4 | 5.4.1+ |
| 3.4.0 - 3.4.3 | 5.1.1 ve üzeri |
| 3.3.0 - 3.3.3 | 4.10.1 ve üzeri |
| 3.2.0 - 3.2.1 | 4.6+ |
| 3.1.0 ve üzeri | 4.4+ |
| 3.0.0+ | 4.1 ve üzeri |
| 2.3.0+ | 3.3+ |
| 2.1.3 - 2.2.3 | 2.14.1 - 3.5 |
| 2.0.0 - 2.1.2 | 2.10 - 2.13 |
| 1.5.0 | 2.2.1 - 2.13 |
| 1.2.0 - 1.3.1 | 2.2.1 - 2.9 |
| 1.0.0 - 1.1.3 | 2.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 |
|
|||||||||
| Dexer (D8) |
|
|||||||||
| Lint |
|
|||||||||
| Shrinker (R8) |
|
|||||||||