Savedstate

Bir işlem sonlandırıldığında kullanıcı arayüzü durumunu kaydeden ve işlem yeniden başlatıldığında bu durumu geri yükleyen takılabilir bileşenler yazın.
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.

Yeni bir sorun oluşturma

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 öğesini compositionLocalWithHostDefaultOf ve SavedStateRegistryOwnerHostDefaultKey kullanacak şekilde taşıyın ve Android dışında görünüm ağacının bir parçası olarak doğrudan alınmasını engelleyin. (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, SavedStateHandle ve SavedStateRegisty için ortak uygulama tabanı olarak kullanılacak yeni bir SavedStateContainer API'si kullanıma sunuldu. (I1da6d)
  • SavedStateRegistry öğesinden alt kapsayıcı oluşturulmasına izin vermek için SavedStateRegistry öğesine asContainer(), 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-runtime bağı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

  • SavedStateRegistry oluş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

  • SavedStateRegistry sınıfına herkese açık kurucular eklendi ve SavedStateRegistry sınıfının SavedStateProvider ile SavedStateRestorer arayüzlerini uygulaması sağlandı. (I3c696)
  • Üst düzey SavedStateProvider arayüzü eklendi. (I20f9d)
  • restoreState(savedState: SavedState?) ile üst düzey SavedStateRestorer arayüzü eklendi ve yayınlanmamış SavedStateRegistry.SavedStateConsumer kaldırıldı. (Idc01d)
  • AutoRecreated ve runOnNextRecreation, SavedStateProvider ve SavedStateRestorer lehine kullanımdan kaldırıldı. (Iadc00)
  • SavedStateRegistry üzerinde SavedStateConsumer arayü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:

  • SavedState nesneleri 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)
  • SavedStateWriter ve SavedStateReader için putKotlinSerializable ve getKotlinSerializable uzantı 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, ViewModelStoreOwner ve SavedStateRegistryOwner için fabrika işlevleri ekleyin. (I9682c)
  • rememberSerializable ile SnapshotStateSet (mutableStateSetOf() üzerinden oluşturulan) kaydetme ve geri yükleme özelliğini etkinleştirin. Artık özel bir kaydediciye gerek kalmadan rememberSerializable içinde SnapshotStateSet kullanabilirsiniz. (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

  • SavedState nesneleri 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

  • SavedStateWriter ve SavedStateReader'ye putKotlinSerializable ve getKotlinSerializable uzantı 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, ViewModelStoreOwner ve SavedStateRegistryOwner için fabrika işlevleri ekleyin. (I9682c)
  • rememberSerializable ile SnapshotStateSet (mutableStateSetOf() üzerinden oluşturulan) kaydetme ve geri yükleme özelliğini etkinleştirin. Artık özel bir kaydediciye gerek kalmadan rememberSerializable içinde SnapshotStateSet kullanabilirsiniz. (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

  • encodeToSavedState ve decodeFromSavedState dillerinde 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.saved içinde null değer alabilen türler için yerel destek ekleyerek null değer alabilen özelliklerin kaydedilmesini ve geri yüklenmesini basitleştirir. (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 SavedState KMP 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 *-compose yapı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 SavedState yapılarına ekleyin.
  • SavedState yapılarına yeni Kotlin Çoklu Platform (KMP) hedefleri eklendi. SavedState artık şu platformları destekliyor: JVM (Android ve masaüstü), yerel (Linux, iOS, watchOS, macOS, MinGW) ve web (JavaScript, WasmJS). *-compose yapılarına yeni KMP hedefleri eklenmedi. Bu, Compose 1.9'un kararlı sürümüne bağlıdır. (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 yeni savedstate-compose modülüne taşındı. Compose kullanıcı arayüzü 1.9.0-alpha02 ve 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-ktx Kotlin uzantıları artık temel savedstate modülüne taşındı.
  • findViewTreeSavedStateRegistryOwner aracılığıyla alınan SavedStateRegistryOwner örnekleri artık bir görünümün ayrık üst öğeleri (ör. ViewOverlay) aracılığıyla çözümlenebilir. Ayrık görünüm üst öğeleri hakkında daha fazla bilgi için çekirdeğin sürüm notlarına veya ViewTree.setViewTreeDisjointParent adresindeki belgelere bakın.

Kotlin Multiplatform

  • SavedState modü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 SavedState opak türünü kullanıma sunun. Kaydedilecek durumu değiştirmek için SavedStateReader ve SavedStateWriter içerir. Android'de SavedState, Bundle iç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 platformlarda SavedState, bir Map<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

  • SavedState artık KotlinX Serialization desteği içeriyor. @Serializable ile ek açıklama eklenmiş bir sınıfı, encodeToSavedState ve decodeFromSavedState yöntemlerini kullanarak SavedState sınıfına dönüştürebilirsiniz. Döndürülen SavedState, Android'de normal bir Bundle olup Bundle kabul 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, savedstate modülündeki androidx.savedstate.serialization.serializers paketinde ve savedstate-compose modülündeki androidx.savedstate.compose.serialization.serializers paketinde bulunabilir.

  • Ayrıca, @Serializable sınıflarını bir SavedStateRegistryOwner içinde (ör. ComponentActivity, Fragment vb.) 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 olan saved'i de ekledik. saved temsilcisinin geç yüklenen bir temsilci olduğunu ve erişilene kadar init lambda'yı çağırmayacağını veya SavedStateRegistry iç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 eklenen SavedStateHandle için benzer bir saved ö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

  • SavedStateReader içinde get koleksiyonları için somutlaştırılmamış yöntem varyantları eklendi. (I0b641, b/399820614)
  • SavedStateConfiguration öğesine encodeDefaults eklenerek varsayılan değerlere sahip özelliklerin kodlanıp kodlanmayacağının özelleştirilmesi sağlandı. (I893cc, b/395104517)
  • mutableStateMapOf için SnapshotStateMapSerializer ekleyin. (Ie6f19, b/378895074)
  • mutableStateListOf için SnapshotStateListSerializer ekleyin. (I4d888, b/378895074)
  • SavedStateReader.get varyant için getOrNull alternatif 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 yerine getOrNull() ?: else() getirildi. (I87317, b/399820614)
  • inline değiştiricisini SavedStateReader ve SavedStateWriter yö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).
  • SparseParcelableArraySerializer yerine SparseArraySerializer kullanı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*Delegates dosyasını SavedState*Delegate olarak yeniden adlandırın. (I8589b, b/399629301)
  • SavedStateConfig dosyasını SavedStateConfiguration olarak 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 Bundle tarafından desteklenen tüm türlerin varsayılan olarak encodeAsSavedState/decodeFromSavedState ile veya @Serializable sınıflarındaki özellikler için @Contextual ek açıklaması aracılığıyla kullanılabilmesini sağlayın. (Ic01d2)
  • SavedStateConfig üzerinde classDiscriminator ve classDiscriminatorMode desteği ekleyin. (I69b66, b/395104517)

API Değişiklikleri

  • saved() temsilcilerine SavedStateConfig parametresi 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)
  • MutableStateFlowSerializer ve MutableStateSerializer için @Serializer(with = ...) desteği (I90953)
  • contentDeepToString öğesini SavedStateReader listesine 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-compose yerine savedstate-compose konumuna taşındı. Böylece SavedState Serialization API'lerini Compose'un MutableState özelliğiyle kullanabilirsiniz. (I4f690, b/378895074)

API Değişiklikleri

  • Mevcut bir SavedState öğesinden SavedState oluşturmak için bir fabrika işlevi ekleyin. (I39f9a)
  • androidx.savedstate için Array<SavedState> ve List<SavedState> desteği eklendi. (Idd8a5)
  • SavedState kodlama/kod çözme işlemine SavedStateConfig isteğ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çin MutableStateFlowSerializer ekleyin. (I6a892, b/378895070)

API Değişiklikleri

  • Aşırı yüklenmiş SavedStateRegistryOwner.saved() temsilci işlevlerini varsayılan parametrelerle değiştirme (Icd1c1)
  • JavaSerializableSerializer ve ParcelableSerializer soyut yapın (I268f6)
  • T : CharSequence adlı genel öğeyi CharSequenceSerializer (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

  • SavedState KMP 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ılabilecek KSerializer örnekleri ekleyin. (I8c10f, I28caf, b/376026712)
  • findViewTreeSavedStateRegistryOwner aracılığıyla alınan SavedStateRegistryOwner örnekleri artık bir görünümün ayrık üst öğeleri (ör. ViewOverlay) aracılığıyla çözümlenebilir. Ayrık görünüm üst öğeleri hakkında daha fazla bilgi için çekirdeğin sürüm notlarına veya ViewTree.setViewTreeDisjointParent adresindeki belgelere bakın. (Iccb33)

API Değişiklikleri

  • Adlandırmaları ve paket organizasyonunu SavedStateRegistryOwnerDelegate ile 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

  • SavedState artık KotlinX Serialization desteği içeriyor. @Serializable ile ek açıklama eklenmiş bir sınıfı, encodeToSavedState ve decodeFromSavedState yöntemlerini kullanarak SavedState sınıfına dönüştürebilirsiniz. Döndürülen SavedState, Android'de normal bir Bundle olup Bundle kabul 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, @Serializable sınıflarını bir SavedStateRegistryOwner içinde (ör. ComponentActivity, Fragment vb.) 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 olan saved'i de ekledik. saved temsilcisinin geç yüklenen bir temsilci olduğunu ve erişilene kadar init lambda'yı çağırmayacağını veya SavedStateRegistry iç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 eklenen SavedStateHandle için benzer bir saved özellik temsilcisi vardır.

API Değişiklikleri

  • toMap öğesini SavedState öğesine ekleyerek herhangi bir SavedState öğesinin normal bir Map öğesine dönüştürülmesine olanak tanır (yüzeysel kopya). (I487b9, b/334076622)
  • SavedState KMP 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

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

  • SavedState modü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 SavedState opak türünü kullanıma sunun. Kaydedilecek durumu değiştirmek için SavedStateReader ve SavedStateWriter içerir. Android'de SavedState, Bundle iç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 platformlarda SavedState, bir Map<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

  • SavedStateRegistry ve SavedStateRegistryController artık KMP ile uyumludur. (Id7bb8, b/334076622)
  • SavedState, SavedStateWriter ve SavedStateReader artı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-ktx Kotlin uzantıları artık temel savedstate modülüne taşındı. (I1cc18, b/274803094)

Not

  • compileSdk sü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

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

  • SavedStateRegistryController artık performAttach() üzerinden SavedStateRegistry'in erken eklenmesine izin veriyor.
  • Artık daha önce kaydedilmiş bir SavedStateProvider öğesini getSavedStateProvider() aracılığıyla SavedStateRegistry üzerinden alabilirsiniz.
  • SavedState kitaplığı Kotlin'de yeniden yazıldı.
    • SavedStateRegistryOwner için bu, Kotlin'de yazılmış sınıflar açısından kaynak uyumsuz bir değişikliktir. Artık önceki getSavedStateRegistry() işlevini uygulamak yerine savedStateRegistry özelliğini geçersiz kılmanız gerekir.
    • ViewTreeSavedStateRegistryOwner iç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ğrudan androidx.savedstate.setViewTreeSavedStateRegistryOwner ve androidx.savedstate.findViewTreeSavedStateRegistryOwner'nin View öğesine aktarıp kullanmanız gerekir. Bu, findViewTreeSavedStateRegistryOwner'in savedstate-ktx API'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

  • SavedStateRegistryOwner Kdoc'ları, sahibin arayüzü nasıl uygulaması veya SavedStateRegistryController ü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

  • SavedStateRegistry ve ViewTreeSavedStateRegistryOwner sınıfları Kotlin'de yeniden yazıldı. ViewTreeSavedStateRegistryOwner iç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ğrudan androidx.savedstate.setViewTreeSavedStateRegistryOwner ve androidx.savedstate.findViewTreeSavedStateRegistryOwner'nin View öğesine aktarıp kullanmanız gerekir. Bu, findViewTreeSavedStateRegistryOwner'in savedstate-ktx API'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 öğesini getSavedStateProvider() aracılığıyla SavedStateRegistry üzerinden alabilirsiniz. (I7ea47, b/215406268)

API Değişiklikleri

  • SavedStateRegistryOwner, SavedStateRegistryController ve Recreator sınıfları Kotlin'de yeniden yazıldı. SavedStateRegistryOwner için bu, Kotlin'de yazılmış sınıflar açısından kaynak uyumsuz bir değişikliktir. Artık önceki getSavedStateRegistry() işlevini uygulamak yerine savedStateRegistry ö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

  • SavedStateRegistryController artık performAttach() üzerinden SavedStateRegistry'in erken eklenmesine izin veriyor. (Ice4bf)

Davranış Değişiklikleri

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

  • ViewTreeSavedStateRegistryOwner API'si: Yeni bir ViewTreeSavedStateRegistryOwner.get(View) API, belirli bir View örneği için kapsayıcı SavedStateRegistry öğesini almanıza olanak tanır. Bu bilgileri doğru şekilde doldurmak için Activity 1.2.0, Fragment 1.3.0 ve AppCompat 1.3.0-alpha01 veya sonraki sürümlere yükseltmeniz gerekir.
  • savedstate-ktx yapısı: Yeni savedstate-ktx yapısı, ViewTreeSavedStateRegistryOwner ile çalışmak için findViewTreeSavedStateRegistryOwner() 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 bir View örneği için kapsayıcı SavedStateRegistry öğesini almanıza olanak tanır. Bunu doğru şekilde doldurmak için Activity 1.2.0-alpha05, Fragment 1.3.0-alpha05 ve AppCompat 1.3.0-alpha01 sürümlerini yükseltmeniz gerekir. (aosp/1298679)
  • Yeni savedstate-ktx yapısı, ViewTreeSavedStateRegistryOwner ile çalışmak için findViewTreeSavedStateRegistryOwner() 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

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ığında AutoRecreated.onRecreated yö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 SavedStateRegistry kullanın.
  • BundleSavedStateRegistryOwner, SavedStateRegistryOwner olarak 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.