Savedstate

Напишите подключаемые компоненты, которые сохраняют состояние интерфейса при завершении процесса и восстанавливают его при перезапуске процесса.
Последнее обновление Основная версия Релиз-кандидат Бета-версия Альфа-версия
18 ноября 2026 г. 1.5.0 - - 1.6.0-alpha06

Объявление зависимостей

Чтобы добавить зависимость от SavedState, необходимо добавить в проект репозиторий Google Maven. Подробную информацию можно найти в статье Репозиторий Google Maven.

Добавьте зависимости для нужных артефактов в файл build.gradle приложения или модуля:

Круто

dependencies {
    // Java language implementation
    implementation "androidx.savedstate:savedstate:1.5.0"

    // Kotlin
    implementation "androidx.savedstate:savedstate-ktx:1.5.0"
}

Котлин

dependencies {
    // Java language implementation
    implementation("androidx.savedstate:savedstate:1.5.0")

    // Kotlin
    implementation("androidx.savedstate:savedstate-ktx:1.5.0")
}

Подробнее о добавлении зависимостей сборки…

Отзыв

Ваши отзывы помогают нам улучшать Jetpack. Если вы обнаружите новые проблемы или у вас появятся идеи по улучшению этой библиотеки, сообщите нам. Прежде чем сообщать о новых ошибках, изучите уже добавленные. Чтобы проголосовать за существующую проблему, нажмите на значок звездочки.

Как создать выпуск

Дополнительную информацию можно найти в документации по системе отслеживания ошибок.

Версия 1.6

Версия 1.6.0-alpha06

18 ноября 2026 г.

Данные "androidx.savedstate:savedstate-*:1.6.0-alpha06" опубликованы. Версия 1.6.0-alpha06 содержит эти коммиты.

Изменения в API

  • Перенесите LocalSavedStateRegistryOwner, чтобы использовать compositionLocalWithHostDefaultOf и SavedStateRegistryOwnerHostDefaultKey, отделив его от прямого извлечения в составе дерева представлений за пределами Android. (I6768f)

Версия 1.6.0-alpha05

21 октября 2026 г.

Данные "androidx.savedstate:savedstate-*:1.6.0-alpha05" опубликованы. Версия 1.6.0-alpha05 содержит эти коммиты.

Изменения в API

  • Добавлен новый API SavedStateContainer, который служит общей базой для реализации SaveableStateRegistry, SavedStateHandle и SavedStateRegisty. (I1da6d)
  • Добавлены asContainer(), getOrCreateContainer() в SavedStateRegistry, чтобы разрешить создание дочерних контейнеров из SavedStateRegistry. (Icb709)

Версия 1.6.0-alpha04

23 сентября 2026 г.

Данные "androidx.savedstate:savedstate-*:1.6.0-alpha04" опубликованы. Версия 1.6.0-alpha04 содержит эти коммиты.

Исправление ошибок

  • Зависимость androidx.lifecycle:lifecycle-runtime обновлена до версии 2.10.0. Эта версия необходима для запуска встроенных проверок жизненного цикла во время выполнения с AGP версии 9.5.0-alpha04 или более поздней. (I99bfd, b/556807521)

Версия 1.6.0-alpha03

9 сентября 2026 г.

Данные "androidx.savedstate:savedstate-*:1.6.0-alpha03" опубликованы. Версия 1.6.0-alpha03 содержит эти коммиты.

Изменения в API

  • Разрешено нулевое начальное состояние в конструкторе SavedStateRegistry. (I76006)

Версия 1.6.0-alpha02

26 августа 2026 г.

Данные "androidx.savedstate:savedstate-*:1.6.0-alpha02" опубликованы. Версия 1.6.0-alpha02 содержит эти коммиты.

Изменения в API

  • Добавлены общедоступные конструкторы в SavedStateRegistry, а также реализованы SavedStateProvider и SavedStateRestorer в SavedStateRegistry. (I3c696)
  • Добавлен интерфейс SavedStateProvider верхнего уровня. (I20f9d)
  • Добавлен интерфейс верхнего уровня SavedStateRestorer с restoreState(savedState: SavedState?) и удален невыпущенный SavedStateRegistry.SavedStateConsumer. (Idc01d)
  • AutoRecreated и runOnNextRecreation больше не поддерживаются. Вместо них используйте SavedStateProvider и SavedStateRestorer. (Iadc00)
  • Добавьте интерфейс SavedStateConsumer в SavedStateRegistry. Позволяет зарегистрированным поставщикам автоматически получать и использовать восстановленное состояние во время восстановления или сразу после регистрации, если состояние уже восстановлено. (I9a378)

