Savedstate
| Son Güncelleme | Kararlı Sürüm | Sürüm Adayı | Beta Sürümü | Alfa Sürümü |
|---|---|---|---|---|
| 18 Kasım 2026 | 1.5.0 | - | - | 1.6.0-alpha06 |
Bağımlılıkları bildirme
SavedState'e 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:
Groovy
dependencies { // Java language implementation implementation "androidx.savedstate:savedstate:1.5.0" // Kotlin implementation "androidx.savedstate:savedstate-ktx:1.5.0" }
Kotlin
dependencies { // Java language implementation implementation("androidx.savedstate:savedstate:1.5.0") // Kotlin implementation("androidx.savedstate:savedstate-ktx:1.5.0") }
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 1.6
Sürüm 1.6.0-alpha06
18 Kasım 2026
androidx.savedstate:savedstate-*:1.6.0-alpha06 yayınlandı. 1.6.0-alpha06 sürümü bu commit'leri içerir.
API Değişiklikleri
LocalSavedStateRegistryOwneröğesinicompositionLocalWithHostDefaultOfveSavedStateRegistryOwnerHostDefaultKeykullanacak ş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. (I6768f)
Sürüm 1.6.0-alpha05
21 Ekim 2026
androidx.savedstate:savedstate-*:1.6.0-alpha05 yayınlandı. 1.6.0-alpha05 sürümü bu kayıtları içerir.
API Değişiklikleri
SaveableStateRegistry,SavedStateHandleveSavedStateRegistyiçin ortak uygulama tabanı olarak kullanılacak yeni birSavedStateContainerAPI'si kullanıma sunuldu. (I1da6d)SavedStateRegistryöğesinden alt kapsayıcı oluşturulmasına izin vermek içinSavedStateRegistryöğesineasContainer(),getOrCreateContainer()eklendi. (Icb709)
Sürüm 1.6.0-alpha04
23 Eylül 2026
androidx.savedstate:savedstate-*:1.6.0-alpha04 yayınlandı. 1.6.0-alpha04 sürümü bu kayıtları içerir.
Hata Düzeltmeleri
androidx.lifecycle:lifecycle-runtimebağımlılığı 2.10.0 olarak güncellendi. Paketlenmiş yaşam döngüsü çalışma zamanı lint kontrollerinin AGP 9.5.0-alpha04 veya sonraki sürümlerle çalışması için bu sürüm gereklidir. (I99bfd, b/556807521)
Sürüm 1.6.0-alpha03
9 Eylül 2026
androidx.savedstate:savedstate-*:1.6.0-alpha03 yayınlandı. 1.6.0-alpha03 sürümü bu commit'leri içerir.
API Değişiklikleri
SavedStateRegistryoluşturucusunda boş ilk duruma izin verildi. (I76006)
Sürüm 1.6.0-alpha02
26 Ağustos 2026
androidx.savedstate:savedstate-*:1.6.0-alpha02 yayınlandı. 1.6.0-alpha02 sürümü bu kayıtları içerir.
API Değişiklikleri
SavedStateRegistrysınıfına herkese açık kurucular eklendi veSavedStateRegistrysınıfınınSavedStateProviderileSavedStateRestorerarayüzlerini uygulaması sağlandı. (I3c696)- Üst düzey
SavedStateProviderarayüzü eklendi. (I20f9d) restoreState(savedState: SavedState?)ile üst düzeySavedStateRestorerarayüzü eklendi ve yayınlanmamışSavedStateRegistry.SavedStateConsumerkaldırıldı. (Idc01d)AutoRecreatedverunOnNextRecreation,SavedStateProviderveSavedStateRestorerlehine kullanımdan kaldırıldı. (Iadc00)SavedStateRegistryüzerindeSavedStateConsumerarayüzünü kullanıma sunma Kayıtlı sağlayıcıların, geri yükleme sırasında veya durum zaten geri yüklenmişse kayıt işleminden hemen sonra geri yüklenen durumu otomatik olarak almasına ve kullanmasına olanak tanır. (I9a378)
Sürüm 1.6.0-alpha01
12 Ağustos 2026
androidx.savedstate:savedstate-*:1.6.0-alpha01 yayınlandı. 1.6.0-alpha01 sürümü bu kayıtları içerir.
Hata Düzeltmeleri
LocalSavedStateRegistryOwnerözelliğini kullanmak için Compose UI 1.8.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. (I16fb0)
Sürüm 1.5
Sürüm 1.5.0
19 Mayıs 2026
androidx.savedstate:savedstate-*:1.5.0 yayınlandı. 1.5.0 sürümü bu commit'leri içerir.
1.4.0 sürümünden sonra yapılan önemli değişiklikler:
SavedStatenesneleri için genel serileştirmeyi etkinleştirerek tüm platformlarda CBOR veya JSON gibi standart biçimler kullanılarak kodlanıp kodlarının çözülmesini sağlayın. (Iafda4, b/425919375)SavedStateWriterveSavedStateReaderiçinputKotlinSerializablevegetKotlinSerializableuzantı işlevleri ekleyerek Kotlin Serializable nesnelerinin anahtarlar kullanılarak doğrudan depolanmasını ve alınmasını sağlayın. Böylece SavedState API'leriyle entegrasyonu kolaylaştırın. (Iba02e)- Özel sahip bileşenleri oluştururken ortak kodları azaltmak için
LifecycleOwner,ViewModelStoreOwnerveSavedStateRegistryOwneriçin fabrika işlevleri ekleyin. (I9682c) rememberSerializableileSnapshotStateSet(mutableStateSetOf()üzerinden oluşturulan) kaydetme ve geri yükleme özelliğini etkinleştirin. Artık özel bir kaydediciye gerek kalmadanrememberSerializableiçindeSnapshotStateSetkullanabilirsiniz. (I9a4ed, b/449498367)
Sürüm 1.5.0-rc01
6 Mayıs 2026
androidx.savedstate:savedstate-*:1.5.0-rc01 yayınlandı. 1.5.0-rc01 sürümü bu kayıtları içerir.
Sürüm 1.5.0-beta01
22 Nisan 2026
androidx.savedstate:savedstate-*:1.5.0-beta01 yayınlandı. 1.5.0-beta01 sürümü bu commit'leri içerir.
Sürüm 1.5.0-alpha02
25 Mart 2026
androidx.savedstate:savedstate-*:1.5.0-alpha02 yayınlandı. 1.5.0-alpha02 sürümü bu kayıtları içerir.
Sürüm 1.5.0-alpha01
11 Mart 2026
androidx.savedstate:savedstate-*:1.5.0-alpha01 yayınlandı. 1.5.0-alpha01 sürümü bu kayıtları içerir.
Yeni özellikler
SavedStatenesneleri için genel serileştirmeyi etkinleştirerek tüm platformlarda CBOR veya JSON gibi standart biçimler kullanılarak kodlanıp kodlarının çözülmesini sağlayın. (Iafda4, b/425919375)
API Değişiklikleri
SavedStateWriterveSavedStateReader'yeputKotlinSerializablevegetKotlinSerializableuzantı işlevleri ekleyerek Kotlin Serializable nesnelerinin anahtarlar kullanılarak doğrudan depolanmasını ve alınmasını sağlayın. BöyleceSavedStateAPI'leriyle entegrasyonu kolaylaştırın. (Iba02e)- Özel sahip bileşenleri oluştururken ortak kodları azaltmak için
LifecycleOwner,ViewModelStoreOwnerveSavedStateRegistryOwneriçin fabrika işlevleri ekleyin. (I9682c) rememberSerializableileSnapshotStateSet(mutableStateSetOf()üzerinden oluşturulan) kaydetme ve geri yükleme özelliğini etkinleştirin. Artık özel bir kaydediciye gerek kalmadanrememberSerializableiçindeSnapshotStateSetkullanabilirsiniz. (I9a4ed, b/449498367)
Sürüm 1.4
Sürüm 1.4.0
5 Kasım 2025
androidx.savedstate:savedstate-*:1.4.0 yayınlandı. 1.4.0 sürümü bu commit'leri içerir.
Sürüm 1.4.0-rc01
22 Ekim 2025
androidx.savedstate:savedstate-*:1.4.0-rc01, 1.4.0-beta01 sürümünden bu yana herhangi bir değişiklik yapılmadan yayınlandı. 1.4.0-rc01 sürümü bu commit'leri içerir.
Sürüm 1.4.0-beta01
8 Ekim 2025
androidx.savedstate:savedstate-*:1.4.0-beta01, son alfa sürümünden bu yana önemli bir değişiklik olmadan yayınlandı. 1.4.0-beta01 sürümü bu kayıtları içerir.
Sürüm 1.4.0-alpha03
27 Ağustos 2025
androidx.savedstate:savedstate-*:1.4.0-alpha03 yayınlandı. 1.4.0-alpha03 sürümü bu commit'leri içerir.
API Değişiklikleri
encodeToSavedStatevedecodeFromSavedStatedillerinde null değer alabilen türler için destek ekleyin. (I79062, b/439527454)- Compose'u 1.9.0 sürümüne güncelleyin. (I2b9de)
Sürüm 1.4.0-alpha02
13 Ağustos 2025
androidx.savedstate:savedstate-*:1.4.0-alpha02 yayınlandı. 1.4.0-alpha02 sürümü bu kayıtları içerir.
Sürüm 1.4.0-alpha01
30 Temmuz 2025
androidx.savedstate:savedstate-*:1.4.0-alpha01 yayınlandı. 1.4.0-alpha01 sürümü bu commit'leri içerir.
API Değişiklikleri
SavedStateRegistryOwner.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. (Ia632, b/421325690)
Sürüm 1.3
Sürüm 1.3.3
17 Eylül 2025
androidx.savedstate:savedstate-*:1.3.3 yayınlandı. 1.3.3 sürümü bu commit'leri içerir.
Hata Düzeltmeleri
- Compose derleyici eklentisinin uygulanmaması nedeniyle
SavedStateKMP yapılarının bozulmasına neden olan bir hata düzeltildi. (Id2290, b/443965665)
Sürüm 1.3.2
27 Ağustos 2025
androidx.savedstate:savedstate-*:1.3.2 yayınlandı. 1.3.2 sürümü bu commit'leri içerir.
Yeni özellikler
- SavedState
*-composeyapısına yeni Kotlin Çoklu Platform (KMP) hedefleri ekleyin. Lifecycle artık şu platformları destekliyor: JVM (Android ve Masaüstü), Yerel (Linux, iOS, watchOS, macOS, MinGW) ve Web (JavaScript, WasmJS). (/Idcf26)
Sürüm 1.3.1
16 Temmuz 2025
androidx.savedstate:savedstate-*:1.3.1 yayınlandı. 1.3.1 sürümü bu commit'leri içerir.
Hata Düzeltmeleri
- Ek açıklamalar tarafından desteklenen tüm KMP hedeflerini
SavedStateyapılarına ekleyin. SavedStateyapılarına yeni Kotlin Çoklu Platform (KMP) hedefleri eklendi.SavedStateartı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. (I062f4).
Sürüm 1.3.0
7 Mayıs 2025
androidx.savedstate:savedstate-*:1.3.0 yayınlandı. 1.3.0 sürümü bu commit'leri içerir.
1.2.0 sürümünden sonra yapılan önemli değişiklikler
LocalSavedStateRegistryOwner, Compose tabanlı yardımcı API'lerinin Compose kullanıcı arayüzü dışında kullanılabilmesi için Compose kullanıcı arayüzünden yenisavedstate-composemodülüne taşındı. Compose kullanıcı arayüzü1.9.0-alpha02ve sonraki sürümler kullanılırken her zaman bu yöntem tercih edilmelidir. Ancak bu yöntem, Compose'un tüm sürümleriyle kullanılabilecek şekilde geriye dönük uyumludur.savedstate-ktxKotlin uzantıları artık temel savedstate modülüne taşındı.findViewTreeSavedStateRegistryOwneraracılığıyla alınanSavedStateRegistryOwnerö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.
Kotlin Multiplatform
SavedStatemodülü artık KMP ile uyumludur. Desteklenen platformlar arasında artık Android, iOS, Linux, Mac ve JVM masaüstü ortamları yer alıyor.KMP'de uygulama durumunu kaydetmek ve geri yüklemek için tutarlı bir yöntem sunmak amacıyla soyutlama olarak
SavedStateopak türünü kullanıma sunun. Kaydedilecek durumu değiştirmek içinSavedStateReaderveSavedStateWriteriçerir. Android'deSavedState,Bundleiçin bir tür takma adıdır. Bu takma ad, ikili uyumluluğu sağlar ve mevcut API'lerin ortak bir kaynak grubuna taşınmasını kolaylaştırır. Diğer platformlardaSavedState, birMap<String, Any>örneğidir.// Create a new SavedState object using the savedState DSL: val savedState = savedState { putInt("currentPage", 1) putString("filter", "favorites") } // Read from a SavedState object val currentPage = savedState.read { getInt("currentPage") } // Edit an existing SavedState object savedState.write { remove("currentPage") }
KotlinX Serileştirme Desteği
SavedStateartık KotlinX Serialization desteği içeriyor.@Serializableile ek açıklama eklenmiş bir sınıfı,encodeToSavedStatevedecodeFromSavedStateyöntemlerini kullanarakSavedStatesınıfına dönüştürebilirsiniz. DöndürülenSavedState, Android'de normal birBundleolupBundlekabul eden tüm API'ler tarafından kullanılabilir.@Serializable data class Person(val firstName: String, val lastName: String) fun main() { val person = Person("John", "Doe") val encoded: SavedState = encodeToSavedState(person) val decoded: Person = decodeFromSavedState(encoded) }Çoğu tür (ör. temel türler) herhangi bir yapılandırma gerekmeden doğrudan desteklenir.
@Serializable(with = ___:class)ile kullanılabilecek ek serileştiriciler,savedstatemodülündekiandroidx.savedstate.serialization.serializerspaketinde vesavedstate-composemodülündekiandroidx.savedstate.compose.serialization.serializerspaketinde bulunabilir.Ayrıca,
@Serializablesınıflarını birSavedStateRegistryOwneriçinde (ör.ComponentActivity,Fragmentvb.) depolamayı kolaylaştırmak ve bu sınıfların işlem sonlandırma ve yeniden oluşturma sırasında otomatik olarak geri yüklenmesini sağlamak için geç yüklenen bir özellik temsilcisi olansaved'i de ekledik.savedtemsilcisinin geç yüklenen bir temsilci olduğunu ve erişilene kadarinitlambda'yı çağırmayacağını veyaSavedStateRegistryiçine hiçbir şey kaydetmeyeceğini unutmayın.@Serializable data class Person(val firstName: String, val lastName: String) class MyActivity : ComponentActivity() { var person by saved { Person("John", "Doe") } override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) this.person = Person("Jane", "Doe") } }Lifecycle
2.9.0'e eklenenSavedStateHandleiçin benzer birsavedözellik temsilcisi vardır.
Sürüm 1.3.0-rc01
23 Nisan 2025
androidx.savedstate:savedstate-*:1.3.0-rc01 yayınlandı. 1.3.0-rc01 sürümü bu kayıtları içerir.
Sürüm 1.3.0-beta01
9 Nisan 2025
androidx.savedstate:savedstate-*:1.3.0-beta01 yayınlandı. 1.3.0-beta01 sürümü bu kayıtları içerir.
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)
Sürüm 1.3.0-alpha11
26 Mart 2025
androidx.savedstate:savedstate-*:1.3.0-alpha11, herkese açık önemli bir değişiklik olmadan yayınlandı. 1.3.0-alpha11 sürümü bu kayıtları içerir.
Sürüm 1.3.0-alpha10
12 Mart 2025
androidx.savedstate:savedstate-*:1.3.0-alpha10 yayınlandı. 1.3.0-alpha10 sürümü bu kayıtları içerir.
Yeni özellikler
SavedStateReaderiçindegetkoleksiyonları için somutlaştırılmamış yöntem varyantları eklendi. (I0b641, b/399820614)SavedStateConfigurationöğesineencodeDefaultseklenerek varsayılan değerlere sahip özelliklerin kodlanıp kodlanmayacağının özelleştirilmesi sağlandı. (I893cc, b/395104517)mutableStateMapOfiçinSnapshotStateMapSerializerekleyin. (Ie6f19, b/378895074)mutableStateListOfiçinSnapshotStateListSerializerekleyin. (I4d888, b/378895074)SavedStateReader.getvaryant içingetOrNullalternatif yöntem ekleyin. Bu yöntemler, ilkel değerleri otomatik olarak kutular. (I6228c, b/399820614)
API Değişiklikleri
getOrElse,SavedStateReaderöğesinden kaldırılıp yerinegetOrNull() ?: else()getirildi. (I87317, b/399820614)inlinedeğiştiricisiniSavedStateReaderveSavedStateWriteryöntemlerinden kaldırın. (If2a02, b/399820614)- Android'e özgü yerleşik liste ve dizi serileştiriciler, herkese açık API'den kaldırıldı (Ida293).
SparseParcelableArraySerializeryerineSparseArraySerializerkullanın (I91de8)- Değer türü, dönüş türüyle eşleşmediğinde hata vererek tüm
SavedStateReader.getöğelerinin tutarlı bir şekilde davranmasını sağlayın (I78c4a, b/399317598). SavedState*DelegatesdosyasınıSavedState*Delegateolarak yeniden adlandırın. (I8589b, b/399629301)SavedStateConfigdosyasınıSavedStateConfigurationolarak yeniden adlandırın. (I043a5, b/399629301)
Sürüm 1.3.0-alpha09
26 Şubat 2025
androidx.savedstate:savedstate-*:1.3.0-alpha09 yayınlandı. 1.3.0-alpha09 sürümü bu kayıtları içerir.
Yeni özellikler
- Yerleşik türler için yedek ekleyerek
Bundletarafından desteklenen tüm türlerin varsayılan olarakencodeAsSavedState/decodeFromSavedStateile veya@Serializablesınıflarındaki özellikler için@Contextualek açıklaması aracılığıyla kullanılabilmesini sağlayın. (Ic01d2) SavedStateConfigüzerindeclassDiscriminatorveclassDiscriminatorModedesteği ekleyin. (I69b66, b/395104517)
API Değişiklikleri
saved()temsilcilerineSavedStateConfigparametresi ekleyin (I39b3a)- Yerleşik serileştiricileri tekil nesneler yapar (Ifeee4)
SavedStateConfigözellikleri artık herkese açık olduğundan diğer modüller bu yapılandırmaları kullanabilir. (Ie5f49, b/378897438)MutableStateFlowSerializerveMutableStateSerializeriçin@Serializer(with = ...)desteği (I90953)contentDeepToStringöğesiniSavedStateReaderlistesine ekle (I14d10)
Sürüm 1.3.0-alpha08
12 Şubat 2025
androidx.savedstate:savedstate-*:1.3.0-alpha08 yayınlandı. 1.3.0-alpha08 sürümü bu kayıtları içerir.
Yeni özellikler
MutableStateSerializer,lifecycle-viewmodel-composeyerinesavedstate-composekonumuna taşındı. Böylece SavedState Serialization API'lerini Compose'unMutableStateözelliğiyle kullanabilirsiniz. (I4f690, b/378895074)
API Değişiklikleri
- Mevcut bir
SavedStateöğesindenSavedStateoluşturmak için bir fabrika işlevi ekleyin. (I39f9a) androidx.savedstateiçinArray<SavedState>veList<SavedState>desteği eklendi. (Idd8a5)- SavedState kodlama/kod çözme işlemine
SavedStateConfigisteğe bağlı parametresi eklendi (I6c4c0)
Sürüm 1.3.0-alpha07
29 Ocak 2025
androidx.savedstate:savedstate-*:1.3.0-alpha07 yayınlandı. 1.3.0-alpha07 sürümü bu kayıtları içerir.
Yeni özellikler
kotlinx.coroutines.flow.MutableStateFlowöğesini serileştirmek içinMutableStateFlowSerializerekleyin. (I6a892, b/378895070)
API Değişiklikleri
- Aşırı yüklenmiş
SavedStateRegistryOwner.saved()temsilci işlevlerini varsayılan parametrelerle değiştirme (Icd1c1) JavaSerializableSerializerveParcelableSerializersoyut yapın (I268f6)T : CharSequenceadlı genel öğeyiCharSequenceSerializer(Ib40bd) adlı gruptan kaldırın
Sürüm 1.3.0-alpha06
11 Aralık 2024
androidx.savedstate:savedstate-*:1.3.0-alpha06 yayınlandı. 1.3.0-alpha06 sürümü bu kayıtları içerir.
Yeni özellikler
SavedStateKMP artık şunları destekliyor:IBinder,Size,SizeF,Array<Parcelable>,SparseArray<Parcelable>ve Serializable (Android). (I1ba94, b/334076622)- Sınıfınızdaki ilgili alanı
@Serializable(with = ParcelableSerializer::class)ile işaretleyerek Bundle tarafından desteklenen Java ve Android türlerini kodlamak/kodunu çözmek için kullanılabilecekKSerializerörnekleri ekleyin. (I8c10f, I28caf, b/376026712) findViewTreeSavedStateRegistryOwneraracılığıyla alınanSavedStateRegistryOwnerö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. (Iccb33)
API Değişiklikleri
- Adlandırmaları ve paket organizasyonunu
SavedStateRegistryOwnerDelegateile daha tutarlı hale getirin (I8c135, b/376026744)
Sürüm 1.3.0-alpha05
13 Kasım 2024
androidx.savedstate:savedstate-*:1.3.0-alpha05 yayınlandı. 1.3.0-alpha05 sürümü bu commit'leri içerir.
KotlinX Serileştirme Desteği
SavedStateartık KotlinX Serialization desteği içeriyor.@Serializableile ek açıklama eklenmiş bir sınıfı,encodeToSavedStatevedecodeFromSavedStateyöntemlerini kullanarakSavedStatesınıfına dönüştürebilirsiniz. DöndürülenSavedState, Android'de normal birBundleolupBundlekabul eden tüm API'ler tarafından kullanılabilir. (I6f59f, b/374102924)@Serializable data class Person(val firstName: String, val lastName: String) fun main() { val person = Person("John", "Doe") val encoded: SavedState = encodeToSavedState(person) val decoded: Person = decodeFromSavedState(encoded) }Ayrıca,
@Serializablesınıflarını birSavedStateRegistryOwneriçinde (ör.ComponentActivity,Fragmentvb.) depolamayı kolaylaştırmak ve bu sınıfların işlem sonlandırma ve yeniden oluşturma sırasında otomatik olarak geri yüklenmesini sağlamak için geç yüklenen bir özellik temsilcisi olansaved'i de ekledik.savedtemsilcisinin geç yüklenen bir temsilci olduğunu ve erişilene kadarinitlambda'yı çağırmayacağını veyaSavedStateRegistryiçine hiçbir şey kaydetmeyeceğini unutmayın. (I66739, b/376027806)@Serializable data class Person(val firstName: String, val lastName: String) class MyActivity : ComponentActivity() { var person by saved { Person("John", "Doe") } override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) this.person = Person("Jane", "Doe") } }Lifecycle
2.9.0-alpha07'e eklenenSavedStateHandleiçin benzer birsavedözellik temsilcisi vardır.
API Değişiklikleri
toMapöğesiniSavedStateöğesine ekleyerek herhangi birSavedStateöğesinin normal birMapöğesine dönüştürülmesine olanak tanır (yüzeysel kopya). (I487b9, b/334076622)SavedStateKMP artık dizileri destekliyor. (Ic0552, b/334076622)
Sürüm 1.3.0-alpha04
30 Ekim 2024
androidx.savedstate:savedstate-*:1.3.0-alpha04 yayınlandı. 1.3.0-alpha04 sürümü bu commit'leri içerir.
API Değişiklikleri
- SavedState KMP artık Char'ı destekliyor. (I9ac2f, b/334076622)
- SavedState KMP'ye
putNullveisNullekleyin. (Iea71d, b/334076622) - İlk
Map<String, Any>değerini destekleyen eksavedStatefabrika parametreleri ekleyin (I9b37d, b/334076622) - SavedState KMP artık
contentDeepEqualskarşılaştırmasını destekliyor. (Ia515c, b/334076622) - SavedState KMP artık Long'u destekliyor. (I4c180, b/334076622)
Sürüm 1.3.0-alpha03
16 Ekim 2024
androidx.savedstate:savedstate-*:1.3.0-alpha03, önemli bir değişiklik olmadan yayınlandı. 1.3.0-alpha03 sürümü bu kayıtları içerir.
Sürüm 1.3.0-alpha02
2 Ekim 2024
androidx.savedstate:savedstate-*:1.3.0-alpha02 yayınlandı. 1.3.0-alpha02 sürümü bu kayıtları içerir.
Kotlin Multiplatform
SavedStatemodülü artık KMP ile uyumludur. Desteklenen platformlar arasında artık Android, iOS, Linux, Mac ve JVM masaüstü ortamları yer alıyor. (I26305, b/334076622)
Yeni özellikler
- KMP'de uygulama durumunu kaydetmek ve geri yüklemek için tutarlı bir yöntem sunmak amacıyla soyutlama olarak
SavedStateopak türünü kullanıma sunun. Kaydedilecek durumu değiştirmek içinSavedStateReaderveSavedStateWriteriçerir. Android'deSavedState,Bundleiçin bir tür takma adıdır. Bu takma ad, ikili uyumluluğu sağlar ve mevcut API'lerin ortak bir kaynak grubuna taşınmasını kolaylaştırır. Diğer platformlardaSavedState, birMap<String, Any>örneğidir. (I18575, b/334076622)
// Create a new SavedState object using the savedState DSL:
val savedState = savedState {
putInt("currentPage", 1)
putString("filter", "favorites")
}
// Read from a SavedState object
val currentPage = savedState.read { getInt("currentPage") }
// Edit an existing SavedState object
savedState.write {
remove("currentPage")
}
API Değişiklikleri
SavedStateRegistryveSavedStateRegistryControllerartık KMP ile uyumludur. (Id7bb8, b/334076622)SavedState,SavedStateWriterveSavedStateReaderartık KMP ile uyumlu. (I26305, b/334076622)
Sürüm 1.3.0-alpha01
7 Ağustos 2024
androidx.savedstate:savedstate:1.3.0-alpha01 ve androidx.savedstate:savedstate-ktx:1.3.0-alpha01 yayınlandı. 1.3.0-alpha01 sürümü bu kayıtları içerir.
API Değişiklikleri
savedstate-ktxKotlin uzantıları artık temel savedstate modülüne taşındı. (I1cc18, b/274803094)
Not
compileSdksürümünü 35'e güncelle (5dc41be)
Sürüm 1.2.1
Sürüm 1.2.1
22 Mart 2023
androidx.savedstate:savedstate:1.2.1 ve androidx.savedstate:savedstate-ktx:1.2.1 yayınlandı. 1.2.1 sürümü bu commit'leri içerir.
Bağımlılık Güncellemeleri
SavedStateartık Lifecycle2.6.1'a bağlıdır. (c1f621)
Sürüm 1.2.0
Sürüm 1.2.0
29 Haziran 2022
androidx.savedstate:savedstate:1.2.0 ve androidx.savedstate:savedstate-ktx:1.2.0 yayınlandı. 1.2.0 sürümü bu commit'leri içerir.
1.1.0 sürümünden sonra yapılan önemli değişiklikler
SavedStateRegistryControllerartıkperformAttach()üzerindenSavedStateRegistry'in erken eklenmesine izin veriyor.- Artık daha önce kaydedilmiş bir
SavedStateProvideröğesinigetSavedStateProvider()aracılığıylaSavedStateRegistryüzerinden alabilirsiniz. SavedStatekitaplığı Kotlin'de yeniden yazıldı.SavedStateRegistryOwneriçin bu, Kotlin'de yazılmış sınıflar açısından kaynak uyumsuz bir değişikliktir. Artık öncekigetSavedStateRegistry()işlevini uygulamak yerinesavedStateRegistryözelliğini geçersiz kılmanız gerekir.ViewTreeSavedStateRegistryOwneriçin bu, Kotlin'de yazılmış sınıflar açısından kaynak uyumsuz bir değişikliktir. Artık daha önce ayarlanmış bir sahibi ayarlamak ve bulmak için Kotlin uzantı yöntemlerini doğrudanandroidx.savedstate.setViewTreeSavedStateRegistryOwnerveandroidx.savedstate.findViewTreeSavedStateRegistryOwner'ninViewöğesine aktarıp kullanmanız gerekir. Bu,findViewTreeSavedStateRegistryOwner'insavedstate-ktxAPI'sinin yerini alır.
Davranış Değişiklikleri
SavedStateRegistry, kaydedilecek bir durum yoksa artık boş bir Bundle kaydetmez.
Sürüm 1.2.0-rc01
11 Mayıs 2022
androidx.savedstate:savedstate:1.2.0-rc01 ve androidx.savedstate:savedstate-ktx:1.2.0-rc01 yayınlandı. 1.2.0-rc01 sürümü bu kayıtları içerir.
Belgelerdeki Değişiklikler
SavedStateRegistryOwnerKdoc'ları, sahibin arayüzü nasıl uygulaması veyaSavedStateRegistryControllerüzerindeki yöntemleri ne zaman çağırması gerektiğiyle ilgili sorumluluklarını ve sözleşmesini netleştirecek şekilde güncellendi. (Iefc95, b/228887344)
Sürüm 1.2.0-beta01
20 Nisan 2022
androidx.savedstate:savedstate:1.2.0-beta01 ve androidx.savedstate:savedstate-ktx:1.2.0-beta01 yayınlandı. 1.2.0-beta01 sürümü bu kayıtları içerir.
API Değişiklikleri
SavedStateRegistryveViewTreeSavedStateRegistryOwnersınıfları Kotlin'de yeniden yazıldı.ViewTreeSavedStateRegistryOwneriçin bu, Kotlin'de yazılmış sınıflar açısından kaynak uyumsuz bir değişikliktir. Artık daha önce ayarlanmış bir sahibi ayarlamak ve bulmak için Kotlin uzantı yöntemlerini doğrudanandroidx.savedstate.setViewTreeSavedStateRegistryOwnerveandroidx.savedstate.findViewTreeSavedStateRegistryOwner'ninViewöğesine aktarıp kullanmanız gerekir. Bu,findViewTreeSavedStateRegistryOwner'insavedstate-ktxAPI'sinin yerini alır. Bu, ikili uyumludur ve Java programlama dilinde yazılmış uygulamalar için kaynak uyumluluğunu korur. (b/220191285)
Sürüm 1.2.0-alpha02
6 Nisan 2022
androidx.savedstate:savedstate:1.2.0-alpha02 ve androidx.savedstate:savedstate-ktx:1.2.0-alpha02 yayınlandı. 1.2.0-alpha02 sürümü bu kayıtları içerir.
Yeni özellikler
- Artık daha önce kaydedilmiş bir
SavedStateProvideröğesinigetSavedStateProvider()aracılığıylaSavedStateRegistryüzerinden alabilirsiniz. (I7ea47, b/215406268)
API Değişiklikleri
SavedStateRegistryOwner,SavedStateRegistryControllerveRecreatorsınıfları Kotlin'de yeniden yazıldı.SavedStateRegistryOwneriçin bu, Kotlin'de yazılmış sınıflar açısından kaynak uyumsuz bir değişikliktir. Artık öncekigetSavedStateRegistry()işlevini uygulamak yerinesavedStateRegistryözelliğini geçersiz kılmanız gerekir. Bu, Java programlama dilinde yazılmış uygulamalar için ikili program ve kaynak uyumludur. (b/220191285)
Sürüm 1.2.0-alpha01
26 Ocak 2022
androidx.savedstate:savedstate:1.2.0-alpha01 ve androidx.savedstate:savedstate-ktx:1.2.0-alpha01 yayınlandı. 1.2.0-alpha01 sürümü bu kayıtları içerir.
Yeni özellikler
SavedStateRegistryControllerartıkperformAttach()üzerindenSavedStateRegistry'in erken eklenmesine izin veriyor. (Ice4bf)
Davranış Değişiklikleri
SavedStateRegistry, kaydedilecek bir durum yoksa artık boş bir Bundle kaydetmez. (aosp/1896865, b/203457956)
Sürüm 1.1.0
Sürüm 1.1.0
10 Şubat 2021
androidx.savedstate:savedstate:1.1.0 ve androidx.savedstate:savedstate-ktx:1.1.0 yayınlandı. 1.1.0 sürümü bu commit'leri içerir.
1.0.0 sürümünden sonra yapılan önemli değişiklikler
ViewTreeSavedStateRegistryOwnerAPI'si: Yeni birViewTreeSavedStateRegistryOwner.get(View)API, belirli birViewörneği için kapsayıcıSavedStateRegistryöğesini almanıza olanak tanır. Bu bilgileri doğru şekilde doldurmak için Activity1.2.0, Fragment1.3.0ve AppCompat1.3.0-alpha01veya sonraki sürümlere yükseltmeniz gerekir.savedstate-ktxyapısı: Yenisavedstate-ktxyapısı,ViewTreeSavedStateRegistryOwnerile çalışmak içinfindViewTreeSavedStateRegistryOwner()Kotlin uzantısıyla eklendi.
Sürüm 1.1.0-rc01
16 Aralık 2020
androidx.savedstate:savedstate:1.1.0-rc01 ve androidx.savedstate:savedstate-ktx:1.1.0-rc01, 1.1.0-beta01 tarihinden bu yana herhangi bir değişiklik yapılmadan yayınlandı. 1.1.0-rc01 sürümü bu commit'leri içerir.
Sürüm 1.1.0-beta01
1 Ekim 2020
androidx.savedstate:savedstate:1.1.0-beta01 ve androidx.savedstate:savedstate-ktx:1.1.0-beta01, 1.1.0-alpha01 tarihinden bu yana herhangi bir değişiklik yapılmadan yayınlandı. 1.1.0-beta01 sürümü bu kayıtları içerir.
Sürüm 1.1.0-alpha01
20 Mayıs 2020
androidx.savedstate:savedstate:1.1.0-alpha01 ve androidx.savedstate:savedstate-ktx:1.1.0-alpha01 yayınlandı. 1.1.0-alpha01 sürümü bu commit'leri içerir.
Yeni özellikler
- Yeni bir
ViewTreeSavedStateRegistryOwner.get(View)API'si, belirli birViewörneği için kapsayıcıSavedStateRegistryöğ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. (aosp/1298679) - Yeni
savedstate-ktxyapısı,ViewTreeSavedStateRegistryOwnerile çalışmak içinfindViewTreeSavedStateRegistryOwner()Kotlin uzantısıyla eklendi. (aosp/1299434)
Sürüm 1.0.0
Sürüm 1.0.0
5 Eylül 2019
androidx.savedstate:savedstate:1.0.0 yayınlandı. Bu sürüme dahil edilen commit'leri burada bulabilirsiniz.
SavedState 1.0.0'ün önemli özellikleri
androidx.savedstate kararlı sürüme geçti. Bu, geliştiricilerin bileşenleri geri yükleme/saveInstanceState işlemine eklemesine olanak tanıyan bir API grubudur. API'nin ana giriş noktası SavedStateRegistry, consumeRestoredStateForKey kullanarak daha önce kaydedilmiş durumları almanın ve sistem istediğinde kaydedilmiş bir durum sağlamak için registerSavedStateProvider'ye geri çağırma kaydetmenin bir yolunu sunar.
Sürüm 1.0.0-rc01
2 Temmuz 2019
androidx.savedstate:savedstate:1.0.0-rc01 yayınlandı. Bu sürüme dahil edilen commit'leri burada bulabilirsiniz.
Hata düzeltmeleri
- Yanlış proguard kuralı düzeltildi (b/132655499)
Sürüm 1.0.0-beta01
7 Mayıs 2019
androidx.savedstate:savedstate:1.0.0-beta01 yayınlandı. Bu sürüme dahil edilen commit'leri burada bulabilirsiniz.
Sürüm 1.0.0-alpha02
13 Mart 2019
androidx.savedstate:savedstate:1.0.0-alpha02 yayınlandı. androidx.savedstate:savedstate, androidx.savedstate:savedstate-bundle ve androidx.savedstate:savedstate-common yapılarını tek bir yapıda birleştirir. Bunun nedeni, savedstate altyapısını basitleştirmeye ve SavedStateRegistry'ten genel türleri kaldırmaya karar verilmiş olmasıdır. Bu nedenle ayrı modüllere gerek yoktur.
Bu sürüme dahil edilen tüm commit'lerin listesini burada bulabilirsiniz.
Yeni özellikler
SavedStateRegistry.runOnNextRecreaction(Class<? extends AutoRecreated> clazz )eklendi. Belirtilen sınıf örneklendirilecek ve sahip olan bileşen yeniden başlatıldığındaAutoRecreated.onRecreatedyöntemi çalıştırılacak.
API değişiklikleri
SavedStateRegistry<T>için jenerik ilaçlar kaldırıldı- AbstractSavedStateRegistry ve BundlableSavedStateRegistry kaldırıldı. Bunun yerine basit
SavedStateRegistrykullanın. BundleSavedStateRegistryOwner,SavedStateRegistryOwnerolarak yeniden adlandırıldı
Sürüm 1.0.0-alpha01
17 Aralık 2018
Bu, SavedState uygulamasının ilk sürümüdür.
Yeni özellikler
androidx.savedstate, geliştiricilerin bileşenleri geri yükleme/saveInstanceState işlemine eklemesine olanak tanıyan yeni bir alfa API grubudur. API'nin ana giriş noktası SavedStateRegistry<T>, daha önce kaydedilmiş durumu consumeRestoredStateForKey aracılığıyla alma ve sistem istediğinde kaydedilmiş bir durum sağlamak için registerSavedStateProvider'ye geri çağırma kaydetme imkanı sunar.