Savedstate

Schreiben Sie Plug-in-Komponenten, die den UI-Status speichern, wenn ein Prozess beendet wird, und ihn wiederherstellen, wenn der Prozess neu gestartet wird.
Letzte Aktualisierung Stabile Release Releasekandidat Beta-Release Alpha-Release
18. November 2026 1.5.0 - - 1.6.0-alpha06

Abhängigkeiten deklarieren

Für eine Abhängigkeit von SavedState musst du deinem Projekt das Google Maven-Repository hinzufügen. Weitere Informationen finden Sie im Google-Repository bei Maven.

Fügen Sie die Abhängigkeiten für die benötigten Artefakte in der Datei build.gradle für Ihre App oder Ihr Modul hinzu:

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")
}

Weitere Informationen zu Abhängigkeiten finden Sie unter Build-Abhängigkeiten hinzufügen.

Feedback

Ihr Feedback hilft uns, Jetpack zu verbessern. Wenn Sie neue Probleme entdecken oder Ideen zur Verbesserung dieser Bibliothek haben, lassen Sie es uns wissen. Bevor Sie ein neues Problem erstellen, sollten Sie sich jedoch die bereits gemeldeten Probleme in dieser Bibliothek ansehen. Wenn Sie sich einer Problemmeldung anschließen möchten, klicken Sie auf den Button mit dem Stern.

Neues Problem melden

Weitere Informationen finden Sie in der Dokumentation zum Issue Tracker.

Version 1.6

Version 1.6.0-alpha06

18. November 2026

androidx.savedstate:savedstate-*:1.6.0-alpha06 ist veröffentlicht. Version 1.6.0-alpha06 enthält diese Commits.

API-Änderungen

  • Migriere LocalSavedStateRegistryOwner, um compositionLocalWithHostDefaultOf und SavedStateRegistryOwnerHostDefaultKey zu verwenden, und trenne es von der direkten Abfrage als Teil des Ansichtsbaums außerhalb von Android. (I6768f)

Version 1.6.0-alpha05

21. Oktober 2026

androidx.savedstate:savedstate-*:1.6.0-alpha05 ist veröffentlicht. Version 1.6.0-alpha05 enthält diese Commits.

API-Änderungen

  • Eine neue SavedStateContainer API wurde eingeführt, die als gemeinsame Implementierungsbasis für SaveableStateRegistry, SavedStateHandle und SavedStateRegisty dient. (I1da6d)
  • asContainer() und getOrCreateContainer() wurden zu SavedStateRegistry hinzugefügt, um das Erstellen von untergeordneten Containern aus einem SavedStateRegistry zu ermöglichen. (Icb709)

Version 1.6.0-alpha04

23. September 2026

androidx.savedstate:savedstate-*:1.6.0-alpha04 ist veröffentlicht. Version 1.6.0-alpha04 enthält diese Commits.

Fehlerkorrekturen

  • Die Abhängigkeit androidx.lifecycle:lifecycle-runtime wurde auf 2.10.0 aktualisiert. Diese Version ist erforderlich, damit die Lint-Prüfungen für die gebündelte Lebenszyklus-Laufzeit mit AGP-Version 9.5.0-alpha04 oder höher ausgeführt werden können. (I99bfd, b/556807521)

Version 1.6.0-alpha03

9. September 2026

androidx.savedstate:savedstate-*:1.6.0-alpha03 ist veröffentlicht. Version 1.6.0-alpha03 enthält diese Commits.

API-Änderungen

  • Zulässiger Null-Anfangszustand im SavedStateRegistry-Konstruktor. (I76006)

Version 1.6.0-alpha02

26. August 2026

androidx.savedstate:savedstate-*:1.6.0-alpha02 ist veröffentlicht. Version 1.6.0-alpha02 enthält diese Commits.

API-Änderungen

  • Öffentliche Konstruktoren wurden zu SavedStateRegistry hinzugefügt und SavedStateRegistry wurde so konfiguriert, dass SavedStateProvider und SavedStateRestorer implementiert werden. (I3c696)
  • SavedStateProvider-Schnittstelle auf oberster Ebene hinzugefügt. (I20f9d)
  • Die übergeordnete SavedStateRestorer-Schnittstelle mit restoreState(savedState: SavedState?) wurde hinzugefügt und die unveröffentlichte SavedStateRegistry.SavedStateConsumer wurde entfernt. (Idc01d)
  • AutoRecreated und runOnNextRecreation wurden zugunsten von SavedStateProvider und SavedStateRestorer eingestellt. (Iadc00)
  • SavedStateConsumer-Schnittstelle auf SavedStateRegistry einführen. Ermöglicht registrierten Anbietern, den wiederhergestellten Status während der Wiederherstellung oder sofort nach der Registrierung automatisch zu empfangen und zu nutzen, wenn der Status bereits wiederhergestellt wurde. (I9a378)

