Yaşam döngüsü

Yaşam döngüsüne duyarlı bileşenler, başka bir bileşenin (ör. etkinlikler ve parçalar) yaşam döngüsü durumundaki değişikliğe yanıt olarak işlem gerçekleştirir. Bu bileşenler, daha iyi organize edilmiş ve genellikle daha hafif, bakımı daha kolay kodlar üretmenize yardımcı olur.

Bu tabloda, androidx.lifecycle grubundaki tüm yapılar listelenir.

Yapı Kararlı Sürüm Sürüm Adayı Beta Sürümü Alfa Sürümü
lifecycle-* 2.11.1 - - 2.12.0-alpha06
lifecycle-viewmodel-navigation3 2.11.1 - - 2.12.0-alpha06
Bu kitaplık en son 18 Kasım 2026'da güncellenmiştir.

Bağımlılıkları bildirme

Lifecycle kitaplığına bağımlılık eklemek için projenize Google Maven deposunu eklemeniz gerekir. Daha fazla bilgi için Google'ın Maven deposu sayfasını okuyun.

Uygulamanız veya modülünüz için build.gradle dosyasında ihtiyacınız olan yapıların bağımlılıklarını ekleyin:

Kotlin

Groovy

    dependencies {
        def lifecycle_version = "2.11.0"
        def arch_version = "2.2.0"

        // ViewModel
        implementation "androidx.lifecycle:lifecycle-viewmodel-ktx:$lifecycle_version"
        // ViewModel utilities for Compose
        implementation "androidx.lifecycle:lifecycle-viewmodel-compose:$lifecycle_version"
        // LiveData
        implementation "androidx.lifecycle:lifecycle-livedata-ktx:$lifecycle_version"
        // Lifecycles only (without ViewModel or LiveData)
        implementation "androidx.lifecycle:lifecycle-runtime-ktx:$lifecycle_version"
        // Lifecycle utilities for Compose
        implementation "androidx.lifecycle:lifecycle-runtime-compose:$lifecycle_version"

        // Saved state module for ViewModel
        implementation "androidx.lifecycle:lifecycle-viewmodel-savedstate:$lifecycle_version"

        // ViewModel integration with Navigation3
        implementation "androidx.lifecycle:lifecycle-viewmodel-navigation3:2.12.0-alpha04"

        // Annotation processor
        kapt "androidx.lifecycle:lifecycle-compiler:$lifecycle_version"
        // alternately - if using Java8, use the following instead of lifecycle-compiler
        implementation "androidx.lifecycle:lifecycle-common-java8:$lifecycle_version"

        // optional - helpers for implementing LifecycleOwner in a Service
        implementation "androidx.lifecycle:lifecycle-service:$lifecycle_version"

        // optional - ProcessLifecycleOwner provides a lifecycle for the whole application process
        implementation "androidx.lifecycle:lifecycle-process:$lifecycle_version"

        // optional - ReactiveStreams support for LiveData
        implementation "androidx.lifecycle:lifecycle-reactivestreams-ktx:$lifecycle_version"

        // optional - Test helpers for LiveData
        testImplementation "androidx.arch.core:core-testing:$arch_version"

        // optional - Test helpers for Lifecycle runtime
        testImplementation "androidx.lifecycle:lifecycle-runtime-testing:$lifecycle_version"
    }
    

Kotlin

    dependencies {
        val lifecycle_version = "2.11.0"
        val arch_version = "2.2.0"

        // ViewModel
        implementation("androidx.lifecycle:lifecycle-viewmodel-ktx:$lifecycle_version")
        // ViewModel utilities for Compose
        implementation("androidx.lifecycle:lifecycle-viewmodel-compose:$lifecycle_version")
        // LiveData
        implementation("androidx.lifecycle:lifecycle-livedata-ktx:$lifecycle_version")
        // Lifecycles only (without ViewModel or LiveData)
        implementation("androidx.lifecycle:lifecycle-runtime-ktx:$lifecycle_version")
        // Lifecycle utilities for Compose
        implementation("androidx.lifecycle:lifecycle-runtime-compose:$lifecycle_version")

        // Saved state module for ViewModel
        implementation("androidx.lifecycle:lifecycle-viewmodel-savedstate:$lifecycle_version")

        // ViewModel integration with Navigation3
        implementation("androidx.lifecycle:lifecycle-viewmodel-navigation3:2.12.0-alpha04")

        // Annotation processor
        kapt("androidx.lifecycle:lifecycle-compiler:$lifecycle_version")
        // alternately - if using Java8, use the following instead of lifecycle-compiler
        implementation("androidx.lifecycle:lifecycle-common-java8:$lifecycle_version")

        // optional - helpers for implementing LifecycleOwner in a Service
        implementation("androidx.lifecycle:lifecycle-service:$lifecycle_version")

        // optional - ProcessLifecycleOwner provides a lifecycle for the whole application process
        implementation("androidx.lifecycle:lifecycle-process:$lifecycle_version")

        // optional - ReactiveStreams support for LiveData
        implementation("androidx.lifecycle:lifecycle-reactivestreams-ktx:$lifecycle_version")

        // optional - Test helpers for LiveData
        testImplementation("androidx.arch.core:core-testing:$arch_version")

        // optional - Test helpers for Lifecycle runtime
        testImplementation ("androidx.lifecycle:lifecycle-runtime-testing:$lifecycle_version")
    }
    

Java

Groovy

    dependencies {
        def lifecycle_version = "2.11.0"
        def arch_version = "2.2.0"

        // ViewModel
        implementation "androidx.lifecycle:lifecycle-viewmodel:$lifecycle_version"
        // LiveData
        implementation "androidx.lifecycle:lifecycle-livedata:$lifecycle_version"
        // Lifecycles only (without ViewModel or LiveData)
        implementation "androidx.lifecycle:lifecycle-runtime:$lifecycle_version"

        // Saved state module for ViewModel
        implementation "androidx.lifecycle:lifecycle-viewmodel-savedstate:$lifecycle_version"

        // Annotation processor
        annotationProcessor "androidx.lifecycle:lifecycle-compiler:$lifecycle_version"
        // alternately - if using Java8, use the following instead of lifecycle-compiler
        implementation "androidx.lifecycle:lifecycle-common-java8:$lifecycle_version"

        // optional - helpers for implementing LifecycleOwner in a Service
        implementation "androidx.lifecycle:lifecycle-service:$lifecycle_version"

        // optional - ProcessLifecycleOwner provides a lifecycle for the whole application process
        implementation "androidx.lifecycle:lifecycle-process:$lifecycle_version"

        // optional - ReactiveStreams support for LiveData
        implementation "androidx.lifecycle:lifecycle-reactivestreams:$lifecycle_version"

        // optional - Test helpers for LiveData
        testImplementation "androidx.arch.core:core-testing:$arch_version"

        // optional - Test helpers for Lifecycle runtime
        testImplementation "androidx.lifecycle:lifecycle-runtime-testing:$lifecycle_version"
    }
    

Kotlin

    dependencies {
        val lifecycle_version = "2.11.0"
        val arch_version = "2.2.0"

        // ViewModel
        implementation("androidx.lifecycle:lifecycle-viewmodel:$lifecycle_version")
        // LiveData
        implementation("androidx.lifecycle:lifecycle-livedata:$lifecycle_version")
        // Lifecycles only (without ViewModel or LiveData)
        implementation("androidx.lifecycle:lifecycle-runtime:$lifecycle_version")

        // Saved state module for ViewModel
        implementation("androidx.lifecycle:lifecycle-viewmodel-savedstate:$lifecycle_version")

        // Annotation processor
        annotationProcessor("androidx.lifecycle:lifecycle-compiler:$lifecycle_version")
        // alternately - if using Java8, use the following instead of lifecycle-compiler
        implementation("androidx.lifecycle:lifecycle-common-java8:$lifecycle_version")

        // optional - helpers for implementing LifecycleOwner in a Service
        implementation("androidx.lifecycle:lifecycle-service:$lifecycle_version")

        // optional - ProcessLifecycleOwner provides a lifecycle for the whole application process
        implementation("androidx.lifecycle:lifecycle-process:$lifecycle_version")

        // optional - ReactiveStreams support for LiveData
        implementation("androidx.lifecycle:lifecycle-reactivestreams:$lifecycle_version")

        // optional - Test helpers for LiveData
        testImplementation("androidx.arch.core:core-testing:$arch_version")

        // optional - Test helpers for Lifecycle runtime
        testImplementation("androidx.lifecycle:lifecycle-runtime-testing:$lifecycle_version")
    }
    

Bağımlılıklar hakkında daha fazla bilgi için Derleme Bağımlılıkları Ekleme başlıklı makaleyi inceleyin.

Geri bildirim

Geri bildirimleriniz Jetpack'i geliştirmemize yardımcı olur. Yeni sorunlar keşfederseniz veya bu kitaplığı iyileştirmek için fikirleriniz varsa bize bildirin. Yeni bir sorun oluşturmadan önce lütfen bu kitaplıktaki mevcut sorunlara göz atın. Yıldız düğmesini tıklayarak mevcut bir sorun için oy verebilirsiniz.

Yeni bir sorun oluşturma

Daha fazla bilgi için Issue Tracker belgelerine bakın.

Sürüm 2.12

Sürüm 2.12.0-alpha06

18 Kasım 2026

androidx.lifecycle:lifecycle-*:2.12.0-alpha06 yayınlandı. 2.12.0-alpha06 sürümü bu commit'leri içerir.

API Değişiklikleri

  • LocalLifecycleOwner öğesini compositionLocalWithHostDefaultOf ve LifecycleOwnerHostDefaultKey kullanacak şekilde taşıyın ve Android dışında görünüm ağacının bir parçası olarak doğrudan alınmasını engelleyin. (I7c265)

Hata Düzeltmeleri

  • Lifecycle 2.11.1 sürümünden itibaren: LifecycleRegistry sınıfının currentStateFlow özelliği, her seferinde yeni bir örnek oluşturmak yerine her çağrıda aynı örneği döndürür. (I1ae01, b/579057749)

Sürüm 2.12.0-alpha05

21 Ekim 2026

androidx.lifecycle:lifecycle-*:2.12.0-alpha05 yayınlandı. 2.12.0-alpha05 sürümü bu commit'leri içerir.

API Değişiklikleri

  • SavedStateHandle artık SavedStateContainer ile entegrasyon için işlevler sunuyor. SavedStateHandle öğesini SavedStateContainer olarak dönüştürmek için asContainer(), tutma yerinin içinde alt kapsayıcı oluşturmak için getOrCreateContainer() ve mevcut öğenin içinde alt SavedStateHandle oluşturmak için getOrCreateSavedStateHandle() var. SavedStateContainer sürümüne geçiş kapsamında, getStateFlow ve getLiveData özelliklerinin SavedStateHandle üzerinde birlikte kullanılması da artık geçerli değildir ve bu durumda IllegalArgumentException (I62f36) hatası verilir.

Sürüm 2.12.0-alpha04

23 Eylül 2026

androidx.lifecycle:lifecycle-*:2.12.0-alpha04 yayınlandı. 2.12.0-alpha04 sürümü bu kayıtları içerir.

Sürüm 2.12.0-alpha03

9 Eylül 2026

androidx.lifecycle:lifecycle-*:2.12.0-alpha03 yayınlandı. 2.12.0-alpha03 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • compileSdk için Compose kitaplıkları 37.1 sürümüne güncellendi. Bu, Compose kullanan tüm uygulamalar ve kitaplıklar için compileSdk sürümünün geçişli olarak güncellenmesini gerektirir. (I05b0f)

Sürüm 2.12.0-alpha02

26 Ağustos 2026

androidx.lifecycle:lifecycle-*:2.12.0-alpha02 yayınlandı. 2.12.0-alpha02 sürümü bu kayıtları içerir.

API Değişiklikleri

  • AutoRecreated ve runOnNextRecreation, SavedStateProvider ve SavedStateRestorer lehine kullanımdan kaldırıldı. (Iadc00)

Sürüm 2.12.0-alpha01

12 Ağustos 2026

androidx.lifecycle:lifecycle-*:2.12.0-alpha01 yayınlandı. 2.12.0-alpha01 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

  • lifecycle-compiler ek açıklama işleyicisi yapısını kullanımdan kaldırın. Lütfen ek açıklama işleyicisi yerine DefaultLifecycleObserver veya LifecycleEventObserver'e geçiş yapın. (Ibf571, b/541926513)
  • SavedStateViewModelFactory ve AbstractSavedStateViewModelFactory, sağlanan SavedStateRegistryOwner ViewModelStoreOwner'yi uygulamıyorsa hemen başarısız olur. Bu sayede, bileşen yeniden oluşturulurken gecikmeli kilitlenmeler önlenir. (Icf317)
  • LifecycleRegistry etkinlik gönderimlerine sistem izleme ekleyin. (Ie1f92, b/112161409)

Sürüm 2.11

Sürüm 2.11.1

18 Kasım 2026

androidx.lifecycle:lifecycle-*:2.11.1 yayınlandı. 2.11.1 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • LifecycleRegistry öğesinin currentStateFlow özelliği artık her seferinde yeni bir örnek oluşturmak yerine her çağrıda aynı örneği döndürüyor. (I1ae01, b/579057749)

Sürüm 2.11.0

17 Haziran 2026

androidx.lifecycle:lifecycle-*:2.11.0 yayınlandı. 2.11.0 sürümü bu commit'leri içerir.

2.10.0 sürümünden sonra yapılan önemli değişiklikler:

Compose'da kapsamlı ViewModel'ler: ViewModel'leri belirli kullanıcı arayüzü kapsamlarına (ör. sayfa gezgini sayfaları) bağlamak için ViewModelStoreProvider, rememberViewModelStoreProvider ve rememberViewModelStoreOwner'nın kullanıma sunulması. Bunlar, yapılandırma değişikliklerinden etkilenmez ve Composable, hiyerarşiden kaldırıldığında otomatik olarak temizlenir.

KMP desteği: ViewModel-Compose ve ViewModel-Navigation3 artık tüm Kotlin Multiplatform hedeflerini destekliyor.

Navigation3 Entegrasyonu: ViewModelStoreNavEntryDecorator artık CreationExtras ve fabrikaları iç içe yerleştirilmiş ViewModel'lere yaymak için bir ViewModelStoreOwner kabul ediyor. Birden fazla eski yığını desteklemek için yeni rememberViewModelStoreNavEntryDecorator aşırı yüklemesini kullanarak sağlayıcıları da yükseltebilirsiniz. removeViewModelStoreOnPop desteği sonlandırıldı.

Lifecycle Utilities: Somutlaştırılmış bir ViewModelProvider.get<VM>(key) uzantısı, lambda tabanlı bir Lifecycle.addObserver ve ViewModelStoreOwner için varsayılan fabrika uzantıları eklendi. ViewModel.onCleared artık @EmptySuper ile ek açıklamalı.

Diğer Değişiklikler: Compose kullanıcı arayüzü 1.7.0+, yansıma yedeklerini kaldırmak için artık LocalLifecycleOwner gerektiriyor. Compose compileSdk güncellemeleri için minimum AGP sürümü 9.2.0 olmalıdır.

Sürüm 2.11.0-rc01

3 Haziran 2026

androidx.lifecycle:lifecycle-*:2.11.0-rc01 yayınlandı. 2.11.0-rc01 sürümü bu commit'leri içerir.

Sürüm 2.11.0-beta02

19 Mayıs 2026

androidx.lifecycle:lifecycle-*:2.11.0-beta02 yayınlandı. 2.11.0-beta02 sürümü bu kayıtları içerir.

API Değişiklikleri

  • ViewModelStoreProvider kabul eden bir rememberViewModelStoreNavEntryDecorator aşırı yüklemesi ekleyin. Bu sayede geliştiriciler, sağlayıcıyı dekoratörün oluşturma kapsamının üzerine çıkarabilir. Böylece, aynı girişin her ikisinde de bulunduğu ancak ayrı durum gerektirdiği birden fazla eski yığını destekleme gibi kullanım alanları mümkün olur. (Ibbbfe, b/503420425)
  • Kardeş sağlayıcı, oluşturmadan kaldırıldığında paylaşılan ViewModels öğesinin erken temizlenmesini önleyin. (Ib321a)

Hata Düzeltmeleri

  • LocalLifecycleOwner özelliğini kullanmak için Compose UI 1.7.0 veya sonraki bir sürüm gerekir. Bu, dahili yansıma yedeklerini kaldırarak performansı artırır ancak istemciler için katı bir bağımlılık yükseltmesi zorunlu kılar. (I48e65)
  • Compose Multiplatform 1.11.0'a yükseltme yaparken eski JetBrains çatallama sürümlerinde sembollerin kopyalanmasını önleyin. (Iccd64)
  • Kararsız varsayılan parametrelerle rememberViewModelStoreProvider kullanılırken yeniden oluşturma sırasında ViewModels öğelerinin yanlışlıkla temizlenmesine neden olan sorun düzeltildi. Sağlayıcı artık yalnızca üst sahip veya açık anahtar değiştiğinde yeniden oluşturulur. (Ibe296, b/501792448)

Sürüm 2.11.0-beta01

22 Nisan 2026

androidx.lifecycle:lifecycle-*:2.11.0-beta01 yayınlandı. 2.11.0-beta01 sürümü bu commit'leri içerir.

API Değişiklikleri

  • rememberViewModelStoreOwner ve rememberViewModelStoreProvider işlevlerini, anahtarlı ve anahtarsız kullanım alanları için ayrı işlevlere bölün. (Ifd154, b/500802788)

Hata Düzeltmeleri

  • Compose compileSdk, API 37'ye güncellendi. Bu nedenle, Compose kullanılırken minimum AGP sürümü 9.2.0 olmalıdır. (Id45cd, b/413674743)

Sürüm 2.11.0-alpha03

25 Mart 2026

androidx.lifecycle:lifecycle-*:2.11.0-alpha03 yayınlandı. 2.11.0-alpha03 sürümü bu kayıtları içerir.

API Değişiklikleri

  • parentKey parametresini ViewModelStoreProvider oluşturucularında isteğe bağlı bir parametre yapın, varsayılan olarak null değerini atayın ve parentStore veya parentOwner parametresinden sonra taşıyın. Bu, paylaşılan bir kapsam anahtarı gerekmediğinde örneklendirmeyi basitleştirir. (I66b67)
  • ViewModelStoreNavEntryDecorator artık ViewModelStore yerine ViewModelStoreOwner kabul ediyor. Bu sayede Navigation3, üst öğenin varsayılan CreationExtras ve ViewModelProvider.Factory değerlerini iç içe yerleştirilmiş ViewModel'lere yayarak uygulama düzeyindeki bağımlılıklar için destek sağlar. (Ia6018, b/434651920)
  • Benzersiz bir anahtar kullanarak ViewModelStoreProvider durumunu izole edin. Bu sayede, kardeş sağlayıcıların imha sırasında birbirlerinin ViewModel'lerini yanlışlıkla temizlemesi önlenir. (I59c0b, b/434651920)
  • ViewModelProvider.get<VM>(key: String) uzantı işlevi ekleyin. Bu sayede geliştiriciler, Kotlin somutlaştırılmış tür parametreleriyle özel bir key kullanarak ViewModel'leri daha temiz bir şekilde alabilir ve sınıf türünü açıkça iletme ihtiyacını ortadan kaldırabilir. (Ic1f59)
  • ViewModel'lerin varsayılan SavedState değerleriyle başlatılmasına izin vermek için ViewModelStoreProvider'e defaultArgs desteği ekleyin. (I1e933, b/434651920, b/165642391)
  • removeViewModelStoreOnPop ve ilişkili ViewModelStoreNavEntryDecoratorDefaults desteğini sonlandırın. Bu API, artık dahili olarak işlenen yapılandırma değişiklikleri için geçici bir çözümdü. ViewModel'ler de dahil olmak üzere tüm dekoratör durumları artık pop sırasında aynı anda temizlenmelidir. Dekoratör durumunu, eski yığın bir NavDisplay'e iletildiğinde de korumak için rememberDecoratedNavEntries API'sini kullanın. (I852d9)

Hata Düzeltmeleri

  • Sınıf adını görüntülemek için CreationExtras.Key öğesine toString() ekleyin. (I5de52)

Sürüm 2.11.0-alpha02

11 Mart 2026

androidx.lifecycle:lifecycle-*:2.11.0-alpha02 yayınlandı. 2.11.0-alpha02 sürümü bu kayıtları içerir.

