Android Gradle eklentisi 3.0.0 ve sonraki sürümler, tüm Java 7 dil özelliklerini ve platform sürümüne göre değişen Java 8 dil özelliklerinin bir alt kümesini destekler. Uygulamanızı Android Gradle eklentisi 4.0.0 ve sonraki sürümleri kullanarak oluştururken uygulamanız için minimum API düzeyi gerekmeden bazı Java 8 dil API'lerini kullanabilirsiniz.
Bu sayfada, kullanabileceğiniz Java 8 dil özellikleri, projenizi bu özellikleri kullanacak şekilde doğru şekilde yapılandırma ve karşılaşabileceğiniz bilinen sorunlar açıklanmaktadır. Java 8 dil özelliklerine genel bakış için aşağıdaki videoyu izleyin.
Android Gradle eklentisi, belirli Java 8 dil özelliklerini ve bunları kullanan üçüncü taraf kitaplıklarını kullanmak için yerleşik destek sağlar. Varsayılan araç zinciri, Şekil 1'de gösterildiği gibi, sınıf dosyalarının DEX koduna D8/R8 derlemesinin bir parçası olarak desugar adı verilen bayt kodu dönüşümleri gerçekleştirerek yeni dil özelliklerini uygular.
desugar bayt kodu dönüşümleri kullanılarak Java 8 dil özelliği desteği.
Java 8 dil özelliği desteği (Android Gradle Eklentisi 3.0.0+)
Desteklenen Java 8 dil özelliklerini kullanmaya başlamak için:
- Android Gradle eklentisini 3.0.0 veya sonraki bir sürüme güncelleyin.
- Java 8 dil özelliklerini kullanan her modül için (kaynak kodunda veya bağımlılıklar aracılığıyla) modülün
build.gradleya dabuild.gradle.ktsdosyasını aşağıda gösterildiği gibi güncelleyin:
Kotlin
android { ... // Configure only for each module that uses Java 8 // language features (either in its source code or // through dependencies). compileOptions { sourceCompatibility = JavaVersion.VERSION_1_8 targetCompatibility = JavaVersion.VERSION_1_8 } // For Kotlin projects kotlinOptions { jvmTarget = "1.8" } }
Modern
android { ... // Configure only for each module that uses Java 8 // language features (either in its source code or // through dependencies). compileOptions { sourceCompatibility JavaVersion.VERSION_1_8 targetCompatibility JavaVersion.VERSION_1_8 } // For Kotlin projects kotlinOptions { jvmTarget = "1.8" } }
Uygulamanızı Android Gradle eklentisi 3.0.0 ve sonraki sürümleri kullanarak oluştururken eklenti, tüm Java 8 dil özelliklerini desteklemez. Aşağıdaki dil özellikleri tüm API düzeylerinde kullanılabilir:
| Java 8 dil özelliği | Notlar |
|---|---|
| Lambda ifadeleri | Android, lambda ifadelerinin serileştirilmesini desteklemez. |
| Yöntem referansları | |
| Tür ek açıklamaları | Tür ek açıklaması bilgileri yalnızca derleme zamanında kullanılabilir, çalışma zamanında kullanılamaz. Platform, API düzeyi 24 ve altında TYPE'yi destekler ancak ElementType.TYPE_USE veya ElementType.TYPE_PARAMETER'yi desteklemez.
|
| Varsayılan ve statik arayüz yöntemleri | |
| Tekrarlanan notlar |
Bu Java 8 dil özelliklerine ek olarak, Android Gradle eklentisinin 3.0.0 ve sonraki sürümleri, try-with-resources desteğini tüm Android API düzeylerine genişletir.
Desugar, MethodHandle.invoke veya MethodHandle.invokeExact'yi desteklemez.
Kaynak kodunuz veya modül bağımlılıklarınızdan biri bu yöntemlerden birini kullanıyorsa minSdkVersion 26 veya daha yüksek bir sürüm belirtmeniz gerekir. Aksi takdirde şu hatayı alırsınız:
Dex: Error converting bytecode to dex:
Cause: signature-polymorphic method called without --min-sdk-version >= 26
Bazı durumlarda modülünüz, bir kitaplık bağımlılığına dahil edilmiş olsalar bile invoke veya invokeExact yöntemlerini kullanmıyor olabilir. Bu kitaplığı minSdkVersion 25 veya daha düşük bir sürümle kullanmaya devam etmek için kod daraltmayı etkinleştirerek kullanılmayan yöntemleri kaldırın. Bu işe yaramazsa desteklenmeyen yöntemleri kullanmayan alternatif bir kitaplık kullanabilirsiniz.
Android Gradle eklentisi 3.0.0 ve sonraki sürümlerde Java 8 ve sonraki sürümlerin dil özelliklerinin desugaring işlemi yapılır. Bu işlem, eski Android sürümlerinde kullanılmak üzere ek sınıflar ve API'ler (ör. java.util.stream.*) sunmaz.
Aşağıdaki bölümde açıklandığı gibi, Android Gradle eklentisi 4.0.0 veya sonraki sürümlerde kısmi Java API desugaring desteği mevcuttur.
Java 8+ API desugaring desteği (Android Gradle Eklentisi 4.0.0+)
Uygulamanızı Android Gradle eklentisi 4.0.0 veya sonraki bir sürümü kullanarak oluşturuyorsanız eklenti, uygulamanız için minimum API düzeyi gerektirmeden çeşitli Java 8 dil API'lerinin kullanımına yönelik desteği genişletir. Android Gradle eklentisi 7.4.0 veya sonraki sürümlerde, desugared kitaplığı 2.0.0 veya sonraki sürümlerle birlikte çeşitli Java 11 dil API'leri de kullanılabilir.
Eski platform sürümleri için bu ek destek, 4.0.0 ve sonraki sürümlerdeki eklentinin, Java dili API'lerini de desugar etmek için desugaring motorunu genişletmesiyle mümkün olur. Yalnızca son Android sürümlerinde (ör. java.util.streams) kullanılabilen standart dil API'lerini, daha eski Android sürümlerini destekleyen uygulamalara ekleyebilirsiniz.
Uygulamanızı Android Gradle eklentisi 4.0.0 veya sonraki bir sürümü kullanarak oluştururken aşağıdaki API'ler desteklenir:
- Sıralı akışlar (
java.util.stream) java.timealt kümesijava.util.functionjava.util.{Map,Collection,Comparator}listesine son eklenenler- İsteğe bağlı öğeler (
java.util.Optional,java.util.OptionalIntvejava.util.OptionalDouble) ve bazı yeni sınıflar java.util.concurrent.atomiciçin bazı eklemeler (AtomicInteger,AtomicLongveAtomicReferenceiçin yeni yöntemler)ConcurrentHashMap(Android 5.0 için hata düzeltmeleriyle birlikte)
Android Gradle eklentisi 7.4.0 veya sonraki sürümlerde, java.nio.file paketinin bir alt kümesi gibi ek Java 11 API'leri desteklenir.
Desteklenen API'lerin tam listesi için Desugaring aracılığıyla kullanılabilen Java 8 ve sonraki sürümlerin API'leri ve Desugaring aracılığıyla kullanılabilen Java 11 ve sonraki sürümlerin API'leri başlıklı makaleleri inceleyin.
Eklenti, bu dil API'lerini desteklemek için eksik API'lerin bir uygulamasını içeren ayrı bir DEX dosyası derler ve bu dosyayı uygulamanıza ekler. Desugaring işlemi, uygulamanızın kodunu çalışma zamanında bu kitaplığı kullanacak şekilde yeniden yazar. Ayrı DEX dosyasına derlenen kaynak kodu, desugar_jdk_libs GitHub deposunda mevcuttur.
Android platformunun herhangi bir sürümünde bu dil API'leri için desteği etkinleştirmek üzere:
- Android Gradle eklentisini 4.0.0 (veya daha yeni bir sürüme) güncelleyin.
- Uygulama modülünüzün
build.gradleveyabuild.gradle.ktsdosyasına aşağıdakileri ekleyin:
Kotlin
android { defaultConfig { // Required when setting minSdkVersion to 20 or lower multiDexEnabled = true } compileOptions { // Flag to enable support for the new language APIs // For AGP 4.1+ isCoreLibraryDesugaringEnabled = true // For AGP 4.0 // coreLibraryDesugaringEnabled = true // Sets Java compatibility to Java 8 sourceCompatibility = JavaVersion.VERSION_1_8 targetCompatibility = JavaVersion.VERSION_1_8 } } dependencies { // For AGP 7.4+ coreLibraryDesugaring("com.android.tools:desugar_jdk_libs:2.0.3") // For AGP 7.3 // coreLibraryDesugaring("com.android.tools:desugar_jdk_libs:1.2.3") // For AGP 4.0 to 7.2 // coreLibraryDesugaring("com.android.tools:desugar_jdk_libs:1.1.9") }
Modern
android { defaultConfig { // Required when setting minSdkVersion to 20 or lower multiDexEnabled true } compileOptions { // Flag to enable support for the new language APIs coreLibraryDesugaringEnabled true // Sets Java compatibility to Java 8 sourceCompatibility JavaVersion.VERSION_1_8 targetCompatibility JavaVersion.VERSION_1_8 } } dependencies { // For AGP 7.4+ coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs:2.0.3' // For AGP 7.3 // coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs:1.2.3' // For AGP 4.0 to 7.2 // coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs:1.1.9' }
Ayrıca, aşağıdaki durumlarda önceki kod snippet'ini bir kitaplık modülünün build.gradle veya build.gradle.kts dosyasına eklemeniz gerekebileceğini unutmayın:
Kitaplık modülünün enstrümantasyon testleri bu dil API'lerini kullanır (doğrudan veya kitaplık modülü ya da bağımlılıkları aracılığıyla). Böylece, eksik API'ler, enstrümantasyon testi APK'nız için sağlanır.
Kitaplık modülünde lint'i tek başına çalıştırmak istiyorsunuz. Bu, lint'in dil API'lerinin geçerli kullanımlarını tanımasına ve yanlış uyarılar bildirmesini önlemesine yardımcı olur.
API desugaring işleminin küçültme ile birleştirilebileceğini ancak bunun yalnızca R8 küçültücü kullanılırken mümkün olduğunu unutmayın.
Sürümler
Aşağıdaki tabloda, Java 8+ API kitaplığının sürümleri ve her sürümü destekleyen minimum Android Gradle eklentisi sürümü gösterilmektedir:
| Sürüm | Minimum Android Gradle eklentisi sürümü |
|---|---|
| 1.1.9 | 4.0.0 |
| 1.2.3 | 7.3.0 |
| 2.0.3 | 7.4.0-alpha10 |
Java 8+ API kitaplığının sürümleri hakkında ayrıntılı bilgi için desugar_jdk_libs GitHub deposundaki CHANGELOG.md dosyasına bakın.