Android Gradle Eklentisi 8.3.0 (Şubat 2024)

Android Gradle eklentisi 8.3.0, çeşitli yeni özellikler ve iyileştirmeler içeren ana sürümdür.

Uyumluluk

Android Gradle eklentisi 8.3'ün desteklediği maksimum API düzeyi, API düzeyi 34'tür. Uyumlulukla ilgili diğer bilgiler şunlardır:

Minimum sürüm Varsayılan sürüm Notlar
Gradle 8,4 8,4 Daha fazla bilgi edinmek için Gradle'ı güncelleme konusuna bakın.
SDK Oluşturma Araçları 34.0.0 34.0.0 SDK Derleme Araçlarını yükleyin veya yapılandırın.
400 Yok 25.1.8937393 Farklı bir NDK sürümü yükleyin veya yapılandırın.
JDK 17 17 Daha fazla bilgi edinmek için JDK sürümünü ayarlama bölümüne bakın.

Android Gradle eklentisi 8.3'teki yeni özellikler aşağıda verilmiştir.

Yama sürümleri

Aşağıda, Android Studio Iguana ve Android Gradle eklentisi 8.3'teki yama sürümlerinin bir listesi bulunmaktadır.

Android Studio Iguana | 2023.2.1 Yama 2 ve AGP 8.3.2 (Nisan 2024)

Bu küçük güncelleme, bu hata düzeltmelerini içerir.

Android Studio Iguana | 2023.2.1 Yama 1 ve AGP 8.3.1 (Mart 2024)

Bu küçük güncelleme, bu hata düzeltmelerini içerir.

Gradle Sürüm Katalogları Desteği

Android Studio, bağımlılıkları tek bir merkezi konumdan yönetmenize ve bağımlılıkları modüller veya projeler arasında paylaşmanıza olanak tanıyan bir özellik olan TOML tabanlı Gradle Sürüm Katalogları'nı destekler. Android Studio artık düzenleyici önerileri ve Proje Yapısı iletişim kutusuyla entegrasyon sayesinde sürüm kataloglarının yapılandırılmasını kolaylaştırıyor. Gradle Sürüm Katalogları oluşturma ve yapılandırma veya derlemenizi sürüm kataloglarına taşıma hakkında bilgi edinin.

Kod tamamlama ve gezinme

Bir sürüm kataloğunu TOML dosya biçiminde düzenlerken veya bir sürüm kataloğundan derleme dosyasına bir bağımlılık eklerken Android Studio, kod tamamlama özelliği sunar. Kod tamamlama özelliğini kullanmak için Ctrl+Boşluk tuşlarına basın (macOS'te Command+Boşluk). Ayrıca, Ctrl+b (macOS'te Command+b) tuşlarına basarak uygulamanızın build.gradle dosyasındaki bir bağımlılık referansından bu referansın sürüm kataloğunda tanımlandığı yere hızlı bir şekilde gidebilirsiniz.

Bağımlılık eklerken kod tamamlama

Proje Yapısı iletişim kutusuyla entegrasyon

Projeniz TOML dosya biçiminde tanımlanan bir sürüm kataloğu kullanıyorsa burada tanımladığınız değişkenleri Android Studio'daki Proje Yapısı iletişim kutusu Değişkenler görünümünden (Dosya > Proje Yapısı > Değişkenler) düzenleyebilirsiniz. Her sürüm kataloğu için ilgili katalogdaki değişkenleri listeleyen bir açılır liste bulunur. Bir değişkeni düzenlemek için değerini tıklayın ve değişkenin üzerine yazın. Bu değişiklikleri kaydettiğinizde TOML dosyası uygun şekilde güncellenir.

Proje Yapısı iletişim kutusundaki bir sürüm kataloğundaki değişkenler

Bağımlılıkları ayrıca Proje Yapısı iletişim kutusu Bağımlılıklar görünümünde (Dosya > Proje Yapısı > Bağımlılıklar) güncelleyebilirsiniz. Proje Yapısı iletişim kutusunu kullanarak sürümleri güncellemek için düzenlemek istediğiniz modüle ve bağımlılığa gidin, ardından İstenen Sürüm alanını güncelleyin. Bu değişiklikleri kaydettiğinizde TOML dosyası buna göre güncellenir. Bağımlılık sürümü bir değişken kullanılarak tanımlanmışsa, sürümü doğrudan bu şekilde güncellediğinizde değişkenin sabit kodlu bir değerle değiştirileceğini unutmayın. Ayrıca, Proje Yapısı iletişim kutusunu kullansanız da kullanmasanız da bir bağımlılığı derleme dosyasından kaldırmanın, bağımlılığın sürüm kataloğundan kaldırılmayacağını unutmayın.

Proje Yapısı iletişim kutusundaki bir sürüm kataloğundaki bağımlılıklar

Bilinen sorunlar ve sınırlamalar