Kapsamlı ViewModel'ler

  • Bu sürümde, Compose'da kapsamlı ViewModelStore örnekleri oluşturmak için API'ler sunulmaktadır. Bu sayede ViewModels, belirli kullanıcı arayüzü kapsamlarına (ör. bağımsız Pager sayfaları veya LazyList öğeleri) bağlanabilir. Bu ViewModels, yapılandırma değişikliklerinden etkilenmez ve karşılık gelen Composable, hiyerarşiden kalıcı olarak kaldırıldığında otomatik olarak temizlenir.

    // Hoist the parent provider outside the Pager.
    val provider = rememberViewModelStoreProvider()
    val pagerState = rememberPagerState(pageCount = { 5 })
    
    HorizontalPager(state = pagerState) { page ->
        // Create an owner scoped to the current page.
        val storeOwner = rememberViewModelStoreOwner(provider, key = page)
    
        // Provide the scoped owner to this composition.
        CompositionLocalProvider(LocalViewModelStoreOwner provides storeOwner) {
            // ViewModel is now scoped specifically to this page.
            val viewModel: PageViewModel = viewModel()
        }
    }
    

ViewModelStoreProvider, Compose dışında kullanılabilir ve Etkinlikler, Parçalar ve/veya Görünümler ile kullanılabilir.

Yeni özellikler

  • ViewModel Navigation3'e tüm KMP hedefleri için destek ekleyin. (I60fa5)
  • Özel sahip bileşenleri oluştururken ortak kodları azaltmak için LifecycleOwner, ViewModelStoreOwner ve SavedStateRegistryOwner için fabrika işlevleri ekleyin. (I9682c)
  • Anonim bir nesneyi örneklendirmeden yaşam döngüsü olaylarının gözlemlenmesine olanak tanımak için lambda tabanlı bir Lifecycle.addObserver uzantı işlevi ekleyin. (I94f38)
  • ViewModelStoreOwner kampanyasına defaultViewModelProviderFactory ve defaultViewModelCreationExtras uzantıları ekleyin. Bunlar, HasDefaultViewModelProviderFactory için manuel tür kontrolleri gerektirmeden varsayılan değerlere güvenli erişim sağlar. (Ifa83d)

API Değişiklikleri

  • Compose'da kapsamlı ViewModelStoreOwner'leri kolayca oluşturmak için rememberViewModelStoreOwner ekleyin. Bu işlev, Composable'ın yaşam döngüsüne bağlı bir sahip döndürür ve Composable, kullanıcı arayüzünden kaldırıldığında ViewModel'lerini otomatik olarak temizler. (I2a15b, b/165642391)
  • Compose'da kapsamlı ViewModelStore örnekleri oluşturulmasına izin vermek için rememberViewModelStoreProvider ekleyin. Bu işlev, bir alt mağazayı üst sahiple ilişkilendirerek ViewModel'lerin yapılandırma değişikliklerinden etkilenmemesini sağlar ve Composable hiyerarşiden kaldırıldığında bunları otomatik olarak temizler. (I0f57a, b/165642391)
  • Kapsamlı ViewModelStore örneklerini yönetmek için ViewModelStoreProvider ekleyin. Bu sınıf, yapılandırma değişikliklerinden etkilenmeyen ancak bağımsız olarak temizlenebilen alt kapsamların oluşturulmasını sağlar. Ayrıca, üst öğeden varsayılan fabrikaları ve oluşturma ekstralarını devralan ViewModelStoreOwner sarmalayıcıları sağlar. (I87f4f, b/434651920)

Sürüm 2.11.0-alpha01

25 Şubat 2026

androidx.lifecycle:lifecycle-*:2.11.0-alpha01 yayınlandı. 2.11.0-alpha01 sürümü bu kayıtları içerir.

Yeni özellikler

  • ViewModel-Compose'da tüm Kotlin Multiplatform (KMP) hedeflerini destekleme Platform ana makinelerinin varsayılan bir ViewModelStoreOwner sağlamasına izin vermek ve Android'de güvenli bir yedek olarak LocalView'yi korumak için sahip çözümünü LocalView'den ayırın. (I09fab, b/434940570, Ic8526, b/478146897)

API Değişiklikleri

  • Hata ayıklamayı kolaylaştırmak için depolanan tüm anahtarları listeleyen bir toString uygulamasını ViewModelStore öğesine ekleyin. (I0a6f4)
  • HasDefaultViewModelProviderFactory.defaultViewModelProviderFactory için varsayılan bir uygulama ekleyin. Böylece, arayüzü uygularken bu özelliği açıkça geçersiz kılmanız gerekmez. (Ia7095)
  • Geçersiz kılma yöntemlerinin super.onCleared() yöntemini çağırması gerekmediğini açıkça belirtmek için ViewModel.onCleared yöntemine @EmptySuper ekleyin. (I8c226)

Sürüm 2.10

Sürüm 2.10.0

19 Kasım 2025

androidx.lifecycle:lifecycle-*:2.10.0 yayınlandı. 2.10.0 sürümü bu commit'leri içerir.

2.9.0 sürümünden sonra yapılan önemli değişiklikler:

  • Doğrudan kullanıcı arayüzünde kapsamlı yaşam döngüleri oluşturmayı etkinleştirmek için rememberLifecycleOwner composable'ı ekleyin. Bu, kendi yaşam döngülerini bağımsız olarak yönetmesi gereken bileşenler için kullanışlıdır. Örneğin, yalnızca mevcut sayfayı RESUMED yapmak isteyen bir HorizontalPager veya Navigation3 gibi kitaplıklar:

    @Composable
    fun MyComposable() {
        // This LifecycleOwner is automatically moved to DESTROYED when
        // it leaves composition and its maxLifecycle is the maximum of either
        // the maxLifecycle you set or the Lifecycle.State of the parentLifecycleOwner
        val lifecycleOwner = rememberLifecycleOwner(
            maxLifecycle = RESUMED,
            parentLifecycleOwner = LocalLifecycleOwner.current,
        )
        CompositionLocalProvider(LocalLifecycleOwner provides lifecycleOwner) {
            val childLifecycleOwner = LocalLifecycleOwner.current
        }
    }
    
  • lifecycle-viewmodel-navigation3 yapısı, Navigation3 için önceden oluşturulmuş bir entegrasyon sağlar. Bu sayede, rememberViewModelStoreNavEntryDecorator() API'yi kullanarak ViewModel örneklerinin kapsamını ayrı ekranlara ("girişler") ayarlayabilirsiniz:

    @Composable
    fun MyComposable() {
        NavDisplay(
            backStack = backStack,
            entryDecorators =
                listOf(
                    rememberSaveableStateHolderNavEntryDecorator(),
                    // Add this line to automatically scope ViewModels to each entry
                    rememberViewModelStoreNavEntryDecorator(),
                ),
            entryProvider = entryProvider {
                // Add your entries here
            }
        }
    }
    
  • CreationExtras için daha kullanışlı ve deyimsel bir Kotlin API'si sağlayan bir oluşturucu fabrika işlevi ekleyin.

    override val defaultViewModelCreationExtras: CreationExtras
        // Use the CreationExtras builder to add in a custom value to the default
        // CreationExtras in your Activity or Fragment
        get() = super.defaultViewModelCreationExtras + CreationExtras {
            this[CustomKey] = "customValue"
       }
    
  • SavedStateHandle.saved içinde null değer alabilen türler için yerel destek ekleyerek null değer alabilen özelliklerin kaydedilmesini ve geri yüklenmesini basitleştirir.

  • SavedStateHandle markayı @VisibleForTesting olarak işaretleyin.

  • minSdk, API 21'den API 23'e değiştirildi.

Sürüm 2.10.0-rc01

5 Kasım 2025

androidx.lifecycle:lifecycle-*:2.10.0-rc01 yayınlandı. 2.10.0-rc01 sürümü bu commit'leri içerir.

Sürüm 2.10.0-beta01

22 Ekim 2025

androidx.lifecycle:lifecycle-*:2.10.0-beta01 yayınlandı. 2.10.0-beta01 sürümü bu commit'leri içerir.

API Değişiklikleri

  • ViewModelStoreNavEntryDecoratorDefault, ViewModelStoreNavEntryDecoratorDefaults olarak yeniden adlandırıldı. (I6d27b, b/444447434)

Hata Düzeltmeleri

  • Sahip, Lifeycle.State.CREATED durumuna geçmeden önce bir Lifecycle.Event.ON_DESTROY etkinliği alırsa rememberLifecycleOwner artık kilitlenmez. (I6f98e, b/444594991)

Sürüm 2.10.0-alpha05

8 Ekim 2025

androidx.lifecycle:lifecycle-*:2.10.0-alpha05 yayınlandı. 2.10.0-alpha05 sürümü bu kayıtları içerir.

API Değişiklikleri

  • removeViewModelStoreOnPopCallback() artık diğer platformların ve uygulamaların varsayılanı çağırabileceği bir ViewModelStoreNavEntryDecoratorDefault nesnesinin parçasıdır. (Ia1f23, b/444447434)
  • ViewModelStoreNavEntryDecorator, NavEntryDecorator için bir fabrika olarak işlevini daha iyi yansıtmak amacıyla bir işlevden sınıfa yeniden düzenlendi ve dekoratörün shouldRemoveViewModelStore parametresi, bu geri çağırmanın yalnızca backStack'ten bir giriş çıkarıldığında çağrıldığını netleştirmek için removeViewModelStoreOnPop olarak yeniden adlandırıldı. (Iefdc5, b/444447434)

Sürüm 2.10.0-alpha04

24 Eylül 2025

androidx.lifecycle:lifecycle-*:2.10.0-alpha04 yayınlandı. 2.10.0-alpha04 sürümü bu kayıtları içerir.

API Değişiklikleri

  • LifecycleOwner composable'ını rememberLifecycleOwner olarak yeniden düzenleyin. İşlev artık doğrudan LifecycleOwner değerini döndürür. Bu sahibi bir alt oluşturmaya sağlamak için CompositionLocalProvider kullanın. (Ic57f0, b/444446629)
  • JetBrains'in bu hedefleri karşılayan ve dolayısıyla CMP'yi destekleyen çatallar sunabilmesi için lifecycle-viewmodel-navigation3'e KMP taslakları ekleyin. (I44a4c)

Sürüm 2.10.0-alpha03

27 Ağustos 2025

androidx.lifecycle:lifecycle-*:2.10.0-alpha03 yayınlandı. 2.10.0-alpha03 sürümü bu commit'leri içerir.

API Değişiklikleri

  • Compose'u 1.9.0 sürümüne güncelleyin. (I2b9de)

Sürüm 2.10.0-alpha02

13 Ağustos 2025

androidx.lifecycle:lifecycle-*:2.10.0-alpha02 yayınlandı. 2.10.0-alpha02 sürümü bu commit'leri içerir.

Yeni özellikler

  • LifecycleOwner composable'ı artık bağımsız bir kök yaşam döngüsü oluşturabilir. parent = null açıkça ayarlandığında yeni yaşam döngüsü, herhangi bir ana makineden (ör. Activity, Fragment veya NavBackStackEntry) bağımsız olarak çalışır. Composable, oluşturmaya girer girmez başlar ve oluşturmadan çıktığında otomatik olarak kaldırılır. (I8dfbe, b/433659048)

    @Composable
    fun IndependentComponent() {
        // Create a standalone lifecycle, not tied to the parent Activity/Fragment.
        LifecycleOwner(parent = null) {
            val rootLifecycle = LocalLifecycleOwner.current.lifecycle
        }
    }
    

API Değişiklikleri

  • LifecycleOwner composable'ında parentLifecycleOwner parametresi parent olarak yeniden adlandırıldı. (I080bc)

Hata Düzeltmeleri

  • LifecycleOwner composable'ı artık imha edildiğinde yaşam döngüsünü doğru şekilde DESTROYED durumuna taşıyor. Bu sayede, yaşam döngüsüne referans veren harici kodlarda olası sızıntılar önlenir. (I9e5b7, b/433659048)
  • Varsayılan minSdk, API 21'den API 23'e taşındı (Ibdfca, b/380448311, b/435705964, b/435705223)

Harici Katkı

  • LifecycleOwner sınıfındaki gereksiz dahili destek alanlarını kaldırın. Katkılarından dolayı Jake Wharton'a teşekkür ederiz. (Ideddb)

Sürüm 2.10.0-alpha01

30 Temmuz 2025

androidx.lifecycle:lifecycle-*:2.10.0-alpha01 yayınlandı. 2.10.0-alpha01 sürümü bu kayıtları içerir.

Yeni özellikler

  • Doğrudan kullanıcı arayüzünde kapsamlı yaşam döngüleri oluşturmayı etkinleştirmek için LifecycleOwner composable'ı ekleyin. Bu, kendi yaşam döngülerini bağımsız olarak yönetmesi gereken bileşenler için kullanışlıdır. Navigation3'ün bu yeni composable'ı nasıl entegre ettiğine dair bir örnek için aosp/3708610 adresini inceleyin. (76cbf7)

    @Composable
    fun MyComposable() {
        LifecycleOwner(
            maxLifecycle = RESUMED,
            parentLifecycleOwner = LocalLifecycleOwner.current,
        ) {
            val childLifecycleOwner = LocalLifecycleOwner.current
        }
    }
    

API Değişiklikleri

  • CreationExtras için daha kullanışlı ve deyimsel bir Kotlin API'si sağlayan bir oluşturucu fabrika işlevi ekleyin. (Iab2bd)
  • SavedStateHandle.saved içinde null değer alabilen türler için yerel destek ekleyerek null değer alabilen özelliklerin kaydedilmesini ve geri yüklenmesini basitleştirir. (I54d69, b/421325690)
  • SavedStateHandle markayı @VisibleForTesting olarak işaretleyin. (Iff0e0, b/408002794)

Sürüm 2.9

Sürüm 2.9.4

17 Eylül 2025

androidx.lifecycle:lifecycle-*:2.9.4 yayınlandı. 2.9.4 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Lifecycle KMP yapılarının bozulmasına neden olan, Compose derleyici eklentisinin uygulanmamasıyla ilgili bir hata düzeltildi. (Ie95bc, b/443096483, b/443965665)

Sürüm 2.9.3

27 Ağustos 2025

androidx.lifecycle:lifecycle-*:2.9.3 yayınlandı. 2.9.3 sürümü bu commit'leri içerir.

Yeni özellikler

  • Lifecycle *-compose yapılarına yeni Kotlin Multiplatform (KMP) hedefleri ekleyin. Lifecycle artık şu platformları destekliyor: JVM (Android ve Masaüstü), Yerel (Linux, iOS, watchOS, macOS, MinGW) ve Web (JavaScript, WasmJS). (I0a0e4)

Hata Düzeltmeleri

Sürüm 2.9.2

16 Temmuz 2025

androidx.lifecycle:lifecycle-*:2.9.2 yayınlandı. 2.9.2 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Yaşam döngüsü yapılarına yeni Kotlin Çoklu Platform (KMP) hedefleri eklendi. Lifecycle artık şu platformları destekliyor: JVM (Android ve Masaüstü), Yerel (Linux, iOS, watchOS, macOS, MinGW) ve Web (JavaScript, WasmJS). *-compose yapılarına yeni KMP hedefleri eklenmedi. Bu, Compose 1.9'un kararlı sürümüne bağlıdır. (I01cb8).

Bağımlılık güncellemeleri

Sürüm 2.9.1

4 Haziran 2025

androidx.lifecycle:lifecycle-*:2.9.1 yayınlandı. 2.9.1 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • SavedStateHandle.remove(key)'in SavedStateHandle.getMutableStateFlow(key) durumlarını temizlememesi sorunu düzeltildi. (d5f939, b/418746333)

Sürüm 2.9.0

7 Mayıs 2025

androidx.lifecycle:lifecycle-*:2.9.0 yayınlandı. 2.9.0 sürümü bu commit'leri içerir.

2.8.0 sürümünden sonra yapılan önemli değişiklikler

  • ViewModels'i tek başına test etmek için ViewModelScenario sınıfı sağlayan yeni bir androidx.lifecycle:lifecycle-viewmodel-testing KMP yapısı kullanıma sunuldu. Bu yapı, onCleared ve SavedStateHandle'yı desteklemenin yanı sıra recreate() aracılığıyla işlem sonlandırma ve yeniden oluşturma testlerini de destekler.
  • MutableStateFlow döndürmek için SavedStateHandle öğesine getMutableStateFlow ekleyin. Bu yeni işlev anahtara özeldir ve getLiveData ile kullanılamaz. Aynı duruma erişmek için her ikisini de kullanmaya çalışırsanız bir istisna oluşturulur.
  • CreationExtras artık Kotlin'de içeriğin deyimsel olarak değiştirilmesini sağlayan harita benzeri operatör aşırı yüklemeleri içeriyor. CreationExtras ile in, += ve +'nin kullanılmasına olanak tanır.

KotlinX Serileştirme Desteği

  • SavedState 1.3.0'e eklenen KotlinX Serialization desteğiyle, @Serializable sınıflarını SavedStateHandle içinde depolamayı ve bu sınıfların işlem sonlandırma ve yeniden oluşturma sırasında otomatik olarak geri yüklenmesini kolaylaştırmak için geç yüklenen bir özellik temsilcisi olan saved'i kullanıma sunduk. saved temsilcisinin geç yüklenen bir temsilci olduğunu ve erişilene kadar init lambda'yı çağırmayacağını veya SavedStateHandle içine hiçbir şey kaydetmeyeceğini unutmayın.

    @Serializable
    data class Person(val firstName: String, val lastName: String)
    
    class MyViewModel(handle: SavedStateHandle) : ViewModel() {
        var person by handle.saved { Person("John", "Doe") }
    
        fun onPersonChanged(person: Person) {
            this.person = person
        }
    }
    

Kotlin Multiplatform

  • lifecycle-testing modülü artık TestLifecycleOwner gibi API'ler de dahil olmak üzere KMP ile uyumludur.
  • lifecycle-viewmodel-savedstate modülü artık SavedStateHandle gibi API'ler de dahil olmak üzere KMP ile uyumludur.
  • androidx.compose.ui.platform.LocalLifecycleOwner artık ortak kaynak grubunda kullanılabilir.
  • NewInstanceFactory artık JVM masaüstü ve Android hedeflerinde kullanılabilir.

Davranış Değişiklikleri

  • Lifecycle.DESTROYED durumu nihai bir durumdur ve Lifecycle öğesini bu durumdan başka bir duruma taşıma girişimi IllegalStateException ile sonuçlanır.
  • SavedStateHandle artık döndürülen Bundle değerinin boş olduğu SavedStateProvider.saveState() değerlerini içermiyor.

Sürüm 2.9.0-rc01

23 Nisan 2025

androidx.lifecycle:lifecycle-*:2.9.0-rc01 yayınlandı. 2.9.0-rc01 sürümü bu commit'leri içerir.

Lint API Uyumluluk Uyarısı

  • JetBrains, KaCallableMemberCall öğesini sınıftan arayüze dönüştürdü. Bu da ikili uyumluluğu bozuyor. Projenizin AGP sürümü, lint kontrollerini derlemek için kullanılan sürümden farklıysa bu durum kilitlenmelere neden olabilir. Bu güncelleme aosp/3577172'de yapıldı ancak sürüm notlarında yer almadı. Bu nedenle burada açıklıyoruz. Önerilen düzeltme: En son kararlı AGP sürümüne güncelleyin. Tamamen güncelleyemiyorsanız lint kontrollerini AGP sürümünüzle uyumlu hale getirmek için android.experimental.lint.version kullanın. Ayrıntılar için Compose çalışma zamanı davranış değişiklikleri başlıklı makaleyi inceleyin.

Sürüm 2.9.0-beta01

9 Nisan 2025

androidx.lifecycle:lifecycle-*:2.9.0-beta01 yayınlandı. 2.9.0-beta01 sürümü bu commit'leri içerir.

API Değişiklikleri

  • Lifecycle ViewModel Compose artık Compose Runtime 1.7.1 ve sonraki sürümlerle aynı Kotlin Çoklu Platform kurulumunu kullanıyor. -desktop yapıları kaldırıldı, -jvmStubs ve -linuxx64Stubs yapıları eklendi. Bu hedeflerin hiçbiri kullanılmak üzere tasarlanmamıştır. Jetbrains Compose çalışmalarına yardımcı olmak için yer tutucu olarak eklenmiştir. (I5cb14, b/406592090)