Version 1.6.0-alpha01

12. August 2026

androidx.savedstate:savedstate-*:1.6.0-alpha01 ist veröffentlicht. Version 1.6.0-alpha01 enthält diese Commits.

Fehlerkorrekturen

  • Für die Verwendung von LocalSavedStateRegistryOwner ist Compose UI 1.8.0 oder höher erforderlich. Dadurch werden interne Reflexions-Fallbacks entfernt, was die Leistung verbessert, aber ein striktes Abhängigkeitsupgrade für Clients erzwingt. (I16fb0)

Version 1.5

Version 1.5.0

19. Mai 2026

androidx.savedstate:savedstate-*:1.5.0 ist veröffentlicht. Version 1.5.0 enthält diese Commits.

Wichtige Änderungen seit 1.4.0:

  • Generische Serialisierung für SavedState-Objekte aktivieren, damit sie auf allen Plattformen mit Standardformaten wie CBOR oder JSON codiert und decodiert werden können. (Iafda4, b/425919375)
  • Die Erweiterungsfunktionen putKotlinSerializable und getKotlinSerializable wurden zu SavedStateWriter und SavedStateReader hinzugefügt, um das direkte Speichern und Abrufen von Kotlin-Serializable-Objekten mithilfe von Schlüsseln zu ermöglichen und die Integration in SavedState APIs zu optimieren. (Iba02e)
  • Fügen Sie Factory-Funktionen für LifecycleOwner, ViewModelStoreOwner und SavedStateRegistryOwner hinzu, um Boilerplate-Code beim Erstellen benutzerdefinierter Inhaberkomponenten zu reduzieren. (I9682c)
  • Aktivieren Sie das Speichern und Wiederherstellen von SnapshotStateSet (erstellt über mutableStateSetOf()) mit rememberSerializable. Sie können jetzt SnapshotStateSet in rememberSerializable verwenden, ohne einen benutzerdefinierten Saver zu benötigen. (I9a4ed, b/449498367)

Version 1.5.0-rc01

6. Mai 2026

androidx.savedstate:savedstate-*:1.5.0-rc01 ist veröffentlicht. Version 1.5.0-rc01 enthält diese Commits.

Version 1.5.0-beta01

22. April 2026

androidx.savedstate:savedstate-*:1.5.0-beta01 ist veröffentlicht. Version 1.5.0-beta01 enthält diese Commits.

Version 1.5.0-alpha02

25. März 2026

androidx.savedstate:savedstate-*:1.5.0-alpha02 ist veröffentlicht. Version 1.5.0-alpha02 enthält diese Commits.

Version 1.5.0-alpha01

11. März 2026

androidx.savedstate:savedstate-*:1.5.0-alpha01 ist veröffentlicht. Version 1.5.0-alpha01 enthält diese Commits.

Neue Funktionen

  • Generische Serialisierung für SavedState-Objekte aktivieren, damit sie auf allen Plattformen mit Standardformaten wie CBOR oder JSON codiert und decodiert werden können. (Iafda4, b/425919375)

API-Änderungen

  • Die Erweiterungsfunktionen putKotlinSerializable und getKotlinSerializable wurden zu SavedStateWriter und SavedStateReader hinzugefügt, damit serialisierbare Kotlin-Objekte direkt über Schlüssel gespeichert und abgerufen werden können. Das vereinfacht die Einbindung in SavedState-APIs. (Iba02e)
  • Fügen Sie Factory-Funktionen für LifecycleOwner, ViewModelStoreOwner und SavedStateRegistryOwner hinzu, um Boilerplate-Code beim Erstellen benutzerdefinierter Inhaberkomponenten zu reduzieren. (I9682c)
  • Aktivieren Sie das Speichern und Wiederherstellen von SnapshotStateSet (erstellt über mutableStateSetOf()) mit rememberSerializable. Sie können jetzt SnapshotStateSet in rememberSerializable verwenden, ohne einen benutzerdefinierten Saver zu benötigen. (I9a4ed, b/449498367)

Version 1.4

Version 1.4.0

5. November 2025

androidx.savedstate:savedstate-*:1.4.0 ist veröffentlicht. Version 1.4.0 enthält diese Commits.

Version 1.4.0-rc01

22. Oktober 2025

androidx.savedstate:savedstate-*:1.4.0-rc01 wird ohne Änderungen seit 1.4.0-beta01 veröffentlicht. Version 1.4.0-rc01 enthält diese Commits.

Version 1.4.0-beta01

8. Oktober 2025

androidx.savedstate:savedstate-*:1.4.0-beta01 wurde ohne nennenswerte Änderungen seit der letzten Alphaversion veröffentlicht. Version 1.4.0-beta01 enthält diese Commits.

Version 1.4.0-alpha03

27. August 2025

