Letzte Aktualisierung | Stabile Version | Releasekandidat | Beta-Ausgabe | Alpharelease |
---|---|---|---|---|
22. März 2023 | 1.2.1 | - | - | - |
Abhängigkeiten deklarieren
Zum Hinzufügen einer Abhängigkeit von SavedState müssen Sie Ihrem Projekt das Google Maven-Repository hinzufügen. Weitere Informationen finden Sie im Maven-Repository von Google.
Fügen Sie der Datei build.gradle
für Ihre Anwendung oder Ihr Modul die Abhängigkeiten für die benötigten Artefakte hinzu:
Groovig
dependencies { // Java language implementation implementation "androidx.savedstate:savedstate:1.2.1" // Kotlin implementation "androidx.savedstate:savedstate-ktx:1.2.1" }
Kotlin
dependencies { // Java language implementation implementation("androidx.savedstate:savedstate:1.2.1") // Kotlin implementation("androidx.savedstate:savedstate-ktx:1.2.1") }
Weitere Informationen zu Abhängigkeiten finden Sie unter Build-Abhängigkeiten hinzufügen.
Feedback
Dein Feedback hilft uns, Jetpack zu verbessern. Lassen Sie uns wissen, wenn Sie neue Probleme entdecken oder Ideen zur Verbesserung dieser Bibliothek haben. Sehen Sie sich die vorhandenen Probleme in dieser Bibliothek an, bevor Sie eine neue erstellen. Durch Klicken auf die Stern-Schaltfläche können Sie zu einem vorhandenen Problem abstimmen.
Weitere Informationen finden Sie in der Dokumentation zum Issue Tracker.
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
werden veröffentlicht. Version 1.2.1 enthält diese Commits.
Aktualisierungen von Abhängigkeiten
SavedState
hängt jetzt vom Lebenszyklus2.6.1
ab. (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
werden veröffentlicht. Version 1.2.0 enthält diese Commits.
Wichtige Änderungen seit Version 1.1.0
SavedStateRegistryController
erlaubt jetzt das vorzeitige Anhängen vonSavedStateRegistry
überperformAttach()
.- Sie können jetzt über
getSavedStateProvider()
einen zuvor registriertenSavedStateProvider
von einerSavedStateRegistry
abrufen. - Die
SavedState
-Bibliothek wurde in Kotlin neu geschrieben.- Bei
SavedStateRegistryOwner
ist dies eine quellinkompatible Änderung für die Klassen, die in Kotlin geschrieben wurden. Sie müssen jetzt das AttributsavedStateRegistry
überschreiben, anstatt die vorherigegetSavedStateRegistry()
-Funktion zu implementieren. - Bei
ViewTreeSavedStateRegistryOwner
ist dies eine quellinkompatible Änderung für die Klassen, die in Kotlin geschrieben wurden. Sie müssen jetzt die Kotlin-Erweiterungsmethoden fürView
vonandroidx.savedstate.setViewTreeSavedStateRegistryOwner
undandroidx.savedstate.findViewTreeSavedStateRegistryOwner
direkt importieren und verwenden, um einen zuvor festgelegten Inhaber festzulegen und zu finden. Dies ersetzt diesavedstate-ktx
API vonfindViewTreeSavedStateRegistryOwner
.
- Bei
Änderungen des Verhaltens
SavedStateRegistry
speichert kein leeres Bundle mehr, wenn kein Status zum Speichern vorhanden ist.
Version 1.2.0-rc01
11. Mai 2022
androidx.savedstate:savedstate:1.2.0-rc01
und androidx.savedstate:savedstate-ktx:1.2.0-rc01
werden veröffentlicht. Version 1.2.0-rc01 enthält diese Commits.
Änderungen an der Dokumentation
- Die
SavedStateRegistryOwner
-Kdocs wurden aktualisiert, um die Verantwortlichkeiten und den Vertrag des Inhabers für die Implementierung der Schnittstelle oder den Zeitpunkt des Aufrufs der Methoden inSavedStateRegistryController
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
werden veröffentlicht. Version 1.2.0-beta01 enthält diese Commits.
API-Änderungen
- Die Klassen
SavedStateRegistry
undViewTreeSavedStateRegistryOwner
wurden in Kotlin neu geschrieben. BeiViewTreeSavedStateRegistryOwner
ist dies eine quellinkompatible Änderung für die Klassen, die in Kotlin geschrieben wurden. Sie müssen jetzt die Kotlin-Erweiterungsmethoden fürView
vonandroidx.savedstate.setViewTreeSavedStateRegistryOwner
undandroidx.savedstate.findViewTreeSavedStateRegistryOwner
direkt importieren und verwenden, um einen zuvor festgelegten Inhaber festzulegen und zu finden. Dies ersetzt diesavedstate-ktx
API vonfindViewTreeSavedStateRegistryOwner
. Dies ist binärkompatibel und bleibt für Implementierungen, die in der Programmiersprache Java geschrieben sind, quellkompatibel. (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
werden veröffentlicht. Version 1.2.0-alpha02 enthält diese Commits.
Neue Funktionen
- Sie können jetzt über
getSavedStateProvider()
einen zuvor registriertenSavedStateProvider
von einerSavedStateRegistry
abrufen. (I7ea47, b/215406268)
API-Änderungen
- Die Klassen
SavedStateRegistryOwner
,SavedStateRegistryController
undRecreator
wurden in Kotlin neu geschrieben. BeiSavedStateRegistryOwner
ist dies eine quellinkompatible Änderung für die Klassen, die in Kotlin geschrieben wurden. Sie müssen jetzt das AttributsavedStateRegistry
überschreiben, anstatt die vorherigegetSavedStateRegistry()
-Funktion 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
werden veröffentlicht. Version 1.2.0-alpha01 enthält diese Commits.
Neue Funktionen
SavedStateRegistryController
ermöglicht jetzt das vorzeitige Anhängen vonSavedStateRegistry
überperformAttach()
. (Ice4bf)
Änderungen des Verhaltens
SavedStateRegistry
speichert kein leeres Bundle mehr, wenn kein Status zum Speichern vorhanden ist. (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
werden veröffentlicht. Version 1.1.0 enthält diese Commits.
Wichtige Änderungen seit Version 1.0.0
ViewTreeSavedStateRegistryOwner
API: Mit einer neuenViewTreeSavedStateRegistryOwner.get(View)
API können Sie dieSavedStateRegistry
bei einerView
-Instanz abrufen. Sie müssen ein Upgrade auf Activity1.2.0
, Fragment1.3.0
und AppCompat1.3.0-alpha01
oder höher ausführen, damit dieses Feld korrekt ausgefüllt wird.savedstate-ktx
-Artefakt: Das neuesavedstate-ktx
-Artefakt wurde mit der Kotlin-ErweiterungfindViewTreeSavedStateRegistryOwner()
für die Arbeit mitViewTreeSavedStateRegistryOwner
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
werden ohne Änderungen seit dem 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
werden ohne Änderungen seit dem 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
werden veröffentlicht. Version 1.1.0-alpha01 enthält diese Commits.
Neue Funktionen
- Mit einer neuen
ViewTreeSavedStateRegistryOwner.get(View)
API können Sie die enthalteneSavedStateRegistry
bei einerView
-Instanz abrufen. Sie müssen ein Upgrade auf Activity1.2.0-alpha05
, Fragment1.3.0-alpha05
und AppCompat1.3.0-alpha01
ausführen, damit dieses Feld korrekt ausgefüllt wird. (aosp/1298679) - Das neue
savedstate-ktx
-Artefakt wurde für die Arbeit mitViewTreeSavedStateRegistryOwner
mit der Kotlin-ErweiterungfindViewTreeSavedStateRegistryOwner()
hinzugefügt. (aosp/1299434)
Version 1.0.0
Version 1.0.0
5. September 2019
androidx.savedstate:savedstate:1.0.0
wird freigegeben. Die in dieser Version enthaltenen Commits finden Sie hier.
Hauptfunktionen von SavedState 1.0.0
androidx.savedstate
wurde auf eine stabile Version umgestellt. Dies ist eine Reihe von APIs, mit denen Entwickler Komponenten in den Wiederherstellungs-/SaveInstanceState-Prozess einbinden können. Der Haupteinstiegspunkt der API ist SavedStateRegistry
. Dort können zuvor gespeicherte Status mithilfe von consumeRestoredStateForKey
abgerufen und ein Callback von registerSavedStateProvider
registriert werden, um einen gespeicherten Status bereitzustellen, sobald das System ihn anfordert.
Version 1.0.0-rc01
2. Juli 2019
androidx.savedstate:savedstate:1.0.0-rc01
wird freigegeben. Die in dieser Version enthaltenen Commits finden Sie hier.
Fehlerkorrekturen
- Falsche Proguard-Regel korrigiert (b/132655499)
Version 1.0.0-beta01
7. Mai 2019
androidx.savedstate:savedstate:1.0.0-beta01
wird freigegeben. 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
wird freigegeben. androidx.savedstate:savedstate
kombiniert die Artefakte androidx.savedstate:savedstate-bundle
und androidx.savedstate:savedstate-common
zu einem Artefakt, da beschlossen wurde, die Savestate-Infrastruktur zu vereinfachen und Generika aus SavedStateRegistry
zu entfernen. Daher sind keine separaten Module erforderlich.
Die 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.onRecreated
wird ausgeführt, wenn die zugehörige Komponente neu gestartet wurde.
API-Änderungen
- Generisch aus „
SavedStateRegistry<T>
“ entfernt - SummarySavedStateRegistry und BundlableSavedStateRegistry wurden entfernt. Verwenden Sie stattdessen das einfache
SavedStateRegistry
. BundleSavedStateRegistryOwner
wurde inSavedStateRegistryOwner
umbenannt.
Version 1.0.0-alpha01
17. Dezember 2018
Dies ist die erste Version von SavedState
.
Neue Funktionen
androidx.savedstate
ist ein neuer Satz von Alpha-APIs, mit denen Entwickler Komponenten für den Wiederherstellungs-/saveInstanceState-Prozess Plug-in verwenden können. Der Haupteinstiegspunkt der API ist SavedStateRegistry<T>
. Hier kannst du einen zuvor gespeicherten Status über consumeRestoredStateForKey
abrufen und einen Callback von registerSavedStateProvider
registrieren, um einen gespeicherten Status bereitzustellen, sobald das System ihn anfordert.