Bağımlılık Güncellemeleri

  • Bu kitaplık artık Kotlin 2.0 dil düzeyini hedefliyor ve KGP 2.0.0 veya daha yeni bir sürümü gerektiriyor. (Idb6b5)
  • Lifecycle ViewModel Compose artık Compose 1.7.8'e bağlıdır. (I5cb14, b/406592090)

Sürüm 2.9.0-alpha13

26 Mart 2025

androidx.lifecycle:lifecycle-*:2.9.0-alpha13, herkese açık önemli bir değişiklik olmadan yayınlandı. 2.9.0-alpha13 sürümü bu commit'leri içerir.

Sürüm 2.9.0-alpha12

12 Mart 2025

androidx.lifecycle:lifecycle-*:2.9.0-alpha12 yayınlandı. 2.9.0-alpha12 sürümü bu kayıtları içerir.

API Değişiklikleri

  • Desteklenen tüm KMP platformlarında ViewModelProvider.get öğesine @MainThread ek açıklamasını ekleyin. (I7e8dd, b/397736115)
  • SavedState*Delegates dosyasını SavedState*Delegate olarak yeniden adlandırın. (I8589b, b/399629301)

Sürüm 2.9.0-alpha11

26 Şubat 2025

androidx.lifecycle:lifecycle-*:2.9.0-alpha11 yayınlandı. 2.9.0-alpha11 sürümü bu kayıtları içerir.

API Değişiklikleri

  • saved() temsilcilerine SavedStateConfig parametresi ekleyin (I39b3a)

Sürüm 2.9.0-alpha10

12 Şubat 2025

androidx.lifecycle:lifecycle-*:2.9.0-alpha10 yayınlandı. 2.9.0-alpha10 sürümü bu commit'leri içerir.

API Değişiklikleri

  • MutableStateSerializer, lifecycle-viewmodel-compose konumundan savedstate-compose konumuna taşınacak. (I4f690, b/378895074)

Harici Katkı

  • Oluşturma sırasında Lifecycle::currentState çağrısı için yeni bir Lint sorunu ekler. Bunun yerine, Lifecycle durumundaki değişikliklerin yeniden oluşturmaya doğru şekilde neden olmasını sağlamak için currentStateAsalue().value kullanmanızı önerir. Teşekkürler Steven Schoen. (Iad484)

Sürüm 2.9.0-alpha09

29 Ocak 2025

androidx.lifecycle:lifecycle-*:2.9.0-alpha09 yayınlandı. 2.9.0-alpha09 sürümü bu kayıtları içerir.

Yeni özellikler

  • androidx.compose.runtime.MutableState öğesini serileştirmek için MutableStateSerializer ekleyin. (Idfc48, b/378895074)

API Değişiklikleri

  • Aşırı yüklenmiş SavedStateHandle.saved() temsilci işlevlerini varsayılan parametrelerle değiştirme (Icd1c1)
  • AbstractSavedStateViewModelFactory, her ViewModel için bir SavedStateHandle oluşturarak gereksiz ek yük oluşturduğundan desteği sonlandırıldı. Daha verimli ViewModel oluşturma için CreationExtras.createSavedStateHandle ile ViewModelProvider.Factory kullanın. (Ia920b, b/388590327)

Sürüm 2.9.0-alpha08

11 Aralık 2024

androidx.lifecycle:lifecycle-*:2.9.0-alpha08 yayınlandı. 2.9.0-alpha08 sürümü bu kayıtları içerir.

Yeni özellikler

  • Test edilen ViewModel ve tüm ilişkili bileşenleri yeniden oluşturan bir sistem işlemi sonlandırmayı simüle etmek için ViewModelScenario.recreate ekleyin. (Id6a69, b/381063087)
  • İlgili findViewTree API'leri aracılığıyla alınan LifecycleOwner ve ViewModelStoreOwner örnekleri artık bir görünümün ayrık üst öğeleri (ör. ViewOverlay) aracılığıyla çözümlenebilir. Ayrık görünüm üst öğeleri hakkında daha fazla bilgi için çekirdeğin sürüm notlarına veya ViewTree.setViewTreeDisjointParent adresindeki belgelere bakın. (I800f4)

API Değişiklikleri

  • Adlandırmaları ve paket organizasyonunu SavedStateRegistryOwnerDelegate ile daha tutarlı hale getirin (I8c135, b/376026744)

Hata Düzeltmeleri

  • Bu kitaplık artık tür kullanımı olan JSpecify boşluk ek açıklamalarını kullanıyor. Kotlin geliştiricileri, doğru kullanımı zorunlu kılmak için şu derleyici bağımsız değişkenini kullanmalıdır: -Xjspecify-annotations=strict (Kotlin derleyicisinin 2.1.0 sürümünden itibaren varsayılan olarak bu kullanılır). (Ie4340, b/326456246)
  • ViewModel.onCleared numaralı belge için denkleştirme sırası. (I586c7, b/363984116)

Sürüm 2.9.0-alpha07

13 Kasım 2024

androidx.lifecycle:lifecycle-*:2.9.0-alpha07 yayınlandı. 2.9.0-alpha07 sürümü bu kayıtları içerir.

Kotlin Multiplatform Uyumluluğu

  • Lifecycle ViewModel SavedState artık KMP ile uyumludur. Bu sayede, ortak kodda SavedStateHandle kullanabilirsiniz. (Ib6394, b/334076622)

KotlinX Serileştirme Desteği

  • SavedState 1.3.0-alpha05'e eklenen KotlinX Serialization desteğiyle, @Serializable sınıflarını SavedStateHandle içinde depolamayı ve bu sınıfların işlem sonlandırma ve yeniden oluşturma sırasında otomatik olarak geri yüklenmesini kolaylaştırmak için geç yüklenen bir özellik temsilcisi olan saved'i kullanıma sunduk. saved temsilcisinin geç yüklenen bir temsilci olduğunu ve erişilene kadar init lambda'yı çağırmayacağını veya SavedStateHandle içine hiçbir şey kaydetmeyeceğini unutmayın. (I47a88, b/376026744)

    @Serializable
    data class Person(val firstName: String, val lastName: String)
    
    class MyViewModel(handle: SavedStateHandle) : ViewModel() {
        var person by handle.saved { Person("John", "Doe") }
    
        fun onPersonChanged(person: Person) {
            this.person = person
        }
    }
    

API Değişiklikleri

  • MutableStateFlow döndürmek için SavedStateHandle öğesine getMutableStateFlow ekleyin. Bu yeni işlev anahtara özeldir ve getLiveData ile kullanılamaz. Aynı duruma erişmek için her ikisini de kullanmaya çalışırsanız bir istisna oluşturulur. (I04a4f, b/375408415)

Sürüm 2.9.0-alpha06

30 Ekim 2024

androidx.lifecycle:lifecycle-*:2.9.0-alpha06 yayınlandı. 2.9.0-alpha06 sürümü bu kayıtları içerir.

Davranış Değişiklikleri

  • Lifecycle.DESTROYED durumu nihai bir durumdur ve Lifecycle öğesini bu durumdan başka bir duruma taşıma girişimi IllegalStateException ile sonuçlanır. (I116c4, b/370577987)
  • SavedStateHandle artık döndürülen Bundle değerinin boş olduğu SavedStateProvider.saveState() değerlerini içermiyor. (I910b5, b/370577987)

Hata Düzeltmeleri

  • Lifecycle.eventFlow, Lifecycle DESTROYED olduğunda artık doğru şekilde tamamlanıyor (I293b2, b/374043130)

Sürüm 2.9.0-alpha05

16 Ekim 2024

androidx.lifecycle:lifecycle-*:2.9.0-alpha05, önemli bir değişiklik olmadan yayınlandı. 2.9.0-alpha05 sürümü bu kayıtları içerir.

Sürüm 2.9.0-alpha04

2 Ekim 2024

androidx.lifecycle:lifecycle-*:2.9.0-alpha04 yayınlandı. 2.9.0-alpha04 sürümü bu commit'leri içerir.

Kotlin Multiplatform

  • lifecycle-viewmodel-savedstate modülü, gelecekteki bir sürümde ortak kaynak grubunda SavedStateHandle gibi API'lerin kullanıma sunulmasına hazırlık olarak KMP ile uyumlu olacak şekilde yapılandırıldı. (I503ed, I48764, b/334076622)

Sürüm 2.9.0-alpha03

18 Eylül 2024

androidx.lifecycle:lifecycle-*:2.9.0-alpha03 yayınlandı. 2.9.0-alpha03 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

Bağımlılık Güncellemeleri

Sürüm 2.9.0-alpha02

4 Eylül 2024

androidx.lifecycle:lifecycle-*:2.9.0-alpha02 yayınlandı. 2.9.0-alpha02 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