Версия 1.6.0-alpha01

12 августа 2026 г.

Данные "androidx.savedstate:savedstate-*:1.6.0-alpha01" опубликованы. Версия 1.6.0-alpha01 содержит эти коммиты.

Исправление ошибок

  • Для использования LocalSavedStateRegistryOwner требуется Compose UI 1.8.0 или более поздней версии. Это удаляет резервные варианты внутреннего отражения, повышая производительность, но принудительно обновляя зависимости для клиентов. (I16fb0)

Версия 1.5

Версия 1.5.0

19 мая 2026 г.

Данные "androidx.savedstate:savedstate-*:1.5.0" опубликованы. Версия 1.5.0 содержит эти коммиты.

Важные изменения по сравнению с версией 1.4.0:

  • Включить общую сериализацию для объектов SavedState, чтобы их можно было кодировать и декодировать с помощью стандартных форматов, таких как CBOR или JSON, на всех платформах. (Iafda4, b/425919375)
  • Добавьте функции расширения putKotlinSerializable и getKotlinSerializable в SavedStateWriter и SavedStateReader, чтобы напрямую сохранять и извлекать сериализуемые объекты Kotlin с помощью ключей. Это упростит интеграцию с SavedState API. (Iba02e)
  • Добавьте фабричные функции для LifecycleOwner, ViewModelStoreOwner и SavedStateRegistryOwner, чтобы сократить шаблонный код при создании пользовательских компонентов владельца. (I9682c)
  • Разрешить сохранять и восстанавливать SnapshotStateSet (создано через mutableStateSetOf()) с помощью rememberSerializable. Теперь вы можете использовать SnapshotStateSet в rememberSerializable без специального средства сохранения. (I9a4ed, b/449498367)

Версия 1.5.0-rc01

6 мая 2026 г.

Данные "androidx.savedstate:savedstate-*:1.5.0-rc01" опубликованы. Версия 1.5.0-rc01 содержит эти коммиты.

Версия 1.5.0-beta01

22 апреля 2026 г.

Данные "androidx.savedstate:savedstate-*:1.5.0-beta01" опубликованы. Версия 1.5.0-beta01 содержит эти коммиты.

Версия 1.5.0-alpha02

25 марта 2026 г.

Данные "androidx.savedstate:savedstate-*:1.5.0-alpha02" опубликованы. Версия 1.5.0-alpha02 содержит эти коммиты.

Версия 1.5.0-alpha01

11 марта 2026 г.

Данные "androidx.savedstate:savedstate-*:1.5.0-alpha01" опубликованы. Версия 1.5.0-alpha01 содержит эти коммиты.

Новые функции

  • Включить общую сериализацию для объектов SavedState, чтобы их можно было кодировать и декодировать с помощью стандартных форматов, таких как CBOR или JSON, на всех платформах. (Iafda4, b/425919375)

Изменения в API

  • Добавьте функции расширения putKotlinSerializable и getKotlinSerializable в SavedStateWriter и SavedStateReader, чтобы разрешить прямое хранение и извлечение сериализуемых объектов Kotlin с помощью ключей, упрощая интеграцию с API SavedState. (Iba02e)
  • Добавьте фабричные функции для LifecycleOwner, ViewModelStoreOwner и SavedStateRegistryOwner, чтобы сократить шаблонный код при создании пользовательских компонентов владельца. (I9682c)
  • Разрешить сохранять и восстанавливать SnapshotStateSet (создано через mutableStateSetOf()) с помощью rememberSerializable. Теперь вы можете использовать SnapshotStateSet в rememberSerializable без специального средства сохранения. (I9a4ed, b/449498367)

Версия 1.4

Версия 1.4.0

5 ноября 2025 г.

Данные "androidx.savedstate:savedstate-*:1.4.0" опубликованы. Версия 1.4.0 содержит эти коммиты.

Версия 1.4.0-rc01

22 октября 2025 г.

Версия androidx.savedstate:savedstate-*:1.4.0-rc01 выпущена без изменений по сравнению с 1.4.0-beta01. Версия 1.4.0-rc01 содержит эти коммиты.

Версия 1.4.0-beta01

8 октября 2025 г.

Выпущена версия androidx.savedstate:savedstate-*:1.4.0-beta01. Значительных изменений по сравнению с последней альфа-версией нет. Версия 1.4.0-beta01 содержит эти коммиты.

Версия 1.4.0-alpha03

27 августа 2025 года

Данные "androidx.savedstate:savedstate-*:1.4.0-alpha03" опубликованы. Версия 1.4.0-alpha03 содержит эти коммиты.

Изменения в API

  • Добавлена поддержка типов, допускающих значение NULL, в encodeToSavedState и decodeFromSavedState. (I79062, b/439527454)
  • Обновите Compose до версии 1.9.0. (I2b9de)

Версия 1.4.0-alpha02

13 августа 2025 г.

Данные "androidx.savedstate:savedstate-*:1.4.0-alpha02" опубликованы. Версия 1.4.0-alpha02 содержит эти коммиты.

Версия 1.4.0-alpha01

30 июля 2025 г.

Данные "androidx.savedstate:savedstate-*:1.4.0-alpha01" опубликованы. Версия 1.4.0-alpha01 содержит эти коммиты.

Изменения в API

  • Добавлена нативная поддержка типов, допускающих значение NULL, в SavedStateRegistryOwner.saved, что упрощает сохранение и восстановление свойств, допускающих значение NULL. (Ia632, b/421325690)

Версия 1.3

Версия 1.3.3

17 сентября 2025 г.

Данные "androidx.savedstate:savedstate-*:1.3.3" опубликованы. Версия 1.3.3 содержит эти коммиты.

Исправление ошибок

  • Исправлена ошибка, из-за которой не применялся плагин Compose Compiler, что приводило к повреждению артефактов KMP SavedState. (Id2290, b/443965665)

Версия 1.3.2

27 августа 2025 года

Данные "androidx.savedstate:savedstate-*:1.3.2" опубликованы. Версия 1.3.2 содержит эти коммиты.

Новые функции

  • Добавлены новые целевые платформы Kotlin Multiplatform (KMP) в артефакт SavedState *-compose. Теперь Lifecycle поддерживает следующие платформы: JVM (Android и Desktop), Native (Linux, iOS, watchOS, macOS, MinGW) и Web (JavaScript, WasmJS). (/Idcf26)

Версия 1.3.1

16 июля 2025 г.

Данные "androidx.savedstate:savedstate-*:1.3.1" опубликованы. Версия 1.3.1 содержит эти коммиты.

Исправление ошибок

  • Добавьте все целевые платформы KMP, поддерживаемые аннотациями, в артефакты SavedState.
  • Добавлены новые целевые платформы Kotlin Multiplatform (KMP) для артефактов SavedState. SavedState теперь поддерживает следующие платформы: JVM (Android и ПК), Native (Linux, iOS, watchOS, macOS, MinGW) и Web (JavaScript, WasmJS). Обратите внимание, что в артефакты *-compose не были добавлены новые цели KMP, поскольку это зависит от стабильного выпуска Compose 1.9. (I062f4).

Версия 1.3.0

7 мая 2025 г.

Данные "androidx.savedstate:savedstate-*:1.3.0" опубликованы. Версия 1.3.0 содержит эти коммиты.

Важные изменения по сравнению с версией 1.2.0

  • LocalSavedStateRegistryOwner перенесен из Compose UI в новый модуль savedstate-compose, чтобы его вспомогательные API на основе Compose можно было использовать за пределами Compose UI. Его всегда следует использовать при работе с Compose UI 1.9.0-alpha02 и более поздними версиями, но он обратно совместим, поэтому его можно использовать со всеми версиями Compose.
  • Расширения kotlin savedstate-ktx перенесены в базовый модуль savedstate.
  • Экземпляры SavedStateRegistryOwner, полученные через findViewTreeSavedStateRegistryOwner, теперь можно разрешить через несвязанные родительские элементы представления, например ViewOverlay. Дополнительную информацию о родительских элементах с непересекающимися представлениями можно найти в примечаниях к выпуску ядра или в документации по ViewTree.setViewTreeDisjointParent.

Kotlin Multiplatform

  • Модуль SavedState теперь совместим с KMP. Теперь поддерживаются платформы Android, iOS, Linux, Mac и JVM.
  • Представляем непрозрачный тип SavedState как абстракцию, обеспечивающую согласованный способ сохранения и восстановления состояния приложения в KMP. Он включает SavedStateReader и SavedStateWriter для изменения состояния, которое нужно сохранить. В Android SavedState – это псевдоним типа для Bundle, обеспечивающий двоичную совместимость и упрощающий перенос существующих API в общий набор исходных файлов. На других платформах SavedState – это экземпляр 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")
      }
    

Поддержка сериализации KotlinX

  • В SavedState добавлена поддержка KotlinX Serialization. Вы можете преобразовать класс, аннотированный с помощью @Serializable, в SavedState, используя методы encodeToSavedState и decodeFromSavedState. Возвращаемый объект SavedState – это обычный объект Bundle в Android, который можно использовать с любым API, принимающим 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)
    }
    
  • Большинство типов (например, примитивные) поддерживаются напрямую без необходимости настройки. Дополнительные сериализаторы, которые можно использовать с @Serializable(with = ___:class), можно найти в пакете androidx.savedstate.serialization.serializers в модуле savedstate и пакете androidx.savedstate.compose.serialization.serializers в модуле savedstate-compose.

  • Мы также добавили saved, делегат отложенного свойства, чтобы упростить хранение классов @Serializable в SavedStateRegistryOwner (например, ComponentActivity, Fragment и т. д.) и автоматически восстанавливать эти классы при завершении и повторном создании процесса. Обратите внимание, что делегат saved является ленивым и не будет вызывать лямбду init или сохранять что-либо в SavedStateRegistry до тех пор, пока к нему не будет осуществлен доступ.

    @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")
        }
    }
    
  • Аналогичный делегат свойства saved для SavedStateHandle добавлен в Lifecycle 2.9.0.

Версия 1.3.0-rc01

23 апреля 2025 г.

Данные "androidx.savedstate:savedstate-*:1.3.0-rc01" опубликованы. Версия 1.3.0-rc01 содержит эти коммиты.

Версия 1.3.0-beta01

9 апреля 2025 г.

Данные "androidx.savedstate:savedstate-*:1.3.0-beta01" опубликованы. Версия 1.3.0-beta01 содержит эти коммиты.

Обновления зависимостей

  • Теперь эта библиотека предназначена для Kotlin 2.0 и требует KGP 2.0.0 или более поздней версии. (Idb6b5)

Версия 1.3.0-alpha11

26 марта 2025 г.

В версии androidx.savedstate:savedstate-*:1.3.0-alpha11 нет заметных изменений. Версия 1.3.0-alpha11 содержит эти коммиты.

Версия 1.3.0-alpha10

12 марта 2025 г.

Данные "androidx.savedstate:savedstate-*:1.3.0-alpha10" опубликованы. Версия 1.3.0-alpha10 содержит эти коммиты.

Новые функции

  • Добавлены варианты методов без конкретизации для коллекций get в SavedStateReader. (I0b641, b/399820614)
  • Добавьте encodeDefaults в SavedStateConfiguration, чтобы можно было настраивать, нужно ли кодировать свойства со значениями по умолчанию. (I893cc, b/395104517)
  • Добавьте SnapshotStateMapSerializer, чтобы поддержать mutableStateMapOf. (Ie6f19, b/378895074)
  • Добавьте SnapshotStateListSerializer, чтобы поддержать mutableStateListOf. (I4d888, b/378895074)
  • Добавьте getOrNull альтернативных методов для SavedStateReader.get вариантов. Эти методы будут автоматически упаковывать примитивные значения. (I6228c, b/399820614)

Изменения в API

  • Удалите getOrElse из SavedStateReader и используйте getOrNull() ?: else(). I87317, b/399820614
  • Удалите модификатор inline из методов SavedStateReader и SavedStateWriter. (If2a02, b/399820614)
  • Из общедоступного API удалены встроенные сериализаторы List и Array для Android (Ida293).
  • Заменить SparseParcelableArraySerializer на SparseArraySerializer (I91de8)
  • Обеспечьте согласованное поведение всех SavedStateReader.get, выбрасывая исключение, когда тип значения не соответствует типу возвращаемого значения (I78c4a, b/399317598).
  • Переименовать SavedState*Delegates в SavedState*Delegate. (I8589b, b/399629301)
  • Переименовать SavedStateConfig в SavedStateConfiguration. (I043a5, b/399629301)

Версия 1.3.0-alpha09

26 февраля 2025 г.

Данные "androidx.savedstate:savedstate-*:1.3.0-alpha09" опубликованы. Версия 1.3.0-alpha09 содержит эти коммиты.

Новые функции

  • Добавьте резервные варианты для встроенных типов, чтобы все типы, поддерживаемые Bundle, можно было использовать с encodeAsSavedState/decodeFromSavedState по умолчанию или, для свойств в классах @Serializable, с помощью аннотации @Contextual. (Ic01d2)
  • Добавьте поддержку classDiscriminator и classDiscriminatorMode на SavedStateConfig. (I69b66, b/395104517)

Изменения в API

  • Добавьте параметр SavedStateConfig в делегаты saved() (I39b3a).
  • Встроенные сериализаторы становятся одиночными объектами (Ifeee4).
  • Свойства SavedStateConfig теперь являются общедоступными, что позволяет другим модулям использовать эти конфигурации. (Ie5f49, b/378897438)
  • Поддержка @Serializer(with = ...) для MutableStateFlowSerializer и MutableStateSerializer (I90953)
  • Добавить contentDeepToString в SavedStateReader (I14d10)

Версия 1.3.0-alpha08

12 февраля 2025 г.

Данные "androidx.savedstate:savedstate-*:1.3.0-alpha08" опубликованы. Версия 1.3.0-alpha08 содержит эти коммиты.

Новые функции

  • Переместите MutableStateSerializer в savedstate-compose из lifecycle-viewmodel-compose, чтобы использовать API сериализации SavedState с MutableState Compose. (I4f690, b/378895074)

Изменения в API

  • Добавьте фабричную функцию, чтобы создать SavedState из существующего SavedState. (I39f9a)
  • Добавлена поддержка Array<SavedState> и List<SavedState> в androidx.savedstate. (Idd8a5)
  • Добавлен необязательный параметр SavedStateConfig для кодирования и декодирования SavedState (I6c4c0).

Версия 1.3.0-alpha07

29 января 2025 г.

Данные "androidx.savedstate:savedstate-*:1.3.0-alpha07" опубликованы. Версия 1.3.0-alpha07 содержит эти коммиты.

Новые функции

  • Добавьте MutableStateFlowSerializer для сериализации kotlinx.coroutines.flow.MutableStateFlow. (I6a892, b/378895070)

Изменения в API

  • Перегруженные функции делегата SavedStateRegistryOwner.saved() заменены параметрами по умолчанию (Icd1c1).
  • Сделайте JavaSerializableSerializer и ParcelableSerializer абстрактными (I268f6)
  • Удалить общий T : CharSequence из CharSequenceSerializer (Ib40bd)

Версия 1.3.0-alpha06

11 декабря 2024 г.

Данные "androidx.savedstate:savedstate-*:1.3.0-alpha06" опубликованы. Версия 1.3.0-alpha06 содержит эти коммиты.

Новые функции

  • SavedState KMP теперь поддерживает: IBinder, Size, SizeF, Array<Parcelable>, SparseArray<Parcelable> и Serializable (Android). (I1ba94, b/334076622)
  • Добавьте экземпляры KSerializer, которые можно использовать для кодирования и декодирования типов Java и Android, поддерживаемых Bundle, пометив соответствующее поле в классе с помощью @Serializable(with = ParcelableSerializer::class). (I8c10f, I28caf, b/376026712)
  • Экземпляры SavedStateRegistryOwner, полученные через findViewTreeSavedStateRegistryOwner, теперь можно разрешить через несвязанные родительские элементы представления, например ViewOverlay. Дополнительную информацию о родительских элементах с непересекающимися представлениями можно найти в примечаниях к выпуску ядра или в документации по ViewTree.setViewTreeDisjointParent. (Iccb33)

Изменения в API

  • Названия и структура пакетов стали более согласованными с SavedStateRegistryOwnerDelegate (I8c135, b/376026744).

Версия 1.3.0-alpha05

13 ноября 2024 г.

Данные "androidx.savedstate:savedstate-*:1.3.0-alpha05" опубликованы. Версия 1.3.0-alpha05 содержит эти коммиты.

Поддержка сериализации KotlinX

  • В SavedState добавлена поддержка KotlinX Serialization. Вы можете преобразовать класс, аннотированный с помощью @Serializable, в SavedState, используя методы encodeToSavedState и decodeFromSavedState. Возвращаемый объект SavedState – это обычный объект Bundle в Android, который можно использовать с любым API, принимающим 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)
    }
    
  • Мы также добавили saved, делегат отложенного свойства, чтобы упростить хранение классов @Serializable в SavedStateRegistryOwner (например, ComponentActivity, Fragment и т. д.) и автоматически восстанавливать эти классы при завершении и повторном создании процесса. Обратите внимание, что делегат saved является ленивым и не будет вызывать лямбду init или сохранять что-либо в SavedStateRegistry до тех пор, пока к нему не будет осуществлен доступ. (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")
        }
    }
    
  • Аналогичный делегат свойства saved для SavedStateHandle добавлен в Lifecycle 2.9.0-alpha07.

Изменения в API

  • Добавьте toMap в SavedState, чтобы любой SavedState можно было преобразовать в обычный Map (поверхностная копия). (I487b9, b/334076622)
  • SavedState KMP теперь поддерживает массивы. (Ic0552, b/334076622)

Версия 1.3.0-alpha04

30 октября 2024 г.

Данные "androidx.savedstate:savedstate-*:1.3.0-alpha04" опубликованы. Версия 1.3.0-alpha04 содержит эти коммиты.

Изменения в API

  • SavedState KMP теперь поддерживает Char. (I9ac2f, b/334076622)
  • Добавьте putNull и isNull в SavedState KMP. (Iea71d, b/334076622)
  • Добавлены дополнительные параметры фабрики savedState, поддерживающие начальное значение Map<String, Any> (I9b37d, b/334076622).
  • SavedState KMP теперь поддерживает сравнение contentDeepEquals. (Ia515c, b/334076622)
  • SavedState KMP теперь поддерживает Long. (I4c180, b/334076622)

Версия 1.3.0-alpha03

16 октября 2024 г.

В версии androidx.savedstate:savedstate-*:1.3.0-alpha03 нет значительных изменений. Версия 1.3.0-alpha03 содержит эти коммиты.

Версия 1.3.0-alpha02

2 октября 2024 г.

Данные "androidx.savedstate:savedstate-*:1.3.0-alpha02" опубликованы. Версия 1.3.0-alpha02 содержит эти коммиты.

Kotlin Multiplatform

  • Модуль SavedState теперь совместим с KMP. Теперь поддерживаются платформы Android, iOS, Linux, Mac и JVM. (I26305, b/334076622)

Новые функции

  • Представляем непрозрачный тип SavedState как абстракцию, обеспечивающую согласованный способ сохранения и восстановления состояния приложения в KMP. Он включает SavedStateReader и SavedStateWriter для изменения состояния, которое нужно сохранить. В Android SavedState – это псевдоним типа для Bundle, обеспечивающий двоичную совместимость и упрощающий перенос существующих API в общий набор исходных файлов. На других платформах SavedState – это экземпляр 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")
  }

Изменения в API

  • SavedStateRegistry и SavedStateRegistryController теперь совместимы с KMP. (Id7bb8, b/334076622)
  • SavedState, SavedStateWriter и SavedStateReader теперь совместимы с KMP. (I26305, b/334076622)

Версия 1.3.0-alpha01

7 августа 2024 г.

Данные "androidx.savedstate:savedstate:1.3.0-alpha01" и "androidx.savedstate:savedstate-ktx:1.3.0-alpha01" опубликованы. Версия 1.3.0-alpha01 содержит эти коммиты.

Изменения в API

  • Расширения kotlin savedstate-ktx перенесены в базовый модуль savedstate. (I1cc18, b/274803094)

Примечание

  • Обновление compileSdk до версии 35 (5dc41be)

Версия 1.2.1

Версия 1.2.1

22 марта 2023 г.

Данные "androidx.savedstate:savedstate:1.2.1" и "androidx.savedstate:savedstate-ktx:1.2.1" опубликованы. Версия 1.2.1 содержит эти коммиты.

Обновления зависимостей

Версия 1.2.0

Версия 1.2.0

29 июня 2022 г.

Данные "androidx.savedstate:savedstate:1.2.0" и "androidx.savedstate:savedstate-ktx:1.2.0" опубликованы. Версия 1.2.0 содержит эти коммиты.

Важные изменения, внесенные после версии 1.1.0

  • Теперь SavedStateRegistryController позволяет заранее прикрепить SavedStateRegistry через performAttach().
  • Теперь вы можете получить ранее зарегистрированный объект SavedStateProvider из объекта SavedStateRegistry с помощью getSavedStateProvider().
  • Библиотека SavedState была переписана на Kotlin.
    • Для SavedStateRegistryOwner это изменение, несовместимое с исходным кодом, для классов, написанных на Kotlin. Теперь вам нужно переопределить свойство savedStateRegistry, а не реализовывать предыдущую функцию getSavedStateRegistry().
    • Для ViewTreeSavedStateRegistryOwner это изменение, несовместимое с исходным кодом для классов, написанных на Kotlin. Теперь вам нужно напрямую импортировать и использовать методы расширения Kotlin в View из androidx.savedstate.setViewTreeSavedStateRegistryOwner и androidx.savedstate.findViewTreeSavedStateRegistryOwner, чтобы задать и найти ранее заданного владельца. Он заменяет API savedstate-ktx в findViewTreeSavedStateRegistryOwner.

Изменения в поведении

  • SavedStateRegistry больше не сохраняет пустой Bundle, если нет состояния для сохранения.

Версия 1.2.0-rc01

11 мая 2022 г.

Данные "androidx.savedstate:savedstate:1.2.0-rc01" и "androidx.savedstate:savedstate-ktx:1.2.0-rc01" опубликованы. Версия 1.2.0-rc01 содержит эти коммиты.

Изменения в документации

  • Документация Kdocs для SavedStateRegistryOwner была обновлена, чтобы уточнить обязанности и контракт, которые владелец имеет в отношении того, как он должен реализовывать интерфейс или когда он должен вызывать методы в SavedStateRegistryController. (Iefc95, b/228887344)

Версия 1.2.0-beta01

20 апреля 2022 г.

Данные "androidx.savedstate:savedstate:1.2.0-beta01" и "androidx.savedstate:savedstate-ktx:1.2.0-beta01" опубликованы. Версия 1.2.0-beta01 содержит эти коммиты.

Изменения в API

  • Классы SavedStateRegistry и ViewTreeSavedStateRegistryOwner были переписаны на Kotlin. Для ViewTreeSavedStateRegistryOwner это изменение, несовместимое с исходным кодом для классов, написанных на Kotlin. Теперь вам нужно напрямую импортировать и использовать методы расширения Kotlin в View из androidx.savedstate.setViewTreeSavedStateRegistryOwner и androidx.savedstate.findViewTreeSavedStateRegistryOwner, чтобы задать и найти ранее заданного владельца. Он заменяет API savedstate-ktx в findViewTreeSavedStateRegistryOwner. Она совместима на уровне двоичного кода и исходного кода для реализаций, написанных на языке программирования Java. (b/220191285)

Версия 1.2.0-alpha02

6 апреля 2022 г.

Данные "androidx.savedstate:savedstate:1.2.0-alpha02" и "androidx.savedstate:savedstate-ktx:1.2.0-alpha02" опубликованы. Версия 1.2.0-alpha02 содержит эти коммиты.

Новые функции

  • Теперь вы можете получить ранее зарегистрированный объект SavedStateProvider из объекта SavedStateRegistry с помощью getSavedStateProvider(). (I7ea47, b/215406268)

Изменения в API

  • Классы SavedStateRegistryOwner, SavedStateRegistryController и Recreator были переписаны на Kotlin. Для SavedStateRegistryOwner это изменение, несовместимое с исходным кодом, для классов, написанных на Kotlin. Теперь вам нужно переопределить свойство savedStateRegistry, а не реализовывать предыдущую функцию getSavedStateRegistry(). Она совместима на уровне двоичного кода и исходного кода с реализациями, написанными на языке программирования Java. (b/220191285)

Версия 1.2.0-alpha01

26 января 2022 г.

Данные "androidx.savedstate:savedstate:1.2.0-alpha01" и "androidx.savedstate:savedstate-ktx:1.2.0-alpha01" опубликованы. Версия 1.2.0-alpha01 содержит эти коммиты.

Новые функции

  • В SavedStateRegistryController теперь можно заранее прикрепить SavedStateRegistry с помощью performAttach(). (Ice4bf)

Изменения в поведении

  • SavedStateRegistry больше не сохраняет пустой Bundle, если нет состояния для сохранения. (aosp/1896865, b/203457956)

Версия 1.1.0

Версия 1.1.0

10 февраля 2021 г.

Данные "androidx.savedstate:savedstate:1.1.0" и "androidx.savedstate:savedstate-ktx:1.1.0" опубликованы. Версия 1.1.0 содержит эти коммиты.

Основные изменения по сравнению с версией 1.0.0

  • ViewTreeSavedStateRegistryOwner API. Новый API ViewTreeSavedStateRegistryOwner.get(View) позволяет получить содержащий SavedStateRegistry, учитывая экземпляр View. Чтобы данные заполнялись правильно, необходимо перейти на Activity 1.2.0, Fragment 1.3.0 и AppCompat 1.3.0-alpha01 или более поздние версии.
  • Объект savedstate-ktx. Добавлен новый объект savedstate-ktx с расширением Kotlin findViewTreeSavedStateRegistryOwner() для работы с ViewTreeSavedStateRegistryOwner.

Версия 1.1.0-rc01

16 декабря 2020 г.

androidx.savedstate:savedstate:1.1.0-rc01 и androidx.savedstate:savedstate-ktx:1.1.0-rc01 выпущены без изменений с 1.1.0-beta01. Версия 1.1.0-rc01 содержит эти коммиты.

Версия 1.1.0-beta01

1 октября 2020 г.

androidx.savedstate:savedstate:1.1.0-beta01 и androidx.savedstate:savedstate-ktx:1.1.0-beta01 выпущены без изменений с 1.1.0-alpha01. Версия 1.1.0-beta01 содержит эти коммиты.

Версия 1.1.0-alpha01

20 мая 2020 г.

Данные "androidx.savedstate:savedstate:1.1.0-alpha01" и "androidx.savedstate:savedstate-ktx:1.1.0-alpha01" опубликованы. Версия 1.1.0-alpha01 содержит эти коммиты.

Новые функции

  • Новый API ViewTreeSavedStateRegistryOwner.get(View) позволяет получить содержащийся SavedStateRegistry, используя экземпляр View. Чтобы заполнить его правильно, необходимо перейти на Activity 1.2.0-alpha05, Fragment 1.3.0-alpha05 и AppCompat 1.3.0-alpha01. (aosp/1298679)
  • Добавлен новый артефакт savedstate-ktx с расширением Kotlin findViewTreeSavedStateRegistryOwner() для работы с ViewTreeSavedStateRegistryOwner. (aosp/1299434)

Версия 1.0.0

Версия 1.0.0

5 сентября 2019 г.

Данные "androidx.savedstate:savedstate:1.0.0" опубликованы. Фиксации, включенные в эту версию, можно найти здесь.

Основные функции SavedState 1.0.0

androidx.savedstate стала стабильной. Это набор API, которые позволяют разработчикам подключать компоненты к процессу restore/saveInstanceState. Основная точка входа API – SavedStateRegistry. Она позволяет получать ранее сохраненные состояния с помощью consumeRestoredStateForKey и регистрировать обратный вызов для registerSavedStateProvider, чтобы предоставлять сохраненное состояние по запросу системы.

Версия 1.0.0-rc01

2 июля 2019 г.

Данные "androidx.savedstate:savedstate:1.0.0-rc01" опубликованы. Фиксации, включенные в эту версию, можно найти здесь.

Исправление ошибок

  • Исправлено неверное правило ProGuard (b/132655499).

Версия 1.0.0-beta01

7 мая 2019 г.

Данные "androidx.savedstate:savedstate:1.0.0-beta01" опубликованы. Фиксации, включенные в эту версию, можно найти здесь.

Версия 1.0.0-alpha02

13 марта 2019 г.

Данные "androidx.savedstate:savedstate:1.0.0-alpha02" опубликованы. androidx.savedstate:savedstate объединяет объекты androidx.savedstate:savedstate-bundle и androidx.savedstate:savedstate-common в один, поскольку было решено упростить инфраструктуру savedstate и удалить универсальные шаблоны из SavedStateRegistry. Поэтому отдельные модули не нужны.

Полный список коммитов, включенных в эту версию, можно найти здесь.

Новые функции

  • Добавлен участник SavedStateRegistry.runOnNextRecreaction(Class<? extends AutoRecreated> clazz ). Будет создан экземпляр указанного класса, и при перезапуске компонента-владельца будет запущен метод AutoRecreated.onRecreated.

Изменения в API

  • Из списка "SavedStateRegistry<T>" удалены общие карты.
  • AbstractSavedStateRegistry и BundlableSavedStateRegistry удалены. Используйте вместо них SavedStateRegistry.
  • BundleSavedStateRegistryOwner переименован в SavedStateRegistryOwner

Версия 1.0.0-alpha01

17 декабря 2018 г.

Это первая версия SavedState.

Новые функции

androidx.savedstate – это новый набор API в альфа-версии, который позволяет разработчикам подключать компоненты к процессу восстановления и saveInstanceState. Основная точка входа API – SavedStateRegistry<T>. Она позволяет получить ранее сохраненное состояние с помощью consumeRestoredStateForKey и зарегистрировать обратный вызов для registerSavedStateProvider, чтобы предоставить сохраненное состояние по запросу системы.