androidx.savedstate:savedstate-*:1.4.0-alpha03 ist veröffentlicht. Version 1.4.0-alpha03 enthält diese Commits.

API-Änderungen

  • Unterstützung für Nullable-Typen in encodeToSavedState und decodeFromSavedState hinzugefügt. (I79062, b/439527454)
  • Aktualisieren Sie Compose auf Version 1.9.0. (I2b9de)

Version 1.4.0-alpha02

13. August 2025

androidx.savedstate:savedstate-*:1.4.0-alpha02 ist veröffentlicht. Version 1.4.0-alpha02 enthält diese Commits.

Version 1.4.0-alpha01

30. Juli 2025

androidx.savedstate:savedstate-*:1.4.0-alpha01 ist veröffentlicht. Version 1.4.0-alpha01 enthält diese Commits.

API-Änderungen

  • In SavedStateRegistryOwner.saved wurde native Unterstützung für Nullable-Typen hinzugefügt, um das Speichern und Wiederherstellen von Nullable-Attributen zu vereinfachen. (Ia632, b/421325690)

Version 1.3

Version 1.3.3

17. September 2025

androidx.savedstate:savedstate-*:1.3.3 ist veröffentlicht. Version 1.3.3 enthält diese Commits.

Fehlerkorrekturen

  • Es wurde ein Fehler behoben, bei dem das Compose Compiler-Plug-in nicht angewendet wurde, was dazu führte, dass SavedState-KMP-Artefakte fehlerhaft waren. (Id2290, b/443965665)

Version 1.3.2

27. August 2025

androidx.savedstate:savedstate-*:1.3.2 ist veröffentlicht. Version 1.3.2 enthält diese Commits.

Neue Funktionen

  • Dem SavedState-Artefakt (*-compose) wurden neue Kotlin Multiplatform-Ziele (KMP) hinzugefügt. Lifecycle unterstützt jetzt die folgenden Plattformen: JVM (Android und Desktop), Native (Linux, iOS, watchOS, macOS, MinGW) und Web (JavaScript, WasmJS). (/Idcf26)

Version 1.3.1

16. Juli 2025

androidx.savedstate:savedstate-*:1.3.1 ist veröffentlicht. Version 1.3.1 enthält diese Commits.

Fehlerkorrekturen

  • Fügen Sie alle von Annotationen unterstützten KMP-Ziele zu SavedState-Artefakten hinzu.
  • Den SavedState-Artefakten wurden neue Kotlin Multiplatform (KMP)-Ziele hinzugefügt. SavedState unterstützt jetzt die folgenden Plattformen: JVM (Android und Desktop), Native (Linux, iOS, watchOS, macOS, MinGW) und Web (JavaScript, WasmJS). Beachten Sie, dass den *-compose-Artefakten keine neuen KMP-Ziele hinzugefügt wurden, da dies vom stabilen Release von Compose 1.9 abhängt. (I062f4).

Version 1.3.0

7. Mai 2025

androidx.savedstate:savedstate-*:1.3.0 ist veröffentlicht. Version 1.3.0 enthält diese Commits.

Wichtige Änderungen seit Version 1.2.0

  • LocalSavedStateRegistryOwner wurde von Compose UI in das neue savedstate-compose-Modul verschoben, damit die Compose-basierten Hilfs-APIs außerhalb von Compose UI verwendet werden können. Dies sollte immer verwendet werden, wenn Compose UI 1.9.0-alpha02 und höher verwendet wird. Es ist jedoch abwärtskompatibel, sodass es mit allen Versionen von Compose verwendet werden kann.
  • Die savedstate-ktx-Kotlin-Erweiterungen wurden jetzt in das Basismodul „savedstate“ verschoben.
  • SavedStateRegistryOwner-Instanzen, die über findViewTreeSavedStateRegistryOwner abgerufen werden, können jetzt über disjunkte übergeordnete Elemente einer Ansicht aufgelöst werden, z. B. ViewOverlay. Weitere Informationen zu disjunkten übergeordneten Ansichten finden Sie in den Versionshinweisen zu Core oder in der Dokumentation unter ViewTree.setViewTreeDisjointParent.

Kotlin Multiplatform

  • Das Modul SavedState ist jetzt KMP-kompatibel. Zu den unterstützten Plattformen gehören jetzt Android, iOS, Linux, Mac und JVM-Desktopumgebungen.
  • Der opake Typ SavedState wurde als Abstraktion eingeführt, um eine einheitliche Möglichkeit zum Speichern und Wiederherstellen des Anwendungsstatus in KMP zu bieten. Sie enthält einen SavedStateReader und einen SavedStateWriter, um den zu speichernden Status zu ändern. Unter Android ist SavedState ein Typ-Alias für Bundle, um die Binärkompatibilität zu gewährleisten und die Migration vorhandener APIs zu einem gemeinsamen Quellsatz zu erleichtern. Auf anderen Plattformen ist SavedState eine Map<String, Any>-Instanz.

      // 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")
      }
    