Harici Katkı

  • androidx.compose.ui.platform.LocalLifecycleOwner, ortak kaynak grubuna (KMP) taşınacak. Katkılarından dolayı JetBrains'den Ivan Matkov'a teşekkür ederiz. (8cd5d03)
  • Yaşam döngüsü 2.8.5: SavedStateHandle.saveable` uzantı temsilcisi artık null değer alabilen değerleri destekliyor. Katkılarından dolayı Roman Kalukiewicz'e teşekkür ederiz. (0d78ea6)

Sürüm 2.9.0-alpha01

7 Ağustos 2024

androidx.lifecycle:lifecycle-*:2.9.0-alpha01 yayınlandı. 2.9.0-alpha01 sürümü bu kayıtları içerir.

Kotlin Multiplatform

  • lifecycle-testing artık KMP ile uyumludur. (Iea41e)
  • linuxArm64 Kotlin çoklu platform hedefi için destek eklendi (I139d3, b/338268719)

Yeni özellikler

  • onCleared (tüm platformlar) ve SavedStateHandle (yalnızca Android) desteğiyle ViewModel'leri ayrı ayrı test etmek için ViewModelScenario sınıfı sağlayan yeni bir androidx.lifecycle:lifecycle-viewmodel-testing KMP yapısı kullanıma sunuldu. (337f68d, c9b3409, 9799a95c, b/264602919)
  • ViewModelProvider ile ViewModel oluşturma işlemi artık iş parçacığı açısından güvenlidir. @MainThread ek açıklamaları kaldırıldı. (Ifd978, b/237006831)

API Değişiklikleri

  • Anonim CreationExtras.Key nesnelerinin oluşturulmasını basitleştirmek için CreationExtras.Key() fabrika işlevini ekleyin. (I970ee)
  • CreationExtras artık Kotlin'de içeriğin deyimsel olarak değiştirilmesini sağlayan harita benzeri operatör aşırı yüklemeleri içeriyor. CreationExtras ile in, += ve +'nin kullanılmasına olanak tanır. (Ib4353)
  • CreationExtras artık equals, hashCode ve toString yöntemlerini uyguluyor. (Ib4353)
  • NewInstanceFactory artık JVM masaüstü ve Android hedeflerinde kullanılabilir. (d3d0892)
  • Kotlin dili sürüm 2.0'da temel uygulamayı güvenli bir şekilde göstermek için satır içi uzantı özelliği (I39df2)

Hata Düzeltmeleri

  • AGP 7.3 veya sonraki sürümlerle (ör. R8 sürüm 3.3) R8 kullanıldığında ve AGP 8.1 veya sonraki sürümlerle (ör. D8 sürüm 8.1) tüm derlemeler için API modelleme aracılığıyla otomatik olarak gerçekleştiğinden, yeni platform API'lerine erişimin manuel olarak özetlenmesi kaldırıldı. AGP kullanmayan müşterilerin D8'i 8.1 veya sonraki bir sürüme güncellemesi önerilir. Daha fazla bilgi için bu makaleye göz atın. (If6b4c, b/345472586)

Sürüm 2.8

Sürüm 2.8.7

30 Ekim 2024

androidx.lifecycle:lifecycle-*:2.8.7 yayınlandı. 2.8.7 sürümü bu commit'leri içerir.

API Değişiklikleri

  • androidx.compose.ui.platform.LocalLifecycleOwner artık ortak kaynak grubunda (KMP) kullanılabilir. (6a3f5b3)
  • lifecycle-runtime-compose: desktop yapı kaldırıldı, -jvmStubs ve -linuxx64Stubs yapı eklendi. Bu hedeflerin hiçbiri kullanılmak üzere tasarlanmamıştır. Jetbrains Compose çalışmalarına yardımcı olmak için yer tutucu olarak eklenmiştir. (6a3f5b3)

Sürüm 2.8.6

18 Eylül 2024

androidx.lifecycle:lifecycle-*:2.8.6 yayınlandı. 2.8.6 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • NullSafeMutableLiveData Lint hatası, akıllı yayınlar için daha iyi destek sunarak yanlış pozitifleri önler. (85fed6, b/181042665)

Bağımlılık Güncellemeleri

Sürüm 2.8.5

4 Eylül 2024

androidx.lifecycle:lifecycle-*:2.8.5 yayınlandı. 2.8.5 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Kod karartmaya izin vermek için androidx.lifecycle.ReportFragment ProGuard kurallarını güncelleyin . (ff898e1)

Harici Katkı

  • SavedStateHandle.saveable uzantı temsilcisi artık null değer alabilen değerleri destekliyor. Katkılarından dolayı Roman Kalukiewicz'e teşekkür ederiz. (0d78ea6)

Sürüm 2.8.4

24 Temmuz 2024

androidx.lifecycle:lifecycle-*:2.8.4 yayınlandı. 2.8.4 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • LiveData.asFlow(), döndürülen akışın LiveData üzerinde ayarlanmış bir değer aldıktan hemen sonra tamamlandığı durumları (ör. take(1) kullanılırken) artık doğru şekilde işliyor. (I9c566)
  • Lifecycle*Effect tamamlanması artık idempotenttir (ör. onStopOrDispose, Lifecycle durdurulduğu için çağrıldıysa Lifecycle tekrar STARTED değerine dönmediği sürece imha sırasında ikinci kez çağrılmaz). (I5f607, b/352364595)

Sürüm 2.8.3

1 Temmuz 2024

androidx.lifecycle:lifecycle-*:2.8.3 yayınlandı. 2.8.3 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Kod daraltma kullanılırken Lifecycle 2.8'in Compose 1.6.0 ve önceki sürümlerle geriye dönük uyumluluğuyla ilgili bir sorun düzeltildi. (aosp/3133056, b/346808608)

Sürüm 2.8.2

12 Haziran 2024

androidx.lifecycle:lifecycle-*:2.8.2 yayınlandı. 2.8.2 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Lifecycle 2.8.X, Compose 1.6.X veya önceki sürümlerle kullanıldığında ortaya çıkan CompositionLocal LocalLifecycleOwner not present hataları düzeltildi. Artık Lifecycle 2.8.2'yi herhangi bir geçici çözüm olmadan Compose'un tüm sürümleriyle kullanabilirsiniz. (aosp/3105647, b/336842920)
  • ViewModelProvider, compileOnly Lifecycle bağımlılıklarının önceki sürümleri 2.8 ve sonraki sürümlerle karıştırıldığında artık kilitlenmeyecek. Böylece LeakCanary gibi kitaplıklarla ilgili sorunlar düzeltilecek. (I80383, b/341792251)

Sürüm 2.8.1

29 Mayıs 2024

androidx.lifecycle:lifecycle-*:2.8.1 yayınlandı. 2.8.1 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • lifecycle-viewmodel-compose artık yalnızca compose-runtime ile ortak bir bağımlılığa sahip. compose-ui ile ortak bağımlılığı kaldırıldı. Android yapısı, uyumluluk için compose-ui değerini korur. (aosp/3079334, b/339562627)
  • ViewModel'ın özellik temsilcilerini kullanan saveable entegrasyonu, artık otomatik olarak üretilmiş anahtarın bir parçası olarak sınıf adını kullanıyor. Bu sayede, birden fazla sınıf aynı SavedStateHandle değerini kullanıyorsa çakışmalar önleniyor. (aosp/3063463)

Sürüm 2.8.0

14 Mayıs 2024

androidx.lifecycle:lifecycle-*:2.8.0 yayınlandı. 2.8.0 sürümü bu commit'leri içerir.

2.7.0 sürümünden sonra yapılan önemli değişiklikler

  • LocalLifecycleOwner, Compose tabanlı yardımcı API'lerinin Compose kullanıcı arayüzü dışında kullanılabilmesi için Compose kullanıcı arayüzünden lifecycle-runtime-compose konumuna taşındı.
  • lifecycle-runtime-compose yapısı artık dropUnlessResumed ve dropUnlessStarted API'lerini içeriyor. Bu API'ler, LifecycleOwner belirli bir Lifecycle.State değerinin altına düştükten sonra bile gerçekleşen tıklama veya diğer etkinlikleri bırakmanıza olanak tanır. Örneğin, başka bir ekrana geçiş başladıktan sonra tıklama etkinliklerinin işlenmesini önlemek için bu özellik Navigation Compose ile kullanılabilir: onClick: () -> Unit = dropUnlessResumed { navController.navigate(NEW_SCREEN) }
  • ViewModel.viewModelScope artık geçersiz kılınabilir bir oluşturucu parametresidir. Bu sayede kendi dağıtıcınızı ve SupervisorJob() öğenizi ekleyebilir veya runTest içinde bulunan backgroundScope öğesini kullanarak varsayılanı geçersiz kılabilirsiniz. (I2817c, b/264598574)

    class MyViewModel(
      // Make Dispatchers.Main the default, rather than Dispatchers.Main.immediate
      viewModelScope: CoroutineScope = Dispatchers.Main + SupervisorJob()
    ) : ViewModel(viewModelScope) {
      // Use viewModelScope as before, without any code changes
    }
    
    // Allows overriding the viewModelScope in a test
    fun Test() = runTest {
      val viewModel = MyViewModel(backgroundScope)
    }
    
  • ViewModel, Kotlin'de yeniden yazıldı ve artık Closeable yerine AutoClosable kullanıyor. Artık getCloseable() aracılığıyla alınmalarına olanak tanıyan key ile AutoCloseable nesneleri eklemeyi destekliyor.

  • LifecycleStartEffect ve LifecycleResumeEffect anahtar olmadan çağrıldığında artık hata veriyor. Bu API'lerin yansıttığı DisposableEffect API'si de aynı kuralı uyguluyor.

  • LiveDataReactiveStreams.toPublisher(lifecycleOwner, liveData), LiveData.toPublisher(lifecycleOwner) lehine kullanımdan kaldırıldı.

  • lifecycle-livedata-core-ktx Kotlin uzantıları lifecycle-livedata-core modülüne taşındı.

  • NullSafeMutableLiveData, çok sayıda yanlış pozitif sonucu önlemek için yeniden düzenlendi.

Lifecycle Kotlin Çoklu Platform Uyumluluğu

Lifecycle, LifecycleOwner, LifecycleObserver, Lifecycle.State, Lifecycle.Event ve LifecycleRegistry'teki temel Lifecycle API'leri artık Kotlin Multiplatform ile uyumlu yapıtlarda sunuluyor.

Etkilenen yapılar:

  • lifecycle-common, çoğu API'yi common'e taşır ve Android'e ek olarak jvm ve iOS'i destekler.
  • lifecycle-runtime, çoğu API'yi common'e taşır ve Android'e ek olarak jvm ve iOS'i destekler.
  • lifecycle-runtime-ktx artık boş ve tüm API'ler lifecycle-runtime paketine taşındı.
  • lifecycle-runtime-compose, tüm API'leri common konumuna taşır ve androidx.compose'nin çoklu platform desteğiyle eşleşen bir Android yapısı sunar.

ViewModel Kotlin Multiplatform Uyumluluğu

lifecycle-viewmodel yapısı ve ViewModel, ViewModelStore, ViewModelStoreOwner ve ViewModelProvider gibi API'ler artık Kotlin Multiplatform ile uyumlu yapılarda sunuluyor.

Bu değişikliğe uyum sağlamak için ViewModelProvider gibi java.lang.Class<T> alan yöntemlerin artık kotlin.reflect.KClass<T> alan eşdeğer bir yöntemi var.

Android'de ikili uyumluluk korunmuştur ancak Android API yüzeyi ile ortak API yüzeyi karşılaştırıldığında birkaç önemli değişiklik vardır:

  • ViewModelProvider örneği oluşturmak için artık doğrudan oluşturucusunu çağırmak yerine ViewModelProvider.create() yöntemleri kullanılır.
  • ViewModelProvider.NewInstanceFactory ve ViewModelProvider.AndroidViewModelFactory yalnızca Android'de kullanılabilir.
    • Özel fabrikaların ViewModelProvider.Factory sınıfından genişletilmesi ve CreationExtras alan create yöntemini veya viewModelFactory Kotlin DSL'yi kullanması önerilir.
  • JVM dışı platformlarda özel bir fabrika olmadan ViewModelProvider kullanılması UnsupportedOperationException hatasına neden olur. JVM platformlarında, özel bir fabrika sağlanmazsa bağımsız değişken içermeyen ViewModel oluşturucu kullanılarak uyumluluk korunur.
  • viewModelScope, Dispatchers.Main özelliğinin kullanılamadığı platformlarda (ör. Linux) EmptyCoroutineContext özelliğine geri döner.

Etkilenen yapılar:

  • lifecycle-viewmodel, çoğu API'yi common'e taşır ve Android'e ek olarak jvm ve iOS'i destekler.
  • lifecycle-viewmodel-ktx artık boş ve tüm API'ler lifecycle-viewmodel paketine taşındı.
  • lifecycle-viewmodel-compose, tüm API'leri common konumuna taşır ve androidx.compose'nin çoklu platform desteğiyle eşleşen bir Android yapısı sunar.

Davranış Değişiklikleri

  • InitializerViewModelFactory (viewModelFactory oluşturucu işlevi dahil), aynı clazz: KClass<VM : ViewModel> değerine sahip bir initializer zaten eklenmişse artık IllegalArgumentException hatası verecek. (Ic3a36)

Bilinen Sorunlar

Sürüm 2.8.0-rc01

1 Mayıs 2024

androidx.lifecycle:lifecycle-*:2.8.0-rc01 yayınlandı. 2.8.0-rc01 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

  • lifecycle-common sınıfları için Baseline Profile'ın düzgün şekilde paketlenmemesine neden olan sorun düzeltildi. Bunlar artık lifecycle-runtime AAR'da paketlenir. (aosp/3038274, b/322382422)
  • Bir ViewModel'e eklenen AutoCloseable örneklerinin temizlenme şeklinde istenmeyen bir sıralama değişikliği düzeltildi. Önceki addCloseable(String, AutoCloseable), ardından addClosable(AutoCloseable) ve son olarak onCleared() sırası geri yüklendi. (aosp/3041632)
  • Yerel ve JVM masaüstü ortamları için viewModelScope'un varsayılan oluşturma davranışını iyileştirme (aosp/3039221)

Harici Katkı

  • JVM Masaüstü'nde ana iş parçacığı kontrolünü iyileştirdiği için Victor Kropp'a teşekkür ederiz. (aosp/3037116)

Sürüm 2.8.0-beta01

17 Nisan 2024

androidx.lifecycle:lifecycle-*:2.8.0-beta01 yayınlandı. 2.8.0-beta01 sürümü bu kayıtları içerir.

Yeni özellikler

  • lifecycle-runtime-compose yapısı artık Kotlin Multiplatform ile uyumludur. Kodunu common konumuna taşır ve androidx.compose için çoklu platform desteğiyle eşleşen bir Android yapısı sunar. (If7a71, I4f4a0, b/331769623)

Sürüm 2.8.0-alpha04

3 Nisan 2024

androidx.lifecycle:lifecycle-*:2.8.0-alpha04 yayınlandı. 2.8.0-alpha04 sürümü bu kayıtları içerir.

Yeni özellikler

  • lifecycle-viewmodel-compose yapısı artık Kotlin Multiplatform ile uyumludur. Kodunu common'e taşır ve androidx.compose'nin çoklu platform desteğiyle eşleşen bir Android yapısı gönderir. Bu değişikliğe uyum sağlamak için Composable viewModel yöntemi artık java.lang.Class'nin yanı sıra KClass değerini de kabul ediyor. (b/330323282)

Hata Düzeltmeleri

  • NullSafeMutableLiveData, çok sayıda yanlış pozitif sonucu önlemek için yeniden düzenlendi. (I2d8c1, Iafb18, I03463, I7ecef)

Bağımlılık güncellemesi

  • lifecycle-viewmodel-compose yapısı artık Compose 1.6.0'a bağlıdır.
  • Lifecycle artık Profile Installer 1.3.1'e bağlıdır.

Sürüm 2.8.0-alpha03

20 Mart 2024

androidx.lifecycle:lifecycle-*:2.8.0-alpha03 yayınlandı. 2.8.0-alpha03 sürümü bu commit'leri içerir.

Yeni özellikler

  • ViewModel.viewModelScope artık geçersiz kılınabilir bir oluşturucu parametresidir. Bu sayede kendi dağıtıcınızı ve SupervisorJob() öğenizi ekleyebilir veya runTest içinde bulunan backgroundScope öğesini kullanarak varsayılanı geçersiz kılabilirsiniz. (I2817c, b/264598574)

    class MyViewModel(
      // Make Dispatchers.Main the default, rather than Dispatchers.Main.immediate
      viewModelScope: CoroutineScope = Dispatchers.Main + SupervisorJob()
    ) : ViewModel(viewModelScope) {
      // Use viewModelScope as before, without any code changes
    }
    
    // Allows overriding the viewModelScope in a test
    fun Test() = runTest {
      val viewModel = MyViewModel(backgroundScope)
    }
    

Kotlin Multiplatform Uyumluluğu

lifecycle-viewmodel yapısı ve ViewModel, ViewModelStore, ViewModelStoreOwner ve ViewModelProvider gibi API'ler artık Kotlin Multiplatform ile uyumlu yapılarda sunuluyor. (b/214568825)

Bu değişikliğe uyum sağlamak için ViewModelProvider gibi java.lang.Class<T> alan yöntemlerin artık kotlin.reflect.KClass<T> alan eşdeğer bir yöntemi var.

Android'de ikili uyumluluk korunmuştur ancak Android API yüzeyi ile ortak API yüzeyi karşılaştırıldığında birkaç önemli değişiklik vardır:

  • ViewModelProvider örneği oluşturmak için artık doğrudan oluşturucusunu çağırmak yerine ViewModelProvider.create() yöntemleri kullanılır.
  • ViewModelProvider.NewInstanceFactory ve ViewModelProvider.AndroidViewModelFactory yalnızca Android'de kullanılabilir.
    • Özel fabrikaların ViewModelProvider.Factory sınıfından genişletilmesi ve CreationExtras alan create yöntemini veya viewModelFactory Kotlin DSL'yi kullanması önerilir.
  • JVM dışı platformlarda özel bir fabrika olmadan ViewModelProvider kullanılması UnsupportedOperationException hatasına neden olur. JVM platformlarında, özel bir fabrika sağlanmazsa bağımsız değişken içermeyen ViewModel oluşturucu kullanılarak uyumluluk korunur.
  • viewModelScope, Dispatchers.Main özelliğinin kullanılamadığı platformlarda (ör. Linux) EmptyCoroutineContext özelliğine geri döner.

Davranış Değişiklikleri

  • InitializerViewModelFactory (viewModelFactory oluşturucu işlevi dahil), aynı clazz: KClass<VM : ViewModel> değerine sahip bir initializer zaten eklenmişse artık IllegalArgumentException hatası verecek. (Ic3a36)

Hata Düzeltmeleri

  • ViewModel.getCloseable artık yinelenen anahtarları işler: key ile ilişkilendirilmiş bir AutoCloseable kaynağı varsa eski kaynak hemen değiştirilir ve kapatılır. (Ibeb67)
  • ViewModel öğesinin viewModelScope özelliğine erişim artık iş parçacığı açısından güvenlidir. (If4766, b/322407038)

Harici Katkı

  • LocalLifecycleOwner, Compose tabanlı yardımcı API'lerinin Compose kullanıcı arayüzü dışında kullanılabilmesi için Compose kullanıcı arayüzünden lifecycle-runtime-compose'a taşındı. Katkılarından dolayı Jake Wharton'a teşekkür ederiz. (I6c41b, b/328263448)

Sürüm 2.8.0-alpha02

21 Şubat 2024

androidx.lifecycle:lifecycle-*:2.8.0-alpha02 yayınlandı. 2.8.0-alpha02 sürümü bu kayıtları içerir.

Yeni özellikler

  • LifecycleOwner, belirtilen Lifecycle.State değerinin altına düştükten sonra bile gerçekleşen tıklama veya diğer etkinlikleri bırakmanıza olanak tanıyan dropUnlessResumed ve dropUnlessStarted API'leri eklendi. Örneğin, başka bir ekrana geçiş başladıktan sonra tıklama etkinliklerinin işlenmesini önlemek için Navigation Compose ile kullanılabilir: onClick: () -> Unit = dropUnlessResumed { navController.navigate(NEW_SCREEN) } (Icba83, b/317230685)

Kotlin Dönüşümleri

  • ViewModel artık Kotlin'de yazılmıştır (I16f26, b/214568825)
  • lifecycle-viewmodel-ktx Kotlin uzantıları artık temel yaşam döngüsü modülüne taşındı. (Id787b, b/274800183)
  • lifecycle-runtime-ktx Kotlin uzantıları artık temel yaşam döngüsü modülüne taşındı. (Ic3686, b/274800183)
  • lifecycle-livedata-core-ktx Kotlin uzantıları artık temel yaşam döngüsü modülüne taşındı. (I54a3d, b/274800183)

Kotlin Multiplatform Uyumluluğu

  • Lifecycle, LifecycleOwner, LifecycleObserver, Lifecycle.State, Lifecycle.Event ve LifecycleRegistry'teki temel Lifecycle API'leri artık Kotlin Multiplatform ile uyumlu yapıtlarda sunuluyor. (b/317249252)

API Değişiklikleri

  • LifecycleStartEffect ve LifecycleResumeEffect anahtar olmadan çağrıldığında artık hata veriyor. Bu API'lerin yansıttığı DisposableEffect API'si de aynı kuralı uyguluyor. (Ib0e0c, b/323518079)
  • ViewModel artık Closeable yerine AutoCloseable kullanıyor. Bu, geriye dönük uyumlu bir değişikliktir. (I27f8e, b/214568825)
  • LiveDataReactiveStreams.toPublisher(lifecycleOwner, liveData), LiveData.toPublisher(lifecycleOwner) lehine kullanımdan kaldırıldı. (Iabe29, b/262623005)

Harici Katkı

  • Lifecycle'ın Kotlin Multiplatform'a taşınmasına yardımcı olan Jetbrains'den Ivan Matkov'a teşekkür ederiz. (aosp/2926690, I0c5ac, If445d)

Sürüm 2.8.0-alpha01

24 Ocak 2024

androidx.lifecycle:lifecycle-*:2.8.0-alpha01 yayınlandı. 2.8.0-alpha01 sürümü bu kayıtları içerir.

Yeni özellikler

  • ViewModel artık getCloseable() aracılığıyla alınmalarına olanak tanıyan key içeren Closeable nesneleri eklemeyi destekliyor. (I3cf63)

Sürüm 2.7

Sürüm 2.7.0

10 Ocak 2024

androidx.lifecycle:lifecycle-*:2.7.0 yayınlandı. 2.7.0 sürümü bu commit'leri içerir.

2.6.0 sürümünden sonra yapılan önemli değişiklikler

  • TestLifecycleOwner artık, durum değişikliğinin ve tüm LifecycleObserver geri çağırmalarının geri dönmeden önce tamamlanmasını sağlayan bir askıya alma işlevi setCurrentState() içeriyor. currentState özelliğini doğrudan ayarlamaktan farklı olarak bu yöntem runBlocking kullanmaz. Bu nedenle, runTest tarafından sağlananlar gibi eş yordamlarda güvenle kullanılabilir.
  • map ve switchMap'nin LiveData uzantıları artık distinctUntilChanged'ün davranışını yansıtıyor. LiveData'de bir value ayarlanmışsa döndürülen LiveData'nin value değerini doldurmak için map/switchMap işlevi hemen çağrılır. Bu, ilk değerin ilk oluşturmanın bir parçası olarak ayarlanmasını sağlar (observeAsState() ile kullanıldığında) ancak gözlem davranışını değiştirmez. LiveData kaynağından gelen değer güncellemeleri yalnızca LiveData'i gözlemlemeye başladığınızda uygulanır.
  • Bu sürümde, işlem sonlandırma ve yeniden oluşturma işleminden sonra SavedStateHandle öğesinin özel Parcelable sınıflarını düzgün şekilde geri yüklememesi sorunu düzeltildi. Android çerçevesi tarafından kaybedilen tür bilgileri nedeniyle, özel Parcelable dizileri ek çalışma (doğru türde yazılmış bir diziyi manuel olarak oluşturma) gerektirir. get, getLiveData ve getStateFlow ile ilgili belgelerde bu sınırlama özellikle belirtilmiştir.
  • LifecycleObserver ile ilişkili ProGuard saklama kuralları kaldırıldı. Bu nedenle, API'leri yansıma yoluyla kullanmak isteyen (ör. uzun süredir desteği sonlandırılmış @OnLifecycleEvent ek açıklamasını kullanarak) ProGuard ile korunan kodun, kendi kullanım alanına özel saklama kuralları sağlaması gerekir.

Yaşam Döngüsü Olayı Gözlemlenebilirliği

  • LifecycleEventObserver kullanmaya alternatif olarak, artık Lifecycle.asFlow() uzantı yöntemi aracılığıyla Lifecycle.Event için Flow gözlemleyebilirsiniz.
  • Jetpack Compose kullanıcıları artık Lifecycle.Event tabanlı Compose yan etkilerini çalıştırmak için LifecycleEventEffect kullanabilir.
@Composable
fun HomeScreen(viewModel: HomeViewModel = viewModel()) {
  LifecycleEventEffect(Lifecycle.Event.ON_RESUME) {
    viewModel.refreshData()
  }
  // …
}
  • Jetpack Compose kullanıcıları, etkinlik çiftlerini (sırasıyla başlatıldı-durduruldu ve devam ettirildi-duraklatıldı) işlemek için LifecycleStartEffect ve LifecycleResumeEffect kullanabilir. Bu API, DisposableEffect içinde bulunan API'yi yansıtır ve durum yükselirken yapılan değişikliğin tekrar aşağı inerken geri alınması gereken durumlar için uygundur.
fun HomeScreen(viewModel: HomeViewModel = viewModel()) {
  LifecycleStartEffect(viewModel) {
    val timeTracking = viewModel.startTrackingTimeOnScreen()
    onStopOrDispose {
      timeTracking.stopTrackingTimeOnScreen()
    }
  }
  // …
}

Daha fazla bilgi için Yaşam döngüsü etkinliklerinde kod çalıştırma başlıklı makaleyi inceleyin.

Yaşam Döngüsü Durumu Gözlemlenebilirliği

  • Mevcut Lifecycle.State artık Lifecycle.currentStateFlow özelliği aracılığıyla gözlemlenebilir. Bu özellik, value değerinin mevcut Lifecycle.State olduğu bir StateFlow döndürür.
  • Jetpack Compose kullanıcıları, Lifecycle.State değerini doğrudan Compose State olarak göstermek için Lifecycle.currentStateAsState() uzantısını kullanabilir. Bu, lifecycle.currentStateFlow.collectAsState() ile eşdeğerdir (ve daha kısa bir alternatiftir).

Daha fazla bilgi için Akışlarla yaşam döngüsü durumunu toplama başlıklı makaleyi inceleyin.

Sürüm 2.7.0-rc02

13 Aralık 2023

androidx.lifecycle:lifecycle-*:2.7.0-rc02 yayınlandı. 2.7.0-rc02 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • İşlem sonlandırılıp yeniden oluşturulduktan sonra SavedStateHandle öğesinin özel Parcelable sınıflarını düzgün şekilde geri yüklememesiyle ilgili sorun düzeltildi. Android çerçevesi tarafından kaybedilen tür bilgileri nedeniyle, özel Parcelable dizileri ek çalışma (doğru türde yazılmış bir diziyi manuel olarak oluşturma) gerektirir. get, getLiveData ve getStateFlow ile ilgili belgelerde bu sınırlama özellikle belirtilmiştir. (I0b55a)

Sürüm 2.7.0-rc01

15 Kasım 2023

androidx.lifecycle:lifecycle-*:2.7.0-rc01 yayınlandı. 2.7.0-rc01 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • LifecycleStartEffect ve LifecycleResumeEffect, LifecycleOwner değiştirildiğinde efekt bloğunu artık doğru şekilde silip yeniden oluşturuyor. (Ia25c6)

Sürüm 2.7.0-beta01

1 Kasım 2023

androidx.lifecycle:lifecycle-*:2.7.0-beta01, değişiklik yapılmadan yayınlandı. 2.7.0-beta01 sürümü bu commit'leri içerir.

  • Beta sürüm yükseltmesi. Bu yayınlanan sürümde önemli bir değişiklik yok.

Sürüm 2.7.0-alpha03

18 Ekim 2023

androidx.lifecycle:lifecycle-*:2.7.0-alpha03 yayınlandı. 2.7.0-alpha03 sürümü bu kayıtları içerir.

Yeni özellikler

  • lifecycle-runtime-testing artık bir eş yordam içindeyken currentState alanını kullanarak TestLifecycleOwner öğesinin Lifecycle.State değerini ayarlamayı önlemek için yeni bir Lint kontrolü içeriyor. Lint kontrolü artık, Lifecycle.State değerini engellemeden ayarlamaya olanak tanıyan askıya alma setCurrentState işlevini öneriyor. (Icf728, b/297880630)

Hata Düzeltmeleri

  • Hem ilk çağrıda hem de sonraki çağrıda aynı LiveData örneğinin döndürülmesinin, LiveData örneğinin kaynak olarak eklenmesini engellediği LiveData.switchMap ile ilgili bir sorun düzeltildi. (Ibedcba7)

Sürüm 2.7.0-alpha02

6 Eylül 2023

androidx.lifecycle:lifecycle-*:2.7.0-alpha02 yayınlandı. 2.7.0-alpha02 sürümü bu commit'leri içerir.

Yeni özellikler

  • TestLifecycleOwner artık setCurrentState() askıya alma işlevini içeriyor. Bu sayede kullanıcılar, runTest tarafından sağlananlar gibi bir eş yordam içinden TestLifecycleOwner kullanabilir. (I329de, b/259344129)

API Değişiklikleri

  • lifecycle-livedata-ktx modüllerindeki tüm dosyalar ana lifecycle-livedata modülüne taşındı. (I10c6f, b/274800183)

Davranış Değişiklikleri

  • LiveData.map() ve LiveData.switchMap() uzantıları artık önceki LiveData için bir değer ayarlanmışsa döndürülen LiveData'nin value değerini ayarlayarak Jetpack Compose'da elde edilen LiveData'nın ilk oluşturmada doğru duruma sahip olmasını sağlar. (I91d2b, b/269479952)
  • ViewModel adlı uygulamanın addCloseable() yöntemi, ViewModel zaten onCleared() çağrısı aldıysa Closeable öğesini hemen kapatıyor. (I4712e, b/280294730)

Hata Düzeltmeleri

  • Lifecycle 2.6.2: Durum geri yüklendikten sonra işlem sonlandırmanın ardından SavedStateHandle öğesinin doğru şekilde geri yüklenmemesine, üst SavedStateRegistry öğesinde durum kaydedilmeden save() öğesinin çağrılmasına ve ardından durumun tekrar geri yüklenmesine neden olan sorun düzeltildi. Bu, rememberSaveable ile Navigation Compose'un NavHost arasındaki etkileşimi düzeltir. (aosp/2729289)

Sürüm 2.7.0-alpha01

26 Temmuz 2023

androidx.lifecycle:lifecycle-*:2.7.0-alpha01 yayınlandı. 2.7.0-alpha01 sürümü bu kayıtları içerir.

API Değişiklikleri

  • Lifecycle.State artık Lifecycle.currentStateFlow aracılığıyla Compose tarafından gözlemlenebilir. Bu, value değerinin geçerli Lifecycle.State olduğu bir StateFlow döndürür. (Ib212d, b/209684871)
  • Lifecycle.Event artık Lifecycle.asFlow(). ile Flow olarak gözlemlenebilir (If2c0f, b/176311030)
  • LifecycleResumeEffect API'si, hem Lifecycle.Event.ON_RESUME hem de Lifecycle.Event.ON_PAUSE etkinlik geri çağırmalarına göre Compose SideEffect'leri çalıştırmak için eklendi. (I60386, b/235529345)
  • Lifecycle.Event.ON_START ve Lifecycle.Event.ON_STOP etkinlik geri çağırmalarına göre Compose SideEffect'leri çalıştırmak için LifecycleStartEffect API'si eklendi. (I5a8d1, b/235529345)
  • Lifecycle.Event'ye dayalı olarak Compose SideEffect'leri çalıştırmak için LifecycleEventEffect API'si eklendi. (Ic9794, b/235529345)
  • Lifecycle.State öğesini doğrudan Compose State olarak göstermek için Lifecycle.collectAsState() uzantısı eklendi. Bu, lifecycle.currentStateFlow.collectAsState() ile eşdeğerdir (ve daha kısa bir alternatiftir). (I11015, b/235529345)

Hata Düzeltmeleri

  • LiveData.distinctUntilChanged() uzantısı artık önceki LiveData için bir değer ayarlanmışsa döndürülen LiveData'nin value değerini ayarlar. Bu işlem, gözlem davranışını değiştirmez. LiveData kaynağından güncellenen değerler, yalnızca distinctUntilChanged() kaynağından döndürülen LiveData değerini gözlemlemeye başladığınızda geçerli olur. (Ib482f)
  • LifecycleObserver ile ilişkili ProGuard saklama kuralları kaldırıldı. Bu nedenle, API'leri yansıma yoluyla kullanmak isteyen ProGuard kodunun, kendi kullanım alanına özel saklama kuralları sağlaması gerekir. (Ia12fd)

Sürüm 2.6

Sürüm 2.6.2

6 Eylül 2023

androidx.lifecycle:lifecycle-*:2.6.2 yayınlandı. 2.6.2 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Durum geri yüklendiyse, save() üst SavedStateRegistry öğesinde durum kaydedilmeden çağrıldıysa ve ardından durum tekrar geri yüklendiyse işlem sonlandırmadan sonra SavedStateHandle öğesinin doğru şekilde geri yüklenmemesine neden olan sorun düzeltildi. Bu, rememberSaveable ile Navigation Compose'un NavHost arasındaki etkileşimi düzeltir. (aosp/2729289)

Sürüm 2.6.1

22 Mart 2023

androidx.lifecycle:lifecycle-*:2.6.1 yayınlandı. 2.6.1 sürümü bu commit'leri içerir.

Bağımlılık Güncellemeleri

Sürüm 2.6.0

8 Mart 2023

androidx.lifecycle:lifecycle-*:2.6.0 yayınlandı. 2.6.0 sürümü bu commit'leri içerir.

2.5.0 sürümünden sonra yapılan önemli değişiklikler

  • LiveData artık LiveData üzerinde açık bir değer ayarlanıp ayarlanmadığını gösteren yeni bir isInitialized özelliği içeriyor. Bu sayede, hiçbir değer ayarlanmadığı için null döndüren liveData.value ile açık bir null değeri arasında ayrım yapabilirsiniz.
  • MediatorLiveData artık başlangıç değeri ayarlamak için bir kurucu içeriyor.
  • StateFlow ve Flow için collectAsStateWithLifecycle()'ın yeni bir uzantısı eklendi. Bu uzantı, akışlardan veri toplar ve en son değerini yaşam döngüsüne duyarlı bir şekilde Compose State olarak gösterir.
  • Duraklatma dağıtıcısı kullanmak bazı durumlarda kaynakların boşa harcanmasına neden olabileceğinden Lifecycle.launchWhenX yöntemleri ve Lifecycle.whenX yöntemleri kullanımdan kaldırıldı. Lifecycle.repeatOnLifecycle kullanılması önerilir. Çalışmayı tek seferlik askıya alma hakkında daha fazla bilgi için lütfen bunun neden doğası gereği güvenli olmadığını açıklayan bu açıklamayı inceleyin.
  • Kotlin Dönüşümü: Çok sayıda Lifecycle sınıfı Kotlin'e dönüştürüldü. Dönüştürülen tüm sınıflar, önceki sürümlerle ikili uyumluluğunu korur. Aşağıdaki sınıflarda, Kotlin'de yazılmış sınıflar için kaynak uyumsuz değişiklikler var: ViewTreeLifecycleOwner, LiveDataReactiveStreams, HasDefaultViewModelProviderFactory, ViewTreeViewModelStoreOwner, Transformations, ViewModelStoreOwner, LifecycleOwner

Aşağıdaki tabloda, yaşam döngüsünün yeni sürümü için kaynak dönüşümler verilmiştir.

Lifecycle 2.5 Lifecycle 2.5 (KTX) Lifecycle 2.6
Transformations.switchMap(liveData) {...} liveData.switchMap {...} liveData.switchMap {...}
Transformations.map(liveData) {...} liveData.map {...} liveData.map {...}
Transformations.distinctUntilChanged(liveData) {...} liveData.distinctUntilChanged{...} liveData.distinctUntilChanged{...}
LiveDataReactiveStreams.fromPublisher(publisher) publisher.toLiveData() publisher.toLiveData()
LiveDataReactiveStreams.toPublisher(lifecycleOwner, liveData) liveData.toPublisher(lifecycleOwner) liveData.toPublisher(lifecycleOwner)
override fun getDefaultViewModelProviderFactory(): ViewModelProvider.Factory = factory override fun getDefaultViewModelProviderFactory(): ViewModelProvider.Factory = factory override val defaultViewModelProviderFactory = factory
override fun getDefaultViewModelCreationExtras(): CreationExtras = extras override fun getDefaultViewModelCreationExtras(): CreationExtras = extras override val defaultViewModelProviderCreationExtras = extras
ViewTreeLifecycleOwner.set(view, owner) ViewTreeLifecycleOwner.set(view, owner) view.setViewTreeLifecycleOwner(owner)
ViewTreeLifecycleOwner.get(view) view.findViewTreeLifecycleOwner() view.findViewTreeLifecycleOwner()
override fun getViewModelStore(): ViewModelStore = store override fun getViewModelStore(): ViewModelStore = store override val viewModelStore: ViewModelStore = store
override fun getLifecycle(): Lifecycle = registry override fun getLifecycle(): Lifecycle = registry override val lifecycle: Lifecycle get() = registry
  • Kotlin'de oluşturulan bir Observer öğesinin onChanged yönteminin null değer alabilme özelliği, artık genel türün null değer alabilme özelliğiyle eşleşiyor. Observer.onChanged() sınıfının null değer alabilen bir türü kabul etmesini istiyorsanız Observer sınıfını null değer alabilen bir türle örneklendirmeniz gerekir.
  • Bu sınıflar da Kotlin'e dönüştürüldü ancak kaynak uyumluluğu devam ediyor: DefaultLifecycleObserver, LifecycleEventObserver, Lifecycle, LifecycleRegistry, LifecycleObserver, ViewModelStore, AndroidViewModel, AbstractSavedStateViewModelFactory, LifecycleService, ServiceLifecycleDispatcher ve ProcessLifecycleOwner

Sürüm 2.6.0-rc01

22 Şubat 2023

androidx.lifecycle:lifecycle-*:2.6.0-rc01 yayınlandı. 2.6.0-rc01 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • LiveData.distinctUntilChanged() uzantısı artık önceki LiveData için bir değer ayarlanmışsa döndürülen LiveData'nin value değerini ayarlar. Bu işlem, gözlem davranışını değiştirmez. LiveData kaynağından güncellenen değerler, yalnızca distinctUntilChanged() kaynağından döndürülen LiveData değerini gözlemlemeye başladığınızda geçerli olur. (Ib482f)

Sürüm 2.6.0-beta01

8 Şubat 2023

androidx.lifecycle:lifecycle-*:2.6.0-beta01 yayınlandı. 2.6.0-beta01 sürümü bu commit'leri içerir.

Kotlin Dönüşümleri

  • LifecycleOwner artık Kotlin'de yazılıyor. Bu, Kotlin'de yazılan sınıflar için kaynakla uyumsuz bir değişikliktir. Bu sınıfların artık önceki getLifecycle() işlevini uygulamak yerine lifecycle özelliğini geçersiz kılması gerekir. (I75b4b, b/240298691)
  • ViewModelStoreOwner artık Kotlin'de. Bu, Kotlin'de yazılan sınıflar için kaynakla uyumsuz bir değişikliktir. Bu sınıfların artık önceki getViewModelStore() işlevini uygulamak yerine viewModelStore özelliğini geçersiz kılması gerekir. (I86409, b/240298691)
  • LifecycleOwner üzerinde lifecycleScope alanını sağlayan Kotlin uzantısı, lifecycle-runtime-ktx yerine lifecycle-common yapısına taşındı. (I41d78, b/240298691)
  • Lifecycle üzerinde coroutineScope alanını sağlayan Kotlin uzantısı, lifecycle-runtime-ktx yerine lifecycle-common yapısına taşındı. (Iabb91, b/240298691)

Sürüm 2.6.0-alpha05

25 Ocak 2023

androidx.lifecycle:lifecycle-*:2.6.0-alpha05 yayınlandı. 2.6.0-alpha05 sürümü bu kayıtları içerir.

Kotlin Dönüşümleri

  • Transformations artık Kotlin'de yazılıyor. Bu, Kotlin'de yazılmış ve doğrudan Transformations.map gibi bir söz dizimi kullanan sınıflar için kaynak uyumsuz bir değişikliktir. Kotlin kodu artık daha önce yalnızca lifecycle-livedata-ktx kullanılırken kullanılabilen Kotlin uzantı yöntemi söz dizimini kullanmalıdır. Java programlama dili kullanılırken bu yöntemlerin androidx.arch.core.util.Function yöntemini alan sürümleri kullanımdan kaldırılır ve Kotlin Function1 alan sürümlerle değiştirilir. Bu değişiklik, ikili program uyumluluğunu korur. (I8e14f)
  • ViewTreeViewModelStoreOwner artık Kotlin'de yazılıyor. Bu, Kotlin'de yazılmış sınıflar için kaynakla uyumlu olmayan bir değişikliktir. Artık daha önce ayarlanmış bir sahibi ayarlamak ve bulmak için androidx.lifecycle.setViewTreeViewModelStoreOwner ve androidx.lifecycle.findViewTreeViewModelStoreOwner'nin View sınıfındaki Kotlin uzantı yöntemlerini doğrudan içe aktarmanız ve kullanmanız gerekir. Bu, ikili uyumludur ve Java programlama dilinde yazılmış uygulamalar için kaynak uyumluluğunu korur. (Ia06d8, Ib22d8, b/240298691)
  • HasDefaultViewModelProviderFactory arayüzü artık Kotlin'de yazılmıştır. Bu, Kotlin'de yazılmış sınıflar için kaynakla uyumlu olmayan bir değişikliktir. Bu sınıfların artık önceki karşılık gelen işlevleri uygulamak yerine defaultViewModelProviderFactory ve defaultViewModelCreationExtras özelliklerini geçersiz kılması gerekir. (Iaed9c, b/240298691)
  • Observer artık Kotlin'de yazılıyor. onChanged() yönteminin parametresi artık value adını kullanıyor. (Iffef2, I4995e, b/240298691)
  • AndroidViewModel, AbstractSavedStateViewModelFactory, LifecycleService, ServiceLifecycleDispatcher ve ProcessLifecycleOwner artık Kotlin'de yazılıyor (I2e771, Ibae40, I160d7, I08884, I1cda7, b/240298691)

Sürüm 2.6.0-alpha04

11 Ocak 2023

androidx.lifecycle:lifecycle-*:2.6.0-alpha04 yayınlandı. 2.6.0-alpha04 sürümü bu commit'leri içerir.

Yeni özellikler

  • LiveData artık LiveData üzerinde açık bir değer ayarlanıp ayarlanmadığını gösteren yeni bir isInitialized özelliği içeriyor. Bu sayede, hiçbir değer ayarlanmadığı için null döndüren liveData.value ile açık bir null değeri arasında ayrım yapabilirsiniz. (Ibd018)

API Değişiklikleri

  • lifecycle-runtime-compose için collectAsStateWithLifecycle() API'leri artık deneysel durumda değil. (I09d42, b/258835424)
  • Duraklatma dağıtıcısı kullanmak bazı durumlarda kaynakların boşa harcanmasına neden olabileceğinden Lifecycle.launchWhenX yöntemleri ve Lifecycle.whenX yöntemleri kullanımdan kaldırıldı. Lifecycle.repeatOnLifecycle kullanılması önerilir. (Iafc54, b/248302832)

Kotlin Dönüşümleri

  • ViewTreeLifecycleOwner artık Kotlin'de yazılıyor. Bu, Kotlin'de yazılmış sınıflar için kaynakla uyumlu olmayan bir değişikliktir. Artık daha önce ayarlanmış bir sahibi ayarlamak ve bulmak için androidx.lifecycle.setViewTreeLifecycleOwner ve androidx.lifecycle.findViewTreeLifecycleOwner'nin View sınıfındaki Kotlin uzantı yöntemlerini doğrudan içe aktarmanız ve kullanmanız gerekir. Bu, lifecycle-runtime-ktx içindeki önceki Kotlin uzantısının yerini alır. Bu, ikili uyumludur ve Java programlama dilinde yazılmış uygulamalar için kaynak uyumluluğunu korur. (I8a77a, I5234e, b/240298691)
  • LiveDataReactiveStreams artık Kotlin'de yazılıyor. Daha önce lifecycle-reactivestreams-ktx içinde bulunan Kotlin uzantıları lifecycle-reactivestreams modülüne taşındı ve Kotlin'de yazılan kodun birincil yüzeyi haline geldi. Kotlin uzantı yöntemi API'lerini kullanmıyorsanız bu, Kotlin'de yazılmış kod için kaynak uyumsuz bir değişikliktir. (I2b1b9, I95d22, b/240298691)
  • DefaultLifecycleObserver, LifecycleEventObserver, Lifecycle, LifecycleRegistry, LifecycleObserver ve ViewModelStore artık Kotlin'de yazılmıştır (Iadffd, (I60034, I8c52c, I9593d, I01fe1, I59a23, b/240298691)

Hata Düzeltmeleri

  • SavedStateHandle, yanlış sınıf türüyle get() çağrılırken artık ClassCastException ile kilitlenmiyor. (I6ae7c)

Sürüm 2.6.0-alpha03

24 Ekim 2022

androidx.lifecycle:lifecycle-*:2.6.0-alpha03 yayınlandı. 2.6.0-alpha03 sürümü bu taahhütleri içerir.

Hata Düzeltmeleri

  • Farklı yaşam döngüsü modülleri arasındaki kısıtlamaların beklendiği gibi çalışmamasıyla ilgili bir sorun düzeltildi. (I18d0d, b/249686765)
  • LifecycleRegistry.moveToState() tarafından oluşturulan hatalar artık geliştiricileri hataya neden olan bileşen hakkında bilgilendiren daha faydalı bir hata mesajı içeriyor. (Idf4b2, b/244910446)

Sürüm 2.6.0-alpha02

7 Eylül 2022

androidx.lifecycle:lifecycle-*:2.6.0-alpha02 yayınlandı. 2.6.0-alpha02 sürümü bu commit'leri içerir.

API Değişiklikleri

  • MediatorLiveData artık başlangıç değeri ayarlamak için bir kurucu içeriyor. (Ib6cc5, b/151244085)

Hata Düzeltmeleri

  • Lifecycle yapıları artık birbirine bağlı tüm Yaşam Döngüsü yapılarının aynı sürümü kullanmasını sağlayan kısıtlamalar içeriyor. Bu sayede, bir bağımlılık yükseltildiğinde diğer bağımlılıklar da otomatik olarak yükseltiliyor. b/242871265
  • FlowLiveData.asFlow(), iş parçacığı güvenliğini ve bağlam korumasını sağlamak için kendi Channel uygulamasını kullanmak yerine artık bir callbackFlow oluşturuyor. (I4a8b2, b/200596935)
  • FlowLiveData'ın asLiveData işlevi artık yeni LiveData nesnesini oluştururken StateFlow'nin ilk değerini koruyacak. (I3f530, b/157380488)
  • Lifecycle 2.5.1: AndroidViewModelFactory için özel uygulamalar, artık Lifecycle 2.4 ve sonraki sürümlerde durum bilgisi olan kurucu kullanılırken create(modelClass) işlevini doğru şekilde çağırıyor (I5b315, b/238011621).

Sürüm 2.6.0-alpha01

29 Haziran 2022

androidx.lifecycle:lifecycle-*:2.6.0-alpha01 yayınlandı. 2.6.0-alpha01 sürümü bu commit'leri içerir.

Yeni özellikler

  • collectAsStateWithLifecycle için StateFlow ve Flow üzerinde yeni bir uzantı eklendi. Bu uzantı, akışlardan veri toplar ve en son değerini yaşam döngüsüne duyarlı bir şekilde Compose State olarak temsil eder. Akış toplanır ve yaşam döngüsü en az belirli bir Lifecycle.State olduğunda yeni emisyon, eyaletin değerine ayarlanır. Yaşam döngüsü Lifecycle.State altına düştüğünde flow toplama işlemi durur ve State'in değeri güncellenmez. (I1856e, b/230557927)

Sürüm 2.5

Sürüm 2.5.1

27 Temmuz 2022

androidx.lifecycle:lifecycle-*:2.5.1 yayınlandı. 2.5.1 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • AndroidViewModelFactory için özel uygulamalar, Lifecycle 2.4+ ile durum bilgisi olan AndroidViewModelFactory oluşturucuyu kullanırken artık create(modelClass) işlevini doğru şekilde çağırıyor. (I5b315, b/238011621)

Sürüm 2.5.0

29 Haziran 2022

androidx.lifecycle:lifecycle-*:2.5.0 yayınlandı. 2.5.0 sürümü bu commit'leri içerir.

2.4.0 sürümünden sonra yapılan önemli değişiklikler

  • SavedStateHandle artık LiveData kullanımına alternatif olarak değer değişikliklerini izlemek için Kotlin StateFlow döndüren bir getStateFlow() API sunuyor.

  • ViewModel CreationExtras: Özel bir ViewModelProvider.Factory yazarken Application veya SavedStateHandle'ya erişmek için artık AndroidViewModelFactory veya AbstractSavedStateViewModelFactory'yı genişletmeniz gerekmez. Bunun yerine, bu alanlar create'ün yeni aşırı yüklemesi (create(Class<T>, CreationExtras)) aracılığıyla her ViewModelProvider.Factory alt sınıfına CreationExtras olarak sağlanır. Bu ekstralar, sırasıyla Activity 1.5.0 ve Fragment 1.5.0 kullanılırken Activity veya Fragment tarafından otomatik olarak sağlanır.

    class CustomFactory : ViewModelProvider.Factory {
        override fun <T : ViewModel> create(modelClass: Class<T>, extras: CreationExtras): T {
            return when (modelClass) {
                HomeViewModel::class -> {
                    // Get the Application object from extras
                    val application = checkNotNull(extras[ViewModelProvider.AndroidViewModelFactory.APPLICATION_KEY])
                    // Pass it directly to HomeViewModel
                    HomeViewModel(application)
                }
                DetailViewModel::class -> {
                    // Create a SavedStateHandle for this ViewModel from extras
                    val savedStateHandle = extras.createSavedStateHandle()
                    DetailViewModel(savedStateHandle)
                }
                else -> throw IllegalArgumentException("Unknown class $modelClass")
            } as T
        }
    }
    
  • lifecycle-viewmodel artık viewModelFactory Kotlin DSL sunuyor. Bu sayede, ViewModelProvider.Factory öğenizi bir veya daha fazla lambda başlatıcı açısından tanımlayabilirsiniz. Özel fabrikanızın desteklediği her bir ViewModel sınıfı için bir tane olmak üzere, birincil veri kaynağı olarak CreationExtras kullanabilirsiniz.

    val customFactory = viewModelFactory {
        // The return type of the lambda automatically sets what class this lambda handles
        initializer {
            // Get the Application object from extras provided to the lambda
            val application = checkNotNull(get(ViewModelProvider.AndroidViewModelFactory.APPLICATION_KEY))
            HomeViewModel(application)
        }
        initializer {
            val savedStateHandle = createSavedStateHandle()
            DetailViewModel(savedStateHandle)
        }
    }
    
  • lifecycle-viewmodel-compose artık özel bir ViewModelProvider.Factory oluşturmaya gerek kalmadan ViewModel örneği oluşturmak için lambda fabrikası kullanan bir viewModel() API'si sunuyor.

    // Within a @Composable, you can now skip writing a custom Factory
    // and instead write a lambda to do the initialization of your ViewModel
    val detailViewModel = viewModel {
      // This lambda is only called the first time the ViewModel is created
      // and all CreationExtras are available inside the lambda
      val savedStateHandle = createSavedStateHandle()
      DetailViewModel(savedStateHandle)
    }
    
  • SavedStateHandle Compose Saver Entegrasyonu: lifecycle-viewmodel-compose yapısı artık SavedStateHandle.saveable içinde, bir `ViewModel'in SavedStateHandle tarafından desteklenen rememberSaveable benzeri davranışlara olanak tanıyan yeni deneysel API'ler içeriyor.

    class ListScreenViewModel(handle: SavedStateHandle): ViewModel() {
        // This value survives both configuration changes and process death and recreation
        val editMode by handle.saveable { mutableStateOf(false) }
    }
    
  • ViewModel temizlendiğinde kapatılacak ViewModel'ye bir veya daha fazla Closeable nesnesi eklemenize olanak tanıyan bir addCloseable() API'si ve yeni bir oluşturucu aşırı yüklemesi eklendi. Bu işlem, onCleared()'te manuel çalışma gerektirmez.

    Örneğin, bir ViewModel'e ekleyebileceğiniz ancak test yoluyla kontrol edebileceğiniz bir eş yordam kapsamı oluşturmak için Closeable uygulayan bir CoroutineScope oluşturabilirsiniz:

    class CloseableCoroutineScope(
        context: CoroutineContext = SupervisorJob() + Dispatchers.Main.immediate
    ) : Closeable, CoroutineScope {
        override val coroutineContext: CoroutineContext = context
        override fun close() {
            coroutineContext.cancel()
       }
    }
    

    Bu, daha sonra viewModelScope ile aynı kullanım ömrünü korurken ViewModel oluşturucunuzda kullanılabilir:

    class TestScopeViewModel(
        val customScope: CloseableCoroutineScope = CloseableCoroutineScope()
    ) : ViewModel(customScope) {
        // You can now use customScope in the same way as viewModelScope
    }
    

