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 с помощью ключей, упрощая интеграцию с APISavedState. (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 UI1.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для изменения состояния, которое нужно сохранить. В AndroidSavedState– это псевдоним типа для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добавлен в Lifecycle2.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 сMutableStateCompose. (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 содержит эти коммиты.
Новые функции
SavedStateKMP теперь поддерживает: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добавлен в Lifecycle2.9.0-alpha07.
Изменения в API
- Добавьте
toMapвSavedState, чтобы любойSavedStateможно было преобразовать в обычныйMap(поверхностная копия). (I487b9, b/334076622) SavedStateKMP теперь поддерживает массивы. (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для изменения состояния, которое нужно сохранить. В AndroidSavedState– это псевдоним типа для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 содержит эти коммиты.
Обновления зависимостей
SavedStateтеперь зависит от Lifecycle2.6.1. (c1f621)
Версия 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, чтобы задать и найти ранее заданного владельца. Он заменяет APIsavedstate-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, чтобы задать и найти ранее заданного владельца. Он заменяет APIsavedstate-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
ViewTreeSavedStateRegistryOwnerAPI. Новый APIViewTreeSavedStateRegistryOwner.get(View)позволяет получить содержащийSavedStateRegistry, учитывая экземплярView. Чтобы данные заполнялись правильно, необходимо перейти на Activity1.2.0, Fragment1.3.0и AppCompat1.3.0-alpha01или более поздние версии.- Объект
savedstate-ktx. Добавлен новый объектsavedstate-ktxс расширением KotlinfindViewTreeSavedStateRegistryOwner()для работы с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. Чтобы заполнить его правильно, необходимо перейти на Activity1.2.0-alpha05, Fragment1.3.0-alpha05и AppCompat1.3.0-alpha01. (aosp/1298679) - Добавлен новый артефакт
savedstate-ktxс расширением KotlinfindViewTreeSavedStateRegistryOwner()для работы с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, чтобы предоставить сохраненное состояние по запросу системы.