Unterstützung für KotlinX-Serialisierung

  • SavedState unterstützt jetzt die KotlinX-Serialisierung. Sie können eine mit @Serializable annotierte Klasse mit den Methoden encodeToSavedState und decodeFromSavedState in ein SavedState konvertieren. Der zurückgegebene SavedState ist ein regulärer Bundle unter Android und kann von jeder API verwendet werden, die einen Bundle akzeptiert.

    @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)
    }
    
  • Die meisten Typen (z. B. primitive Typen) werden direkt unterstützt, ohne dass eine Konfiguration erforderlich ist. Zusätzliche Serialisierer, die mit @Serializable(with = ___:class) verwendet werden können, finden Sie im Paket androidx.savedstate.serialization.serializers im Modul savedstate und im Paket androidx.savedstate.compose.serialization.serializers im Modul savedstate-compose.

  • Wir haben auch saved, einen Lazy-Property-Delegaten, hinzugefügt, um das Speichern von @Serializable-Klassen in einem SavedStateRegistryOwner (z.B. ComponentActivity, Fragment usw.) zu vereinfachen und diese Klassen nach einer Prozessbeendigung und -neuerstellung automatisch wiederherzustellen. Beachte, dass der saved-Delegat verzögert ist und den init-Lambda-Ausdruck erst aufruft oder etwas in SavedStateRegistry speichert, wenn darauf zugegriffen wird.

    @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")
        }
    }
    
  • In Lifecycle 2.9.0 wurde ein ähnlicher saved-Property-Delegat für SavedStateHandle hinzugefügt.

Version 1.3.0-rc01

23. April 2025

androidx.savedstate:savedstate-*:1.3.0-rc01 ist veröffentlicht. Version 1.3.0-rc01 enthält diese Commits.

Version 1.3.0-beta01

09. April 2025

androidx.savedstate:savedstate-*:1.3.0-beta01 ist veröffentlicht. Version 1.3.0-beta01 enthält diese Commits.

Abhängigkeitsupdates

  • Diese Bibliothek ist jetzt auf die Kotlin 2.0-Sprachebene ausgerichtet und erfordert KGP 2.0.0 oder höher. (Idb6b5)

Version 1.3.0-alpha11

26. März 2025

androidx.savedstate:savedstate-*:1.3.0-alpha11 wurde ohne nennenswerte öffentliche Änderungen veröffentlicht. Version 1.3.0-alpha11 enthält diese Commits.

Version 1.3.0-alpha10

12. März 2025

androidx.savedstate:savedstate-*:1.3.0-alpha10 ist veröffentlicht. Version 1.3.0-alpha10 enthält diese Commits.

Neue Funktionen

  • Nicht reifizierte Methodenvarianten für get-Sammlungen in SavedStateReader hinzufügen. (I0b641, b/399820614)
  • encodeDefaults wurde zu SavedStateConfiguration hinzugefügt, damit angepasst werden kann, ob Attribute mit Standardwerten codiert werden sollen. (I893cc, b/395104517)
  • Füge SnapshotStateMapSerializer hinzu, um mutableStateMapOf zu unterstützen. (Ie6f19, b/378895074)
  • Füge SnapshotStateListSerializer hinzu, um mutableStateListOf zu unterstützen. (I4d888, b/378895074)
  • Fügen Sie getOrNull alternative Methoden für SavedStateReader.get Varianten hinzu. Diese Methoden führen ein Auto-Boxing primitiver Werte durch. (I6228c, b/399820614)

API-Änderungen

  • Entfernen Sie getOrElse aus SavedStateReader und verwenden Sie stattdessen getOrNull() ?: else(). (I87317, b/399820614)
  • Modifikator inline aus den Methoden SavedStateReader und SavedStateWriter entfernt (If2a02, b/399820614)
  • Integrierte Android-spezifische Listen- und Array-Serialisierer wurden aus der öffentlichen API entfernt (Ida293).
  • SparseParcelableArraySerializer durch SparseArraySerializer ersetzt (I91de8)
  • Alle SavedStateReader.get verhalten sich jetzt einheitlich, indem sie einen Fehler auslösen, wenn der Werttyp nicht mit dem Rückgabetyp übereinstimmt (I78c4a, b/399317598).
  • Benennen Sie SavedState*Delegates in SavedState*Delegate um. (I8589b, b/399629301)
  • Benennen Sie SavedStateConfig in SavedStateConfiguration um. (I043a5, b/399629301)

Version 1.3.0-alpha09

26. Februar 2025

androidx.savedstate:savedstate-*:1.3.0-alpha09 ist veröffentlicht. Version 1.3.0-alpha09 enthält diese Commits.