Davranış değişiklikleri

  • Lifecycle.State öğesini INITIALIZED durumundan DESTROYED durumuna taşımaya çalışmak, Lifecycle öğesinin ekli bir gözlemcisi olup olmadığına bakılmaksızın her zaman IllegalStateException hatasına neden olur.
  • LifecycleRegistry, DESTROYED durumuna ulaştığında gözlemcilerini temizleyecek.

Sürüm 2.5.0-rc02

15 Haziran 2022

androidx.lifecycle:lifecycle-*:2.5.0-rc02 yayınlandı. 2.5.0-rc02 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • ViewModelProvider, compileOnly Lifecycle bağımlılıklarının önceki sürümleri 2.5 ve sonraki sürümlerle karıştırıldığında artık kilitlenmeyecek. (I81a66, b/230454566)

Sürüm 2.5.0-rc01

11 Mayıs 2022

androidx.lifecycle:lifecycle-*:2.5.0-rc01 yayınlandı. 2.5.0-rc01 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

  • MediatorLiveData.addSource(), null kaynağını gözlemcilere yaymak yerine null kaynağı iletildiğinde NullPointerException hatası veriyor.(Ibd0fb, b/123085232)

Sürüm 2.5.0-beta01

20 Nisan 2022

androidx.lifecycle:lifecycle-*:2.5.0-beta01 yayınlandı. 2.5.0-beta01 sürümü bu kayıtları içerir.