Aşağıda, Android Studio'daki Gradle Sürüm Katalogları desteğiyle ilgili bilinen sorunlar veya sınırlamalar bulunmaktadır.

  • Kotlin komut dosyası dosyalarında eklenti takma adı bildirimleri vurgulanırken hata oluştu: alias(libs.plugins.example) formunda bir eklenti bildirimi eklediğinizde düzenleyici, libs bölümünün altına kırmızı bir alt çizgi ekler. Bu, Gradle'ın 8.0 ve önceki sürümlerinde bilinen bir sorundur ve Gradle'ın gelecekteki bir sürümünde çözülecektir.

  • Android Studio yalnızca TOML biçimindeki sürüm katalogları için desteklenir: Şu anda Android Studio kod tamamlama, gezinme ve Proje Yapısı iletişim kutusu desteği yalnızca TOML dosya biçiminde tanımlanan sürüm katalogları için kullanılabilir. Yine de doğrudan settings.gradle dosyasına bir sürüm kataloğu ekleyebilir ve bu kataloğun bağımlılıklarını projenizde kullanabilirsiniz.

  • KTS derleme dosyalarında gezinme desteklenmez: Kotlin komut dosyası kullanılarak yazılan derleme dosyalarında Control+tıklama (macOS'te Command+tıklama) komutuyla sürüm kataloğundaki bir bağımlılık tanımına gitme henüz desteklenmemektedir.

  • Firebase Assistant, bağımlılıkları doğrudan derleme komut dosyalarına ekler: Firebase Assistant, bağımlılıkları sürüm katalogları yerine doğrudan derleme komut dosyalarınıza ekler.

  • "Kullanımları bulma" işlevi desteklenmez: Derleme dosyasının KTS veya Groovy'de olması fark etmeksizin, diğer derleme dosyalarında sürüm kataloğu değişkeninin kullanımlarını bulma özelliği henüz desteklenmemektedir. Yani bir sürüm kataloğundaki değişken tanımında Control+click (macOS'te Command+click) komutu, değişkenin kullanıldığı derleme dosyalarına yönlendirilemez.

  • Android Studio'daki Proje Yapısı iletişim kutusu, kök gradle klasöründe birden fazla katalog dosyası gösterir ancak birleşik derleme kataloglarını göstermez. Örneğin, biri uygulamanız ve diğeri birleşik derleme için iki katalog dosyanız varsa Proje Yapısı iletişim kutusunda yalnızca uygulama kataloğu dosyası gösterilir. Kompozit bir derleme kullanabilirsiniz, ancak doğrudan TOML dosyasını düzenlemeniz gerekir.

Ek SDK analizleri: Politika sorunları

Android Studio, build.gradle.kts ile build.gradle dosyalarında ve Google Play SDK Dizini'nde Play politikalarını ihlal eden herkese açık SDK'lar için Proje Yapısı İletişim Kutusu'nda lint uyarıları gösterir. Gelecekte Google Play Console'da içerik yayınlamanızı engelleyebileceği için Play politikalarını ihlal eden tüm bağımlılıkları güncellemeniz gerekir. Politika ihlali uyarıları, Android Studio tarafından gösterilen eski sürüm uyarılarını tamamlar.

Android Studio Derleme SDK sürümü desteği

Projeniz, Android Studio'nun geçerli sürümünde desteklenmeyen bir compileSdk kullanıyorsa Android Studio bir uyarı gösterir. Varsa projeniz tarafından kullanılan compileSdk destekleyen bir Android Studio sürümüne geçmeniz de önerilir. Android Studio'yu yeni sürüme geçirmek için AGP'yi yeni sürüme geçirmeniz gerekebileceğini unutmayın. Projenizde kullanılan compileSdk, AGP'nin geçerli sürümü tarafından desteklenmiyorsa AGP ayrıca Derleme araç penceresinde bir uyarı görüntüler.

Lint davranışı değişiklikleri

Bir modül üzerinde lint çalıştırırken, Android Gradle eklentisi 8.3.0-alpha02 ile başlayarak, modülün ana ve test bileşenleri için ayrı lint analiz görevleri çalıştırılır. Bu değişikliğin amacı performansı artırmaktır. Önceki davranışa geri dönmek için gradle.properties dosyanızda android.experimental.lint.analysisPerComponent=false değerini ayarlayın.

Varsayılan olarak hassas kaynak daralması açık

resources.arsc dosyasındaki kullanılmayan girişleri kaldıran ve kullanılmayan kaynak dosyaları ortadan kaldıran hassas kaynak daraltma varsayılan olarak etkindir. Bu daraltma etkinleştirildiğinde, kaynak tablonuz küçültülür ve APK'ya yalnızca referans verilen res klasör girişleri dahil edilir.

Hassas kaynak daraltmayı devre dışı bırakmak için projenizin gradle.properties dosyasında android.enableNewResourceShrinker.preciseShrinking öğesini false olarak ayarlayın.