Savedstate
| Najnowsza aktualizacja | Wersja stabilna | Wersja kandydująca do publikacji | Wersja beta | Wersja alfa |
|---|---|---|---|---|
| 18 listopada 2026 r. | 1.5.0 | - | - | 1.6.0-alpha06 |
Deklarowanie zależności
Aby dodać zależność od SavedState, musisz dodać do projektu repozytorium Maven Google. Więcej informacji znajdziesz w repozytorium Maven Google.
Dodaj zależności dla artefaktów, których potrzebujesz, w pliku build.gradle aplikacji lub modułu:
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") }
Więcej informacji o zależnościach znajdziesz w artykule Dodawanie zależności kompilacji.
Prześlij opinię
Twoja opinia pomoże nam ulepszyć Jetpacka. Daj nam znać, jeśli odkryjesz nowe problemy lub masz pomysły na ulepszenie tej biblioteki. Przed utworzeniem nowego problemu zapoznaj się z dotychczasowymi problemami w tej bibliotece. Możesz dodać swój głos do istniejącego problemu, klikając przycisk gwiazdki.
Więcej informacji znajdziesz w dokumentacji narzędzia Issue Tracker.
Wersja 1.6
Wersja 1.6.0-alpha06
18 listopada 2026 r.
Publikacja androidx.savedstate:savedstate-*:1.6.0-alpha06 Wersja 1.6.0-alpha06 zawiera te zmiany.
Zmiany w interfejsie API
- Przenieś
LocalSavedStateRegistryOwner, aby używaćcompositionLocalWithHostDefaultOfiSavedStateRegistryOwnerHostDefaultKey, odłączając go od bezpośredniego pobierania w ramach drzewa widoku poza Androidem. (I6768f)
Wersja 1.6.0-alpha05
21 października 2026 r.
Publikacja androidx.savedstate:savedstate-*:1.6.0-alpha05 Wersja 1.6.0-alpha05 zawiera te zmiany.
Zmiany w interfejsie API
- Wprowadziliśmy nowy interfejs API
SavedStateContainer, który służy jako wspólna baza implementacji dlaSaveableStateRegistry,SavedStateHandleiSavedStateRegisty. (I1da6d) - Dodano
asContainer(),getOrCreateContainer()doSavedStateRegistry, aby umożliwić tworzenie kontenerów podrzędnych zSavedStateRegistry. (Icb709)
Wersja 1.6.0-alpha04
23 września 2026 r.
Publikacja androidx.savedstate:savedstate-*:1.6.0-alpha04 Wersja 1.6.0-alpha04 zawiera te zatwierdzenia.
Poprawki błędów
- Zależność
androidx.lifecycle:lifecycle-runtimezostała zaktualizowana do wersji 2.10.0. Ta wersja jest wymagana do uruchamiania pakietu kontroli błędów środowiska wykonawczego cyklu życia z AGP w wersji 9.5.0-alpha04 lub nowszej. (I99bfd, b/556807521)
Wersja 1.6.0-alpha03
9 września 2026 r.
Publikacja androidx.savedstate:savedstate-*:1.6.0-alpha03 Wersja 1.6.0-alpha03 zawiera te zatwierdzenia.
Zmiany w interfejsie API
- Dozwolony stan początkowy null w konstruktorze
SavedStateRegistry. (I76006)
Wersja 1.6.0-alpha02
26 sierpnia 2026 r.
Publikacja androidx.savedstate:savedstate-*:1.6.0-alpha02 Wersja 1.6.0-alpha02 zawiera te zatwierdzenia.
Zmiany w interfejsie API
- Dodaliśmy konstruktory publiczne do
SavedStateRegistryi sprawiliśmy, żeSavedStateRegistryimplementujeSavedStateProvideriSavedStateRestorer. (I3c696) - Dodano interfejs
SavedStateProvidernajwyższego poziomu. (I20f9d) - Dodano interfejs najwyższego poziomu
SavedStateRestorerzrestoreState(savedState: SavedState?)i usunięto nieopublikowany interfejsSavedStateRegistry.SavedStateConsumer. (Idc01d) - Metody
AutoRecreatedirunOnNextRecreationzostały wycofane na rzecz metodSavedStateProvideriSavedStateRestorer. (Iadc00) - Wprowadź interfejs
SavedStateConsumerwSavedStateRegistry. Umożliwia zarejestrowanym dostawcom automatyczne otrzymywanie i wykorzystywanie przywróconego stanu podczas przywracania lub natychmiast po rejestracji, jeśli stan został już przywrócony. (I9a378)
Wersja 1.6.0-alpha01
12 sierpnia 2026 r.
Publikacja androidx.savedstate:savedstate-*:1.6.0-alpha01 Wersja 1.6.0-alpha01 zawiera te zatwierdzenia.
Poprawki błędów
- Do korzystania z funkcji
LocalSavedStateRegistryOwnerwymagany jest interfejs Compose UI w wersji 1.8.0 lub nowszej. Usuwa to zastępcze wewnętrzne odbicia, co poprawia wydajność, ale wymusza ścisłe uaktualnienie zależności dla klientów. (I16fb0)
Wersja 1.5
Wersja 1.5.0
19 maja 2026 r.
Publikacja androidx.savedstate:savedstate-*:1.5.0 Wersja 1.5.0 zawiera te zatwierdzenia.
Ważne zmiany od wersji 1.4.0:
- Włącz ogólną serializację obiektów
SavedState, aby umożliwić ich kodowanie i dekodowanie przy użyciu standardowych formatów, takich jak CBOR lub JSON, na wszystkich platformach. (Iafda4, b/425919375) - Dodaliśmy funkcje rozszerzeń
putKotlinSerializableigetKotlinSerializabledoSavedStateWriteriSavedStateReader, aby umożliwić bezpośrednie przechowywanie i pobieranie obiektów Kotlin Serializable za pomocą kluczy, co usprawnia integrację z interfejsami API SavedState. (Iba02e) - Dodaj funkcje fabryczne dla
LifecycleOwner,ViewModelStoreOwneriSavedStateRegistryOwner, aby zmniejszyć ilość powtarzalnego kodu podczas tworzenia niestandardowych komponentów właściciela. (I9682c) - Włącz zapisywanie i przywracanie
SnapshotStateSet(utworzonych za pomocąmutableStateSetOf()) za pomocąrememberSerializable. Możesz teraz używaćSnapshotStateSetwrememberSerializablebez konieczności stosowania niestandardowego modułu zapisującego. (I9a4ed, b/449498367)
Wersja 1.5.0-rc01
6 maja 2026 r.
Publikacja androidx.savedstate:savedstate-*:1.5.0-rc01 Wersja 1.5.0-rc01 zawiera te zatwierdzenia.
Wersja 1.5.0-beta01
22 kwietnia 2026 r.
Publikacja androidx.savedstate:savedstate-*:1.5.0-beta01 Wersja 1.5.0-beta01 zawiera te zatwierdzenia.
Wersja 1.5.0-alpha02
25 marca 2026 r.
Publikacja androidx.savedstate:savedstate-*:1.5.0-alpha02 Wersja 1.5.0-alpha02 zawiera te zatwierdzenia.
Wersja 1.5.0-alpha01
11 marca 2026 r.
Publikacja androidx.savedstate:savedstate-*:1.5.0-alpha01 Wersja 1.5.0-alpha01 zawiera te zatwierdzenia.
Nowe funkcje
- Włącz ogólną serializację obiektów
SavedState, aby umożliwić ich kodowanie i dekodowanie przy użyciu standardowych formatów, takich jak CBOR lub JSON, na wszystkich platformach. (Iafda4, b/425919375)
Zmiany w interfejsie API
- Dodaj funkcje rozszerzeń
putKotlinSerializableigetKotlinSerializabledoSavedStateWriteriSavedStateReader, aby umożliwić bezpośrednie przechowywanie i pobieranie obiektów Kotlin Serializable za pomocą kluczy, co usprawni integrację z interfejsami APISavedState. (Iba02e) - Dodaj funkcje fabryczne dla
LifecycleOwner,ViewModelStoreOwneriSavedStateRegistryOwner, aby zmniejszyć ilość powtarzalnego kodu podczas tworzenia niestandardowych komponentów właściciela. (I9682c) - Włącz zapisywanie i przywracanie
SnapshotStateSet(utworzonych za pomocąmutableStateSetOf()) za pomocąrememberSerializable. Możesz teraz używaćSnapshotStateSetwrememberSerializablebez konieczności stosowania niestandardowego modułu zapisującego. (I9a4ed, b/449498367)
Wersja 1.4
Wersja 1.4.0
5 listopada 2025 r.
Publikacja androidx.savedstate:savedstate-*:1.4.0 Wersja 1.4.0 zawiera te zatwierdzenia.
Wersja 1.4.0-rc01
22 października 2025 r.
Wersja androidx.savedstate:savedstate-*:1.4.0-rc01 została opublikowana bez zmian w stosunku do wersji 1.4.0-beta01. Wersja 1.4.0-rc01 zawiera te zatwierdzenia.
Wersja 1.4.0-beta01
8 października 2025 r.
Wersja androidx.savedstate:savedstate-*:1.4.0-beta01 nie zawiera żadnych istotnych zmian w porównaniu z ostatnią wersją alfa. Wersja 1.4.0-beta01 zawiera te zatwierdzenia.
Wersja 1.4.0-alpha03
27 sierpnia 2025 roku
Publikacja androidx.savedstate:savedstate-*:1.4.0-alpha03 Wersja 1.4.0-alpha03 zawiera te zatwierdzenia.
Zmiany w interfejsie API
- Dodaj obsługę typów dopuszczających wartości null w
encodeToSavedStateidecodeFromSavedState. (I79062, b/439527454) - Zaktualizuj Compose do wersji 1.9.0. (I2b9de)
Wersja 1.4.0-alpha02
13 sierpnia 2025 r.
Publikacja androidx.savedstate:savedstate-*:1.4.0-alpha02 Wersja 1.4.0-alpha02 zawiera te zatwierdzenia.
Wersja 1.4.0-alpha01
30 lipca 2025 r.
Publikacja androidx.savedstate:savedstate-*:1.4.0-alpha01 Wersja 1.4.0-alpha01 zawiera te zatwierdzenia.
Zmiany w interfejsie API
- Dodaliśmy natywną obsługę typów dopuszczających wartości null w
SavedStateRegistryOwner.saved, co upraszcza zapisywanie i przywracanie właściwości dopuszczających wartości null. (Ia632, b/421325690)
Wersja 1.3
Wersja 1.3.3
17 września 2025 r.
Publikacja androidx.savedstate:savedstate-*:1.3.3 Wersja 1.3.3 zawiera te zatwierdzenia.
Poprawki błędów
- Naprawiliśmy błąd polegający na tym, że wtyczka Compose Compiler nie była stosowana, co powodowało uszkodzenie artefaktów
SavedStateKMP. (Id2290, b/443965665)
Wersja 1.3.2
27 sierpnia 2025 roku
Publikacja androidx.savedstate:savedstate-*:1.3.2 Wersja 1.3.2 zawiera te zatwierdzenia.
Nowe funkcje
- Dodano nowe cele Kotlin Multiplatform (KMP) do artefaktu SavedState
*-compose. Lifecycle obsługuje teraz te platformy: JVM (Android i komputery), Native (Linux, iOS, watchOS, macOS, MinGW) i Web (JavaScript, WasmJS). (/Idcf26)
Wersja 1.3.1
16 lipca 2025 r.
Publikacja androidx.savedstate:savedstate-*:1.3.1 Wersja 1.3.1 zawiera te zatwierdzenia.
Poprawki błędów
- Dodaj wszystkie cele KMP obsługiwane przez adnotacje do artefaktów
SavedState. - Dodaliśmy nowe cele Kotlin Multiplatform (KMP) do artefaktów
SavedState.SavedStateobsługuje teraz te platformy: JVM (Android i komputery), Native (Linux, iOS, watchOS, macOS, MinGW) i Web (JavaScript, WasmJS). Pamiętaj, że do artefaktów*-composenie dodano żadnych nowych środowisk docelowych KMP, ponieważ zależy to od stabilnej wersji Compose 1.9. (I062f4).
Wersja 1.3.0
7 maja 2025 r.
Publikacja androidx.savedstate:savedstate-*:1.3.0 Wersja 1.3.0 zawiera te zatwierdzenia.
Ważne zmiany od wersji 1.2.0
- Klasa
LocalSavedStateRegistryOwnerzostała przeniesiona z interfejsu Compose UI do nowego modułusavedstate-compose, dzięki czemu jej interfejsy API pomocnicze oparte na Compose mogą być używane poza interfejsem Compose UI. Należy go zawsze używać w przypadku interfejsu Compose w wersji1.9.0-alpha02i nowszych, ale jest on zgodny wstecznie, więc można go używać ze wszystkimi wersjami Compose. - Rozszerzenia kotlin
savedstate-ktxzostały przeniesione do podstawowego modułu savedstate. - Instancje
SavedStateRegistryOwnerpobrane za pomocąfindViewTreeSavedStateRegistryOwnermożna teraz rozwiązywać za pomocą rozłącznych elementów nadrzędnych widoku, takich jakViewOverlay. Więcej informacji o rozłącznych widokach nadrzędnych znajdziesz w informacjach o wersji podstawowej lub w dokumentacji wViewTree.setViewTreeDisjointParent.
Kotlin Multiplatform
- Moduł
SavedStatejest teraz zgodny z KMP. Obsługiwane platformy obejmują teraz Androida, iOS, Linuksa, Maca i środowiska komputerowe JVM. Wprowadzamy nieprzezroczysty typ
SavedStatejako abstrakcję, aby zapewnić spójny sposób zapisywania i przywracania stanu aplikacji w KMP. Zawiera onSavedStateReaderiSavedStateWriterdo modyfikowania stanu, który ma zostać zapisany. Na AndroidzieSavedStateto alias typu dlaBundle, który zapewnia zgodność plików binarnych i ułatwia migrację istniejących interfejsów API do wspólnego zbioru źródeł. Na innych platformachSavedStateto instancjaMap<String, Any>.// 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") }
Obsługa serializacji KotlinX
SavedStateobsługuje teraz serializację KotlinX. Klasę z adnotacją@Serializablemożesz przekonwertować naSavedStateza pomocą metodencodeToSavedStateidecodeFromSavedState. Zwrócony obiektSavedStateto zwykły obiektBundlena Androidzie, który może być używany przez dowolny interfejs API akceptujący obiektBundle.@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) }Większość typów (np. typy podstawowe) jest obsługiwana bezpośrednio bez konieczności konfiguracji, ale dodatkowe serializatory, których można używać z
@Serializable(with = ___:class), znajdziesz w pakiecieandroidx.savedstate.serialization.serializersw modulesavedstatei w pakiecieandroidx.savedstate.compose.serialization.serializersw modulesavedstate-compose.Dodaliśmy też
saved, czyli delegat właściwości lazy, aby ułatwić przechowywanie klas@SerializablewSavedStateRegistryOwner(np.ComponentActivity,Fragmentitd.) i automatycznie przywracać te klasy po śmierci procesu i ponownym utworzeniu. Pamiętaj, że delegatsavedjest leniwy i nie wywoła funkcji lambdainitani nie zapisze niczego wSavedStateRegistry, dopóki nie zostanie wywołany.@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") } }W Lifecycle
2.9.0dodano podobny obiekt delegowany właściwościsaveddlaSavedStateHandle.
Wersja 1.3.0-rc01
23 kwietnia 2025 r.
Publikacja androidx.savedstate:savedstate-*:1.3.0-rc01 Wersja 1.3.0-rc01 zawiera te zatwierdzenia.
Wersja 1.3.0-beta01
9 kwietnia 2025 r.
Publikacja androidx.savedstate:savedstate-*:1.3.0-beta01 Wersja 1.3.0-beta01 zawiera te zatwierdzenia.
Aktualizacje zależności
- Ta biblioteka jest teraz kierowana na poziom języka Kotlin 2.0 i wymaga KGP w wersji 2.0.0 lub nowszej. (Idb6b5)
Wersja 1.3.0-alpha11
26 marca 2025 r.
Wersja androidx.savedstate:savedstate-*:1.3.0-alpha11 nie zawiera żadnych istotnych zmian publicznych. Wersja 1.3.0-alpha11 zawiera te zatwierdzenia.
Wersja 1.3.0-alpha10
12 marca 2025 r.
Publikacja androidx.savedstate:savedstate-*:1.3.0-alpha10 Wersja 1.3.0-alpha10 zawiera te zatwierdzenia.
Nowe funkcje
- Dodaj niereifikowane warianty metod dla kolekcji
getwSavedStateReader. (I0b641, b/399820614) - Dodaj
encodeDefaultsdoSavedStateConfiguration, aby umożliwić dostosowywanie, czy właściwości z wartościami domyślnymi powinny być kodowane. (I893cc, b/395104517) - Dodaj
SnapshotStateMapSerializer, aby wesprzećmutableStateMapOf. (Ie6f19, b/378895074) - Dodaj
SnapshotStateListSerializer, aby wesprzećmutableStateListOf. (I4d888, b/378895074) - Dodaj
getOrNullmetody alternatywne dlaSavedStateReader.getwariantów. Te metody będą automatycznie pakować wartości podstawowe. (I6228c, b/399820614)
Zmiany w interfejsie API
- Usuń
getOrElsezSavedStateReaderna rzeczgetOrNull() ?: else(). (I87317, b/399820614) - Usunięto modyfikator
inlinez metodSavedStateReaderiSavedStateWriter. (If2a02, b/399820614) - Usunięto wbudowane serializatory List i Array na Androida z publicznego interfejsu API (Ida293)
- Zastąp
SparseParcelableArraySerializerelementemSparseArraySerializer(I91de8) - Ujednolicenie działania wszystkich funkcji
SavedStateReader.getprzez zgłaszanie błędu, gdy typ wartości nie pasuje do zwracanego typu (I78c4a, b/399317598) - Zmień nazwę
SavedState*DelegatesnaSavedState*Delegate. (I8589b, b/399629301) - Zmień nazwę
SavedStateConfignaSavedStateConfiguration. (I043a5, b/399629301)
Wersja 1.3.0-alpha09
26 lutego 2025 r.
Publikacja androidx.savedstate:savedstate-*:1.3.0-alpha09 Wersja 1.3.0-alpha09 zawiera te zatwierdzenia.
Nowe funkcje
- Dodaj kreację zastępczą dla typów wbudowanych, aby wszystkie typy obsługiwane przez
Bundlemogły być domyślnie używane zencodeAsSavedState/decodeFromSavedStatelub, w przypadku właściwości w klasach@Serializable, za pomocą adnotacji@Contextual. (Ic01d2) - Uwzględnij obsługę
classDiscriminatoriclassDiscriminatorModenaSavedStateConfig. (I69b66, b/395104517)
Zmiany w interfejsie API
- Dodanie parametru
SavedStateConfigdo obiektów delegowanychsaved()(I39b3a) - Wbudowane serializatory są teraz obiektami typu singleton (Ifeee4).
- Właściwości
SavedStateConfigsą teraz publiczne, co umożliwia innym modułom korzystanie z tych konfiguracji. (Ie5f49, b/378897438) - Obsługa
@Serializer(with = ...)w przypadkuMutableStateFlowSerializeriMutableStateSerializer(I90953) - Dodaj
contentDeepToStringdoSavedStateReader(I14d10)
Wersja 1.3.0-alpha08
12 lutego 2025 r.
Publikacja androidx.savedstate:savedstate-*:1.3.0-alpha08 Wersja 1.3.0-alpha08 zawiera te zmiany.
Nowe funkcje
- Przenieśliśmy
MutableStateSerializerdosavedstate-composezlifecycle-viewmodel-compose, co umożliwia korzystanie z interfejsów API serializacji SavedState zMutableStatew Compose. (I4f690, b/378895074)
Zmiany w interfejsie API
- Dodaj funkcję fabryczną, aby utworzyć
SavedStatez istniejącegoSavedState. (I39f9a) - Dodaliśmy obsługę właściwości
Array<SavedState>iList<SavedState>wandroidx.savedstate. (Idd8a5) - Dodanie opcjonalnego parametru
SavedStateConfigdo kodowania/dekodowania SavedState (I6c4c0)
Wersja 1.3.0-alpha07
29 stycznia 2025 r.
Publikacja androidx.savedstate:savedstate-*:1.3.0-alpha07 Wersja 1.3.0-alpha07 zawiera te zmiany.
Nowe funkcje
- Dodaj
MutableStateFlowSerializer, aby serializowaćkotlinx.coroutines.flow.MutableStateFlow. (I6a892, b/378895070)
Zmiany w interfejsie API
- Zastąp przeciążone funkcje delegowane
SavedStateRegistryOwner.saved()parametrami domyślnymi (Icd1c1) - Ustaw
JavaSerializableSerializeriParcelableSerializerjako abstrakcyjne (I268f6) - Usuń ogólny element
T : CharSequencezCharSequenceSerializer(Ib40bd)
Wersja 1.3.0-alpha06
11 grudnia 2024 r.
Publikacja androidx.savedstate:savedstate-*:1.3.0-alpha06 Wersja 1.3.0-alpha06 zawiera te zmiany.
Nowe funkcje
SavedStateKMP obsługuje teraz:IBinder,Size,SizeF,Array<Parcelable>,SparseArray<Parcelable>i Serializable (Android). (I1ba94, b/334076622)- Dodaj instancje
KSerializer, których można używać do kodowania i dekodowania typów Java i Android obsługiwanych przez Bundle, oznaczając odpowiednie pole w klasie za pomocą@Serializable(with = ParcelableSerializer::class). (I8c10f, I28caf, b/376026712) - Instancje
SavedStateRegistryOwnerpobrane za pomocąfindViewTreeSavedStateRegistryOwnermożna teraz rozwiązywać za pomocą rozłącznych elementów nadrzędnych widoku, takich jakViewOverlay. Więcej informacji o rozłącznych widokach nadrzędnych znajdziesz w informacjach o wersji podstawowej lub w dokumentacji wViewTree.setViewTreeDisjointParent. (Iccb33)
Zmiany w interfejsie API
- Ujednoliciliśmy nazewnictwo i organizację pakietów z
SavedStateRegistryOwnerDelegate(I8c135, b/376026744).
Wersja 1.3.0-alpha05
13 listopada 2024 r.
Publikacja androidx.savedstate:savedstate-*:1.3.0-alpha05 Wersja 1.3.0-alpha05 zawiera te zmiany.
Obsługa serializacji KotlinX
SavedStateobsługuje teraz serializację KotlinX. Klasę z adnotacją@Serializablemożesz przekonwertować naSavedStateza pomocą metodencodeToSavedStateidecodeFromSavedState. Zwrócony obiektSavedStateto zwykły obiektBundlena Androidzie, który może być używany przez dowolny interfejs API akceptujący obiektBundle. (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) }Dodaliśmy też
saved, czyli delegat właściwości lazy, aby ułatwić przechowywanie klas@SerializablewSavedStateRegistryOwner(np.ComponentActivity,Fragmentitd.) i automatycznie przywracać te klasy po śmierci procesu i ponownym utworzeniu. Pamiętaj, że delegatsavedjest leniwy i nie wywoła funkcji lambdainitani nie zapisze niczego wSavedStateRegistry, dopóki nie zostanie wywołany. (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") } }W Lifecycle
2.9.0-alpha07dodano podobny obiekt delegowany właściwościsaveddlaSavedStateHandle.
Zmiany w interfejsie API
- Dodaj
toMapdoSavedState, aby umożliwić przekonwertowanie dowolnegoSavedStatena zwykłyMap(płytka kopia). (I487b9, b/334076622) SavedStateKMP obsługuje teraz tablice. (Ic0552, b/334076622)
Wersja 1.3.0-alpha04
30 października 2024 r.
Publikacja androidx.savedstate:savedstate-*:1.3.0-alpha04 Wersja 1.3.0-alpha04 zawiera te zatwierdzenia.
Zmiany w interfejsie API
- SavedState KMP obsługuje teraz typ Char. (I9ac2f, b/334076622)
- Dodaj
putNulliisNulldo SavedState KMP. (Iea71d, b/334076622) - Dodano dodatkowe parametry fabryczne
savedStateobsługujące inicjałMap<String, Any>(I9b37d, b/334076622). - SavedState KMP obsługuje teraz porównywanie
contentDeepEquals. (Ia515c, b/334076622) - SavedState KMP obsługuje teraz typ Long. (I4c180, b/334076622)
Wersja 1.3.0-alpha03
16 października 2024 r.
Wersja androidx.savedstate:savedstate-*:1.3.0-alpha03 nie zawiera żadnych istotnych zmian. Wersja 1.3.0-alpha03 zawiera te zatwierdzenia.
Wersja 1.3.0-alpha02
2 października 2024 r.
Publikacja androidx.savedstate:savedstate-*:1.3.0-alpha02 Wersja 1.3.0-alpha02 zawiera te zatwierdzenia.
Kotlin Multiplatform
- Moduł
SavedStatejest teraz zgodny z KMP. Obsługiwane platformy obejmują teraz Androida, iOS, Linuksa, Maca i środowiska komputerowe JVM. (I26305, b/334076622)
Nowe funkcje
- Wprowadzamy nieprzezroczysty typ
SavedStatejako abstrakcję, aby zapewnić spójny sposób zapisywania i przywracania stanu aplikacji w KMP. Zawiera onSavedStateReaderiSavedStateWriterdo modyfikowania stanu, który ma zostać zapisany. Na AndroidzieSavedStateto alias typu dlaBundle, który zapewnia zgodność plików binarnych i ułatwia migrację istniejących interfejsów API do wspólnego zbioru źródeł. Na innych platformachSavedStateto instancjaMap<String, Any>. (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")
}
Zmiany w interfejsie API
SavedStateRegistryiSavedStateRegistryControllersą teraz zgodne z KMP. (Id7bb8, b/334076622)- Biblioteki
SavedState,SavedStateWriteriSavedStateReadersą teraz zgodne z KMP. (I26305, b/334076622)
Wersja 1.3.0-alpha01
7 sierpnia 2024 r.
Publikacja androidx.savedstate:savedstate:1.3.0-alpha01 i androidx.savedstate:savedstate-ktx:1.3.0-alpha01 Wersja 1.3.0-alpha01 zawiera te zatwierdzenia.
Zmiany w interfejsie API
- Rozszerzenia kotlin
savedstate-ktxzostały przeniesione do podstawowego modułu savedstate. (I1cc18, b/274803094)
Uwaga
- Zaktualizuj
compileSdkdo wersji 35 (5dc41be)
Wersja 1.2.1
Wersja 1.2.1
22 marca 2023 r.
Publikacja androidx.savedstate:savedstate:1.2.1 i androidx.savedstate:savedstate-ktx:1.2.1 Wersja 1.2.1 zawiera te zatwierdzenia.
Aktualizacje zależności
SavedStatezależy teraz od Lifecycle2.6.1. (c1f621)
Wersja 1.2.0
Wersja 1.2.0
29 czerwca 2022 r.
Publikacja androidx.savedstate:savedstate:1.2.0 i androidx.savedstate:savedstate-ktx:1.2.0 Wersja 1.2.0 zawiera te zatwierdzenia.
Ważne zmiany od wersji 1.1.0
SavedStateRegistryControllerumożliwia teraz wcześniejsze dołączenieSavedStateRegistryza pomocąperformAttach().- Możesz teraz pobrać wcześniej zarejestrowany
SavedStateProviderzSavedStateRegistryza pomocągetSavedStateProvider(). - Biblioteka
SavedStatezostała przepisana w języku Kotlin.- W przypadku
SavedStateRegistryOwnerjest to zmiana niezgodna ze źródłem w klasach napisanych w Kotlinie – musisz teraz zastąpić właściwośćsavedStateRegistry, a nie implementować poprzednią funkcjęgetSavedStateRegistry(). - W przypadku
ViewTreeSavedStateRegistryOwnerjest to zmiana niezgodna ze źródłem w odniesieniu do klas napisanych w języku Kotlin – musisz teraz bezpośrednio importować i używać metod rozszerzenia Kotlin wViewklasandroidx.savedstate.setViewTreeSavedStateRegistryOwneriandroidx.savedstate.findViewTreeSavedStateRegistryOwner, aby ustawić i znaleźć wcześniej ustawionego właściciela. Zastępuje on interfejs APIsavedstate-ktxwfindViewTreeSavedStateRegistryOwner.
- W przypadku
Zmiany w zachowaniu
SavedStateRegistrynie zapisuje już pustego pakietu, jeśli nie ma stanu do zapisania.
Wersja 1.2.0-rc01
11 maja 2022 roku
Publikacja androidx.savedstate:savedstate:1.2.0-rc01 i androidx.savedstate:savedstate-ktx:1.2.0-rc01 Wersja 1.2.0-rc01 zawiera te zatwierdzenia.
Zmiany w dokumentacji
- Zaktualizowaliśmy dokumentację Kdoc dla
SavedStateRegistryOwner, aby wyjaśnić obowiązki i umowę właściciela dotyczące sposobu implementacji interfejsu lub wywoływania metod wSavedStateRegistryController. (Iefc95, b/228887344)
Wersja 1.2.0-beta01
20 kwietnia 2022 r.
Publikacja androidx.savedstate:savedstate:1.2.0-beta01 i androidx.savedstate:savedstate-ktx:1.2.0-beta01 Wersja 1.2.0-beta01 zawiera te zatwierdzenia.
Zmiany w interfejsie API
- Klasy
SavedStateRegistryiViewTreeSavedStateRegistryOwnerzostały przepisane w języku Kotlin. W przypadkuViewTreeSavedStateRegistryOwnerjest to zmiana niezgodna ze źródłem w odniesieniu do klas napisanych w języku Kotlin – musisz teraz bezpośrednio importować i używać metod rozszerzenia Kotlin wViewklasandroidx.savedstate.setViewTreeSavedStateRegistryOwneriandroidx.savedstate.findViewTreeSavedStateRegistryOwner, aby ustawić i znaleźć wcześniej ustawionego właściciela. Zastępuje on interfejs APIsavedstate-ktxwfindViewTreeSavedStateRegistryOwner. Jest on zgodny binarnie i zachowuje zgodność źródłową w przypadku implementacji napisanych w języku programowania Java. (b/220191285)
Wersja 1.2.0-alpha02
6 kwietnia 2022 roku
Publikacja androidx.savedstate:savedstate:1.2.0-alpha02 i androidx.savedstate:savedstate-ktx:1.2.0-alpha02 Wersja 1.2.0-alpha02 zawiera te zatwierdzenia.
Nowe funkcje
- Możesz teraz pobrać wcześniej zarejestrowany
SavedStateProviderzSavedStateRegistryza pomocągetSavedStateProvider(). (I7ea47, b/215406268)
Zmiany w interfejsie API
- Klasy
SavedStateRegistryOwner,SavedStateRegistryControlleriRecreatorzostały przepisane w języku Kotlin. W przypadkuSavedStateRegistryOwnerjest to zmiana niezgodna ze źródłem dla klas napisanych w Kotlinie – musisz teraz zastąpić właściwośćsavedStateRegistry, zamiast implementować poprzednią funkcjęgetSavedStateRegistry(). Jest on zgodny pod względem binarnym i źródłowym z implementacjami napisanymi w języku programowania Java. (b/220191285)
Wersja 1.2.0-alpha01
26 stycznia 2022 r.
Publikacja androidx.savedstate:savedstate:1.2.0-alpha01 i androidx.savedstate:savedstate-ktx:1.2.0-alpha01 Wersja 1.2.0-alpha01 zawiera te zatwierdzenia.
Nowe funkcje
SavedStateRegistryControllerumożliwia teraz wcześniejsze dołączenieSavedStateRegistryza pomocąperformAttach(). (Ice4bf)
Zmiany w zachowaniu
SavedStateRegistrynie zapisuje już pustego pakietu, jeśli nie ma stanu do zapisania. (aosp/1896865, b/203457956)
Wersja 1.1.0
Wersja 1.1.0
10 lutego 2021 r.
Publikacja androidx.savedstate:savedstate:1.1.0 i androidx.savedstate:savedstate-ktx:1.1.0 Wersja 1.1.0 zawiera te zatwierdzenia.
Najważniejsze zmiany od wersji 1.0.0
- Interfejs API
ViewTreeSavedStateRegistryOwner: nowy interfejs APIViewTreeSavedStateRegistryOwner.get(View)umożliwia pobieranie zawierającegoSavedStateRegistrydla danej instancjiView. Aby prawidłowo wypełnić to pole, musisz przejść na Activity1.2.0, Fragment1.3.0i AppCompat1.3.0-alpha01lub nowszą wersję. - Artefakt
savedstate-ktx: dodano nowy artefaktsavedstate-ktxz rozszerzeniemfindViewTreeSavedStateRegistryOwner()Kotlin do pracy zViewTreeSavedStateRegistryOwner.
Wersja 1.1.0-rc01
16 grudnia 2020 roku
Wersje androidx.savedstate:savedstate:1.1.0-rc01 i androidx.savedstate:savedstate-ktx:1.1.0-rc01 zostały opublikowane bez zmian od wersji 1.1.0-beta01. Wersja 1.1.0-rc01 zawiera te zatwierdzenia.
Wersja 1.1.0-beta01
1 października 2020 roku
Wersje androidx.savedstate:savedstate:1.1.0-beta01 i androidx.savedstate:savedstate-ktx:1.1.0-beta01 zostały opublikowane bez zmian od wersji 1.1.0-alpha01. Wersja 1.1.0-beta01 zawiera te zatwierdzenia.
Wersja 1.1.0-alpha01
20 maja 2020 r.
Publikacja androidx.savedstate:savedstate:1.1.0-alpha01 i androidx.savedstate:savedstate-ktx:1.1.0-alpha01 Wersja 1.1.0-alpha01 zawiera te zatwierdzenia.
Nowe funkcje
- Nowy interfejs API
ViewTreeSavedStateRegistryOwner.get(View)umożliwia pobieranie zawierającegoSavedStateRegistrydla danej instancjiView. Aby prawidłowo wypełnić to pole, musisz przejść na Activity1.2.0-alpha05, Fragment1.3.0-alpha05i AppCompat1.3.0-alpha01. (aosp/1298679) - Dodano nowy artefakt
savedstate-ktxz rozszerzeniem KotlinfindViewTreeSavedStateRegistryOwner()do pracy zViewTreeSavedStateRegistryOwner. (aosp/1299434)
Wersja 1.0.0
Wersja 1.0.0
5 września 2019 r.
Publikacja androidx.savedstate:savedstate:1.0.0 Zatwierdzenia uwzględnione w tej wersji znajdziesz tutaj.
Najważniejsze funkcje SavedState 1.0.0
Wersja androidx.savedstate została oznaczona jako stabilna. Jest to zestaw interfejsów API, które umożliwiają deweloperom podłączanie komponentów do procesu przywracania/saveInstanceState. Głównym punktem wejścia interfejsu API jest SavedStateRegistry, który umożliwia pobieranie wcześniej zapisanych stanów za pomocą consumeRestoredStateForKey i rejestrowanie wywołania zwrotnego w registerSavedStateProvider, aby udostępnić zapisany stan, gdy system o niego poprosi.
Wersja 1.0.0-rc01
2 lipca 2019 r.
Publikacja androidx.savedstate:savedstate:1.0.0-rc01 Zatwierdzenia uwzględnione w tej wersji znajdziesz tutaj.
Poprawki błędów
- Naprawiono nieprawidłową regułę ProGuard (b/132655499).
Wersja 1.0.0-beta01
7 maja 2019 r.
Publikacja androidx.savedstate:savedstate:1.0.0-beta01 Zatwierdzenia uwzględnione w tej wersji znajdziesz tutaj.
Wersja 1.0.0-alpha02
13 marca 2019 r.
Publikacja androidx.savedstate:savedstate:1.0.0-alpha02 androidx.savedstate:savedstate łączy artefakty androidx.savedstate:savedstate-bundle i androidx.savedstate:savedstate-common w jeden, ponieważ zdecydowano się uprościć infrastrukturę savedstate i usunąć typy ogólne z SavedStateRegistry. Nie ma więc potrzeby tworzenia osobnych modułów.
Pełną listę zatwierdzeń uwzględnionych w tej wersji znajdziesz tutaj.
Nowe funkcje
- Dodano użytkownika
SavedStateRegistry.runOnNextRecreaction(Class<? extends AutoRecreated> clazz ). Po ponownym uruchomieniu komponentu nadrzędnego zostanie utworzona instancja podanej klasy i uruchomiona metodaAutoRecreated.onRecreated.
Zmiany w interfejsie API
- Usunięto leki generyczne z:
SavedStateRegistry<T> - Klasy AbstractSavedStateRegistry i BundlableSavedStateRegistry zostały usunięte. Zamiast nich używaj prostej klasy
SavedStateRegistry. - Nazwa
BundleSavedStateRegistryOwnerzostała zmieniona naSavedStateRegistryOwner
Wersja 1.0.0-alpha01
17 grudnia 2018 r.
To jest pierwsza wersja aplikacji SavedState.
Nowe funkcje
androidx.savedstate to nowy zestaw interfejsów API w wersji alfa, które umożliwiają deweloperom podłączanie komponentów do procesu przywracania/saveInstanceState. Głównym punktem wejścia interfejsu API jest SavedStateRegistry<T>, który umożliwia pobieranie wcześniej zapisanego stanu za pomocą consumeRestoredStateForKey i rejestrowanie wywołania zwrotnego w registerSavedStateProvider, aby udostępnić zapisany stan, gdy system o niego poprosi.