Neue Funktionen

  • Fallback für integrierte Typen hinzugefügt, damit alle von Bundle unterstützten Typen standardmäßig mit encodeAsSavedState/decodeFromSavedState oder für Attribute in @Serializable-Klassen über die Annotation @Contextual verwendet werden können. (Ic01d2)
  • Unterstützung für classDiscriminator und classDiscriminatorMode auf SavedStateConfig hinzugefügt. (I69b66, b/395104517)

API-Änderungen

  • Parameter SavedStateConfig zu saved()-Delegaten hinzugefügt (I39b3a)
  • Integrierte Serialisierer werden zu Singleton-Objekten (Ifeee4)
  • Die Attribute von SavedStateConfig sind jetzt öffentlich, sodass andere Module diese Konfigurationen verwenden können. (Ie5f49, b/378897438)
  • Unterstützung von @Serializer(with = ...) für MutableStateFlowSerializer und MutableStateSerializer (I90953)
  • contentDeepToString zu SavedStateReader hinzufügen (I14d10)

Version 1.3.0-alpha08

12. Februar 2025

androidx.savedstate:savedstate-*:1.3.0-alpha08 ist veröffentlicht. Version 1.3.0-alpha08 enthält diese Commits.

Neue Funktionen

  • MutableStateSerializer wurde von lifecycle-viewmodel-compose nach savedstate-compose verschoben, sodass Sie die SavedState-Serialisierungs-APIs mit MutableState von Compose verwenden können. (I4f690, b/378895074)

API-Änderungen

  • Fügen Sie eine Factory-Funktion hinzu, um SavedState aus einem vorhandenen SavedState zu erstellen. (I39f9a)
  • Unterstützung für Array<SavedState> und List<SavedState> in androidx.savedstate hinzugefügt. (Idd8a5)
  • Optionaler Parameter SavedStateConfig zur SavedState-Codierung/-Decodierung hinzugefügt (I6c4c0)

Version 1.3.0-alpha07

29. Januar 2025

androidx.savedstate:savedstate-*:1.3.0-alpha07 ist veröffentlicht. Version 1.3.0-alpha07 enthält diese Commits.

Neue Funktionen

  • Fügen Sie MutableStateFlowSerializer für die Serialisierung von kotlinx.coroutines.flow.MutableStateFlow hinzu. (I6a892, b/378895070)

API-Änderungen

  • Überladene SavedStateRegistryOwner.saved()-Delegatfunktionen durch Standardparameter ersetzen (Icd1c1)
  • JavaSerializableSerializer und ParcelableSerializer abstrakt machen (I268f6)
  • Generisches T : CharSequence aus CharSequenceSerializer entfernen (Ib40bd)

Version 1.3.0-alpha06

11. Dezember 2024

androidx.savedstate:savedstate-*:1.3.0-alpha06 ist veröffentlicht. Version 1.3.0-alpha06 enthält diese Commits.

Neue Funktionen

  • SavedState KMP unterstützt jetzt: IBinder, Size, SizeF, Array<Parcelable>, SparseArray<Parcelable> und Serializable (Android). (I1ba94, b/334076622)
  • Fügen Sie KSerializer-Instanzen hinzu, die zum Codieren/Decodieren von Java- und Android-Typen verwendet werden können, die von Bundle unterstützt werden. Markieren Sie dazu das entsprechende Feld in Ihrer Klasse mit @Serializable(with = ParcelableSerializer::class). (I8c10f, I28caf, b/376026712)
  • SavedStateRegistryOwner-Instanzen, die über findViewTreeSavedStateRegistryOwner abgerufen werden, können jetzt über disjunkte übergeordnete Elemente einer Ansicht aufgelöst werden, z. B. ViewOverlay. Weitere Informationen zu disjunkten übergeordneten Ansichten finden Sie in den Versionshinweisen zu Core oder in der Dokumentation unter ViewTree.setViewTreeDisjointParent. (Iccb33)

API-Änderungen

  • Die Benennung und Paketorganisation wurden konsistenter mit SavedStateRegistryOwnerDelegate gestaltet (I8c135, b/376026744).

Version 1.3.0-alpha05

13. November 2024

androidx.savedstate:savedstate-*:1.3.0-alpha05 ist veröffentlicht. Version 1.3.0-alpha05 enthält diese Commits.