API Değişiklikleri

  • Durumu SavedStateHandle içinde kalıcı hale getirmek için özellik adlarını anahtar olarak kullanan SavedStateHandle.saveable özellik temsilcileri eklendi (I8bb86, b/225014345)

Hata Düzeltmeleri

  • Birincil olmayan bir alt gezinme sekmesinde bir NavHost öğesini başka bir NavHost öğesinin içine yerleştirmenin, birden fazla eski yığın kullanıldığında IllegalStateException hatasına yol açmasına neden olan sorun düzeltildi. (I11bd5, b/228865698)

Sürüm 2.5.0-alpha06

6 Nisan 2022

androidx.lifecycle:lifecycle-*:2.5.0-alpha06 yayınlandı. 2.5.0-alpha06 sürümü bu kayıtları içerir.

Yeni özellikler

  • rememberSaveable ile eşitlik için SavedStateHandle.saveable öğesine deneysel MutableState aşırı yüklemesi ekleyin (I38cfe, b/224565154)

API Değişiklikleri

  • CreationExtras artık mühürlü değil, soyut. (Ib8a7a)

Hata Düzeltmeleri

  • SavedStateHandleController nedeniyle oluşan IllegalStateException: Already attached to lifecycleOwner hatası düzeltildi. (I7ea47, b/215406268)

Sürüm 2.5.0-alpha05

23 Mart 2022

androidx.lifecycle:lifecycle-*:2.5.0-alpha05 yayınlandı. 2.5.0-alpha05 sürümü bu kayıtları içerir.

Yeni özellikler

  • lifecycle-viewmodel-compose modülü artık SavedStateHandleSaver adlı deneysel bir API sunuyor. Bu API, SavedStateHandle içindeki değerlerin rememberSaveable tarafından kullanılan aynı kaydedilmiş örnek durumuyla doğru şekilde entegre edilmesini sağlıyor. (Ia88b7, b/195689777)

API Değişiklikleri

  • Java'da Lifecycle 2.3 ve daha yeni Lifecycle sürümleriyle ilgili bir uyumluluk sorunu düzeltildi. (I52c8a, b/219545060)

Hata Düzeltmeleri

  • SavedStateViewFactory artık SavedStateRegistryOwner ile başlatılmış olsa bile CreationExtras kullanımını destekliyor. Ekstralar sağlanırsa başlatılan bağımsız değişkenler yoksayılır. (I6c43b, b/224844583)

Sürüm 2.5.0-alpha04

9 Mart 2022

androidx.lifecycle:lifecycle-*:2.5.0-alpha04 yayınlandı. 2.5.0-alpha04 sürümü bu kayıtları içerir.

API Değişiklikleri

  • SavedStateHandle artık LiveData kullanmaya alternatif olarak değer değişikliklerini izlemek için Kotlin StateFlow döndüren bir getStateFlow() API'si sunuyor. (Iad3ab, b/178037961)

Sürüm 2.5.0-alpha03

23 Şubat 2022

androidx.lifecycle:lifecycle-*:2.5.0-alpha03 yayınlandı. 2.5.0-alpha03 sürümü bu kayıtları içerir.

Yeni özellikler

  • ViewModel temizlendiğinde kapatılacak bir veya daha fazla Closeable nesnesini ViewModel'ye eklemenize olanak tanıyan bir addCloseable() API'si ve yeni bir kurucu aşırı yüklemesi eklendi. Bu işlem, onCleared() içinde manuel çalışma gerektirmez. (I55ea0)
  • lifecycle-viewmodel artık belirli ViewModel sınıflarını işlemek için lambda eklemenize olanak tanıyan bir InitializerViewModelFactory sunuyor. Bu işlem için birincil veri kaynağı olarak CreationExtras kullanılıyor. (If58fc, b/216687549)
  • lifecycle-viewmodel-compose artık özel bir ViewModelProvider.Factory oluşturmaya gerek kalmadan ViewModel örneği oluşturmak için lambda fabrikası kullanan bir viewModel() API'si sunuyor. (I97fbb, b/216688927)

API Değişiklikleri

  • Artık lifecycle-viewmodel-compose üzerinden CreationExtras ile ViewModel oluşturabilirsiniz. (I08887, b/216688927)

Davranış değişiklikleri

  • Lifecycle.State öğesini INITIALIZED konumundan DESTROYED konumuna taşımaya çalışmak, Lifecycle öğesinin ekli bir gözlemcisi olup olmadığına bakılmaksızın her zaman IllegalStateException hatasına neden olur. (I7c390, b/177924329)
  • LifecycleRegistry, DESTROYED durumuna ulaştığında gözlemcilerini temizleyecek. (I4f8dd, b/142925860)

Sürüm 2.5.0-alpha02

9 Şubat 2022

androidx.lifecycle:lifecycle-*:2.5.0-alpha02 yayınlandı. 2.5.0-alpha02 sürümü şu commit'leri içerir:

API Değişiklikleri

  • SavedStateHandle ve SavedStateViewModelFactory, Kotlin'e dönüştürüldü. Bu sayede her iki sınıftaki jeneriklerin null değer alabilme özelliği iyileştirildi. (Ib6ce2, b/216168263, I9647a, b/177667711)
  • LiveData switchMap işlev parametresi artık null değer alabilen bir çıkışa sahip olabilir. (I40396, b/132923666)
  • LiveData -ktx uzantıları artık bu işlevler çağrılırken sonucun kullanılmasını zorunlu kılmak için @CheckResult ile ek açıklama eklenmiştir. (Ia0f05, b/207325134)

Davranış değişiklikleri

  • SavedStateHandle, belirtilen anahtar için değer olmadığında defaultValue'yu artık doğru şekilde saklıyor. (I1c6ce, b/178510877)

Hata Düzeltmeleri

  • Lifecycle 2.4.1: lifecycle-process, Startup 1.1.1'e bağlı olacak şekilde güncellendi. Böylece ProcessLifecycleInitializer'in StartupException hatası vermesini önleyen düzeltmeler varsayılan olarak kullanılabilir. (Ib01df, b/216490724)
  • Özel AndroidViewModel sınıflarında parametreler yanlış sırada olduğunda ve ViewModel oluşturmaya çalışıldığında artık daha iyi bir hata mesajı gösteriliyor. (I340f7, b/177667711)
  • Artık uygulama ayarlamadan AndroidViewModelFactory kullanarak CreationExtras üzerinden görünüm modeli oluşturabilirsiniz. (I6ebef, b/217271656)

Sürüm 2.5.0-alpha01

26 Ocak 2022

androidx.lifecycle:lifecycle-*:2.5.0-alpha01 yayınlandı. 2.5.0-alpha01 sürümü bu commit'leri içerir.

ViewModel CreationExtras

Bu sürümle birlikte, ViewModel oluşturma şeklini yeniden yapılandırmanın temelini atıyoruz. Her biri ek işlevler ekleyen (AndroidViewModelFactory aracılığıyla Application oluşturucu parametresine izin verme, SavedStateViewModelFactory ve AbstractSavedStateViewModelFactory aracılığıyla SavedStateHandle oluşturucu parametresine izin verme vb.) katı bir ViewModelProvider.Factory alt sınıf kümesi yerine, yeni bir kavram olan CreationExtras'ya dayalı durum bilgisiz fabrikalar dünyasına geçiyoruz. (Ia7343, b/188691010, b/188541057)

Bu değişiklikle birlikte ViewModelProvider, artık ViewModelProvider.Factory sınıfının önceki create(Class<T>) yöntemine doğrudan çağrı yapmaz. Bunun yerine, create'nin yeni bir aşırı yüklemesini çağırır: create(Class<T>, CreationExtras). Bu, ViewModelProvider.Factory örneğinin doğrudan uygulandığı her yerde artık bu yeni CreationExtras öğelerinin her birine erişilebileceği anlamına gelir:

  • ViewModelProvider.NewInstanceFactory.VIEW_MODEL_KEY: Bu String, ViewModelProvider.get() öğesine ilettiğiniz özel anahtara erişim sağlar.
  • ViewModelProvider.AndroidViewModelFactory.APPLICATION_KEY, Application sınıfına erişim sağlar.
  • SavedStateHandleSupport.SAVED_STATE_REGISTRY_OWNER_KEY, bu ViewModel'i oluşturmak için kullanılan SavedStateRegistryOwner öğesine erişim sağlar.
  • SavedStateHandleSupport.VIEW_MODEL_STORE_OWNER_KEY, bu ViewModel'i oluşturmak için kullanılan ViewModelStoreOwner öğesine erişim sağlar.
  • SavedStateHandleSupport.DEFAULT_ARGS_KEY, SavedStateHandle oluşturmak için kullanılması gereken bağımsız değişkenlerin Bundle değerine erişim sağlar.

Bu ekstralar Activity 1.5.0-alpha01, Fragment 1.5.0-alpha01 ve Navigation 2.5.0-alpha01 kullanılırken varsayılan olarak sağlanır. Bu kitaplıkların önceki bir sürümünü kullanıyorsanız CreationExtras boş olur. ViewModelProvider.Factory sınıfının mevcut tüm alt sınıfları, bu kitaplıkların önceki sürümleri tarafından kullanılan eski oluşturma yolunu ve gelecekte kullanılacak CreationExtras yolunu destekleyecek şekilde yeniden yazılmıştır.

Bu CreationExtras, katı bir Factory alt sınıf hiyerarşisine bağlı kalmadan her ViewModel için yalnızca ihtiyacınız olan bilgileri ileten bir ViewModelProvider.Factory oluşturmanıza olanak tanır:

class CustomFactory : ViewModelProvider.Factory {
    override fun <T : ViewModel> create(modelClass: Class<T>, extras: CreationExtras): T {
        return when (modelClass) {
            HomeViewModel::class -> {
                // Get the Application object from extras
                val application = checkNotNull(extras[ViewModelProvider.AndroidViewModelFactory.APPLICATION_KEY])
                // Pass it directly to HomeViewModel
                HomeViewModel(application)
            }
            DetailViewModel::class -> {
                // Create a SavedStateHandle for this ViewModel from extras
                val savedStateHandle = extras.createSavedStateHandle()
                DetailViewModel(savedStateHandle)
            }
            else -> throw IllegalArgumentException("Unknown class $modelClass")
        } as T
    }
}

Yalnızca ihtiyacı olan tek bir ViewModel için SavedStateHandle oluşturmak üzere SavedStateHandleSupport'den CreationExtras üzerinde createSavedStateHandle() Kotlin uzantı işlevini kullanırız. (Ia6654, b/188541057)

Özel CreationExtras, ComponentActivity veya Fragment dosyanızda getDefaultViewModelCreationExtras() geçersiz kılınarak sağlanabilir. Böylece, özel ViewModelProvider.Factory için yerleşik bir destekli ekleme biçimi olarak kullanılabilir. Bu ekstralar, doğrudan ViewModelProvider ile kullanıldığında veya by viewModels() ve by activityViewModels() Kotlin özellik uzantıları kullanıldığında özel Factory'nizde otomatik olarak kullanılabilir hale getirilir. (I79f2b, b/207012584, b/207012585, b/207012490)

Hata Düzeltmeleri

  • SavedStateHandle için sağlanan varsayılan değerin, SavedStateHandle öğesinden özellikle kaldırılmış olsa bile işlem sonlandırma ve yeniden oluşturma işleminden sonra tekrar görünmesine neden olan bir sorun düzeltildi. Bunun sonucunda SavedStateHandle, varsayılan değerleri ve geri yüklenen değerleri artık birleştirmeyecek, bunun yerine yalnızca geri yüklenen değerleri doğru kaynak olarak kullanacak. (I53a4b)

Sürüm 2.4

Sürüm 2.4.1

9 Şubat 2022

androidx.lifecycle:lifecycle-*:2.4.1 yayınlandı. 2.4.1 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Lifecycle 2.5.0-alpha01 sürümünden geri taşındı: SavedStateHandle için sağlanan varsayılan değerin, SavedStateHandle öğesinden özellikle kaldırılmış olsa bile işlem sonlandırma ve yeniden oluşturma işleminden sonra tekrar görünmesine neden olan sorun düzeltildi. Bunun sonucunda SavedStateHandle, varsayılan değerleri ve geri yüklenen değerleri artık birleştirmeyecek, bunun yerine yalnızca geri yüklenen değerleri doğru kaynak olarak kullanacak. (I53a4b)
  • lifecycle-process artık Androidx Startup 1.1.1'e bağlıdır. Bu sürümde, ProcessLifecycleInitializer kullanımının StartupException hatasına neden olduğu bir gerileme düzeltilmiştir. (b/216490724)

Sürüm 2.4.0

27 Ekim 2021

androidx.lifecycle:lifecycle-*:2.4.0 yayınlandı. 2.4.0 sürümü bu commit'leri içerir.

2.3.0 sürümünden sonra yapılan önemli değişiklikler

  • @OnLifecycleEvent desteği sonlandırıldı. Bunun yerine LifecycleEventObserver veya DefaultLifecycleObserver kullanılmalıdır.
  • androidx.lifecycle:lifecycle-viewmodel-compose kitaplığı eklendi. viewModel() composable ve LocalViewModelStoreOwner sağlar.
    • Kaynakta zarar veren değişiklik: ViewModelProvider, Kotlin'de yeniden yazıldı. ViewModelProvider.Factory.create yöntemi artık boş değer atanabilir jeneriklere izin vermiyor.
  • androidx.lifecycle:lifecycle-runtime-ktx için yeni eş yordam API'leri eklendi:
  • Lifecycle.repeatOnLifecycle, Yaşam Döngüsü en azından belirli bir durumdayken bir eş yordamda kod bloğu yürüten API. Yaşam döngüsü hedef durumun içine ve dışına taşındıkça blok iptal edilir ve yeniden başlatılır.
  • Flow.flowWithLifecycle, yaşam döngüsü en azından belirli bir durumdayken yukarı akış akışından değerler yayınlayan API.
  • DefaultLifecycleObserver, lifecycle.lifecycle-common-java8 konumundan lifecycle.lifecycle-common konumuna taşındı. lifecycle.lifecycle-common-java8, lifecycle.lifecycle-common'e ek olarak başka bir işlev sağlamadığından, bağımlılığı lifecycle.lifecycle-common ile değiştirilebilir.
  • lifecycle-viewmodel-ktx uygulamasındaki eş yordam olmayan API, lifecycle-viewmodel modülüne taşındı.
  • lifecycle-process, ProcessLifecycleOwner başlatmak için artık androidx.startup kullanıyor.

    Daha önce bu işlem androidx.lifecycle.ProcessLifecycleOwnerInitializer tarafından yapılıyordu.

    Geçmişte işlem yaşam döngüsünü ilk kullanıma hazırlamak için kullanılan ContentProvider tools:node="remove" kullandıysanız bunun yerine aşağıdakileri yapmanız gerekir.

     <provider
        android:name="androidx.startup.InitializationProvider"
        android:authorities=\"${applicationId}.androidx-startup"
        android:exported="false"
        tools:node=\"merge">
        <!-- If you are using androidx.startup to initialize other components -->
        <meta-data
            android:name="androidx.lifecycle.ProcessLifecycleInitializer"
            android:value="androidx.startup"
            tools:node="remove" />
     </provider>
    

    (veya)

     <!-- If you want to disable androidx.startup completely. -->
     <provider
        android:name="androidx.startup.InitializationProvider"
        android:authorities="${applicationId}.androidx-startup"
        tools:node="remove">
     </provider>
    

Sürüm 2.4.0-rc01

29 Eylül 2021

androidx.lifecycle:lifecycle-*:2.4.0-rc01, Lifecycle 2.4.0-beta01 ile aynı şekilde yayınlandı. 2.4.0-rc01 sürümü bu kayıtları içerir.

Sürüm 2.4.0-beta01

15 Eylül 2021

androidx.lifecycle:lifecycle-*:2.4.0-beta01 yayınlandı. 2.4.0-beta01 sürümü bu commit'leri içerir.

API Değişiklikleri

  • @OnLifecycleEvent desteği sonlandırıldı. Bunun yerine LifecycleEventObserver veya DefaultLifecycleObserver kullanılmalıdır. (I5a8fa)
  • DefaultLifecycleObserver, androidx.lifecycle.lifecycle-common-java8 konumundan androidx.lifecycle.lifecycle-common konumuna taşındı. androidx.lifecycle.lifecycle-common-java8, androidx.lifecycle.lifecycle-common'e ek olarak başka bir işlev sağlamadığından, bağımlılığı androidx.lifecycle.lifecycle-common ile değiştirilebilir. (I021aa)
  • lifecycle-viewmodel-ktx adlı modüldeki eş yordam olmayan API, lifecycle-viewmodel modülüne taşındı. (I6d5b2)

Harici Katkı

  • ViewModel belgelerindeki bir yazım hatasını düzelttiği için dmitrilc'ye teşekkür ederiz. (#221)

