Savedstate
最近更新时间 | 当前稳定版 | 下一候选版本 | Beta 版 | Alpha 版 |
---|---|---|---|---|
2021 年 2 月 10 日 | 1.1.0 | - | - | - |
声明依赖项
如需添加 SavedState 的依赖项,您必须将 Google Maven 代码库添加到项目中。如需了解详情,请参阅 Google 的 Maven 代码库。
在应用或模块的 build.gradle
文件中添加所需工件的依赖项:
dependencies { // Java language implementation implementation "androidx.savedstate:savedstate:1.1.0" // Kotlin implementation "androidx.savedstate:savedstate-ktx:1.1.0" }
如需详细了解依赖项,请参阅添加构建依赖项。
反馈
您的反馈将帮助我们改进 Jetpack。如果您发现了新问题,或对库的改进有某些建议,请告诉我们。创建新问题前,请先查看此库中的现有问题。您可以点击星标按钮,为现有问题投票。
如需了解详情,请参阅问题跟踪器文档。
版本 1.1.0
版本 1.1.0
2021 年 2 月 10 日
发布了 androidx.savedstate:savedstate:1.1.0
和 androidx.savedstate:savedstate-ktx:1.1.0
。版本 1.1.0 中包含这些提交内容。
自 1.0.0 以来的重要变更
ViewTreeSavedStateRegistryOwner
API:新的ViewTreeSavedStateRegistryOwner.get(View)
API 允许您根据View
实例检索包含的SavedStateRegistry
。您必须升级到 Activity1.2.0
、Fragment1.3.0
和 AppCompat1.3.0-alpha01
或更高版本,才能正确填充此 API。savedstate-ktx
工件:添加了新的savedstate-ktx
工件,其中包含用于与ViewTreeSavedStateRegistryOwner
搭配使用的findViewTreeSavedStateRegistryOwner()
Kotlin 扩展。
版本 1.1.0-rc01
2020 年 12 月 16 日
发布了 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
2020 年 10 月 1 日
发布了 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
2020 年 5 月 20 日
发布了 androidx.savedstate:savedstate:1.1.0-alpha01
和 androidx.savedstate:savedstate-ktx:1.1.0-alpha01
。版本 1.1.0-alpha01 中包含这些提交内容。
新功能
- 新的
ViewTreeSavedStateRegistryOwner.get(View)
API 允许您根据View
实例检索包含的SavedStateRegistry
。您必须升级到 Activity1.2.0-alpha05
、Fragment1.3.0-alpha05
和 AppCompat1.3.0-alpha01
,才能正确填充此 API。(aosp/1298679) - 添加了新的
savedstate-ktx
工件,其中包含用于与ViewTreeSavedStateRegistryOwner
搭配使用的findViewTreeSavedStateRegistryOwner()
Kotlin 扩展。(aosp/1299434)
版本 1.0.0
版本 1.0.0
2019 年 9 月 5 日
发布了 androidx.savedstate:savedstate:1.0.0
。点击此处可查看此版本中包含的提交内容。
SavedState 1.0.0 的主要功能
androidx.savedstate
已升级为稳定版本。这是一组 API,允许开发者将组件以插件形式添加到恢复 /saveInstanceState 进程。该 API 的主要入口点是 SavedStateRegistry
,它提供了一种方法来使用 consumeRestoredStateForKey
检索之前保存的状态,并注册一个回调,通过调用 registerSavedStateProvider
在系统请求时提供已保存的状态。
版本 1.0.0-rc01
2019 年 7 月 2 日
发布了 androidx.savedstate:savedstate:1.0.0-rc01
。点击此处可查看此版本中包含的提交内容。
问题修复
- 修复了不正确的 proguard 规则 (b/132655499)
版本 1.0.0-beta01
2019 年 5 月 7 日
发布了 androidx.savedstate:savedstate:1.0.0-beta01
。点击此处可查看此版本中包含的提交内容。
版本 1.0.0-alpha02
2019 年 3 月 13 日
发布了 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
2018 年 12 月 17 日
这是 SavedState
的第一个版本。
新功能
androidx.savedstate
是一组新的 Alpha API,允许开发者将组件以插件形式添加到恢复 /saveInstanceState 进程。该 API 的主要入口点是 SavedStateRegistry<T>
,它提供了一种方法来通过 consumeRestoredStateForKey
检索之前保存的状态,并注册一个 registerSavedStateProvider
回调,以便在系统请求时提供已保存的状态。