Java 8 dili özelliklerini ve API'lerini kullanın

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
Şekil 1. 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:

  1. Android Gradle eklentisini 3.0.0 veya sonraki bir sürüme güncelleyin.
  2. Java 8 dil özelliklerini kullanan her modül için (kaynak kodunda veya bağımlılıklar aracılığıyla) modülün build.gradle ya da build.gradle.kts dosyası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.time alt kümesi
  • java.util.function
  • java.util.{Map,Collection,Comparator} listesine son eklenenler
  • İsteğe bağlı öğeler (java.util.Optional, java.util.OptionalInt ve java.util.OptionalDouble) ve bazı yeni sınıflar
  • java.util.concurrent.atomic için bazı eklemeler (AtomicInteger, AtomicLong ve AtomicReference iç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:

  1. Android Gradle eklentisini 4.0.0 (veya daha yeni bir sürüme) güncelleyin.
  2. Uygulama modülünüzün build.gradle veya build.gradle.kts dosyası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.