Sürüm 2.4.0-alpha03

4 Ağustos 2021

androidx.lifecycle:lifecycle-*:2.4.0-alpha03 yayınlandı. 2.4.0-alpha03 sürümü bu kayıtları içerir.

API Değişiklikleri

  • Kaynakta zarar veren değişiklik: ViewModelProvider, Kotlin'de yeniden yazıldı. ViewModelProvider.Factory.create yöntemi artık null değer alabilen genel türlere izin vermiyor. (I9b9f6)

Davranış Değişiklikleri

  • Lifecycle.repeatOnLifecycle: block, yürütme tekrarlanırken artık her zaman seri olarak çağrılır. (Ibab33)

Harici Katkı

  • repeatOnLifecycle belgelerindeki kod snippet'lerini düzelttiği için chao2zhang'a teşekkür ederiz. #205.

Sürüm 2.4.0-alpha02

16 Haziran 2021

androidx.lifecycle:lifecycle-*:2.4.0-alpha02 yayınlandı. 2.4.0-alpha02 sürümü bu kayıtları içerir.

Yeni özellikler

  • lifecycle-runtime-ktx için repeateOnLifecycle öğesinin onStart() veya onResume() içinde yanlış kullanıldığını tespit eden yeni bir RepeatOnLifecycleWrongUsage lint kontrolü eklendi. (706078, b/187887400)

API Değişiklikleri

  • LifecycleOwner.addRepeatingJob API'si, yapılandırılmış eşzamanlılığı dikkate alan ve daha kolay anlaşılır olan Lifecycle.repeatOnLifecycle lehine kaldırıldı. (I4a3a8)
  • Diğer androidx.startup.Initializer'lerin bunları bağımlılık olarak kullanabilmesi için ProcessLifecycleInitializer öğesini herkese açık hale getirin. (I94c31)

