OpenHarmony 对存储框架—MMKV

介绍

一款小型键值对存储框架

• 支持存储 number、boolean、string、Set类型数据存储
• 支持继承组件中 SerializeBase.ets 的 class 类对象的序列化反序列化
• 支持存储数据备份
• 支持存储数据恢复

下载安装

ohpm install @ohos/mmkv

OpenHarmony ohpm 环境配置等更多内容，请参考如何安装 OpenHarmony ohpm 包

使用

1、初始化：设置 mmkv 保存文件根目录(rootPath)和缓存目录(cachePath)

MMKV.initialize(rootPath, cachePath)

2、实例化 mmkv：

let mmkv = MMKV.getBackedUpMMKVWithID(mmapID, MMKV.SINGLE_PROCESS_MODE, "Tencent MMKV", backupRootDir);

3、存取键值对数据:

3.1 常用数据类型：boolean、number、string、Set

存数据示例：

mmkv.encodeBool('boolData', false)
mmkv.encodeNumber('numberData', 3.0122)
mmkv.encodeString('stringData', 'dsfsg')
let set1 = new Set<string>()
set1.add('ass1')
mmkv.encodeSet('setData', set1)

取数据示例：

mmkv.decodeBool('boolData')
mmkv.decodeNumber('stringData')
mmkv.decodeString('numberData')
mmkv.decodeSet('setData')

3.2 类对象数据的序列化反序列化

类对象需要继承 SerializeBase类，需序列化属性需要标识注解@Serialize() 如：

class MyClass extends SerializeBase{
    @Serialize()
    public code: number = 0;
    public title: string = 'titles';
    @Serialize()
    public description: string = 'descs';
}

存数据：

let myClass1 = new MyClass(1, 't1', 'desc1')
kv.encodeSerialize('serialize111', myClass1)

取数据：

let myClass2 = kv.decodeSerialize('serialize111', new MyClass())

4、系统轻量级存储数据转存为mmkv存储

//name:context：上下文, preference文件名, callback：异步回调
preferencesToMMKV(name: string, callback: ICallBack, context: Context)

5、设置加密密钥

mmkv.reCryptKey('Key_seq_1') //Key_seq_1：加密密钥

6、数据备份

备份otherDir路径mmapID的mmkv存储数据到backupRootDir

MMKV.backupOneToDirectory(mmapID, backupRootDir, otherDir)//mmapID：需要备份的mmapID；backupRootDir：备份到目标路径；otherDir：待备份所在路径

备份全部mmkv存储数据到backupRootDir

MMKV.backupAllToDirectory(backupRootDir) //backupRootDir：备份到目标路径

7、数据恢复

从srcDir恢复mmkv存储数据

MMKV.restoreOneMMKVFromDirectory(mmapID, srcDir, otherDir)//mmapID：需要恢复的mmapID；srcDir：目标路径；otherDir：待备份所在路径

恢复srcDir路径下的全部mmkv存储数据

MMKV.restoreAllFromDirectory(srcDir) //srcDir： 目标路径

8、清除所有存储数据

mmkv.clearAll()

接口说明

