v1.2.1 released
v1.2.1
破坏性变更:移除 DataSaverListState 及相关类
不再支持 rememberDataSaverListState 以及相关内容。创建此类的初衷是希望能够对 List 的操作做一些优化,但实际上,由于 mutableStateListOf 返回的 SnapshotStateList 也无法被继承,因此在旧版实现中,其相对于 DataSaverState<List<T>> 并无任何性能优势,有些冗余。且新版实现在 findRestorer 上无法传入某一个值,代码不太好写,故最终去除
迁移指南
- 如果之前没有用到过此类:那么新的直接用
mutableDataSaverState<List<ExampleBean>("key", emptyList())这种即可,且需要注册转换器,但务必注明具体泛型。否则此变量将被推断为List<Any>,转换器无法正常工作 - 如果之前有用到,且希望保留数据,在迁移到
mutableDataSaverState的同时,您还需要注册新的转换器以支持List<Bean>。同时,由于之前默认的分隔符是#@#,与大多数框架的,不同,您需要在restore时转换一下:
registerTypeConverters<ExampleBean>(
save = { bean -> Json.encodeToString(bean) },
restore = { str -> Json.decodeFromString(str.replace("#@#", ",")) }
)其他更改
- 支持
emptyList/emptyMap作为默认值(#7) - 增强
registerTypeConverters,现在除了通过类判断,也可以自行传入判断条件 - 在 JVM Desktop 端新增
DataSaverEncryptedProperties,用于保存加密的键值对数据 - 引入了
kotlin-reflect的依赖库,这是为了多平台做准备。之前的::class.java在 JVM 以外平台无法使用。将在下一版新增其他平台
Full Changelog: v1.2.0...v1.2.1