Savedstate
| 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.
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, umcompositionLocalWithHostDefaultOfundSavedStateRegistryOwnerHostDefaultKeyzu 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
SavedStateContainerAPI wurde eingeführt, die als gemeinsame Implementierungsbasis fürSaveableStateRegistry,SavedStateHandleundSavedStateRegistydient. (I1da6d) asContainer()undgetOrCreateContainer()wurden zuSavedStateRegistryhinzugefügt, um das Erstellen von untergeordneten Containern aus einemSavedStateRegistryzu 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-runtimewurde 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
SavedStateRegistryhinzugefügt undSavedStateRegistrywurde so konfiguriert, dassSavedStateProviderundSavedStateRestorerimplementiert werden. (I3c696) SavedStateProvider-Schnittstelle auf oberster Ebene hinzugefügt. (I20f9d)- Die übergeordnete
SavedStateRestorer-Schnittstelle mitrestoreState(savedState: SavedState?)wurde hinzugefügt und die unveröffentlichteSavedStateRegistry.SavedStateConsumerwurde entfernt. (Idc01d) AutoRecreatedundrunOnNextRecreationwurden zugunsten vonSavedStateProviderundSavedStateRestorereingestellt. (Iadc00)SavedStateConsumer-Schnittstelle aufSavedStateRegistryeinfü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
LocalSavedStateRegistryOwnerist 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
putKotlinSerializableundgetKotlinSerializablewurden zuSavedStateWriterundSavedStateReaderhinzugefü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,ViewModelStoreOwnerundSavedStateRegistryOwnerhinzu, um Boilerplate-Code beim Erstellen benutzerdefinierter Inhaberkomponenten zu reduzieren. (I9682c) - Aktivieren Sie das Speichern und Wiederherstellen von
SnapshotStateSet(erstellt übermutableStateSetOf()) mitrememberSerializable. Sie können jetztSnapshotStateSetinrememberSerializableverwenden, 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
putKotlinSerializableundgetKotlinSerializablewurden zuSavedStateWriterundSavedStateReaderhinzugefügt, damit serialisierbare Kotlin-Objekte direkt über Schlüssel gespeichert und abgerufen werden können. Das vereinfacht die Einbindung inSavedState-APIs. (Iba02e) - Fügen Sie Factory-Funktionen für
LifecycleOwner,ViewModelStoreOwnerundSavedStateRegistryOwnerhinzu, um Boilerplate-Code beim Erstellen benutzerdefinierter Inhaberkomponenten zu reduzieren. (I9682c) - Aktivieren Sie das Speichern und Wiederherstellen von
SnapshotStateSet(erstellt übermutableStateSetOf()) mitrememberSerializable. Sie können jetztSnapshotStateSetinrememberSerializableverwenden, 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
encodeToSavedStateunddecodeFromSavedStatehinzugefü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.savedwurde 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.SavedStateunterstü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
LocalSavedStateRegistryOwnerwurde von Compose UI in das neuesavedstate-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 UI1.9.0-alpha02und 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 überfindViewTreeSavedStateRegistryOwnerabgerufen 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 unterViewTree.setViewTreeDisjointParent.
Kotlin Multiplatform
- Das Modul
SavedStateist jetzt KMP-kompatibel. Zu den unterstützten Plattformen gehören jetzt Android, iOS, Linux, Mac und JVM-Desktopumgebungen. Der opake Typ
SavedStatewurde als Abstraktion eingeführt, um eine einheitliche Möglichkeit zum Speichern und Wiederherstellen des Anwendungsstatus in KMP zu bieten. Sie enthält einenSavedStateReaderund einenSavedStateWriter, um den zu speichernden Status zu ändern. Unter Android istSavedStateein Typ-Alias fürBundle, um die Binärkompatibilität zu gewährleisten und die Migration vorhandener APIs zu einem gemeinsamen Quellsatz zu erleichtern. Auf anderen Plattformen istSavedStateeineMap<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
SavedStateunterstützt jetzt die KotlinX-Serialisierung. Sie können eine mit@Serializableannotierte Klasse mit den MethodenencodeToSavedStateunddecodeFromSavedStatein einSavedStatekonvertieren. Der zurückgegebeneSavedStateist ein regulärerBundleunter Android und kann von jeder API verwendet werden, die einenBundleakzeptiert.@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 Paketandroidx.savedstate.serialization.serializersim Modulsavedstateund im Paketandroidx.savedstate.compose.serialization.serializersim Modulsavedstate-compose.Wir haben auch
saved, einen Lazy-Property-Delegaten, hinzugefügt, um das Speichern von@Serializable-Klassen in einemSavedStateRegistryOwner(z.B.ComponentActivity,Fragmentusw.) zu vereinfachen und diese Klassen nach einer Prozessbeendigung und -neuerstellung automatisch wiederherzustellen. Beachte, dass dersaved-Delegat verzögert ist und deninit-Lambda-Ausdruck erst aufruft oder etwas inSavedStateRegistryspeichert, 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.0wurde ein ähnlichersaved-Property-Delegat fürSavedStateHandlehinzugefü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 inSavedStateReaderhinzufügen. (I0b641, b/399820614) encodeDefaultswurde zuSavedStateConfigurationhinzugefügt, damit angepasst werden kann, ob Attribute mit Standardwerten codiert werden sollen. (I893cc, b/395104517)- Füge
SnapshotStateMapSerializerhinzu, ummutableStateMapOfzu unterstützen. (Ie6f19, b/378895074) - Füge
SnapshotStateListSerializerhinzu, ummutableStateListOfzu unterstützen. (I4d888, b/378895074) - Fügen Sie
getOrNullalternative Methoden fürSavedStateReader.getVarianten hinzu. Diese Methoden führen ein Auto-Boxing primitiver Werte durch. (I6228c, b/399820614)
API-Änderungen
- Entfernen Sie
getOrElseausSavedStateReaderund verwenden Sie stattdessengetOrNull() ?: else(). (I87317, b/399820614) - Modifikator
inlineaus den MethodenSavedStateReaderundSavedStateWriterentfernt (If2a02, b/399820614) - Integrierte Android-spezifische Listen- und Array-Serialisierer wurden aus der öffentlichen API entfernt (Ida293).
SparseParcelableArraySerializerdurchSparseArraySerializerersetzt (I91de8)- Alle
SavedStateReader.getverhalten sich jetzt einheitlich, indem sie einen Fehler auslösen, wenn der Werttyp nicht mit dem Rückgabetyp übereinstimmt (I78c4a, b/399317598). - Benennen Sie
SavedState*DelegatesinSavedState*Delegateum. (I8589b, b/399629301) - Benennen Sie
SavedStateConfiginSavedStateConfigurationum. (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
Bundleunterstützten Typen standardmäßig mitencodeAsSavedState/decodeFromSavedStateoder für Attribute in@Serializable-Klassen über die Annotation@Contextualverwendet werden können. (Ic01d2) - Unterstützung für
classDiscriminatorundclassDiscriminatorModeaufSavedStateConfighinzugefügt. (I69b66, b/395104517)
API-Änderungen
- Parameter
SavedStateConfigzusaved()-Delegaten hinzugefügt (I39b3a) - Integrierte Serialisierer werden zu Singleton-Objekten (Ifeee4)
- Die Attribute von
SavedStateConfigsind jetzt öffentlich, sodass andere Module diese Konfigurationen verwenden können. (Ie5f49, b/378897438) - Unterstützung von
@Serializer(with = ...)fürMutableStateFlowSerializerundMutableStateSerializer(I90953) contentDeepToStringzuSavedStateReaderhinzufü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
MutableStateSerializerwurde vonlifecycle-viewmodel-composenachsavedstate-composeverschoben, sodass Sie die SavedState-Serialisierungs-APIs mitMutableStatevon Compose verwenden können. (I4f690, b/378895074)
API-Änderungen
- Fügen Sie eine Factory-Funktion hinzu, um
SavedStateaus einem vorhandenenSavedStatezu erstellen. (I39f9a) - Unterstützung für
Array<SavedState>undList<SavedState>inandroidx.savedstatehinzugefügt. (Idd8a5) - Optionaler Parameter
SavedStateConfigzur 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
MutableStateFlowSerializerfür die Serialisierung vonkotlinx.coroutines.flow.MutableStateFlowhinzu. (I6a892, b/378895070)
API-Änderungen
- Überladene
SavedStateRegistryOwner.saved()-Delegatfunktionen durch Standardparameter ersetzen (Icd1c1) JavaSerializableSerializerundParcelableSerializerabstrakt machen (I268f6)- Generisches
T : CharSequenceausCharSequenceSerializerentfernen (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
SavedStateKMP 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 überfindViewTreeSavedStateRegistryOwnerabgerufen 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 unterViewTree.setViewTreeDisjointParent. (Iccb33)
API-Änderungen
- Die Benennung und Paketorganisation wurden konsistenter mit
SavedStateRegistryOwnerDelegategestaltet (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
SavedStateunterstützt jetzt die KotlinX-Serialisierung. Sie können eine mit@Serializableannotierte Klasse mit den MethodenencodeToSavedStateunddecodeFromSavedStatein einSavedStatekonvertieren. Der zurückgegebeneSavedStateist ein regulärerBundleunter Android und kann von jeder API verwendet werden, die einenBundleakzeptiert. (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 einemSavedStateRegistryOwner(z.B.ComponentActivity,Fragmentusw.) zu vereinfachen und diese Klassen nach einer Prozessbeendigung und -neuerstellung automatisch wiederherzustellen. Beachte, dass dersaved-Delegat verzögert ist und deninit-Lambda-Ausdruck erst aufruft oder etwas inSavedStateRegistryspeichert, 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-alpha07wurde ein ähnlichersaved-Property-Delegat fürSavedStateHandlehinzugefügt.
API-Änderungen
toMapwurde zuSavedStatehinzugefügt, sodass alleSavedStatein reguläreMap(flache Kopie) konvertiert werden können. (I487b9, b/334076622)SavedStateKMP 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
- SavedState KMP unterstützt jetzt Char. (I9ac2f, b/334076622)
putNullundisNullzu SavedState KMP hinzufügen. (Iea71d, b/334076622)- Zusätzliche
savedState-Factory-Parameter hinzugefügt, die einen anfänglichenMap<String, Any>unterstützen (I9b37d, b/334076622) - SavedState KMP unterstützt jetzt den Vergleich von
contentDeepEquals. (Ia515c, b/334076622) - SavedState KMP unterstützt jetzt Long. (I4c180, b/334076622)
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
SavedStateist 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
SavedStatewurde als Abstraktion eingeführt, um eine einheitliche Möglichkeit zum Speichern und Wiederherstellen des Anwendungsstatus in KMP zu bieten. Sie enthält einenSavedStateReaderund einenSavedStateWriter, um den zu speichernden Status zu ändern. Unter Android istSavedStateein Typ-Alias fürBundle, um die Binärkompatibilität zu gewährleisten und die Migration vorhandener APIs zu einem gemeinsamen Quellsatz zu erleichtern. Auf anderen Plattformen istSavedStateeineMap<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
SavedStateRegistryundSavedStateRegistryControllersind jetzt KMP-kompatibel. (Id7bb8, b/334076622)SavedState,SavedStateWriterundSavedStateReadersind 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
compileSdkauf 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
SavedStatehängt jetzt von Lifecycle2.6.1ab. (c1f621)
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
SavedStateRegistryControllerermöglicht jetzt das vorzeitige Anhängen desSavedStateRegistryüberperformAttach().- Sie können jetzt einen zuvor registrierten
SavedStateProvideraus einemSavedStateRegistryübergetSavedStateProvider()abrufen. - Die
SavedState-Bibliothek wurde in Kotlin neu geschrieben.- Für
SavedStateRegistryOwnerist dies eine quellinkompatible Änderung für die in Kotlin geschriebenen Klassen. Sie müssen jetzt die PropertysavedStateRegistryüberschreiben, anstatt die vorherige FunktiongetSavedStateRegistry()zu implementieren. - Für
ViewTreeSavedStateRegistryOwnerist dies eine quellinkompatible Änderung für die in Kotlin geschriebenen Klassen. Sie müssen jetzt die Kotlin-Erweiterungsmethoden fürViewvonandroidx.savedstate.setViewTreeSavedStateRegistryOwnerundandroidx.savedstate.findViewTreeSavedStateRegistryOwnerdirekt importieren und verwenden, um einen zuvor festgelegten Inhaber festzulegen und zu finden. Dadurch wird diesavedstate-ktxAPI vonfindViewTreeSavedStateRegistryOwnerersetzt.
- Für
Geändertes Verhalten
SavedStateRegistryspeichert 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
SavedStateRegistryOwnerwurden aktualisiert, um die Verantwortlichkeiten und den Vertrag des Inhabers in Bezug auf die Implementierung der Schnittstelle oder den Aufruf der Methoden fürSavedStateRegistryControllerzu 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
SavedStateRegistryundViewTreeSavedStateRegistryOwnerwurden in Kotlin neu geschrieben. FürViewTreeSavedStateRegistryOwnerist dies eine quellinkompatible Änderung für die in Kotlin geschriebenen Klassen. Sie müssen jetzt die Kotlin-Erweiterungsmethoden fürViewvonandroidx.savedstate.setViewTreeSavedStateRegistryOwnerundandroidx.savedstate.findViewTreeSavedStateRegistryOwnerdirekt importieren und verwenden, um einen zuvor festgelegten Inhaber festzulegen und zu finden. Dadurch wird diesavedstate-ktxAPI vonfindViewTreeSavedStateRegistryOwnerersetzt. 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
SavedStateProvideraus einemSavedStateRegistryübergetSavedStateProvider()abrufen. (I7ea47, b/215406268)
API-Änderungen
- Die Klassen
SavedStateRegistryOwner,SavedStateRegistryControllerundRecreatorwurden in Kotlin neu geschrieben. FürSavedStateRegistryOwnerist dies eine quellinkompatible Änderung für die in Kotlin geschriebenen Klassen. Sie müssen jetzt die PropertysavedStateRegistryüberschreiben, anstatt die vorherige FunktiongetSavedStateRegistry()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
SavedStateRegistryControllerermöglicht jetzt das frühzeitige Anhängen desSavedStateRegistryüberperformAttach(). (Ice4bf)
Geändertes Verhalten
SavedStateRegistryspeichert 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
ViewTreeSavedStateRegistryOwnerAPI: Mit einer neuenViewTreeSavedStateRegistryOwner.get(View)API können Sie die enthaltendeSavedStateRegistryfür eine bestimmteView-Instanz abrufen. Sie müssen ein Upgrade auf Activity1.2.0, Fragment1.3.0und AppCompat1.3.0-alpha01oder höher durchführen, damit diese korrekt ausgefüllt werden.savedstate-ktx-Artefakt: Das neuesavedstate-ktx-Artefakt wurde mit einerfindViewTreeSavedStateRegistryOwner()-Kotlin-Erweiterung für die Arbeit mitViewTreeSavedStateRegistryOwnerhinzugefü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 übergeordneteSavedStateRegistryfür eine bestimmteView-Instanz abrufen. Sie müssen ein Upgrade auf Activity1.2.0-alpha05, Fragment1.3.0-alpha05und AppCompat1.3.0-alpha01durchführen, damit diese korrekt ausgefüllt werden. (aosp/1298679) - Das neue Artefakt
savedstate-ktxwurde mit einerfindViewTreeSavedStateRegistryOwner()-Kotlin-Erweiterung für die Arbeit mitViewTreeSavedStateRegistryOwnerhinzugefü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
- Falsche Proguard-Regel korrigiert (b/132655499)
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 MethodeAutoRecreated.onRecreatedwird 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. BundleSavedStateRegistryOwnerwird inSavedStateRegistryOwnerumbenannt
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.