Savedstate

tworzyć komponenty, które zapisują stan interfejsu, gdy proces zostanie przerwany, i przywracają go po ponownym uruchomieniu procesu;
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.

Tworzenie nowego problemu

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ć compositionLocalWithHostDefaultOf i SavedStateRegistryOwnerHostDefaultKey, 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 dla SaveableStateRegistry, SavedStateHandle i SavedStateRegisty. (I1da6d)
  • Dodano asContainer(), getOrCreateContainer() do SavedStateRegistry, aby umożliwić tworzenie kontenerów podrzędnych z SavedStateRegistry. (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-runtime został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 SavedStateRegistry i sprawiliśmy, że SavedStateRegistry implementuje SavedStateProvider i SavedStateRestorer. (I3c696)
  • Dodano interfejs SavedStateProvider najwyższego poziomu. (I20f9d)
  • Dodano interfejs najwyższego poziomu SavedStateRestorer z restoreState(savedState: SavedState?) i usunięto nieopublikowany interfejs SavedStateRegistry.SavedStateConsumer. (Idc01d)
  • Metody AutoRecreated i runOnNextRecreation zostały wycofane na rzecz metod SavedStateProvider i SavedStateRestorer. (Iadc00)
  • Wprowadź interfejs SavedStateConsumer w SavedStateRegistry. 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 LocalSavedStateRegistryOwner wymagany 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ń putKotlinSerializable i getKotlinSerializable do SavedStateWriter i SavedStateReader, 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, ViewModelStoreOwner i SavedStateRegistryOwner, 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ć SnapshotStateSet w rememberSerializable bez 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ń putKotlinSerializable i getKotlinSerializable do SavedStateWriter i SavedStateReader, aby umożliwić bezpośrednie przechowywanie i pobieranie obiektów Kotlin Serializable za pomocą kluczy, co usprawni integrację z interfejsami API SavedState. (Iba02e)
  • Dodaj funkcje fabryczne dla LifecycleOwner, ViewModelStoreOwner i SavedStateRegistryOwner, 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ć SnapshotStateSet w rememberSerializable bez 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 encodeToSavedState i decodeFromSavedState. (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 SavedState KMP. (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. SavedState obsługuje teraz te platformy: JVM (Android i komputery), Native (Linux, iOS, watchOS, macOS, MinGW) i Web (JavaScript, WasmJS). Pamiętaj, że do artefaktów *-compose nie 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 LocalSavedStateRegistryOwner została przeniesiona z interfejsu Compose UI do nowego modułu savedstate-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 wersji 1.9.0-alpha02 i nowszych, ale jest on zgodny wstecznie, więc można go używać ze wszystkimi wersjami Compose.
  • Rozszerzenia kotlin savedstate-ktx zostały przeniesione do podstawowego modułu savedstate.
  • Instancje SavedStateRegistryOwner pobrane za pomocą findViewTreeSavedStateRegistryOwner można teraz rozwiązywać za pomocą rozłącznych elementów nadrzędnych widoku, takich jak ViewOverlay. Więcej informacji o rozłącznych widokach nadrzędnych znajdziesz w informacjach o wersji podstawowej lub w dokumentacji w ViewTree.setViewTreeDisjointParent.

Kotlin Multiplatform

  • Moduł SavedState jest teraz zgodny z KMP. Obsługiwane platformy obejmują teraz Androida, iOS, Linuksa, Maca i środowiska komputerowe JVM.
  • Wprowadzamy nieprzezroczysty typ SavedState jako abstrakcję, aby zapewnić spójny sposób zapisywania i przywracania stanu aplikacji w KMP. Zawiera on SavedStateReader i SavedStateWriter do modyfikowania stanu, który ma zostać zapisany. Na Androidzie SavedState to alias typu dla Bundle, który zapewnia zgodność plików binarnych i ułatwia migrację istniejących interfejsów API do wspólnego zbioru źródeł. Na innych platformach SavedState to instancja Map<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

  • SavedState obsługuje teraz serializację KotlinX. Klasę z adnotacją @Serializable możesz przekonwertować na SavedState za pomocą metod encodeToSavedState i decodeFromSavedState. Zwrócony obiekt SavedState to zwykły obiekt Bundle na Androidzie, który może być używany przez dowolny interfejs API akceptujący obiekt Bundle.

    @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 pakiecie androidx.savedstate.serialization.serializers w module savedstate i w pakiecie androidx.savedstate.compose.serialization.serializers w module savedstate-compose.

  • Dodaliśmy też saved, czyli delegat właściwości lazy, aby ułatwić przechowywanie klas @Serializable w SavedStateRegistryOwner (np. ComponentActivity, Fragment itd.) i automatycznie przywracać te klasy po śmierci procesu i ponownym utworzeniu. Pamiętaj, że delegat saved jest leniwy i nie wywoła funkcji lambda init ani nie zapisze niczego w SavedStateRegistry, 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.0 dodano podobny obiekt delegowany właściwości saved dla SavedStateHandle.

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 get w SavedStateReader. (I0b641, b/399820614)
  • Dodaj encodeDefaults do SavedStateConfiguration, 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 getOrNull metody alternatywne dla SavedStateReader.get wariantów. Te metody będą automatycznie pakować wartości podstawowe. (I6228c, b/399820614)

Zmiany w interfejsie API

  • Usuń getOrElse z SavedStateReader na rzecz getOrNull() ?: else(). (I87317, b/399820614)
  • Usunięto modyfikator inline z metod SavedStateReader i SavedStateWriter. (If2a02, b/399820614)
  • Usunięto wbudowane serializatory List i Array na Androida z publicznego interfejsu API (Ida293)
  • Zastąp SparseParcelableArraySerializer elementem SparseArraySerializer (I91de8)
  • Ujednolicenie działania wszystkich funkcji SavedStateReader.get przez zgłaszanie błędu, gdy typ wartości nie pasuje do zwracanego typu (I78c4a, b/399317598)
  • Zmień nazwę SavedState*Delegates na SavedState*Delegate. (I8589b, b/399629301)
  • Zmień nazwę SavedStateConfig na SavedStateConfiguration. (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 Bundle mogły być domyślnie używane z encodeAsSavedState/decodeFromSavedState lub, w przypadku właściwości w klasach @Serializable, za pomocą adnotacji @Contextual. (Ic01d2)
  • Uwzględnij obsługę classDiscriminator i classDiscriminatorMode na SavedStateConfig. (I69b66, b/395104517)

Zmiany w interfejsie API

  • Dodanie parametru SavedStateConfig do obiektów delegowanych saved() (I39b3a)
  • Wbudowane serializatory są teraz obiektami typu singleton (Ifeee4).
  • Właściwości SavedStateConfig są teraz publiczne, co umożliwia innym modułom korzystanie z tych konfiguracji. (Ie5f49, b/378897438)
  • Obsługa @Serializer(with = ...) w przypadku MutableStateFlowSerializer i MutableStateSerializer (I90953)
  • Dodaj contentDeepToString do SavedStateReader (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 MutableStateSerializer do savedstate-compose z lifecycle-viewmodel-compose, co umożliwia korzystanie z interfejsów API serializacji SavedState z MutableState w Compose. (I4f690, b/378895074)

Zmiany w interfejsie API

  • Dodaj funkcję fabryczną, aby utworzyć SavedState z istniejącego SavedState. (I39f9a)
  • Dodaliśmy obsługę właściwości Array<SavedState> i List<SavedState> w androidx.savedstate. (Idd8a5)
  • Dodanie opcjonalnego parametru SavedStateConfig do 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 JavaSerializableSerializer i ParcelableSerializer jako abstrakcyjne (I268f6)
  • Usuń ogólny element T : CharSequence z CharSequenceSerializer (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

  • SavedState KMP 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 SavedStateRegistryOwner pobrane za pomocą findViewTreeSavedStateRegistryOwner można teraz rozwiązywać za pomocą rozłącznych elementów nadrzędnych widoku, takich jak ViewOverlay. Więcej informacji o rozłącznych widokach nadrzędnych znajdziesz w informacjach o wersji podstawowej lub w dokumentacji w ViewTree.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

  • SavedState obsługuje teraz serializację KotlinX. Klasę z adnotacją @Serializable możesz przekonwertować na SavedState za pomocą metod encodeToSavedState i decodeFromSavedState. Zwrócony obiekt SavedState to zwykły obiekt Bundle na Androidzie, który może być używany przez dowolny interfejs API akceptujący obiekt Bundle. (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 @Serializable w SavedStateRegistryOwner (np. ComponentActivity, Fragment itd.) i automatycznie przywracać te klasy po śmierci procesu i ponownym utworzeniu. Pamiętaj, że delegat saved jest leniwy i nie wywoła funkcji lambda init ani nie zapisze niczego w SavedStateRegistry, 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-alpha07 dodano podobny obiekt delegowany właściwości saved dla SavedStateHandle.

Zmiany w interfejsie API

  • Dodaj toMap do SavedState, aby umożliwić przekonwertowanie dowolnego SavedState na zwykły Map (płytka kopia). (I487b9, b/334076622)
  • SavedState KMP 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

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ł SavedState jest 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 SavedState jako abstrakcję, aby zapewnić spójny sposób zapisywania i przywracania stanu aplikacji w KMP. Zawiera on SavedStateReader i SavedStateWriter do modyfikowania stanu, który ma zostać zapisany. Na Androidzie SavedState to alias typu dla Bundle, który zapewnia zgodność plików binarnych i ułatwia migrację istniejących interfejsów API do wspólnego zbioru źródeł. Na innych platformach SavedState to instancja Map<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

  • SavedStateRegistry i SavedStateRegistryController są teraz zgodne z KMP. (Id7bb8, b/334076622)
  • Biblioteki SavedState, SavedStateWriter i SavedStateReader są 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-ktx zostały przeniesione do podstawowego modułu savedstate. (I1cc18, b/274803094)

Uwaga

  • Zaktualizuj compileSdk do 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

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

  • SavedStateRegistryController umożliwia teraz wcześniejsze dołączenie SavedStateRegistry za pomocą performAttach().
  • Możesz teraz pobrać wcześniej zarejestrowany SavedStateProvider z SavedStateRegistry za pomocą getSavedStateProvider().
  • Biblioteka SavedState została przepisana w języku Kotlin.
    • W przypadku SavedStateRegistryOwner jest 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 ViewTreeSavedStateRegistryOwner jest 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 w View klas androidx.savedstate.setViewTreeSavedStateRegistryOwner i androidx.savedstate.findViewTreeSavedStateRegistryOwner, aby ustawić i znaleźć wcześniej ustawionego właściciela. Zastępuje on interfejs API savedstate-ktx w findViewTreeSavedStateRegistryOwner.

Zmiany w zachowaniu

  • SavedStateRegistry nie 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 w SavedStateRegistryController. (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 SavedStateRegistry i ViewTreeSavedStateRegistryOwner zostały przepisane w języku Kotlin. W przypadku ViewTreeSavedStateRegistryOwner jest 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 w View klas androidx.savedstate.setViewTreeSavedStateRegistryOwner i androidx.savedstate.findViewTreeSavedStateRegistryOwner, aby ustawić i znaleźć wcześniej ustawionego właściciela. Zastępuje on interfejs API savedstate-ktx w findViewTreeSavedStateRegistryOwner. 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 SavedStateProvider z SavedStateRegistry za pomocą getSavedStateProvider(). (I7ea47, b/215406268)

Zmiany w interfejsie API

  • Klasy SavedStateRegistryOwner, SavedStateRegistryController i Recreator zostały przepisane w języku Kotlin. W przypadku SavedStateRegistryOwner jest 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

  • SavedStateRegistryController umożliwia teraz wcześniejsze dołączenie SavedStateRegistry za pomocą performAttach(). (Ice4bf)

Zmiany w zachowaniu

  • SavedStateRegistry nie 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 API ViewTreeSavedStateRegistryOwner.get(View) umożliwia pobieranie zawierającego SavedStateRegistry dla danej instancji View. Aby prawidłowo wypełnić to pole, musisz przejść na Activity 1.2.0, Fragment 1.3.0 i AppCompat 1.3.0-alpha01 lub nowszą wersję.
  • Artefakt savedstate-ktx: dodano nowy artefakt savedstate-ktx z rozszerzeniem findViewTreeSavedStateRegistryOwner() Kotlin do pracy z ViewTreeSavedStateRegistryOwner.

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

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 metoda AutoRecreated.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 BundleSavedStateRegistryOwner została zmieniona na SavedStateRegistryOwner

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.