Hata Düzeltmeleri

  • Alanda değiştiriciler olduğunda NullSafeMutableLiveData lint kontrolüyle ilgili bir sorun düzeltildi. (#147, b/183696616)
  • Jenerik türler kullanılırken NullSafeMutableLiveData lint kontrolüyle ilgili başka bir sorun düzeltildi. (#161, b/184830263)

Harici Katkı

  • NullSafeMutableLiveData lint kontrolünü iyileştirdiği için maxsav'a teşekkür ederiz. (#147, b/183696616)
  • NullSafeMutableLiveData lint kontrolünü iyileştirdiği için kozaxinan'a teşekkür ederiz. (#161, b/184830263)

Sürüm 2.4.0-alpha01

24 Mart 2021

androidx.lifecycle:lifecycle-*:2.4.0-alpha01 yayınlandı. 2.4.0-alpha01 sürümü bu taahhütleri içerir.

Davranış Değişiklikleri

  • lifecycle-process, ProcessLifecycleOwner başlatmak için artık androidx.startup kullanıyor.

    Daha önce bu işlem androidx.lifecycle.ProcessLifecycleOwnerInitializer tarafından yapılıyordu.

    Geçmişte işlem yaşam döngüsünü ilk kullanıma hazırlamak için kullanılan ContentProvider tools:node="remove" kullandıysanız bunun yerine aşağıdakileri yapmanız gerekir.

     <provider
        android:name="androidx.startup.InitializationProvider"
        android:authorities=\"${applicationId}.androidx-startup"
        android:exported="false"
        tools:node=\"merge">
        <!-- If you are using androidx.startup to initialize other components -->
        <meta-data
            android:name="androidx.lifecycle.ProcessLifecycleInitializer"
            android:value="androidx.startup"
            tools:node="remove" />
     </provider>
    

    (veya)

     <!-- If you want to disable androidx.startup completely. -->
     <provider
        android:name="androidx.startup.InitializationProvider"
        android:authorities="${applicationId}.androidx-startup"
        tools:node="remove">
     </provider>
    

API Değişiklikleri

  • Yaşam döngüsü en azından belirli bir durumdayken Lifecycle.repeatOnLifecycle API'sini kullanarak yukarı akış akışından değerler yayan bir Flow.flowWithLifecycle API'si eklendi. Bu, yeni LifecycleOwner.addRepeatinJob API'ye bir alternatiftir. (I0f4cd)

Hata Düzeltmeleri

  • Lifecycle 2.3.1 sürümünden itibaren: NonNullableMutableLiveData lint kuralı artık farklı null değer alabilme özelliklerine sahip alan değişkenlerini doğru şekilde ayırt edebiliyor. (b/169249668)

Lifecycle Viewmodel Compose Sürüm 1.0.0

Sürüm 1.0.0-alpha07

16 Haziran 2021

androidx.lifecycle:lifecycle-viewmodel-compose:1.0.0-alpha07 yayınlandı. 1.0.0-alpha07 sürümü bu kayıtları içerir.

Önemli API Değişiklikleri

  • viewModel() artık isteğe bağlı bir ViewModelStoreOwner alarak LocalViewModelStoreOwner dışındaki sahiplerle çalışmayı kolaylaştırıyor. Örneğin, artık belirli bir gezinme grafiğiyle ilişkili ViewModel'i almak için viewModel(navBackStackEntry) kullanabilirsiniz. (I2628d, b/188693123)

Sürüm 1.0.0-alpha06

2 Haziran 2021

androidx.lifecycle:lifecycle-viewmodel-compose:1.0.0-alpha06 yayınlandı. 1.0.0-alpha06 sürümü şu taahhütleri içerir:

Compose 1.0.0-beta08 sürümüyle uyumlu olacak şekilde güncellendi.

Sürüm 1.0.0-alpha05

18 Mayıs 2021

androidx.lifecycle:lifecycle-viewmodel-compose:1.0.0-alpha05 yayınlandı. 1.0.0-alpha05 sürümü bu kayıtları içerir.

Yeni özellikler

  • Compose 1.0.0-beta07 sürümüyle uyumlu olacak şekilde güncellendi.

Hata Düzeltmeleri

  • ui-test-manifest ve ui-tooling-data'daki AndroidManifest dosyaları artık Android 12 ile uyumlu (I6f9de, b/184718994)

Sürüm 1.0.0-alpha04

7 Nisan 2021

androidx.lifecycle:lifecycle-viewmodel-compose:1.0.0-alpha04 yayınlandı. 1.0.0-alpha04 sürümü şu commit'leri içerir:

Bağımlılık Değişiklikleri

  • Bu sürüm, androidx.hilt:hilt-navigation-compose ve androidx.navigation:navigation-compose'nin androidx.compose.compiler:compiler:1.0.0-beta04 ve androidx.compose.runtime:runtime:1.0.0-beta04'deki bağımlılıkları senkronize etmesine olanak tanır. 1.0.0 için derleyici ve çalışma zamanının eşleşmesi gerekir.

Sürüm 1.0.0-alpha03

10 Mart 2021

androidx.lifecycle:lifecycle-viewmodel-compose:1.0.0-alpha03 yayınlandı. 1.0.0-alpha03 sürümü bu kayıtları içerir.

API Değişiklikleri

  • LocalViewModelStoreOwner.current artık geçerli oluşturmada ViewModelStoreOwner olup olmadığını daha iyi belirlemek için null değer alabilen ViewModelStoreOwner döndürüyor. viewModel() ve NavHost gibi ViewModelStoreOwner gerektiren API'ler, ViewModelStoreOwner ayarlanmamışsa istisna oluşturmaya devam eder. (Idf39a)

Lifecycle-Viewmodel-Compose Sürüm 1.0.0-alpha02

24 Şubat 2021

androidx.lifecycle:lifecycle-viewmodel-compose:1.0.0-alpha02 yayınlandı. 1.0.0-alpha02 sürümü bu kayıtları içerir.

API Değişiklikleri

  • LocalViewModelStoreOwner artık asProvidableCompositionLocal() API'nin yerini alan, CompositionLocalProvider ile kullanılabilecek provides işlevlerine sahip. (I45d24)

Lifecycle-Viewmodel-Compose Sürüm 1.0.0-alpha01

10 Şubat 2021

androidx.lifecycle:lifecycle-viewmodel-compose:1.0.0-alpha01 yayınlandı. 1.0.0-alpha01 sürümü bu kayıtları içerir.

Yeni özellikler

  • viewModel() composable ve LocalViewModelStoreOwner, androidx.compose.ui.viewinterop'den androidx.lifecycle.viewmodel.compose paketindeki bu yapıya taşındı. (I7a374)

Sürüm 2.3.1

Lifecycle 2.3.1 sürümü

24 Mart 2021

androidx.lifecycle:lifecycle-*:2.3.1 yayınlandı. 2.3.1 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • NonNullableMutableLiveData lint kuralı artık farklı null değer alabilme özelliklerine sahip alan değişkenlerini doğru şekilde ayırt edebiliyor. (b/169249668)

Sürüm 2.3.0

Sürüm 2.3.0

10 Şubat 2021

androidx.lifecycle:lifecycle-*:2.3.0 yayınlandı. 2.3.0 sürümü bu commit'leri içerir.

2.2.0 sürümünden sonra yapılan önemli değişiklikler

  • SavedStateHandle, parcelable olmayan sınıfları destekler: SavedStateHandle, belirli bir anahtar için setSavedStateProvider() yöntemini çağırmanıza olanak tanıyarak geç serileştirmeyi destekler. SavedStateHandle, durumunu kaydetmesi istendiğinde saveState() yöntemine geri çağırma yapacak bir SavedStateProvider sağlar. Paketlenebilir olmayan sınıfları kaydetme bölümüne bakın.
  • Yaşam Döngüsü Davranış Yaptırımı:
    • LifecycleRegistry artık DESTROYED'i terminal durumu olarak zorunlu kılıyor.
    • LifecycleRegistry artık yöntemlerinin ana iş parçacığında çağrıldığını doğrular. Bu, etkinliklerin, parçaların vb. yaşam döngüleri için her zaman bir gereklilikti. Ana olmayan iş parçacıklarından gözlemcilerin eklenmesi, çalışma zamanında yakalanması zor kilitlenmelere neden oluyordu. Kendi bileşenlerinize ait LifecycleRegistry nesneleri için LifecycleRegistry.createUnsafe(...) kullanarak kontrolleri açıkça devre dışı bırakabilirsiniz. Ancak bu durumda, farklı iş parçacıklarından bu LifecycleRegistry nesnesine erişildiğinde doğru senkronizasyonun yapıldığından emin olmanız gerekir.
  • Yaşam Döngüsü Durumu ve Etkinlik Yardımcıları: State ve geçiş yönü verildiğinde Event oluşturmak için Lifecycle.Event sınıfına downFrom(State), downTo(State), upFrom(State), upTo(State) statik yardımcı yöntemleri eklendi. Lifecycle'ın Event'den hemen sonra geçiş yapacağı State değerini sağlayan getTargetState() yöntemi eklendi.
  • withStateAtLeast: Yaşam döngüsü durumunu bekleyen ve durum değişikliği noktasında askıya alınmayan bir kod bloğunu eşzamanlı olarak çalıştıran, ardından sonuçla devam eden Lifecycle.withStateAtLeast API'ler eklendi. Bu API'ler, askıya alma kodunun çalıştırılmasına izin vermediği ve özel bir dağıtıcı kullanmadığı için mevcut when* yöntemlerinden farklıdır. (aosp/1326081)
  • ViewTree API'leri: Yeni bir ViewTreeLifecycleOwner.get(View) ve ViewTreeViewModelStoreOwner.get(View) API'si, belirli bir View örneği için sırasıyla LifecycleOwner ve ViewModelStoreOwner içeren öğeleri almanıza olanak tanır. Bunu doğru şekilde doldurmak için Activity 1.2.0 ve Fragment 1.3.0 ile AppCompat 1.3.0-alpha01 veya sonraki sürümlere yükseltmeniz gerekir. findViewTreeLifecycleOwner ve findViewTreeViewModelStoreOwner Kotlin uzantıları sırasıyla lifecycle-runtime-ktx ve lifecycle-viewmodel-ktx sürümlerinde kullanılabilir.
  • LiveData.observe() Kotlin uzantısının desteğinin sonlandırılması: Lambda söz dizimini kullanmak için gereken LiveData.observe() Kotlin uzantısı, Kotlin 1.4 kullanılırken gerekli olmadığından artık desteklenmiyor.

Sürüm 2.3.0-rc01

16 Aralık 2020

androidx.lifecycle:lifecycle-*:2.3.0-rc01 yayınlandı. 2.3.0-rc01 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • SavedStateHandle sınıfının keys() yöntemi artık durum kaydedilmeden önce ve sonra tutarlı. Artık set() ve getLiveData() ile kullanılan anahtarlara ek olarak daha önce setSavedStateProvider() ile kullanılan anahtarları da içeriyor. (aosp/1517919, b/174713653)

Harici Katkı

Sürüm 2.3.0-beta01

1 Ekim 2020

androidx.lifecycle:lifecycle-*:2.3.0-beta01 yayınlandı. 2.3.0-beta01 sürümü bu kayıtları içerir.

API Değişiklikleri

  • Lambda söz dizimini kullanmak için gereken LiveData.observe() Kotlin uzantısı, Kotlin 1.4 kullanılırken gerekli olmadığından artık kullanımdan kaldırılmıştır. (I40d3f)

Hata Düzeltmeleri

Belgelerdeki Değişiklikler

  • liveData oluşturucu ve asLiveData() belgeleri, belirtilen zaman aşımı değerlerini değiştirme ile ilgili ayrıntıları içerecek şekilde güncellendi. (aosp/1122324)

Sürüm 2.3.0-alpha07

19 Ağustos 2020

androidx.lifecycle:lifecycle-*:2.3.0-alpha07 yayınlandı. 2.3.0-alpha07 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

  • NullSafeMutableLiveData Lint kontrolünde kilitlenme sorunu düzeltildi. (aosp/1395367)

Sürüm 2.3.0-alpha06

22 Temmuz 2020

androidx.lifecycle:lifecycle-*:2.3.0-alpha06 yayınlandı. 2.3.0-alpha06 sürümü bu kayıtları içerir.

Yeni özellikler

  • State ve geçiş yönü verildiğinde Event oluşturmak için Lifecycle.Event sınıfına downFrom(State), downTo(State), upFrom(State), upTo(State) statik yardımcı yöntemleri eklendi. Lifecycle'ın Event'den hemen sonra geçiş yapacağı State değerini sağlayan getTargetState() yöntemi eklendi. (I00887)
  • Yaşam döngüsü durumunu bekleyen ve durum değişikliği noktasında askıya alınmayan bir kod bloğunu eşzamanlı olarak çalıştıran, ardından sonuçla devam eden Lifecycle.withStateAtLeast API'leri eklendi. Bu API'ler, askıya alma kodunun çalıştırılmasına izin vermediği ve özel bir dağıtıcı kullanmadığı için mevcut when* yöntemlerinden farklıdır. (aosp/1326081)

Davranış Değişiklikleri

  • LifecycleRegistry artık DESTROYED'i terminal durumu olarak zorunlu kılıyor. (I00887)
  • LifecycleRegistry artık yöntemlerinin ana iş parçacığında çağrıldığını doğrular. Bu, etkinliklerin, parçaların vb. yaşam döngüleri için her zaman bir gereklilikti. Ana olmayan iş parçacıklarından gözlemcilerin eklenmesi, çalışma zamanında yakalanması zor kilitlenmelere neden oluyordu. Kendi bileşenlerinize ait LifecycleRegistry nesneleri için LifecycleRegistry.createUnsafe(...) kullanarak kontrolleri açıkça devre dışı bırakabilirsiniz ancak bu LifecycleRegistry nesnesine farklı iş parçacıklarından erişildiğinde uygun bir senkronizasyonun yapıldığından emin olmanız gerekir (Ie7280, b/137392809).

Hata Düzeltmeleri

  • NullSafeMutableLiveData uygulamasındaki kilitlenme sorunu düzeltildi. (b/159987480)
  • lifecycle-livedata-core-ktx (ve özellikle NullSafeMutableLiveData) ile birlikte gelen Lint kontrolleri için ObsoleteLintCustomCheck düzeltildi. (b/158699265)

Sürüm 2.3.0-alpha05

24 Haziran 2020

androidx.lifecycle:lifecycle-*:2.3.0-alpha05 yayınlandı. 2.3.0-alpha05 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • LiveData artık yeniden giriş durumlarını daha iyi işleyerek onActive() veya onInactive() için yinelenen çağrıları önlüyor. (b/157840298)
  • Android Studio 4.1 Canary 6 veya sonraki sürümler kullanılırken Lint kontrollerinin çalışmamasına neden olan sorun düzeltildi. (aosp/1331903)

Sürüm 2.3.0-alpha04

10 Haziran 2020

androidx.lifecycle:lifecycle-*:2.3.0-alpha04 yayınlandı. 2.3.0-alpha04 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

  • NonNullableMutableLiveData Lint kontrolündeki kilitlenme sorunu düzeltildi. (b/157294666)
  • NonNullableMutableLiveData Lint kontrolü artık boş olmayan tür parametresine sahip bir MutableLiveData için null değerinin ayarlandığı çok daha fazla durumu kapsıyor. (b/156002218)

Sürüm 2.3.0-alpha03

20 Mayıs 2020

androidx.lifecycle:lifecycle-*:2.3.0-alpha03 yayınlandı. 2.3.0-alpha03 sürümü bu kayıtları içerir.

Yeni özellikler

  • SavedStateHandle artık belirli bir anahtar için setSavedStateProvider() yöntemini çağırmanıza olanak tanıyarak geç serileştirmeyi destekliyor. Bu yöntem, SavedStateHandle'den durumunu kaydetmesi istendiğinde saveState() için geri çağırma alacak bir SavedStateProvider sağlar. (b/155106862)
  • Yeni bir ViewTreeViewModelStoreOwner.get(View) API'si, belirli bir View örneği için kapsayıcı ViewModelStoreOwner öğesini almanıza olanak tanır. Bunu doğru şekilde doldurmak için Activity 1.2.0-alpha05, Fragment 1.3.0-alpha05 ve AppCompat 1.3.0-alpha01 sürümlerini yükseltmeniz gerekir. lifecycle-viewmodel-ktx için findViewModelStoreOwner() Kotlin uzantısı eklendi. (aosp/1295522)

Hata Düzeltmeleri

  • Lifecycle 2.3.0-alpha01 sürümünde yayınlanan MutableLiveData Lint kontrollerinin lifecycle-livedata-core-ktx yapısıyla birlikte yayınlanmasına neden olan sorun düzeltildi. (b/155323109)

Sürüm 2.3.0-alpha02

29 Nisan 2020

androidx.lifecycle:lifecycle-*:2.3.0-alpha02 yayınlandı. 2.3.0-alpha02 sürümü bu kayıtları içerir.

API Değişiklikleri

  • SavedStateViewModelFactory, artık oluşturucusuna boş bir Application iletmenize olanak tanıyor. Böylece, hazırda bir bulunmayan ve AndroidViewModel desteğine ihtiyaç duyulmayan durumlar daha iyi destekleniyor. (aosp/1285740)

Hata Düzeltmeleri

  • API 28 ve daha eski cihazlarda sınıf doğrulama hatası önlenerek baştan başlatma performansı iyileştirildi. (aosp/1282118)

Sürüm 2.3.0-alpha01

4 Mart 2020

androidx.lifecycle:lifecycle-*:2.3.0-alpha01 yayınlandı. 2.3.0-alpha01 sürümü bu kayıtları içerir.

Yeni özellikler

  • Yeni bir ViewTreeLifecycleOwner.get(View) API'si, belirli bir View örneği için kapsayıcı LifecycleOwner öğesini almanıza olanak tanır. Bunu doğru şekilde doldurmak için Activity 1.2.0-alpha01 ve Fragment 1.3.0-alpha01 sürümlerini yükseltmeniz gerekir. lifecycle-runtime-ktx içinde bir findViewTreeLifecycleOwner Kotlin uzantısı kullanılabilir. (aosp/1182361, aosp/1182956)
  • Kotlin'de boş olmayan olarak tanımlanmış bir MutableLiveData için null değeri ayarlandığında sizi uyaran yeni bir Lint kontrolü eklendi. Bu özellik, livedata-core-ktx veya livedata-ktx yapıları kullanılırken kullanılabilir. (aosp/1154723, aosp/1159092)
  • LifecycleOwner'yi uygulayan ve iş parçacığı açısından güvenli, değiştirilebilir bir Lifecycle sağlayan TestLifecycleOwner sunan yeni bir lifecycle-runtime-testing yapısı mevcut. (aosp/1242438)

Hata düzeltmeleri

  • lifecycle-runtime yapısı artık benzersiz bir paket adına sahip. (aosp/1187196)

Sürüm 2.2.0

ViewModel-Savedstate 2.2.0 sürümü

5 Şubat 2020

androidx.lifecycle:lifecycle-viewmodel-savedstate:2.2.0 yayınlandı. 2.2.0 sürümü bu commit'leri içerir.

Lifecycle ViewModel SavedState artık diğer Lifecycle yapılarıyla aynı sürümü paylaşıyor. 2.2.0, 1.0.0 ile aynı şekilde davranır.

Sürüm 2.2.0

22 Ocak 2020

androidx.lifecycle:lifecycle-*:2.2.0 yayınlandı. 2.2.0 sürümü bu commit'leri içerir.

2.1.0 sürümünden sonra yapılan önemli değişiklikler

  • Yaşam Döngüsü Eş Yordam Entegrasyonu: Yeni lifecycle-runtime-ktx yapısı, Yaşam Döngüsü ile Kotlin eş yordamları arasında entegrasyon ekler. lifecycle-livedata-ktx, eş yordamlardan yararlanacak şekilde de genişletildi. Daha fazla bilgi için Kotlin eş yordamlarını Mimari Bileşenleri ile kullanma başlıklı makaleyi inceleyin.
  • ViewModelProviders.of() desteğinin sonlandırılması: ViewModelProviders.of() desteği sonlandırıldı. Fragment 1.2.0 kullanırken aynı işlevi elde etmek için yeni ViewModelProvider(ViewModelStoreOwner) oluşturucusuna bir Fragment veya FragmentActivity iletebilirsiniz.
  • lifecycle-extensions Yapısının Desteğinin Sonlandırılması: Yukarıda belirtilen ViewModelProviders.of() desteğinin sonlandırılmasıyla birlikte, bu sürümde lifecycle-extensions içindeki son API'nin desteği sonlandırılıyor ve bu yapının tamamı artık desteği sonlandırılmış olarak kabul edilmelidir. lifecycle-extensions için gelecekte 2.3.0 sürümü olmayacağından, lifecycle-extensions yerine ihtiyacınız olan belirli Yaşam Döngüsü yapılarına (ör. LifecycleService kullanıyorsanız lifecycle-service ve ProcessLifecycleOwner kullanıyorsanız lifecycle-process) bağlı kalmanızı önemle tavsiye ederiz.
  • Gradle Artımlı Ek Açıklama İşleyicisi: Lifecycle'ın ek açıklama işleyicisi varsayılan olarak artımlıdır. Uygulamanız Java 8 programlama dilinde yazılmışsa bunun yerine DefautLifecycleObserver, Java 7 programlama dilinde yazılmışsa LifecycleEventObserver kullanabilirsiniz.

Sürüm 2.2.0-rc03

4 Aralık 2019

androidx.lifecycle:lifecycle-*:2.2.0-rc03 yayınlandı. 2.2.0-rc03 sürümü şu commit'leri içerir.

Hata düzeltmeleri

  • Sahte bir ViewModel, ViewModelStore içinde depolandığında ve daha sonra varsayılan fabrika ile sorgulandığında ortaya çıkan hata düzeltildi.
  • launchWhenCreated ve benzer yöntemlerde Dispatchers.Main.immediate kullanımını, ilgili yaşam döngüsü olayı sırasında eşzamanlı olarak çağrılacak şekilde düzeltin. (aosp/1156203)

Harici katkılar

  • Düzeltmeye katkıda bulunan Anders Järleberg'e teşekkür ederiz. (aosp/1156203)
  • Satır içi yürütme uygulamasını incelediği için Jetbrains'den Vsevolod Tolstopyatov'a teşekkür ederiz.

Bağımlılık değişiklikleri

  • Lifecycle Extensions artık Fragment 1.2.0-rc03'e bağlıdır.

Sürüm 2.2.0-rc02

7 Kasım 2019

androidx.lifecycle:lifecycle-*:2.2.0-rc02 yayınlandı. 2.2.0-rc02 sürümü şu commit'leri içerir.

Hata düzeltmeleri

  • Kitaplığın ProGuard kurulumunda, hedef API 29'un altındaysa API 28 ve sonraki sürümleri çalıştıran cihazları etkileyen bir hata düzeltildi. (b/142778206)

Sürüm 2.2.0-rc01

23 Ekim 2019

androidx.lifecycle:lifecycle-*:2.2.0-rc01 yayınlandı. 2.2.0-rc01 sürümü şu commit'leri içerir.

Hata düzeltmeleri

  • launchWhenCreated ve ilgili yöntemlerin, Dispatchers.Main.immediate yerine Dispatchers.Main kullanması nedeniyle ilişkili yaşam döngüsü yönteminden bir kare sonra çalışmasına neden olan sorun düzeltildi. (aosp/1145596)

Harici katkılar

  • Düzeltmeye katkıda bulunan Nicklas Ansman'a teşekkür ederiz. (aosp/1145596)

Sürüm 2.2.0-beta01

9 Ekim 2019

androidx.lifecycle:lifecycle-*:2.2.0-beta01 yayınlandı. 2.2.0-beta01 sürümü şu commit'leri içerir.

Hata düzeltmeleri

  • Lifecycle 2.2.0-alpha05 sürümünde, Android 10 cihazlarda ProcessLifecycleOwner ve etkinliğin LifecycleOwner sıralamasının başlatıldı ve devam ettirildi durumuna geçmesiyle ilgili bir gerileme düzeltildi. (aosp/1128132)
  • Lifecycle 2.2.0-alpha05 sürümünde ortaya çıkan ve lifecycle-process'nın 2.0.0 veya 2.1.0 sürümü kullanılırken NullPointerException hatasına neden olan bir gerileme düzeltildi. (b/141536990)

Sürüm 2.2.0-alpha05

18 Eylül 2019

androidx.lifecycle:lifecycle-*:2.2.0-alpha05 yayınlandı. 2.2.0-alpha05 sürümü şu commit'leri içerir.

Hata düzeltmeleri

  • Eş yordam LiveData oluşturucusundaki yarışma durumu düzeltildi. b/140249349

Sürüm 2.2.0-alpha04

5 Eylül 2019

androidx.lifecycle:lifecycle-*:2.2.0-alpha04 yayınlandı. Bu sürüme dahil edilen commit'leri burada bulabilirsiniz.

Yeni özellikler

  • lifecycleScope, whenCreated, whenStarted, whenResumed, viewModelScope ve liveData'in temel uygulaması artık Dispatchers.Main yerine Dispatchers.Main.immediate kullanıyor. (b/139740492)

Harici katkılar

  • Dispatchers.Main.immediate'ya geçişe katkıda bulunan Nicklas Ansman'a teşekkür ederiz. (aosp/1106073)

Sürüm 2.2.0-alpha03

7 Ağustos 2019

androidx.lifecycle:lifecycle-*:2.2.0-alpha03 yayınlandı. Bu sürüme dahil edilen commit'leri burada bulabilirsiniz.

Yeni özellikler

API değişiklikleri

  • ViewModelProviders.of() desteği sonlandırıldı. Aynı işlevi elde etmek için yeni ViewModelProvider(ViewModelStoreOwner) oluşturucuya bir Fragment veya FragmentActivity iletebilirsiniz. (aosp/1009889)

Sürüm 2.2.0-alpha02

2 Temmuz 2019

androidx.lifecycle:*:2.2.0-alpha02 yayınlandı. Bu sürüme dahil edilen commit'leri burada bulabilirsiniz.

API değişiklikleri

  • LiveDataScope.initialValue, liveData bloğunun mevcut yayınlanan değerini izleyecek olan LiveDataScope.latestValue ile değiştirildi.
  • liveData oluşturucuya, timeout parametresini Duration türünde alan yeni bir aşırı yükleme eklendi.

Sürüm 2.2.0-alpha01

7 Mayıs 2019

androidx.lifecycle:*:2.2.0-alpha01 yayınlandı. Bu sürüme dahil edilen commit'leri burada bulabilirsiniz.

Yeni özellikler

  • Bu sürümde, Lifecycle ve LiveData için Kotlin eş yordamlarını destekleyen yeni özellikler eklenmiştir. Bunlarla ilgili ayrıntılı dokümanları burada bulabilirsiniz.

ViewModel-SavedState Sürüm 1.0.0

Sürüm 1.0.0

22 Ocak 2020

androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0 yayınlandı. 1.0.0 sürümü bu commit'leri içerir.

1.0.0 sürümündeki önemli özellikler

  • Yeni SavedStateHandle sınıfı eklendi. ViewModel sınıflarınızın kaydedilen duruma erişmesine ve katkıda bulunmasına olanak tanır. Bu nesne, ViewModel sınıfının oluşturucusunda alınabilir ve Fragments ile AppCompatActivity tarafından varsayılan olarak sağlanan fabrikalar, SavedStateHandle nesnesini otomatik olarak ekler.
  • AbstractSavedStateViewModelFactory eklendi. ViewModel için özel fabrikalar oluşturmanıza ve bunlara SavedStateHandle erişimi vermenize olanak tanır.

ViewModel-Savedstate Sürüm 1.0.0-rc03

4 Aralık 2019

androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0-rc03 yayınlandı. 1.0.0-rc03 sürümü şu commit'leri içerir.

Bağımlılık değişiklikleri

  • Lifecycle ViewModel SavedState artık Lifecycle 2.2.0-rc03'e bağlıdır.

Viewmodel-Savedstate Sürüm 1.0.0-rc02

7 Kasım 2019

androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0-rc02 yayınlandı. 1.0.0-rc02 sürümü şu taahhütleri içerir.

Bağımlılık değişiklikleri

  • Artık yaşam döngüsü 2.2.0-rc02'na bağlı.

ViewModel-SavedState Sürüm 1.0.0-rc01

23 Ekim 2019

androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0-rc01, 1.0.0-beta01 sürümünden herhangi bir değişiklik yapılmadan yayınlandı. 1.0.0-rc01 sürümü şu taahhütleri içerir.

ViewModel-Savedstate Sürüm 1.0.0-beta01

9 Ekim 2019

androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0-beta01 yayınlandı. 1.0.0-beta01 sürümü şu commit'leri içerir.

Hata düzeltmeleri

  • Activity.onActivityResult() içinde bir SavedState ViewModel'e ilk kez erişildiğinde IllegalStateException hatasının oluşmasına neden olan sorun düzeltildi. (b/139093676)
  • AbstractSavedStateViewModelFactory kullanılırken yaşanan bir IllegalStateException düzeltildi. (b/141225984)

ViewModel-SavedState Sürüm 1.0.0-alpha05

18 Eylül 2019

androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0-alpha05 yayınlandı. 1.0.0-alpha05 sürümü şu taahhütleri içerir.

API değişiklikleri

  • SavedStateViewModelFactory artık AbstractSavedStateViewModelFactory sınıfını genişletmiyor ve SavedStateHandle yalnızca bunu isteyen ViewModel'ler için oluşturuluyor (aosp/1113593)

ViewModel-SavedState Sürüm 1.0.0-alpha03

7 Ağustos 2019

androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0-alpha03 yayınlandı. Bu sürüme dahil edilen commit'leri burada bulabilirsiniz.

Zarar Veren Değişiklikler

ViewModel-SavedState Sürüm 1.0.0-alpha02

2 Temmuz 2019

androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0-alpha02 yayınlandı. Bu sürüme dahil edilen commit'leri burada bulabilirsiniz.

Yeni özellikler

  • Varsayılan değer kabul eden SavedStateHandle.getLiveData() aşırı yüklemesi eklendi.

API Değişiklikleri

  • SavedStateVMFactory, SavedStateViewModelFactory olarak yeniden adlandırıldı.
  • AbstractSavedStateVMFactory, AbstractSavedStateViewModelFactory olarak yeniden adlandırıldı.

ViewModel-Savedstate Sürüm 1.0.0-alpha01

13 Mart 2019

androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0-alpha01 yayınlandı. Bu ilk sürümün tam kayıt günlüğünü burada bulabilirsiniz.

Yeni özellikler

  • Artık ViewModels, savedstate'e katkıda bulunabilir. Bunun için yeni kullanıma sunulan ViewModel'in factory SavedStateVMFactory işlevini kullanırsınız ve ViewModel'inizde parametre olarak SavedStateHandle nesnesini alan bir kurucu bulunmalıdır.

Sürüm 2.1.0

2.0.0 sürümünden sonra yapılan önemli değişiklikler

  • Yaşam döngüsü olayları akışının gerektiği durumlar için LifecycleEventObserver eklendi. Gizli bir GenericLifecycleObserver sınıfı yerine herkese açık bir API'dir.
  • LiveData.observe yöntemleri ve Transformations.* yöntemleri için ktx uzantıları eklendi.
  • Kaynak LiveData değeri değiştirilene kadar değer yaymayan yeni bir LiveData nesnesi oluşturan Transformations.distinctUntilChanged eklendi.
  • ViewModel.viewModelScope uzantı özelliği eklenerek ViewModel'lere eş yordam desteği eklendi.

Sürüm 2.1.0

5 Eylül 2019

androidx.lifecycle:lifecycle-*:2.1.0 yayınlandı. Bu sürüme dahil edilen commit'leri burada bulabilirsiniz.

Sürüm 2.1.0-rc01

2 Temmuz 2019

androidx.lifecycle:*:2.1.0-rc01, androidx.lifecycle:*:2.1.0-beta01 sürümünden herhangi bir değişiklik yapılmadan yayınlandı. Bu sürüme dahil edilen commit'leri burada bulabilirsiniz.

Sürüm 2.1.0-beta01

7 Mayıs 2019

androidx.lifecycle:*:2.1.0-beta01 yayınlandı. Bu sürüme dahil edilen commit'leri burada bulabilirsiniz.

Yeni özellikler

  • Yaşam döngüleri beta sürümüne yükseltildi: Önceki alfa sürümlerinde kullanıma sunulan API'ler (ör. dönüşümler ve gözlemler için liveData uzantı işlevleri, özellik yetkilendirmesiyle ViewModel başlatma ve diğerleri) kararlı hale getirildi ve değiştirilmeyecek.

Sürüm 2.1.0-alpha04

3 Nisan 2019

androidx.lifecycle:*:2.1.0-alpha04 yayınlandı. Bu sürüme dahil edilen commit'leri burada bulabilirsiniz.

API değişiklikleri

  • Zarar veren değişiklik: by viewModels() ve by activityViewModels()'nın temelindeki API, yalnızca ViewModelStoreOwner yerine doğrudan ViewModelStore destekleyecek şekilde değiştirildi. (aosp/932932)

Sürüm 2.1.0-alpha03

13 Mart 2019

androidx.lifecycle:*:2.1.0-alpha03 yayınlandı. Bu sürüme dahil edilen tüm commit'lerin listesini burada bulabilirsiniz.

API değişiklikleri

  • ViewModelProvider.KeyedFactory kaldırıldı. ViewModelProvider.Factory arayüzüne ek olarak ikinci arayüz, Kotlin by viewmodels {}'deki özellik yetkilendirme gibi yeni özelliklerle iyi bir şekilde oluşturulmadı. (aosp/914133)

Sürüm 2.1.0-alpha02

30 Ocak 2019

androidx.lifecycle 2.1.0-alpha02 yayınlandı.

API değişiklikleri

  • LifecycleRegistry artık, desteği sonlandırılan setState() yönteminin yerini alan bir setCurrentState() yöntemi içeriyor. (aosp/880715)

Hata düzeltmeleri

  • İçeren ViewModelStore temizlendiğinde sahte ViewModel örneklerinin kilitlenmesine neden olan bir sorun düzeltildi. b/122273087

Sürüm 2.1.0-alpha01

17 Aralık 2018

androidx.lifecycle 2.1.0-alpha01 yayınlandı.

Yeni özellikler

  • Yaşam döngüsü olayları akışının gerektiği durumlar için LifecycleEventObserver eklendi. Gizli bir GenericLifecycleObserver sınıfı yerine herkese açık bir API'dir.
  • LiveData.observe yöntemleri ve Transformations.* yöntemleri için ktx uzantıları eklendi.
  • Transformations.distinctUntilChanged yöntemi eklendi. Kaynak LiveData değeri değiştirilene kadar değer yaymayan yeni bir LiveData nesnesi oluşturur.
  • ViewModel'lerde eş yordam desteği: ViewModel.viewModelScope uzantı özelliği eklendi.
  • create yönteminde key ve Class alan ViewModel'ler için bir fabrika olan ViewModelProvider.KeyedFactory eklendi.

Sürüm 2.0.0

Sürüm 2.0.0

21 Eylül 2018

Lifecycle 2.0.0, ViewModel'de 2.0.0-rc01 sürümünden bir hata düzeltmesiyle yayınlandı.

Hata Düzeltmeleri

  • Yapıcıları yanlışlıkla kaldıran bir ViewModel proguard kuralı düzeltildi b/112230489

Sürüm 2.0.0-beta01

2 Temmuz 2018

Hata Düzeltmeleri

  • Yalnızca uygulamaları tutmak, alt arayüzleri tutmamak için LifecycleObserver proguard kuralı düzeltildi b/71389427
  • Karartma ve küçültmeye izin vermek için ViewModel proguard kuralları düzeltildi.

AndroidX Öncesi Sürümler

Lifecycle'ın aşağıdaki AndroidX öncesi sürümleri için şu bağımlılıkları ekleyin:

dependencies {
    def lifecycle_version = "1.1.1"

    // ViewModel and LiveData
    implementation "android.arch.lifecycle:extensions:$lifecycle_version"
    // alternatively - just ViewModel
    implementation "android.arch.lifecycle:viewmodel:$lifecycle_version" // For Kotlin use viewmodel-ktx
    // alternatively - just LiveData
    implementation "android.arch.lifecycle:livedata:$lifecycle_version"
    // alternatively - Lifecycles only (no ViewModel or LiveData).
    //     Support library depends on this lightweight import
    implementation "android.arch.lifecycle:runtime:$lifecycle_version"

    annotationProcessor "android.arch.lifecycle:compiler:$lifecycle_version" // For Kotlin use kapt instead of annotationProcessor
    // alternately - if using Java8, use the following instead of compiler
    implementation "android.arch.lifecycle:common-java8:$lifecycle_version"

    // optional - ReactiveStreams support for LiveData
    implementation "android.arch.lifecycle:reactivestreams:$lifecycle_version"

    // optional - Test helpers for LiveData
    testImplementation "android.arch.core:core-testing:$lifecycle_version"
}

Sürüm 1.1.1

21 Mart 2018

Yalnızca küçük bir değişiklik var: android.arch.core.util.Function, arch:runtime yerine arch:common olarak değiştirildi. Bu sayede, çalışma zamanı bağımlılığı olmadan kullanılabilir (ör. aşağıdaki paging:common bölümünde).

lifecycle:common, lifecycle:runtime için bir bağımlılıktır. Bu nedenle, bu değişiklik lifecycle:runtime'i doğrudan etkilemez. Yalnızca Paging gibi doğrudan lifecycle:common'e bağlı olan modülleri etkiler.

Sürüm 1.1.0

22 Ocak 2018

Paketleme Değişiklikleri

Yeni ve çok daha küçük bağımlılıklar artık kullanılabilir:

  • android.arch.lifecycle:livedata:1.1.0
  • android.arch.lifecycle:viewmodel:1.1.0

API Değişiklikleri

  • Desteği sonlandırılan LifecycleActivity ve LifecycleFragment artık kaldırıldı. Lütfen FragmentActivity, AppCompatActivity veya desteklenen Fragment kullanın.
  • @NonNull ek açıklaması ViewModelProviders ve ViewModelStores klasörüne eklendi
  • ViewModelProviders oluşturucusu kullanımdan kaldırıldı. Lütfen doğrudan statik yöntemlerini kullanın.
  • ViewModelProviders.DefaultFactory desteği sonlandırıldı. Lütfen ViewModelProvider.AndroidViewModelFactory kullanın.
  • ViewModel ve AndroidViewModel örnekleri oluşturmaya uygun statik bir Factory almak için statik ViewModelProvider.AndroidViewModelFactory.getInstance(Application) yöntemi eklendi.