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:
- 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ı 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.6.0 sürümüne
build.gradle.kts
dosyası:
Kotlin
plugins { id("com.android.application") version "8.6.0" apply false id("com.android.library") version "8.6.0" apply false id("org.jetbrains.kotlin.android") version "2.0.20" apply false }
Eski
plugins { id 'com.android.application' version '8.6.0' apply false id 'com.android.library' version '8.6.0' apply false id 'org.jetbrains.kotlin.android' version '2.0.20' 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.6.+'
.
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,5 | 8,7 |
8,4 | 8,6 |
8,3 | 8,4 |
8,2 | 8,2 |
8.1 | 8.0 |
8.0 | 8.0 |
7,4 | 7,5 |
Eski sürümler
Eklenti sürümü | Gerekli Gradle sürümü |
---|---|
7,3 | 7,4 |
7.2 | 7.3.3 |
7.1 | 7.2 |
7,0 | 7,0 |
4.2.0 ve sonraki sürümler | 6.7.1 |
4.1.0 ve sonraki sürümler | 6.5 ve üzeri |
4.0.0 ve sonraki sürümler | 6.1.1 ve sonraki sürümler |
3.6.0 - 3.6.4 | 5.6.4 ve sonraki sürümler |
3.5,0 - 3.5.4 | 5.4.1 ve sonraki sürümler |
3.4.0 - 3.4.3 | 5.1.1 ve sonraki sürümler |
3.3.0 - 3.3.3 | 4.10.1 ve üzeri |
3.2.0 - 3.2.1 | 4.6 ve üzeri |
3.1.0 ve sonraki sürümler | 4.4 ve üzeri |
3.0.0 ve sonraki sürümler | 4.1 ve üzeri |
2.3.0 ve sonraki sürümler | 3.3 ve üzeri |
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ü 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.6 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.6
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.6-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ü |
---|---|
Uğur Böceği | 1.2.2024 | 3,2-8,7 |
Koala Yeni Özellik | 2.1.2024 | 3,2-8,6 |
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 eklentisi (AGP) için 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 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ükseltmeyi deneyebilirsiniz.
API'lerin desteği, yaklaşık bir yıl öncesinden itibaren 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.6'nın desteklediği maksimum API düzeyi, API düzeyi 34'tür. Uyumlulukla ilgili diğer bilgileri aşağıda bulabilirsiniz: