鸿蒙学习笔记:ArkTS 里用 Preferences 做轻量持久化,设置项不再丢

举报
yd_216186949 发表于 2026/11/14 09:44:49 2026/11/14
【摘要】 给鸿蒙小应用加设置页时,我遇到一个问题:用户选了深色模式,关掉应用再打开,选择全丢了。因为页面状态只活在内存里,退出就清空。要让设置项被“记住”,得写进本地持久化存储。量小的配置,我用 ArkTS 的 Preferences,比数据库轻得多。 Preferences 是什么Preferences 是鸿蒙的轻量键值对持久化方案,由 @ohos.data.preferences 提供,支持 nu...

给鸿蒙小应用加设置页时,我遇到一个问题:用户选了深色模式,关掉应用再打开,选择全丢了。因为页面状态只活在内存里,退出就清空。要让设置项被“记住”,得写进本地持久化存储。量小的配置,我用 ArkTS 的 Preferences,比数据库轻得多。

Preferences 是什么

Preferences 是鸿蒙的轻量键值对持久化方案,由 @ohos.data.preferences 提供,支持 number、string、boolean 等基本类型。它只适合存配置、偏好和开关状态,不存大量业务数据。

三步上手

分三步:取实例、put 写入、get 读取,写完 flush 落盘:

import preferences from '@ohos.data.preferences';
const pref = await preferences.getPreferences(this.context, 'app_settings');
await pref.put('dark_mode', true);
await pref.flush();

以主题为例:开关变化时 put 写入 dark_mode 并 flush,启动时 get 读出,再定亮色或深色主题。其他设置各占一个键,键名加业务前缀,如 setting_theme。

注意三点

一是 put 后不 flush,数据还在内存里,应用被回收就可能丢;二是 getPreferences 是异步的,要先 await 拿到实例再读写;三是 get 的默认值要当业务初始值来定,第一次没存过这个键时返回的就是它。密码和 Token 别放这里,它不加密。

Preferences 不用建表、不用写 SQL,几个键就把设置项解决干净。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。