鸿蒙实践笔记:ArkTS 本地数据持久化三件套选型与实战
一、从一次“闪退丢数据”说起
做鸿蒙应用开发时,几乎每个开发者都会遇到这样一个场景:用户刚在待办清单里记下明天要交的材料,切换到别的 App 回来,数据不见了。原因并不复杂——数据只存在内存里的 @State 变量中,进程一回收就没了。把数据落到本地磁盘,是每个鸿蒙 App 从“演示”走向“可用”的第一道坎。
ArkTS 官方给出的本地持久化方案主要有三件套:Preferences(轻量键值对)、关系型数据库(RDB)和文件存储。它们各有各的适用面,选错了,要么性能拉胯,要么代码越写越绕。
二、三件套速览
Preferences:系统提供的轻量级键值存储,适合存登录态、主题、开关这类“小而散”的配置。读写都是异步接口,用起来几乎没有学习成本。
关系型数据库:基于 SQLite 的结构化存储,适合存任务列表、订单、聊天记录这类“多而有关系”的数据,支持条件查询、排序和事务。
文件存储:直接读写沙箱内的文件,适合存图片、音频、导出的 JSON 这类“大块非结构化”内容。
一句话记住:配置用 Preferences,列表用数据库,大文件走文件。
三、Preferences:小数据的首选
登录成功后,token 和用户名要随应用“活着”,最简单的办法就是 Preferences:
import preferences from '@ohos.data.preferences';
const store = await preferences.getPreferences(this.context, 'user');
await store.put('token', token);
await store.flush();
注意两点:第一,put 只是写进内存缓存,必须调 flush() 才会真正落盘;第二,Preferences 不适合存大对象,官方建议单条数据控制在较小体积,存整个任务列表进去既慢又容易出问题。
四、关系型数据库:结构化数据的正解
当数据量上来、需要按条件查的时候,就该请出关系型数据库:
import relationalStore from '@ohos.data.relationalStore';
const config: relationalStore.StoreConfig = {
name: 'todo.db',
securityLevel: relationalStore.SecurityLevel.S1
};
const store = await relationalStore.getRdbStore(this.context, config);
建表、增删改查都走标准 SQL 语义,配合谓词(Predicates)可以按优先级、截止日期过滤。需要提醒的是,数据库操作是耗时操作,务必放在异步任务里做,别在 UI 线程上直接读写;批量写入时用事务包裹,一次提交比逐条提交快一个数量级。
五、文件存储:大块内容的归宿
图片、导出的备份文件这类内容,放数据库里是“反模式”,正确做法是写文件、数据库里只存路径:
import fs from '@ohos.file.fs';
const path = this.context.filesDir + '/backup.json';
const file = fs.openSync(path, fs.OpenMode.WRITE_ONLY | fs.OpenMode.CREATE);
fs.writeSync(file.fd, JSON.stringify(tasks));
fs.closeSync(file);
文件读写要区分应用沙箱目录:filesDir 是应用私有目录,随应用卸载而清除;需要用户可见的文件则走公共目录并申请相应权限。
六、选型对照表
| 方案 | 适合存什么 | 优势 | 注意事项 |
|---|---|---|---|
| Preferences | 登录态、开关、主题 | 简单、快速 | 别存大对象,记得 flush |
| 关系型数据库 | 任务、订单、记录 | 可查询、可事务 | 异步操作、批量用事务 |
| 文件存储 | 图片、音频、备份 | 容量大、格式自由 | 只存路径进数据库 |
七、实战组合:一个待办清单的数据分层
拿“云同步待办清单”这个案例来说,落地时可以这样分层:登录 token 和上次同步时间放 Preferences;任务本身(标题、优先级、截止日期、完成状态)放关系型数据库;导出的备份文件走文件存储。三层各司其职,端侧代码反而更干净:UI 层只关心状态,数据层按类型分流,云同步时只需要把数据库里的增量变更推上去。
反过来,如果所有数据都塞进 Preferences,列表一长就会卡顿;如果把 token 存进数据库,每次启动都要多一次查询,纯属多余。分层不是为了“显得专业”,而是让每种数据的读写成本都落在最低点。
八、避坑清单
- 不要在 UI 线程做数据库读写,耗时操作一律异步。
- Preferences 写完记得 flush,否则杀进程就丢。
- 数据库升级要写迁移逻辑,onUpgrade 里补字段,别直接删库重建。
- 敏感信息不要明文存,token 至少要做加密或走系统密钥服务。
- 离线优先:先读本地缓存再联网同步,弱网环境下体验差距非常明显。
九、小结
本地持久化没有“银弹”,只有“合适的选择”。小配置用 Preferences,结构化数据用关系型数据库,大文件走文件存储,再配合云端同步做多端备份,一台手机上的鸿蒙应用就有了完整的数据底座。下一篇文章,我会继续写端云同步里的增量拉取怎么做,欢迎关注交流。
- 点赞
- 收藏
- 关注作者
评论(0)