Unterstützung für KotlinX-Serialisierung

  • SavedState unterstützt jetzt die KotlinX-Serialisierung. Sie können eine mit @Serializable annotierte Klasse mit den Methoden encodeToSavedState und decodeFromSavedState in ein SavedState konvertieren. Der zurückgegebene SavedState ist ein regulärer Bundle unter Android und kann von jeder API verwendet werden, die einen Bundle akzeptiert. (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)
    }
    
  • Wir haben auch saved, einen Lazy-Property-Delegaten, hinzugefügt, um das Speichern von @Serializable-Klassen in einem SavedStateRegistryOwner (z.B. ComponentActivity, Fragment usw.) zu vereinfachen und diese Klassen nach einer Prozessbeendigung und -neuerstellung automatisch wiederherzustellen. Beachte, dass der saved-Delegat verzögert ist und den init-Lambda-Ausdruck erst aufruft oder etwas in SavedStateRegistry speichert, wenn darauf zugegriffen wird. (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")
        }
    }
    
  • In Lifecycle 2.9.0-alpha07 wurde ein ähnlicher saved-Property-Delegat für SavedStateHandle hinzugefügt.

API-Änderungen

  • toMap wurde zu SavedState hinzugefügt, sodass alle SavedState in reguläre Map (flache Kopie) konvertiert werden können. (I487b9, b/334076622)
  • SavedState KMP unterstützt jetzt Arrays. (Ic0552, b/334076622)

Version 1.3.0-alpha04

30. Oktober 2024

androidx.savedstate:savedstate-*:1.3.0-alpha04 ist veröffentlicht. Version 1.3.0-alpha04 enthält diese Commits.

API-Änderungen

Version 1.3.0-alpha03

16. Oktober 2024

androidx.savedstate:savedstate-*:1.3.0-alpha03 wurde ohne nennenswerte Änderungen veröffentlicht. Version 1.3.0-alpha03 enthält diese Commits.

Version 1.3.0-alpha02

2. Oktober 2024

androidx.savedstate:savedstate-*:1.3.0-alpha02 ist veröffentlicht. Version 1.3.0-alpha02 enthält diese Commits.

Kotlin Multiplatform

  • Das Modul SavedState ist jetzt KMP-kompatibel. Zu den unterstützten Plattformen gehören jetzt Android, iOS, Linux, Mac und JVM-Desktopumgebungen. (I26305, b/334076622)

