Yaşam döngüsü
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 |
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.
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öğesinicompositionLocalWithHostDefaultOfveLifecycleOwnerHostDefaultKeykullanacak ş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:
LifecycleRegistrysınıfınıncurrentStateFlowö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
SavedStateHandleartıkSavedStateContainerile entegrasyon için işlevler sunuyor.SavedStateHandleöğesiniSavedStateContainerolarak dönüştürmek içinasContainer(), tutma yerinin içinde alt kapsayıcı oluşturmak içingetOrCreateContainer()ve mevcut öğenin içinde altSavedStateHandleoluşturmak içingetOrCreateSavedStateHandle()var.SavedStateContainersürümüne geçiş kapsamında,getStateFlowvegetLiveDataözelliklerininSavedStateHandleüzerinde birlikte kullanılması da artık geçerli değildir ve bu durumdaIllegalArgumentException(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
compileSdkiçin Compose kitaplıkları 37.1 sürümüne güncellendi. Bu, Compose kullanan tüm uygulamalar ve kitaplıklar içincompileSdksü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
AutoRecreatedverunOnNextRecreation,SavedStateProviderveSavedStateRestorerlehine 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-compilerek açıklama işleyicisi yapısını kullanımdan kaldırın. Lütfen ek açıklama işleyicisi yerineDefaultLifecycleObserverveyaLifecycleEventObserver'e geçiş yapın. (Ibf571, b/541926513)SavedStateViewModelFactoryveAbstractSavedStateViewModelFactory, sağlananSavedStateRegistryOwnerViewModelStoreOwner'yi uygulamıyorsa hemen başarısız olur. Bu sayede, bileşen yeniden oluşturulurken gecikmeli kilitlenmeler önlenir. (Icf317)LifecycleRegistryetkinlik 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öğesinincurrentStateFlowö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
ViewModelStoreProviderkabul eden birrememberViewModelStoreNavEntryDecoratoraşı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
rememberViewModelStoreProviderkullanılırken yeniden oluşturma sırasındaViewModelsöğ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
rememberViewModelStoreOwnerverememberViewModelStoreProvideriş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
parentKeyparametresiniViewModelStoreProvideroluşturucularında isteğe bağlı bir parametre yapın, varsayılan olaraknulldeğerini atayın veparentStoreveyaparentOwnerparametresinden sonra taşıyın. Bu, paylaşılan bir kapsam anahtarı gerekmediğinde örneklendirmeyi basitleştirir. (I66b67)ViewModelStoreNavEntryDecoratorartıkViewModelStoreyerineViewModelStoreOwnerkabul ediyor. Bu sayede Navigation3, üst öğenin varsayılanCreationExtrasveViewModelProvider.Factorydeğ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
ViewModelStoreProviderdurumunu 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 birkeykullanarak 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
SavedStatedeğerleriyle başlatılmasına izin vermek içinViewModelStoreProvider'edefaultArgsdesteği ekleyin. (I1e933, b/434651920, b/165642391) removeViewModelStoreOnPopve ilişkiliViewModelStoreNavEntryDecoratorDefaultsdesteğ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çinrememberDecoratedNavEntriesAPI'sini kullanın. (I852d9)
Hata Düzeltmeleri
- Sınıf adını görüntülemek için
CreationExtras.KeyöğesinetoString()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 sayedeViewModels, belirli kullanıcı arayüzü kapsamlarına (ör. bağımsızPagersayfaları veyaLazyListöğeleri) bağlanabilir. BuViewModels, 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,ViewModelStoreOwnerveSavedStateRegistryOwneriç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.addObserveruzantı işlevi ekleyin. (I94f38) ViewModelStoreOwnerkampanyasınadefaultViewModelProviderFactoryvedefaultViewModelCreationExtrasuzantıları ekleyin. Bunlar,HasDefaultViewModelProviderFactoryiç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çinrememberViewModelStoreOwnerekleyin. 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çinrememberViewModelStoreProviderekleyin. 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çinViewModelStoreProviderekleyin. 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ı devralanViewModelStoreOwnersarmalayı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
ViewModelStoreOwnersağlamasına izin vermek ve Android'de güvenli bir yedek olarakLocalView'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
toStringuygulamasınıViewModelStoreöğesine ekleyin. (I0a6f4) HasDefaultViewModelProviderFactory.defaultViewModelProviderFactoryiç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çinViewModel.onClearedyöntemine@EmptySuperekleyin. (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
rememberLifecycleOwnercomposable'ı 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ıRESUMEDyapmak isteyen birHorizontalPagerveya 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-navigation3yapısı, Navigation3 için önceden oluşturulmuş bir entegrasyon sağlar. Bu sayede,rememberViewModelStoreNavEntryDecorator()API'yi kullanarakViewModelö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 } } }CreationExtrasiç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.savediçinde null değer alabilen türler için yerel destek ekleyerek null değer alabilen özelliklerin kaydedilmesini ve geri yüklenmesini basitleştirir.SavedStateHandlemarkayı@VisibleForTestingolarak 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,ViewModelStoreNavEntryDecoratorDefaultsolarak yeniden adlandırıldı. (I6d27b, b/444447434)
Hata Düzeltmeleri
- Sahip,
Lifeycle.State.CREATEDdurumuna geçmeden önce birLifecycle.Event.ON_DESTROYetkinliği alırsarememberLifecycleOwnerartı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 birViewModelStoreNavEntryDecoratorDefaultnesnesinin parçasıdır. (Ia1f23, b/444447434)ViewModelStoreNavEntryDecorator,NavEntryDecoratoriçin bir fabrika olarak işlevini daha iyi yansıtmak amacıyla bir işlevden sınıfa yeniden düzenlendi ve dekoratörünshouldRemoveViewModelStoreparametresi, bu geri çağırmanın yalnızcabackStack'ten bir giriş çıkarıldığında çağrıldığını netleştirmek içinremoveViewModelStoreOnPopolarak 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
LifecycleOwnercomposable'ınırememberLifecycleOwnerolarak yeniden düzenleyin. İşlev artık doğrudanLifecycleOwnerdeğerini döndürür. Bu sahibi bir alt oluşturmaya sağlamak içinCompositionLocalProviderkullanı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
LifecycleOwnercomposable'ı artık bağımsız bir kök yaşam döngüsü oluşturabilir.parent = nullaçıkça ayarlandığında yeni yaşam döngüsü, herhangi bir ana makineden (ör.Activity,FragmentveyaNavBackStackEntry) 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
LifecycleOwnercomposable'ındaparentLifecycleOwnerparametresiparentolarak yeniden adlandırıldı. (I080bc)
Hata Düzeltmeleri
LifecycleOwnercomposable'ı artık imha edildiğinde yaşam döngüsünü doğru şekildeDESTROYEDdurumuna 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ı
LifecycleOwnersı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
LifecycleOwnercomposable'ı 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
CreationExtrasiçin daha kullanışlı ve deyimsel bir Kotlin API'si sağlayan bir oluşturucu fabrika işlevi ekleyin. (Iab2bd)SavedStateHandle.savediç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)SavedStateHandlemarkayı@VisibleForTestingolarak 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
*-composeyapı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
androidx.annotation, 1.9.1 sürümüne güncellendi (Ic9e4f, b/397701294)
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).
*-composeyapı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
- Lifecycle artık yeni KMP hedefleri için destek sağlamak üzere Annotation
1.9.1'a bağlıdır (Ic9e4f, b/397701294).
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)'inSavedStateHandle.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çinViewModelScenariosınıfı sağlayan yeni birandroidx.lifecycle:lifecycle-viewmodel-testingKMP yapısı kullanıma sunuldu. Bu yapı,onClearedveSavedStateHandle'yı desteklemenin yanı sırarecreate()aracılığıyla işlem sonlandırma ve yeniden oluşturma testlerini de destekler.MutableStateFlowdöndürmek içinSavedStateHandleöğesinegetMutableStateFlowekleyin. Bu yeni işlev anahtara özeldir vegetLiveDataile kullanılamaz. Aynı duruma erişmek için her ikisini de kullanmaya çalışırsanız bir istisna oluşturulur.CreationExtrasartık Kotlin'de içeriğin deyimsel olarak değiştirilmesini sağlayan harita benzeri operatör aşırı yüklemeleri içeriyor.CreationExtrasilein,+=ve+'nin kullanılmasına olanak tanır.
KotlinX Serileştirme Desteği
SavedState
1.3.0'e eklenen KotlinX Serialization desteğiyle,@SerializablesınıflarınıSavedStateHandleiç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 olansaved'i kullanıma sunduk.savedtemsilcisinin geç yüklenen bir temsilci olduğunu ve erişilene kadarinitlambda'yı çağırmayacağını veyaSavedStateHandleiç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-testingmodülü artıkTestLifecycleOwnergibi API'ler de dahil olmak üzere KMP ile uyumludur.lifecycle-viewmodel-savedstatemodülü artıkSavedStateHandlegibi API'ler de dahil olmak üzere KMP ile uyumludur.androidx.compose.ui.platform.LocalLifecycleOwnerartık ortak kaynak grubunda kullanılabilir.NewInstanceFactoryartık JVM masaüstü ve Android hedeflerinde kullanılabilir.
Davranış Değişiklikleri
Lifecycle.DESTROYEDdurumu nihai bir durumdur veLifecycleöğesini bu durumdan başka bir duruma taşıma girişimiIllegalStateExceptionile sonuçlanır.SavedStateHandleartık döndürülenBundledeğerinin boş olduğuSavedStateProvider.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çinandroid.experimental.lint.versionkullanı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 Composeartık Compose Runtime 1.7.1 ve sonraki sürümlerle aynı Kotlin Çoklu Platform kurulumunu kullanıyor.-desktopyapıları kaldırıldı,-jvmStubsve-linuxx64Stubsyapı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 Composeartı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@MainThreadek açıklamasını ekleyin. (I7e8dd, b/397736115) SavedState*DelegatesdosyasınıSavedState*Delegateolarak 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()temsilcilerineSavedStateConfigparametresi 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-composekonumundansavedstate-composekonumuna 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çincurrentStateAsalue().valuekullanmanı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çinMutableStateSerializerekleyin. (Idfc48, b/378895074)
API Değişiklikleri
- Aşırı yüklenmiş
SavedStateHandle.saved()temsilci işlevlerini varsayılan parametrelerle değiştirme (Icd1c1) AbstractSavedStateViewModelFactory, herViewModeliçin birSavedStateHandleoluşturarak gereksiz ek yük oluşturduğundan desteği sonlandırıldı. Daha verimliViewModeloluşturma içinCreationExtras.createSavedStateHandleileViewModelProvider.Factorykullanı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
ViewModelve tüm ilişkili bileşenleri yeniden oluşturan bir sistem işlemi sonlandırmayı simüle etmek içinViewModelScenario.recreateekleyin. (Id6a69, b/381063087) - İlgili
findViewTreeAPI'leri aracılığıyla alınanLifecycleOwnerveViewModelStoreOwnerö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 veyaViewTree.setViewTreeDisjointParentadresindeki belgelere bakın. (I800f4)
API Değişiklikleri
- Adlandırmaları ve paket organizasyonunu
SavedStateRegistryOwnerDelegateile 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.onClearednumaralı 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 SavedStateartık KMP ile uyumludur. Bu sayede, ortak koddaSavedStateHandlekullanabilirsiniz. (Ib6394, b/334076622)
KotlinX Serileştirme Desteği
SavedState
1.3.0-alpha05'e eklenen KotlinX Serialization desteğiyle,@SerializablesınıflarınıSavedStateHandleiç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 olansaved'i kullanıma sunduk.savedtemsilcisinin geç yüklenen bir temsilci olduğunu ve erişilene kadarinitlambda'yı çağırmayacağını veyaSavedStateHandleiç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
MutableStateFlowdöndürmek içinSavedStateHandleöğesinegetMutableStateFlowekleyin. Bu yeni işlev anahtara özeldir vegetLiveDataile 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.DESTROYEDdurumu nihai bir durumdur veLifecycleöğesini bu durumdan başka bir duruma taşıma girişimiIllegalStateExceptionile sonuçlanır. (I116c4, b/370577987)SavedStateHandleartık döndürülenBundledeğerinin boş olduğuSavedStateProvider.saveState()değerlerini içermiyor. (I910b5, b/370577987)
Hata Düzeltmeleri
Lifecycle.eventFlow,LifecycleDESTROYEDolduğ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-savedstatemodülü, gelecekteki bir sürümde ortak kaynak grubundaSavedStateHandlegibi 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
- Lifecycle
2.8.6:NullSafeMutableLiveDataLint hatası, akıllı yayınlar için daha iyi destek sunarak yanlış pozitifleri önler. (85fed6, b/181042665)
Bağımlılık Güncellemeleri
- Lifecycle
2.8.6: Lifecycle Runtime Compose artık Compose Runtime1.7.1'a bağlıdır. - Lifecycle Runtime artık ProfileInstaller
1.4.0'a bağlıdır.
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
- Yaşam döngüsü
2.8.5: Karartmaya izin vermek içinandroidx.lifecycle.ReportFragmentProGuard kurallarını güncelleyin . (ff898e1)
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-testingartık KMP ile uyumludur. (Iea41e)linuxArm64Kotlin çoklu platform hedefi için destek eklendi (I139d3, b/338268719)
Yeni özellikler
onCleared(tüm platformlar) veSavedStateHandle(yalnızca Android) desteğiyle ViewModel'leri ayrı ayrı test etmek içinViewModelScenariosınıfı sağlayan yeni birandroidx.lifecycle:lifecycle-viewmodel-testingKMP yapısı kullanıma sunuldu. (337f68d, c9b3409, 9799a95c, b/264602919)ViewModelProviderileViewModeloluşturma işlemi artık iş parçacığı açısından güvenlidir.@MainThreadek açıklamaları kaldırıldı. (Ifd978, b/237006831)
API Değişiklikleri
- Anonim
CreationExtras.Keynesnelerinin oluşturulmasını basitleştirmek içinCreationExtras.Key()fabrika işlevini ekleyin. (I970ee) CreationExtrasartık Kotlin'de içeriğin deyimsel olarak değiştirilmesini sağlayan harita benzeri operatör aşırı yüklemeleri içeriyor.CreationExtrasilein,+=ve+'nin kullanılmasına olanak tanır. (Ib4353)CreationExtrasartıkequals,hashCodevetoStringyöntemlerini uyguluyor. (Ib4353)NewInstanceFactoryartı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.LocalLifecycleOwnerartık ortak kaynak grubunda (KMP) kullanılabilir. (6a3f5b3)lifecycle-runtime-compose:desktopyapı kaldırıldı,-jvmStubsve-linuxx64Stubsyapı 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
NullSafeMutableLiveDataLint hatası, akıllı yayınlar için daha iyi destek sunarak yanlış pozitifleri önler. (85fed6, b/181042665)
Bağımlılık Güncellemeleri
- Lifecycle Runtime Compose artık Compose Runtime
1.7.1'a bağlıdır.
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.ReportFragmentProGuard kurallarını güncelleyin . (ff898e1)
Harici Katkı
SavedStateHandle.saveableuzantı 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ışınLiveDataü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*Effecttamamlanması artık idempotenttir (ör.onStopOrDispose, Lifecycle durdurulduğu için çağrıldıysa Lifecycle tekrarSTARTEDdeğ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 presenthataları 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,compileOnlyLifecycle 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-composeartık yalnızcacompose-runtimeile ortak bir bağımlılığa sahip.compose-uiile ortak bağımlılığı kaldırıldı. Android yapısı, uyumluluk içincompose-uideğerini korur. (aosp/3079334, b/339562627)ViewModel'ın özellik temsilcilerini kullanansaveableentegrasyonu, 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ıSavedStateHandledeğ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ündenlifecycle-runtime-composekonumuna taşındı.lifecycle-runtime-composeyapısı artıkdropUnlessResumedvedropUnlessStartedAPI'lerini içeriyor. Bu API'ler,LifecycleOwnerbelirli birLifecycle.Statedeğ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.viewModelScopeartık geçersiz kılınabilir bir oluşturucu parametresidir. Bu sayede kendi dağıtıcınızı veSupervisorJob()öğenizi ekleyebilir veyarunTestiçinde bulunanbackgroundScopeöğ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ıkCloseableyerineAutoClosablekullanıyor. ArtıkgetCloseable()aracılığıyla alınmalarına olanak tanıyankeyileAutoCloseablenesneleri eklemeyi destekliyor.LifecycleStartEffectveLifecycleResumeEffectanahtar olmadan çağrıldığında artık hata veriyor. Bu API'lerin yansıttığıDisposableEffectAPI'si de aynı kuralı uyguluyor.LiveDataReactiveStreams.toPublisher(lifecycleOwner, liveData),LiveData.toPublisher(lifecycleOwner)lehine kullanımdan kaldırıldı.lifecycle-livedata-core-ktxKotlin uzantılarılifecycle-livedata-coremodü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'yicommon'e taşır ve Android'e ek olarak jvm ve iOS'i destekler.lifecycle-runtime, çoğu API'yicommon'e taşır ve Android'e ek olarak jvm ve iOS'i destekler.lifecycle-runtime-ktxartık boş ve tüm API'lerlifecycle-runtimepaketine taşındı.lifecycle-runtime-compose, tüm API'lericommonkonumuna taşır veandroidx.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 yerineViewModelProvider.create()yöntemleri kullanılır.ViewModelProvider.NewInstanceFactoryveViewModelProvider.AndroidViewModelFactoryyalnızca Android'de kullanılabilir.- Özel fabrikaların
ViewModelProvider.Factorysınıfından genişletilmesi veCreationExtrasalancreateyöntemini veyaviewModelFactoryKotlin DSL'yi kullanması önerilir.
- Özel fabrikaların
- JVM dışı platformlarda özel bir fabrika olmadan
ViewModelProviderkullanılmasıUnsupportedOperationExceptionhatası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'yicommon'e taşır ve Android'e ek olarak jvm ve iOS'i destekler.lifecycle-viewmodel-ktxartık boş ve tüm API'lerlifecycle-viewmodelpaketine taşındı.lifecycle-viewmodel-compose, tüm API'lericommonkonumuna taşır veandroidx.compose'nin çoklu platform desteğiyle eşleşen bir Android yapısı sunar.
Davranış Değişiklikleri
InitializerViewModelFactory(viewModelFactoryoluşturucu işlevi dahil), aynıclazz: KClass<VM : ViewModel>değerine sahip birinitializerzaten eklenmişse artıkIllegalArgumentExceptionhatası verecek. (Ic3a36)
Bilinen Sorunlar
lifecycle-*:2.8.0için minimum Compose sürümü 1.7.0-alpha05 (b/336842920) gereklidir.
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-commonsınıfları için Baseline Profile'ın düzgün şekilde paketlenmemesine neden olan sorun düzeltildi. Bunlar artıklifecycle-runtimeAAR'da paketlenir. (aosp/3038274, b/322382422)- Bir ViewModel'e eklenen
AutoCloseableörneklerinin temizlenme şeklinde istenmeyen bir sıralama değişikliği düzeltildi. ÖncekiaddCloseable(String, AutoCloseable), ardındanaddClosable(AutoCloseable)ve son olarakonCleared()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-composeyapısı artık Kotlin Multiplatform ile uyumludur. Kodunucommonkonumuna taşır veandroidx.composeiç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-composeyapısı artık Kotlin Multiplatform ile uyumludur. Kodunucommon'e taşır veandroidx.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 ComposableviewModelyöntemi artıkjava.lang.Class'nin yanı sıraKClassdeğ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-composeyapı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.viewModelScopeartık geçersiz kılınabilir bir oluşturucu parametresidir. Bu sayede kendi dağıtıcınızı veSupervisorJob()öğenizi ekleyebilir veyarunTestiçinde bulunanbackgroundScopeöğ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 yerineViewModelProvider.create()yöntemleri kullanılır.ViewModelProvider.NewInstanceFactoryveViewModelProvider.AndroidViewModelFactoryyalnızca Android'de kullanılabilir.- Özel fabrikaların
ViewModelProvider.Factorysınıfından genişletilmesi veCreationExtrasalancreateyöntemini veyaviewModelFactoryKotlin DSL'yi kullanması önerilir.
- Özel fabrikaların
- JVM dışı platformlarda özel bir fabrika olmadan
ViewModelProviderkullanılmasıUnsupportedOperationExceptionhatası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(viewModelFactoryoluşturucu işlevi dahil), aynıclazz: KClass<VM : ViewModel>değerine sahip birinitializerzaten eklenmişse artıkIllegalArgumentExceptionhatası verecek. (Ic3a36)
Hata Düzeltmeleri
ViewModel.getCloseableartık yinelenen anahtarları işler:keyile ilişkilendirilmiş birAutoCloseablekaynağı varsa eski kaynak hemen değiştirilir ve kapatılır. (Ibeb67)ViewModelöğesininviewModelScopeö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, belirtilenLifecycle.Statedeğerinin altına düştükten sonra bile gerçekleşen tıklama veya diğer etkinlikleri bırakmanıza olanak tanıyandropUnlessResumedvedropUnlessStartedAPI'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
ViewModelartık Kotlin'de yazılmıştır (I16f26, b/214568825)lifecycle-viewmodel-ktxKotlin uzantıları artık temel yaşam döngüsü modülüne taşındı. (Id787b, b/274800183)lifecycle-runtime-ktxKotlin uzantıları artık temel yaşam döngüsü modülüne taşındı. (Ic3686, b/274800183)lifecycle-livedata-core-ktxKotlin 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.EventveLifecycleRegistry'teki temel Lifecycle API'leri artık Kotlin Multiplatform ile uyumlu yapıtlarda sunuluyor. (b/317249252)
API Değişiklikleri
LifecycleStartEffectveLifecycleResumeEffectanahtar olmadan çağrıldığında artık hata veriyor. Bu API'lerin yansıttığıDisposableEffectAPI'si de aynı kuralı uyguluyor. (Ib0e0c, b/323518079)ViewModelartıkCloseableyerineAutoCloseablekullanı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
ViewModelartıkgetCloseable()aracılığıyla alınmalarına olanak tanıyankeyiçerenCloseablenesneleri 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
TestLifecycleOwnerartık, durum değişikliğinin ve tümLifecycleObservergeri çağırmalarının geri dönmeden önce tamamlanmasını sağlayan bir askıya alma işlevisetCurrentState()içeriyor.currentStateözelliğini doğrudan ayarlamaktan farklı olarak bu yöntemrunBlockingkullanmaz. Bu nedenle,runTesttarafından sağlananlar gibi eş yordamlarda güvenle kullanılabilir.mapveswitchMap'ninLiveDatauzantıları artıkdistinctUntilChanged'ün davranışını yansıtıyor.LiveData'de birvalueayarlanmışsa döndürülenLiveData'ninvaluedeğerini doldurmak içinmap/switchMapiş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.LiveDatakaynağından gelen değer güncellemeleri yalnızcaLiveData'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 özelParcelablesı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,getLiveDatavegetStateFlowile ilgili belgelerde bu sınırlama özellikle belirtilmiştir. LifecycleObserverile 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ış@OnLifecycleEventek 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
LifecycleEventObserverkullanmaya alternatif olarak, artıkLifecycle.asFlow()uzantı yöntemi aracılığıylaLifecycle.EventiçinFlowgözlemleyebilirsiniz.- Jetpack Compose kullanıcıları artık
Lifecycle.Eventtabanlı Compose yan etkilerini çalıştırmak içinLifecycleEventEffectkullanabilir.
@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
LifecycleStartEffectveLifecycleResumeEffectkullanabilir. Bu API,DisposableEffectiç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.StateartıkLifecycle.currentStateFlowözelliği aracılığıyla gözlemlenebilir. Bu özellik,valuedeğerinin mevcutLifecycle.Stateolduğu birStateFlowdöndürür. - Jetpack Compose kullanıcıları,
Lifecycle.Statedeğerini doğrudan ComposeStateolarak göstermek içinLifecycle.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 özelParcelablesı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,getLiveDatavegetStateFlowile 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
LifecycleStartEffectveLifecycleResumeEffect,LifecycleOwnerdeğ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-testingartık bir eş yordam içindeykencurrentStatealanını kullanarakTestLifecycleOwneröğesininLifecycle.Statedeğerini ayarlamayı önlemek için yeni bir Lint kontrolü içeriyor. Lint kontrolü artık,Lifecycle.Statedeğerini engellemeden ayarlamaya olanak tanıyan askıya almasetCurrentStateiş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ğiLiveData.switchMapile 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
TestLifecycleOwnerartıksetCurrentState()askıya alma işlevini içeriyor. Bu sayede kullanıcılar,runTesttarafından sağlananlar gibi bir eş yordam içindenTestLifecycleOwnerkullanabilir. (I329de, b/259344129)
API Değişiklikleri
lifecycle-livedata-ktxmodüllerindeki tüm dosyalar analifecycle-livedatamodülüne taşındı. (I10c6f, b/274800183)
Davranış Değişiklikleri
LiveData.map()veLiveData.switchMap()uzantıları artık öncekiLiveDataiçin bir değer ayarlanmışsa döndürülenLiveData'ninvaluedeğerini ayarlayarak Jetpack Compose'da elde edilen LiveData'nın ilk oluşturmada doğru duruma sahip olmasını sağlar. (I91d2b, b/269479952)ViewModeladlı uygulamanınaddCloseable()yöntemi,ViewModelzatenonCleared()çağrısı aldıysaCloseableöğ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ındanSavedStateHandleöğesinin doğru şekilde geri yüklenmemesine, üstSavedStateRegistryöğesinde durum kaydedilmedensave()öğesinin çağrılmasına ve ardından durumun tekrar geri yüklenmesine neden olan sorun düzeltildi. Bu,rememberSaveableile Navigation Compose'unNavHostarası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.StateartıkLifecycle.currentStateFlowaracılığıyla Compose tarafından gözlemlenebilir. Bu,valuedeğerinin geçerliLifecycle.Stateolduğu birStateFlowdöndürür. (Ib212d, b/209684871)Lifecycle.EventartıkLifecycle.asFlow().ileFlowolarak gözlemlenebilir (If2c0f, b/176311030)LifecycleResumeEffectAPI'si, hemLifecycle.Event.ON_RESUMEhem deLifecycle.Event.ON_PAUSEetkinlik geri çağırmalarına göre ComposeSideEffect'leri çalıştırmak için eklendi. (I60386, b/235529345)Lifecycle.Event.ON_STARTveLifecycle.Event.ON_STOPetkinlik geri çağırmalarına göre ComposeSideEffect'leri çalıştırmak içinLifecycleStartEffectAPI'si eklendi. (I5a8d1, b/235529345)Lifecycle.Event'ye dayalı olarak ComposeSideEffect'leri çalıştırmak içinLifecycleEventEffectAPI'si eklendi. (Ic9794, b/235529345)Lifecycle.Stateöğesini doğrudan ComposeStateolarak göstermek içinLifecycle.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 öncekiLiveDataiçin bir değer ayarlanmışsa döndürülenLiveData'ninvaluedeğerini ayarlar. Bu işlem, gözlem davranışını değiştirmez.LiveDatakaynağından güncellenen değerler, yalnızcadistinctUntilChanged()kaynağından döndürülenLiveDatadeğerini gözlemlemeye başladığınızda geçerli olur. (Ib482f)LifecycleObserverile 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()üstSavedStateRegistryöğesinde durum kaydedilmeden çağrıldıysa ve ardından durum tekrar geri yüklendiyse işlem sonlandırmadan sonraSavedStateHandleöğesinin doğru şekilde geri yüklenmemesine neden olan sorun düzeltildi. Bu,rememberSaveableile Navigation Compose'unNavHostarası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
lifecycle-viewmodel-savedstateartık SavedState1.2.1'e bağlıdır. (cd7251)- Yaşam döngüsü artık ProfileInstaller
1.3.0'a bağlıdır. (f9d30b)
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
LiveDataartıkLiveDataüzerinde açık bir değer ayarlanıp ayarlanmadığını gösteren yeni birisInitializedözelliği içeriyor. Bu sayede, hiçbir değer ayarlanmadığı içinnulldöndürenliveData.valueile açık birnulldeğeri arasında ayrım yapabilirsiniz.MediatorLiveDataartık başlangıç değeri ayarlamak için bir kurucu içeriyor.StateFlowveFlowiçincollectAsStateWithLifecycle()'ı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.launchWhenXyöntemleri veLifecycle.whenXyöntemleri kullanımdan kaldırıldı.Lifecycle.repeatOnLifecyclekullanı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öğesininonChangedyö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ızObserversı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,ServiceLifecycleDispatcherveProcessLifecycleOwner
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 öncekiLiveDataiçin bir değer ayarlanmışsa döndürülenLiveData'ninvaluedeğerini ayarlar. Bu işlem, gözlem davranışını değiştirmez.LiveDatakaynağından güncellenen değerler, yalnızcadistinctUntilChanged()kaynağından döndürülenLiveDatadeğ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
LifecycleOwnerartı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 öncekigetLifecycle()işlevini uygulamak yerinelifecycleözelliğini geçersiz kılması gerekir. (I75b4b, b/240298691)ViewModelStoreOwnerartı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 öncekigetViewModelStore()işlevini uygulamak yerineviewModelStoreözelliğini geçersiz kılması gerekir. (I86409, b/240298691)LifecycleOwnerüzerindelifecycleScopealanını sağlayan Kotlin uzantısı,lifecycle-runtime-ktxyerinelifecycle-commonyapısına taşındı. (I41d78, b/240298691)LifecycleüzerindecoroutineScopealanını sağlayan Kotlin uzantısı,lifecycle-runtime-ktxyerinelifecycle-commonyapı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
Transformationsartık Kotlin'de yazılıyor. Bu, Kotlin'de yazılmış ve doğrudanTransformations.mapgibi bir söz dizimi kullanan sınıflar için kaynak uyumsuz bir değişikliktir. Kotlin kodu artık daha önce yalnızcalifecycle-livedata-ktxkullanılırken kullanılabilen Kotlin uzantı yöntemi söz dizimini kullanmalıdır. Java programlama dili kullanılırken bu yöntemlerinandroidx.arch.core.util.Functionyöntemini alan sürümleri kullanımdan kaldırılır ve KotlinFunction1alan sürümlerle değiştirilir. Bu değişiklik, ikili program uyumluluğunu korur. (I8e14f)ViewTreeViewModelStoreOwnerartı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çinandroidx.lifecycle.setViewTreeViewModelStoreOwnerveandroidx.lifecycle.findViewTreeViewModelStoreOwner'ninViewsı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)HasDefaultViewModelProviderFactoryarayü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 yerinedefaultViewModelProviderFactoryvedefaultViewModelCreationExtrasözelliklerini geçersiz kılması gerekir. (Iaed9c, b/240298691)Observerartık Kotlin'de yazılıyor.onChanged()yönteminin parametresi artıkvalueadını kullanıyor. (Iffef2, I4995e, b/240298691)AndroidViewModel,AbstractSavedStateViewModelFactory,LifecycleService,ServiceLifecycleDispatcherveProcessLifecycleOwnerartı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
LiveDataartıkLiveDataüzerinde açık bir değer ayarlanıp ayarlanmadığını gösteren yeni birisInitializedözelliği içeriyor. Bu sayede, hiçbir değer ayarlanmadığı içinnulldöndürenliveData.valueile açık birnulldeğeri arasında ayrım yapabilirsiniz. (Ibd018)
API Değişiklikleri
lifecycle-runtime-composeiçincollectAsStateWithLifecycle()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.launchWhenXyöntemleri veLifecycle.whenXyöntemleri kullanımdan kaldırıldı.Lifecycle.repeatOnLifecyclekullanılması önerilir. (Iafc54, b/248302832)
Kotlin Dönüşümleri
ViewTreeLifecycleOwnerartı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çinandroidx.lifecycle.setViewTreeLifecycleOwnerveandroidx.lifecycle.findViewTreeLifecycleOwner'ninViewsınıfındaki Kotlin uzantı yöntemlerini doğrudan içe aktarmanız ve kullanmanız gerekir. Bu,lifecycle-runtime-ktxiç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)LiveDataReactiveStreamsartık Kotlin'de yazılıyor. Daha öncelifecycle-reactivestreams-ktxiçinde bulunan Kotlin uzantılarılifecycle-reactivestreamsmodü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,LifecycleObserverveViewModelStoreartı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üyleget()çağrılırken artıkClassCastExceptionile 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
MediatorLiveDataartık başlangıç değeri ayarlamak için bir kurucu içeriyor. (Ib6cc5, b/151244085)
Hata Düzeltmeleri
Lifecycleyapı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/242871265FlowLiveData.asFlow(), iş parçacığı güvenliğini ve bağlam korumasını sağlamak için kendiChanneluygulamasını kullanmak yerine artık bircallbackFlowoluşturuyor. (I4a8b2, b/200596935)FlowLiveData'ınasLiveDataişlevi artık yeniLiveDatanesnesini oluştururkenStateFlow'nin ilk değerini koruyacak. (I3f530, b/157380488)- Lifecycle
2.5.1:AndroidViewModelFactoryiçin özel uygulamalar, artıkLifecycle2.4 ve sonraki sürümlerde durum bilgisi olan kurucu kullanılırkencreate(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
collectAsStateWithLifecycleiçinStateFlowveFlowü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 birLifecycle.Stateolduğunda yeni emisyon, eyaletin değerine ayarlanır. Yaşam döngüsüLifecycle.Statealtı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
AndroidViewModelFactoryiçin özel uygulamalar,Lifecycle2.4+ ile durum bilgisi olanAndroidViewModelFactoryoluşturucuyu kullanırken artıkcreate(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
SavedStateHandleartıkLiveDatakullanımına alternatif olarak değer değişikliklerini izlemek için KotlinStateFlowdöndüren birgetStateFlow()API sunuyor.ViewModel CreationExtras: Özel bir
ViewModelProvider.FactoryyazarkenApplicationveyaSavedStateHandle'ya erişmek için artıkAndroidViewModelFactoryveyaAbstractSavedStateViewModelFactory'yı genişletmeniz gerekmez. Bunun yerine, bu alanlarcreate'ün yeni aşırı yüklemesi (create(Class<T>, CreationExtras)) aracılığıyla herViewModelProvider.Factoryalt sınıfınaCreationExtrasolarak sağlanır. Bu ekstralar, sırasıyla Activity1.5.0ve Fragment1.5.0kullanı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-viewmodelartıkviewModelFactoryKotlin 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 birViewModelsınıfı için bir tane olmak üzere, birincil veri kaynağı olarakCreationExtraskullanabilirsiniz.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-composeartık özel birViewModelProvider.Factoryoluşturmaya gerek kalmadanViewModelörneği oluşturmak için lambda fabrikası kullanan birviewModel()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-composeyapısı artıkSavedStateHandle.saveableiçinde, bir `ViewModel'inSavedStateHandletarafından desteklenenrememberSaveablebenzeri 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) } }ViewModeltemizlendiğinde kapatılacakViewModel'ye bir veya daha fazlaCloseablenesnesi eklemenize olanak tanıyan biraddCloseable()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
Closeableuygulayan birCoroutineScopeoluşturabilirsiniz:class CloseableCoroutineScope( context: CoroutineContext = SupervisorJob() + Dispatchers.Main.immediate ) : Closeable, CoroutineScope { override val coroutineContext: CoroutineContext = context override fun close() { coroutineContext.cancel() } }Bu, daha sonra
viewModelScopeile aynı kullanım ömrünü korurkenViewModeloluş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öğesiniINITIALIZEDdurumundanDESTROYEDdurumuna taşımaya çalışmak,Lifecycleöğesinin ekli bir gözlemcisi olup olmadığına bakılmaksızın her zamanIllegalStateExceptionhatasına neden olur.LifecycleRegistry,DESTROYEDdurumuna 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(),nullkaynağını gözlemcilere yaymak yerinenullkaynağı iletildiğindeNullPointerExceptionhatası 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
SavedStateHandleiçinde kalıcı hale getirmek için özellik adlarını anahtar olarak kullananSavedStateHandle.saveableözellik temsilcileri eklendi (I8bb86, b/225014345)
Hata Düzeltmeleri
- Birincil olmayan bir alt gezinme sekmesinde bir
NavHostöğesini başka birNavHostöğesinin içine yerleştirmenin, birden fazla eski yığın kullanıldığındaIllegalStateExceptionhatası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
rememberSaveableile eşitlik içinSavedStateHandle.saveableöğesine deneyselMutableStateaşırı yüklemesi ekleyin (I38cfe, b/224565154)
API Değişiklikleri
CreationExtrasartık mühürlü değil, soyut. (Ib8a7a)
Hata Düzeltmeleri
SavedStateHandleControllernedeniyle oluşanIllegalStateException: Already attached to lifecycleOwnerhatası 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-composemodülü artıkSavedStateHandleSaveradlı deneysel bir API sunuyor. Bu API,SavedStateHandleiçindeki değerlerinrememberSaveabletarafı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
SavedStateViewFactoryartıkSavedStateRegistryOwnerile başlatılmış olsa bileCreationExtraskullanı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
SavedStateHandleartıkLiveDatakullanmaya alternatif olarak değer değişikliklerini izlemek için KotlinStateFlowdöndüren birgetStateFlow()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
ViewModeltemizlendiğinde kapatılacak bir veya daha fazlaCloseablenesnesiniViewModel'ye eklemenize olanak tanıyan biraddCloseable()API'si ve yeni bir kurucu aşırı yüklemesi eklendi. Bu işlem,onCleared()içinde manuel çalışma gerektirmez. (I55ea0)lifecycle-viewmodelartık belirliViewModelsınıflarını işlemek için lambda eklemenize olanak tanıyan birInitializerViewModelFactorysunuyor. Bu işlem için birincil veri kaynağı olarakCreationExtraskullanılıyor. (If58fc, b/216687549)lifecycle-viewmodel-composeartık özel birViewModelProvider.Factoryoluşturmaya gerek kalmadanViewModelörneği oluşturmak için lambda fabrikası kullanan birviewModel()API'si sunuyor. (I97fbb, b/216688927)
API Değişiklikleri
- Artık
lifecycle-viewmodel-composeüzerindenCreationExtrasileViewModeloluşturabilirsiniz. (I08887, b/216688927)
Davranış değişiklikleri
Lifecycle.StateöğesiniINITIALIZEDkonumundanDESTROYEDkonumuna taşımaya çalışmak,Lifecycleöğesinin ekli bir gözlemcisi olup olmadığına bakılmaksızın her zamanIllegalStateExceptionhatasına neden olur. (I7c390, b/177924329)LifecycleRegistry,DESTROYEDdurumuna 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
SavedStateHandleveSavedStateViewModelFactory, 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)LiveDataswitchMapiş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@CheckResultile 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öyleceProcessLifecycleInitializer'inStartupExceptionhatası vermesini önleyen düzeltmeler varsayılan olarak kullanılabilir. (Ib01df, b/216490724) - Özel
AndroidViewModelsınıflarında parametreler yanlış sırada olduğunda veViewModeloluşturmaya çalışıldığında artık daha iyi bir hata mesajı gösteriliyor. (I340f7, b/177667711) - Artık uygulama ayarlamadan
AndroidViewModelFactorykullanarakCreationExtrasü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: BuString,ViewModelProvider.get()öğesine ilettiğiniz özel anahtara erişim sağlar.ViewModelProvider.AndroidViewModelFactory.APPLICATION_KEY,Applicationsınıfına erişim sağlar.SavedStateHandleSupport.SAVED_STATE_REGISTRY_OWNER_KEY, bu ViewModel'i oluşturmak için kullanılanSavedStateRegistryOwneröğesine erişim sağlar.SavedStateHandleSupport.VIEW_MODEL_STORE_OWNER_KEY, bu ViewModel'i oluşturmak için kullanılanViewModelStoreOwneröğesine erişim sağlar.SavedStateHandleSupport.DEFAULT_ARGS_KEY,SavedStateHandleoluşturmak için kullanılması gereken bağımsız değişkenlerinBundledeğ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
SavedStateHandleiç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 sonucundaSavedStateHandle, 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-alpha01sürümünden geri taşındı:SavedStateHandleiç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 sonucundaSavedStateHandle, 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-processartık Androidx Startup 1.1.1'e bağlıdır. Bu sürümde,ProcessLifecycleInitializerkullanımınınStartupExceptionhatası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
@OnLifecycleEventdesteği sonlandırıldı. Bunun yerineLifecycleEventObserverveyaDefaultLifecycleObserverkullanılmalıdır.androidx.lifecycle:lifecycle-viewmodel-composekitaplığı eklendi.viewModel()composable veLocalViewModelStoreOwnersağlar.- Kaynakta zarar veren değişiklik:
ViewModelProvider, Kotlin'de yeniden yazıldı.ViewModelProvider.Factory.createyöntemi artık boş değer atanabilir jeneriklere izin vermiyor.
- Kaynakta zarar veren değişiklik:
androidx.lifecycle:lifecycle-runtime-ktxiç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-java8konumundanlifecycle.lifecycle-commonkonumuna 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-commonile değiştirilebilir.lifecycle-viewmodel-ktxuygulamasındaki eş yordam olmayan API,lifecycle-viewmodelmodülüne taşındı.lifecycle-process,ProcessLifecycleOwnerbaşlatmak için artıkandroidx.startupkullanıyor.Daha önce bu işlem
androidx.lifecycle.ProcessLifecycleOwnerInitializertarafından yapılıyordu.Geçmişte işlem yaşam döngüsünü ilk kullanıma hazırlamak için kullanılan
ContentProvidertools: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
@OnLifecycleEventdesteği sonlandırıldı. Bunun yerineLifecycleEventObserverveyaDefaultLifecycleObserverkullanılmalıdır. (I5a8fa)- DefaultLifecycleObserver,
androidx.lifecycle.lifecycle-common-java8konumundanandroidx.lifecycle.lifecycle-commonkonumuna 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-commonile değiştirilebilir. (I021aa) lifecycle-viewmodel-ktxadlı modüldeki eş yordam olmayan API,lifecycle-viewmodelmodülüne taşındı. (I6d5b2)
Harici Katkı
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.createyö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ı
repeatOnLifecyclebelgelerindeki 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-ktxiçinrepeateOnLifecycleöğesininonStart()veyaonResume()içinde yanlış kullanıldığını tespit eden yeni birRepeatOnLifecycleWrongUsagelint kontrolü eklendi. (706078, b/187887400)
API Değişiklikleri
LifecycleOwner.addRepeatingJobAPI'si, yapılandırılmış eşzamanlılığı dikkate alan ve daha kolay anlaşılır olanLifecycle.repeatOnLifecyclelehine kaldırıldı. (I4a3a8)- Diğer
androidx.startup.Initializer'lerin bunları bağımlılık olarak kullanabilmesi içinProcessLifecycleInitializeröğesini herkese açık hale getirin. (I94c31)
Hata Düzeltmeleri
- Alanda değiştiriciler olduğunda
NullSafeMutableLiveDatalint kontrolüyle ilgili bir sorun düzeltildi. (#147, b/183696616) - Jenerik türler kullanılırken
NullSafeMutableLiveDatalint kontrolüyle ilgili başka bir sorun düzeltildi. (#161, b/184830263)
Harici Katkı
NullSafeMutableLiveDatalint kontrolünü iyileştirdiği için maxsav'a teşekkür ederiz. (#147, b/183696616)NullSafeMutableLiveDatalint 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,ProcessLifecycleOwnerbaşlatmak için artıkandroidx.startupkullanıyor.Daha önce bu işlem
androidx.lifecycle.ProcessLifecycleOwnerInitializertarafından yapılıyordu.Geçmişte işlem yaşam döngüsünü ilk kullanıma hazırlamak için kullanılan
ContentProvidertools: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.repeatOnLifecycleAPI'sini kullanarak yukarı akış akışından değerler yayan birFlow.flowWithLifecycleAPI'si eklendi. Bu, yeniLifecycleOwner.addRepeatinJobAPI'ye bir alternatiftir. (I0f4cd)
Hata Düzeltmeleri
- Lifecycle 2.3.1 sürümünden itibaren:
NonNullableMutableLiveDatalint 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ı birViewModelStoreOwneralarakLocalViewModelStoreOwnerdışındaki sahiplerle çalışmayı kolaylaştırıyor. Örneğin, artık belirli bir gezinme grafiğiyle ilişkili ViewModel'i almak içinviewModel(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-beta07sü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-composeveandroidx.navigation:navigation-compose'ninandroidx.compose.compiler:compiler:1.0.0-beta04veandroidx.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.currentartık geçerli oluşturmadaViewModelStoreOwnerolup olmadığını daha iyi belirlemek için null değer alabilenViewModelStoreOwnerdöndürüyor.viewModel()veNavHostgibiViewModelStoreOwnergerektiren API'ler,ViewModelStoreOwnerayarlanmamış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
LocalViewModelStoreOwnerartıkasProvidableCompositionLocal()API'nin yerini alan,CompositionLocalProviderile kullanılabilecekprovidesiş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 veLocalViewModelStoreOwner,androidx.compose.ui.viewinterop'denandroidx.lifecycle.viewmodel.composepaketindeki 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
NonNullableMutableLiveDatalint 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çinsetSavedStateProvider()yöntemini çağırmanıza olanak tanıyarak geç serileştirmeyi destekler.SavedStateHandle, durumunu kaydetmesi istendiğindesaveState()yöntemine geri çağırma yapacak birSavedStateProvidersağ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. LifecycleRegistryartı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 aitLifecycleRegistrynesneleri içinLifecycleRegistry.createUnsafe(...)kullanarak kontrolleri açıkça devre dışı bırakabilirsiniz. Ancak bu durumda, farklı iş parçacıklarından buLifecycleRegistrynesnesine erişildiğinde doğru senkronizasyonun yapıldığından emin olmanız gerekir.
- LifecycleRegistry artık
- Yaşam Döngüsü Durumu ve Etkinlik Yardımcıları:
Stateve geçiş yönü verildiğindeEventoluşturmak içinLifecycle.EventsınıfınadownFrom(State),downTo(State),upFrom(State),upTo(State)statik yardımcı yöntemleri eklendi. Lifecycle'ınEvent'den hemen sonra geçiş yapacağıStatedeğerini sağlayangetTargetState()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 edenLifecycle.withStateAtLeastAPI'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 mevcutwhen*yöntemlerinden farklıdır. (aosp/1326081)ViewTreeAPI'leri: Yeni birViewTreeLifecycleOwner.get(View)veViewTreeViewModelStoreOwner.get(View)API'si, belirli birViewörneği için sırasıylaLifecycleOwnerveViewModelStoreOwneriçeren öğeleri almanıza olanak tanır. Bunu doğru şekilde doldurmak için Activity1.2.0ve Fragment1.3.0ile AppCompat 1.3.0-alpha01 veya sonraki sürümlere yükseltmeniz gerekir.findViewTreeLifecycleOwnervefindViewTreeViewModelStoreOwnerKotlin uzantıları sırasıylalifecycle-runtime-ktxvelifecycle-viewmodel-ktxsürümlerinde kullanılabilir.LiveData.observe()Kotlin uzantısının desteğinin sonlandırılması: Lambda söz dizimini kullanmak için gerekenLiveData.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
SavedStateHandlesınıfınınkeys()yöntemi artık durum kaydedilmeden önce ve sonra tutarlı. Artıkset()vegetLiveData()ile kullanılan anahtarlara ek olarak daha öncesetSavedStateProvider()ile kullanılan anahtarları da içeriyor. (aosp/1517919, b/174713653)
Harici Katkı
- Yaşam döngüsüne duyarlı eş yordamları askıya alan API'ler artık
yield()çağrılarını daha iyi işliyor. Nicklas Ansman Giertz'e teşekkürler. (aosp/1430830, b/168777346)
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
- Kotlin 1.4'ü kullanmak için androidx'i yükseltin (Id6471, b/165307851, b/165300826)
Belgelerdeki Değişiklikler
liveDataoluşturucu veasLiveData()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
NullSafeMutableLiveDataLint 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
Stateve geçiş yönü verildiğindeEventoluşturmak içinLifecycle.EventsınıfınadownFrom(State),downTo(State),upFrom(State),upTo(State)statik yardımcı yöntemleri eklendi. Lifecycle'ınEvent'den hemen sonra geçiş yapacağıStatedeğerini sağlayangetTargetState()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.withStateAtLeastAPI'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 mevcutwhen*yöntemlerinden farklıdır. (aosp/1326081)
Davranış Değişiklikleri
- LifecycleRegistry artık
DESTROYED'i terminal durumu olarak zorunlu kılıyor. (I00887) LifecycleRegistryartı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 aitLifecycleRegistrynesneleri içinLifecycleRegistry.createUnsafe(...)kullanarak kontrolleri açıkça devre dışı bırakabilirsiniz ancak buLifecycleRegistrynesnesine 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
NullSafeMutableLiveDatauygulamasındaki kilitlenme sorunu düzeltildi. (b/159987480)lifecycle-livedata-core-ktx(ve özellikleNullSafeMutableLiveData) ile birlikte gelen Lint kontrolleri içinObsoleteLintCustomCheckdü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
LiveDataartık yeniden giriş durumlarını daha iyi işleyerekonActive()veyaonInactive()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
NonNullableMutableLiveDataLint kontrolündeki kilitlenme sorunu düzeltildi. (b/157294666)NonNullableMutableLiveDataLint kontrolü artık boş olmayan tür parametresine sahip birMutableLiveDataiçinnulldeğ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
SavedStateHandleartık belirli bir anahtar içinsetSavedStateProvider()yöntemini çağırmanıza olanak tanıyarak geç serileştirmeyi destekliyor. Bu yöntem,SavedStateHandle'den durumunu kaydetmesi istendiğindesaveState()için geri çağırma alacak birSavedStateProvidersağlar. (b/155106862)- Yeni bir
ViewTreeViewModelStoreOwner.get(View)API'si, belirli birViewörneği için kapsayıcıViewModelStoreOwneröğesini almanıza olanak tanır. Bunu doğru şekilde doldurmak için Activity1.2.0-alpha05, Fragment1.3.0-alpha05ve AppCompat1.3.0-alpha01sürümlerini yükseltmeniz gerekir.lifecycle-viewmodel-ktxiçinfindViewModelStoreOwner()Kotlin uzantısı eklendi. (aosp/1295522)
Hata Düzeltmeleri
- Lifecycle
2.3.0-alpha01sürümünde yayınlananMutableLiveDataLint kontrollerininlifecycle-livedata-core-ktxyapı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ş birApplicationiletmenize olanak tanıyor. Böylece, hazırda bir bulunmayan veAndroidViewModeldesteğ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 birViewörneği için kapsayıcıLifecycleOwneröğesini almanıza olanak tanır. Bunu doğru şekilde doldurmak için Activity1.2.0-alpha01ve Fragment1.3.0-alpha01sürümlerini yükseltmeniz gerekir.lifecycle-runtime-ktxiçinde birfindViewTreeLifecycleOwnerKotlin uzantısı kullanılabilir. (aosp/1182361, aosp/1182956) - Kotlin'de boş olmayan olarak tanımlanmış bir
MutableLiveDataiçinnulldeğeri ayarlandığında sizi uyaran yeni bir Lint kontrolü eklendi. Bu özellik,livedata-core-ktxveyalivedata-ktxyapı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 birLifecyclesağlayanTestLifecycleOwnersunan yeni birlifecycle-runtime-testingyapısı mevcut. (aosp/1242438)
Hata düzeltmeleri
lifecycle-runtimeyapı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-ktxyapı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ı. Fragment1.2.0kullanırken aynı işlevi elde etmek için yeniViewModelProvider(ViewModelStoreOwner)oluşturucusuna birFragmentveyaFragmentActivityiletebilirsiniz.lifecycle-extensionsYapısının Desteğinin Sonlandırılması: Yukarıda belirtilenViewModelProviders.of()desteğinin sonlandırılmasıyla birlikte, bu sürümdelifecycle-extensionsiç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-extensionsiçin gelecekte2.3.0sürümü olmayacağından,lifecycle-extensionsyerine ihtiyacınız olan belirli Yaşam Döngüsü yapılarına (ör.LifecycleServicekullanıyorsanızlifecycle-serviceveProcessLifecycleOwnerkullanıyorsanızlifecycle-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ışsaLifecycleEventObserverkullanabilirsiniz.
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,ViewModelStoreiçinde depolandığında ve daha sonra varsayılan fabrika ile sorgulandığında ortaya çıkan hata düzeltildi. launchWhenCreatedve benzer yöntemlerdeDispatchers.Main.immediatekullanı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
launchWhenCreatedve ilgili yöntemlerin,Dispatchers.Main.immediateyerineDispatchers.Mainkullanması 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
ProcessLifecycleOwnerve etkinliğinLifecycleOwnersıralamasının başlatıldı ve devam ettirildi durumuna geçmesiyle ilgili bir gerileme düzeltildi. (aosp/1128132) - Lifecycle
2.2.0-alpha05sürümünde ortaya çıkan velifecycle-process'nın2.0.0veya2.1.0sürümü kullanılırkenNullPointerExceptionhatası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,viewModelScopeveliveData'in temel uygulaması artıkDispatchers.MainyerineDispatchers.Main.immediatekullanı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
ViewModelStoreOwneruygulamaları artık varsayılan birViewModelProvider.Factorysağlamak için isteğe bağlı olarakHasDefaultViewModelProviderFactoryuygulayabilir. Bu işlem Activity1.1.0-alpha02, Fragment1.2.0-alpha02ve Navigation2.2.0-alpha01için yapılmıştır. (aosp/1092370, b/135716331)
API değişiklikleri
ViewModelProviders.of()desteği sonlandırıldı. Aynı işlevi elde etmek için yeniViewModelProvider(ViewModelStoreOwner)oluşturucuya birFragmentveyaFragmentActivityiletebilirsiniz. (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,liveDatabloğunun mevcut yayınlanan değerini izleyecek olanLiveDataScope.latestValueile değiştirildi.liveDataoluşturucuya,timeoutparametresiniDurationtü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.
ViewModelsınıflarınızın kaydedilen duruma erişmesine ve katkıda bulunmasına olanak tanır. Bu nesne,ViewModelsınıfının oluşturucusunda alınabilir ve Fragments ile AppCompatActivity tarafından varsayılan olarak sağlanan fabrikalar,SavedStateHandlenesnesini otomatik olarak ekler. - AbstractSavedStateViewModelFactory eklendi.
ViewModeliçin özel fabrikalar oluşturmanıza ve bunlaraSavedStateHandleeriş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ğindeIllegalStateExceptionhatasının oluşmasına neden olan sorun düzeltildi. (b/139093676)AbstractSavedStateViewModelFactorykullanılırken yaşanan birIllegalStateExceptiondü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
SavedStateViewModelFactoryartıkAbstractSavedStateViewModelFactorysınıfını genişletmiyor veSavedStateHandleyalnı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
lifecycle-viewmodel-savedstateartıkfragment'e bağlı değil ve ilgiliSavedStateViewModelFactory(Fragment)veSavedStateViewModelFactory(FragmentActivity)oluşturucular kaldırıldı. Bunun yerine, Activity1.1.0-alpha02, Fragment1.2.0-alpha02ve Navigation2.2.0-alpha01için varsayılan fabrika artıkSavedStateViewModelFactory. (b/135716331)
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,SavedStateViewModelFactoryolarak yeniden adlandırıldı.AbstractSavedStateVMFactory,AbstractSavedStateViewModelFactoryolarak 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 factorySavedStateVMFactoryişlevini kullanırsınız ve ViewModel'inizde parametre olarakSavedStateHandlenesnesini 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
LifecycleEventObservereklendi. Gizli birGenericLifecycleObserversınıfı yerine herkese açık bir API'dir. LiveData.observeyöntemleri veTransformations.*yöntemleri için ktx uzantıları eklendi.- Kaynak
LiveDatadeğeri değiştirilene kadar değer yaymayan yeni bir LiveData nesnesi oluşturanTransformations.distinctUntilChangedeklendi. ViewModel.viewModelScopeuzantı ö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
liveDatauzantı işlevleri, özellik yetkilendirmesiyleViewModelbaş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()veby activityViewModels()'nın temelindeki API, yalnızcaViewModelStoreOwneryerine doğrudanViewModelStoredestekleyecek ş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.KeyedFactorykaldırıldı.ViewModelProvider.Factoryarayüzüne ek olarak ikinci arayüz, Kotlinby 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
LifecycleRegistryartık, desteği sonlandırılansetState()yönteminin yerini alan birsetCurrentState()yöntemi içeriyor. (aosp/880715)
Hata düzeltmeleri
- İçeren
ViewModelStoretemizlendiğinde sahteViewModelö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
LifecycleEventObservereklendi. Gizli birGenericLifecycleObserversınıfı yerine herkese açık bir API'dir. LiveData.observeyöntemleri veTransformations.*yöntemleri için ktx uzantıları eklendi.Transformations.distinctUntilChangedyöntemi eklendi. Kaynak LiveData değeri değiştirilene kadar değer yaymayan yeni birLiveDatanesnesi oluşturur.- ViewModel'lerde eş yordam desteği:
ViewModel.viewModelScopeuzantı özelliği eklendi. createyöntemindekeyveClassalan ViewModel'ler için bir fabrika olanViewModelProvider.KeyedFactoryeklendi.
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.0android.arch.lifecycle:viewmodel:1.1.0
API Değişiklikleri
- Desteği sonlandırılan
LifecycleActivityveLifecycleFragmentartık kaldırıldı. LütfenFragmentActivity,AppCompatActivityveya desteklenenFragmentkullanın. @NonNullek açıklamasıViewModelProvidersveViewModelStoresklasörüne eklendiViewModelProvidersoluşturucusu kullanımdan kaldırıldı. Lütfen doğrudan statik yöntemlerini kullanın.ViewModelProviders.DefaultFactorydesteği sonlandırıldı. LütfenViewModelProvider.AndroidViewModelFactorykullanın.ViewModelveAndroidViewModelörnekleri oluşturmaya uygun statik birFactoryalmak için statikViewModelProvider.AndroidViewModelFactory.getInstance(Application)yöntemi eklendi.