方法名	入参	接口描述
version	无	获取 native版本
getRootDir	无	获取存储路径
pageSize	无	获取设备内存页数量
getDefaultMMKV	mode?: number, cryptKey?: string	创建默认实例
totalSize	无	获取基础文件的大小
encode	key: string, value: number、Set、string、boolean	存储数据
decodeString	key: string, defaultValue?: string	根据key获取字符串值
decodeBool	key: string, defaultValue?: boolean	根据key获取布尔值
decodeNumber	handle: string, key: string, defaultValue: number	根据key获取number值
decodeSet	key: string, defaultValue?: Set	根据key获取数组值
containsKey	key: string	检查是否包含传入的key
getCryptKey	无	获取加密密钥
getMMapID	无	获取实例id
removeValueForKey	key: string	按key移除值
removeValuesForKeys	value: string[]	批量移除值
clearAll	无	清除所有键值
count	无	获取key的数量
isFileValid	mmapID: string	检查MMKV文件是否有效
reCryptKey	cryptKey: string	重新设置密钥
backupOneToDirectory	mmapID: string, dstDir: string, rootPath: string	将一个MMKV实例备份到dstDir
backupAllToDirectory	dstDir: string	将所有MMKV实例备份到dstDir
restoreOneMMKVFromDirectory	mmapID: string, srcDir: string, rootPath: string	从srcDir恢复一个MMKV实例
restoreAllFromDirectory	srcDir: string	从srcDir恢复所有MMKV实例
initialize	root: string, cachePath: string, logLevel?: MMKVLogLevel	初始化MMKV
getBackedUpMMKVWithID	mmapID: string, mode: number, crpKey: string, rootPath: string	获取备份MMKV实例
encodeSerialize	key: string, value: SerializeBase	存储序列化数据
decodeSerialize	key: string, defaultValue: T	按key获取序列化数据
encodeString	key: string, value: string	存储String数据
encodeSet	key: string, value: Set	存储Set数据
encodeBool	key: string, value: boolean	存储Bool数据
encodeNumber	key: string, value: number	存储Number数据
getAllKeys	无	获取所有key
clearMemoryCache	无	清除MMKV实例的内存缓存
actualSize	无	获取MMKV实例的实际使用大小
getHandle	无	获取MMKV 实例句柄
close	无	关闭mmkv实例
trim	无	清除MMKV实例中的所有键值
checkContentChangedByOuterProcess	无	手动检查进程间内容更改
setLogLevel	level: MMKVLogLevel	设置日志级别
checkReSetCryptKey	cryptKey: string	重置加密密钥（不会加密或解密任何内容）
simpleLog	level: MMKVLogLevel, message: string	打印日志
preferencesToMMKV	context: Context, name: string, callback: ICallBack	系统轻量级存储数据转存为mmkv存储
LogUtil.d	message: string	打印debug类型日志
LogUtil.i	message: string	打印info类型日志
LogUtil_e	message: string	打印error类型日志
isEnd	无	获取文件读取是否结束
close	无	文件读取关闭

单元测试用例详情见TEST.md

约束与限制

在下述版本验证通过：

• DevEco Studio: 4.0 (4.0.3.513), SDK: API10 (4.0.10.10)
• DevEco Studio: 4.0 Canary2(4.0.3.312), SDK: API10 (4.0.9.3)
• DevEco Studio: 3.1 Beta2(3.1.0.400), SDK: API9 Release(3.2.11.9)

目录结构

|----MMMKV
|     |---- entry  # 示例代码文件夹
|     |---- library  # MMMKV库文件夹
|           |---- index.ets  # 对外接口
|     |---- README.md  # 安装使用方法

经常有很多小伙伴抱怨说：不知道学习鸿蒙开发哪些技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？

为了能够帮助到大家能够有规划的学习，这里特别整理了一套纯血版鸿蒙（HarmonyOS Next）全栈开发技术的学习路线，包含了鸿蒙开发必掌握的核心知识要点，内容有（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、WebGL、元服务、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、OpenHarmony驱动开发、系统定制移植等等）鸿蒙（HarmonyOS NEXT）技术知识点。

《鸿蒙 (Harmony OS)开发学习手册》（共计892页）

如何快速入门？

1.基本概念
2.构建第一个ArkTS应用
3.……

1.应用基础知识

2.配置文件

3.应用数据管理

4.应用安全管理

5.应用隐私保护

6.三方应用调用管控机制

7.资源分类与访问

8.学习ArkTS语言

9.……

基于ArkTS 开发

1.Ability开发

2.UI开发

3.公共事件与通知

4.窗口管理

5.媒体

6.安全

7.网络与链接

8.电话服务

9.数据管理

10.后台任务(Background Task)管理

11.设备管理

12.设备使用信息统计

13.DFX

14.国际化开发

15.折叠屏系列

16.……

OpenHarmony 开发环境搭建

《OpenHarmony源码解析》

• 搭建开发环境
• Windows 开发环境的搭建
• Ubuntu 开发环境搭建
• Linux 与 Windows 之间的文件共享
• ……
• 系统架构分析
• 构建子系统
• 启动流程
• 子系统
• 分布式任务调度子系统
• 分布式通信子系统
• 驱动子系统
• ……

OpenHarmony 设备开发学习手册