Neue Funktionen

  • Der opake Typ SavedState wurde als Abstraktion eingeführt, um eine einheitliche Möglichkeit zum Speichern und Wiederherstellen des Anwendungsstatus in KMP zu bieten. Sie enthält einen SavedStateReader und einen SavedStateWriter, um den zu speichernden Status zu ändern. Unter Android ist SavedState ein Typ-Alias für Bundle, um die Binärkompatibilität zu gewährleisten und die Migration vorhandener APIs zu einem gemeinsamen Quellsatz zu erleichtern. Auf anderen Plattformen ist SavedState eine Map<String, Any>-Instanz. (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-Änderungen

  • SavedStateRegistry und SavedStateRegistryController sind jetzt KMP-kompatibel. (Id7bb8, b/334076622)
  • SavedState, SavedStateWriter und SavedStateReader sind jetzt KMP-kompatibel. (I26305, b/334076622)

Version 1.3.0-alpha01

7. August 2024

androidx.savedstate:savedstate:1.3.0-alpha01 und androidx.savedstate:savedstate-ktx:1.3.0-alpha01 sind veröffentlicht. Version 1.3.0-alpha01 enthält diese Commits.

API-Änderungen

  • Die savedstate-ktx-Kotlin-Erweiterungen wurden jetzt in das Basismodul „savedstate“ verschoben. (I1cc18, b/274803094)

Hinweis

  • compileSdk auf 35 aktualisieren (5dc41be)

Version 1.2.1

Version 1.2.1

22. März 2023

androidx.savedstate:savedstate:1.2.1 und androidx.savedstate:savedstate-ktx:1.2.1 sind veröffentlicht. Version 1.2.1 enthält diese Commits.

Abhängigkeitsupdates

Version 1.2.0

Version 1.2.0

29. Juni 2022

androidx.savedstate:savedstate:1.2.0 und androidx.savedstate:savedstate-ktx:1.2.0 sind veröffentlicht. Version 1.2.0 enthält diese Commits.

Wichtige Änderungen seit 1.1.0

  • SavedStateRegistryController ermöglicht jetzt das vorzeitige Anhängen des SavedStateRegistry über performAttach().
  • Sie können jetzt einen zuvor registrierten SavedStateProvider aus einem SavedStateRegistry über getSavedStateProvider() abrufen.
  • Die SavedState-Bibliothek wurde in Kotlin neu geschrieben.
    • Für SavedStateRegistryOwner ist dies eine quellinkompatible Änderung für die in Kotlin geschriebenen Klassen. Sie müssen jetzt die Property savedStateRegistry überschreiben, anstatt die vorherige Funktion getSavedStateRegistry() zu implementieren.
    • Für ViewTreeSavedStateRegistryOwner ist dies eine quellinkompatible Änderung für die in Kotlin geschriebenen Klassen. Sie müssen jetzt die Kotlin-Erweiterungsmethoden für View von androidx.savedstate.setViewTreeSavedStateRegistryOwner und androidx.savedstate.findViewTreeSavedStateRegistryOwner direkt importieren und verwenden, um einen zuvor festgelegten Inhaber festzulegen und zu finden. Dadurch wird die savedstate-ktx API von findViewTreeSavedStateRegistryOwner ersetzt.

Geändertes Verhalten

  • SavedStateRegistry speichert kein leeres Bundle mehr, wenn kein Status gespeichert werden muss.

Version 1.2.0-rc01

11. Mai 2022

androidx.savedstate:savedstate:1.2.0-rc01 und androidx.savedstate:savedstate-ktx:1.2.0-rc01 sind veröffentlicht. Version 1.2.0-rc01 enthält diese Commits.

Änderungen an der Dokumentation

  • Die Kdocs für SavedStateRegistryOwner wurden aktualisiert, um die Verantwortlichkeiten und den Vertrag des Inhabers in Bezug auf die Implementierung der Schnittstelle oder den Aufruf der Methoden für SavedStateRegistryController zu verdeutlichen. (Iefc95, b/228887344)

Version 1.2.0-beta01

20. April 2022

androidx.savedstate:savedstate:1.2.0-beta01 und androidx.savedstate:savedstate-ktx:1.2.0-beta01 sind veröffentlicht. Version 1.2.0-beta01 enthält diese Commits.

API-Änderungen

  • Die Klassen SavedStateRegistry und ViewTreeSavedStateRegistryOwner wurden in Kotlin neu geschrieben. Für ViewTreeSavedStateRegistryOwner ist dies eine quellinkompatible Änderung für die in Kotlin geschriebenen Klassen. Sie müssen jetzt die Kotlin-Erweiterungsmethoden für View von androidx.savedstate.setViewTreeSavedStateRegistryOwner und androidx.savedstate.findViewTreeSavedStateRegistryOwner direkt importieren und verwenden, um einen zuvor festgelegten Inhaber festzulegen und zu finden. Dadurch wird die savedstate-ktx API von findViewTreeSavedStateRegistryOwner ersetzt. Dies ist binärkompatibel und bleibt quellkompatibel für Implementierungen, die in der Programmiersprache Java geschrieben sind. (b/220191285)

Version 1.2.0-alpha02

6. April 2022

androidx.savedstate:savedstate:1.2.0-alpha02 und androidx.savedstate:savedstate-ktx:1.2.0-alpha02 sind veröffentlicht. Version 1.2.0-alpha02 enthält diese Commits.

Neue Funktionen

  • Sie können jetzt einen zuvor registrierten SavedStateProvider aus einem SavedStateRegistry über getSavedStateProvider() abrufen. (I7ea47, b/215406268)

API-Änderungen

  • Die Klassen SavedStateRegistryOwner, SavedStateRegistryController und Recreator wurden in Kotlin neu geschrieben. Für SavedStateRegistryOwner ist dies eine quellinkompatible Änderung für die in Kotlin geschriebenen Klassen. Sie müssen jetzt die Property savedStateRegistry überschreiben, anstatt die vorherige Funktion getSavedStateRegistry() zu implementieren. Dies ist binär- und quellkompatibel für Implementierungen, die in der Programmiersprache Java geschrieben wurden. (b/220191285)

Version 1.2.0-alpha01

26. Januar 2022

androidx.savedstate:savedstate:1.2.0-alpha01 und androidx.savedstate:savedstate-ktx:1.2.0-alpha01 sind veröffentlicht. Version 1.2.0-alpha01 enthält diese Commits.

Neue Funktionen

  • SavedStateRegistryController ermöglicht jetzt das frühzeitige Anhängen des SavedStateRegistry über performAttach(). (Ice4bf)

Geändertes Verhalten

  • SavedStateRegistry speichert kein leeres Bundle mehr, wenn kein Status gespeichert werden muss. (aosp/1896865, b/203457956)

Version 1.1.0

Version 1.1.0

10. Februar 2021

androidx.savedstate:savedstate:1.1.0 und androidx.savedstate:savedstate-ktx:1.1.0 sind veröffentlicht. Version 1.1.0 enthält diese Commits.

Wichtige Änderungen seit Version 1.0.0

  • ViewTreeSavedStateRegistryOwner API: Mit einer neuen ViewTreeSavedStateRegistryOwner.get(View) API können Sie die enthaltende SavedStateRegistry für eine bestimmte View-Instanz abrufen. Sie müssen ein Upgrade auf Activity 1.2.0, Fragment 1.3.0 und AppCompat 1.3.0-alpha01 oder höher durchführen, damit diese korrekt ausgefüllt werden.
  • savedstate-ktx-Artefakt: Das neue savedstate-ktx-Artefakt wurde mit einer findViewTreeSavedStateRegistryOwner()-Kotlin-Erweiterung für die Arbeit mit ViewTreeSavedStateRegistryOwner hinzugefügt.

Version 1.1.0-rc01

16. Dezember 2020

androidx.savedstate:savedstate:1.1.0-rc01 und androidx.savedstate:savedstate-ktx:1.1.0-rc01 wurden ohne Änderungen seit 1.1.0-beta01 veröffentlicht. Version 1.1.0-rc01 enthält diese Commits.

Version 1.1.0-beta01

1. Oktober 2020

androidx.savedstate:savedstate:1.1.0-beta01 und androidx.savedstate:savedstate-ktx:1.1.0-beta01 wurden ohne Änderungen seit 1.1.0-alpha01 veröffentlicht. Version 1.1.0-beta01 enthält diese Commits.

Version 1.1.0-alpha01

20. Mai 2020

androidx.savedstate:savedstate:1.1.0-alpha01 und androidx.savedstate:savedstate-ktx:1.1.0-alpha01 sind veröffentlicht. Version 1.1.0-alpha01 enthält diese Commits.

Neue Funktionen

  • Mit der neuen ViewTreeSavedStateRegistryOwner.get(View) API können Sie die übergeordnete SavedStateRegistry für eine bestimmte View-Instanz abrufen. Sie müssen ein Upgrade auf Activity 1.2.0-alpha05, Fragment 1.3.0-alpha05 und AppCompat 1.3.0-alpha01 durchführen, damit diese korrekt ausgefüllt werden. (aosp/1298679)
  • Das neue Artefakt savedstate-ktx wurde mit einer findViewTreeSavedStateRegistryOwner()-Kotlin-Erweiterung für die Arbeit mit ViewTreeSavedStateRegistryOwner hinzugefügt. (aosp/1299434)

Version 1.0.0

Version 1.0.0

5. September 2019

androidx.savedstate:savedstate:1.0.0 ist veröffentlicht. Die in dieser Version enthaltenen Commits finden Sie hier.

Wichtige Funktionen von SavedState 1.0.0

androidx.savedstate wurde zu einer stabilen Version hochgestuft. Dies ist eine Reihe von APIs, mit denen Entwickler Komponenten in den Prozess „restore/saveInstanceState“ einbinden können. Der Haupteinstiegspunkt der API ist SavedStateRegistry. Damit können zuvor gespeicherte Zustände mit consumeRestoredStateForKey abgerufen und ein Callback für registerSavedStateProvider registriert werden, um einen gespeicherten Zustand bereitzustellen, sobald das System ihn anfordert.

Version 1.0.0-rc01

2. Juli 2019

androidx.savedstate:savedstate:1.0.0-rc01 ist veröffentlicht. Die in dieser Version enthaltenen Commits finden Sie hier.

Diverse Fehlerkorrekturen

Version 1.0.0-beta01

7. Mai 2019

androidx.savedstate:savedstate:1.0.0-beta01 ist veröffentlicht. Die in dieser Version enthaltenen Commits finden Sie hier.

Version 1.0.0-alpha02

13. März 2019

androidx.savedstate:savedstate:1.0.0-alpha02 ist veröffentlicht. androidx.savedstate:savedstate kombiniert die Artefakte androidx.savedstate:savedstate-bundle und androidx.savedstate:savedstate-common zu einem Artefakt, da beschlossen wurde, die savedstate-Infrastruktur zu vereinfachen und Generics aus SavedStateRegistry zu entfernen. Es sind also keine separaten Module erforderlich.

Eine vollständige Liste der in dieser Version enthaltenen Commits finden Sie hier.

Neue Funktionen

  • SavedStateRegistry.runOnNextRecreaction(Class<? extends AutoRecreated> clazz ) wurde hinzugefügt. Die angegebene Klasse wird instanziiert und die Methode AutoRecreated.onRecreated wird ausgeführt, wenn die übergeordnete Komponente neu gestartet wird.

API-Änderungen

  • Generika aus SavedStateRegistry<T> entfernt
  • AbstractSavedStateRegistry und BundlableSavedStateRegistry wurden entfernt. Verwenden Sie stattdessen die einfache SavedStateRegistry.
  • BundleSavedStateRegistryOwner wird in SavedStateRegistryOwner umbenannt

Version 1.0.0-alpha01

17. Dezember 2018

Dies ist die erste Version von SavedState.

Neue Funktionen

androidx.savedstate ist eine neue Reihe von Alpha-APIs, mit denen Entwickler Komponenten in den Prozess „restore / saveInstanceState“ einbinden können. Der Haupteinstiegspunkt der API ist SavedStateRegistry<T>. Damit kann ein zuvor gespeicherter Status über consumeRestoredStateForKey abgerufen und ein Callback für registerSavedStateProvider registriert werden, um einen gespeicherten Status bereitzustellen, sobald das System ihn anfordert.