当前位置: 首页 > news >正文

鸿蒙用户首选项数据持久化

踏入鸿蒙世界的敲门砖,标志着您在技术征途上的全新起点,提升就业竞争力,获得行业认可,点亮职业成长先机,快人一步抢占未来应用开发赛道!https://developer.huawei.com/consumer/cn/training/dev-cert-detail/101666948302721398?ha_source=hmosclass-infoq&ha_sourceId=89000233

用户首选项为应用提供Key-Value键值型的数据处理能力,支持应用持久化轻量级数据,并对其修改和查询。当用户希望有一个全局唯一存储的地方,可以采用用户首选项来进行存储。Preferences会将该数据缓存在内存中,当用户读取的时候,能够快速从内存中获取数据,当需要持久化时可以使用flush接口将内存中的数据写入持久化文件中。Preferences会随着存放的数据量越多而导致应用占用的内存越大,因此,Preferences不适合存放过多的数据,也不支持通过配置加密,适用的场景一般为应用保存用户的个性化设置(字体大小,是否开启夜间模式)等。

动作机制

如图所示,用户程序通过ArkTS接口调用用户首选项读写对应的数据文件。开发者可以将用户首选项持久化文件的内容加载到Preferences实例,每个文件唯一对应到一个Preferences实例,系统会通过静态容器将该实例存储在内存中,直到主动从内存中移除该实例或者删除该文件。

约束限制

·首选项无法保证进程并发安全,会有文件损坏和数据丢失的风险,不支持在多进程场景下使用。

·Key键为string类型,要求非空且长度不超过1024个字节。

·如果Value值为string类型,请使用UTF-8编码格式,可以为空,不为空时长度不超过16MB。

·当存储的数据中包含非UTF-8格式的字符串时,请使用Uint8Array类型存储,否则会造成持久化文件出现格式错误造成文件损坏。

·当调用removePreferencesFromCache或者deletePreferences后,订阅的数据变更会主动取消订阅,重新getPreferences后需要重新订阅数据变更。

·不允许deletePreferences与其他接口多线程、多进程并发调用,否则会发生不可预期行为。

·内存会随着存储数据量的增大而增大,所以存储的数据量应该是轻量级的,建议存储的数据不超过50MB,当存储的数据较大时,在使用同步接口创建Preferences对象和持久化数据时会变成耗时操作,不建议在主线程中使用,否则可能出现appfreeze问题。

开发步骤

1. 导入@kit.ArkData模块

2. 获取Preferences实例

3. 写入数据

使用putSync()方法保存数据到缓存的Preferences实例中。在写入数据后,如有需要,可使用flush()方法将Preferences实例的数据存储到持久化文件。

4. 读取数据

使用getSync()方法获取数据,即指定键对应的值。如果值为null或者非默认值类型,则返回默认数据。

5. 删除数据

使用deleteSync()方法删除指定键值对。

6. 数据持久化

应用存入数据到Preferences实例后,可以使用flush()方法实现数据持久化。

7. 删除指定文件

使用deletePreferences()方法从内存中移除指定文件对应的Preferences实例,包括内存中的数据。若该Preference存在对应的持久化文件,则同时删除该持久化文件,包括指定文件及其备份文件、损坏文件。

(转载自51CTO,作者:龙儿筝)image.png

http://www.wxhsa.cn/company.asp?id=2628

相关文章:

  • 基于Transformer的预训练大语言模型,如何区分文本位置?
  • UE RPC介绍
  • part 5
  • GAS_Aura-Code Clean Up
  • 最强大模型评测工具EvalScope
  • JS监听DOM元素的变化
  • CF1485F Copy or Prefix Sum
  • 拉格朗日反演定理(LIFT)
  • 云斗八月银组做题记录
  • 详细介绍:24年秋招-京东-后端开发岗-第1批笔试总结
  • 深入解析:中国AI云市场报告:阿里云份额达35.8%,高于2至4名总和
  • 关于前端的一些疑问整理2(选择器)
  • 模拟散列表(哈希表)
  • 题解:P3323 [SDOI2015] 旅行计划
  • GAS_Aura-Implementing Auto Running
  • 暑假周进度总结
  • 万能欧几里得算法
  • test
  • 直播软件源码,聊聊Java的异常机制问题 - 云豹科技
  • 调度引擎pefect
  • 我的编码规范
  • 静态库与动态库
  • 谷歌浏览器正规下载地址
  • RoPE使用复数乘法的原因
  • 2025 项目管理到底用什么软件?
  • 我就是我不一样的烟火
  • 周总结报告8
  • 深入解析:PostgreSQL 视图与物化视图(View / Materialized View)详解
  • Win11纯净版D盘出现黄色感叹号的问题
  • nuxt3中useCookie()轻松实现数据存储与安全优化