MMKV——腾讯开源库基于 mmap 的高性能通用 key-value 组件

MMKV 是基于 mmap 内存映射的 key-value 组件，底层序列化/反序列化使用 protobuf 实现，性能高，稳定性强。从 2015 年中至今在微信上使用，其性能和稳定性经过了时间的验证。近期也已移植到 Android / macOS / Win32 / POSIX 平台，一并开源。

MMKV 源起

在微信客户端的日常运营中，时不时就会爆发特殊文字引起系统的 crash，参考文章，文章里面设计的技术方案是在关键代码前后进行计数器的加减，通过检查计数器的异常，来发现引起闪退的异常文字。在会话列表、会话界面等有大量 cell 的地方，希望新加的计时器不会影响滑动性能；另外这些计数器还要永久存储下来——因为闪退随时可能发生。这就需要一个性能非常高的通用 key-value 存储组件，我们考察了 SharedPreferences、NSUserDefaults、SQLite 等常见组件，发现都没能满足如此苛刻的性能要求。考虑到这个防 crash 方案最主要的诉求还是实时写入，而 mmap 内存映射文件刚好满足这种需求，我们尝试通过它来实现一套 key-value 组件。

MMKV 原理

内存准备

通过 mmap 内存映射文件，提供一段可供随时写入的内存块，App 只管往里面写数据，由操作系统负责将内存回写到文件，不必担心 crash 导致数据丢失。

数据组织

数据序列化方面我们选用 protobuf 协议，pb 在性能和空间占用上都有不错的表现。

写入优化

考虑到主要使用场景是频繁地进行写入更新，我们需要有增量更新的能力。我们考虑将增量 kv 对象序列化后，append 到内存末尾。

空间增长

使用 append 实现增量更新带来了一个新的问题，就是不断 append 的话，文件大小会增长得不可控。我们需要在性能和空间上做个折中。

更详细的设计原理参考 MMKV 原理。

快速上手

MMKV 的使用非常简单，所有变更立马生效，无需调用 save、sync。

在 App 启动时初始化 MMKV，设定 MMKV 的根目录，例如在 main() 里：

C++

#include

int main() {

std::wstring rootDir = getYourAppDocumentDir();

MMKV::initializeMMKV(rootDir);

// MMKV 提供一个全局的实例，可以直接使用：

auto mmkv = MMKV::defaultMMKV();

mmkv->set(true, "bool");

std::cout << "bool = " << mmkv->getBool("bool") << std::endl;

`mmkv->set(1024, "int32");`

`std::cout << "int32 = " << mmkv->getInt32("int32") << std::endl;`



`mmkv->set("Hello, MMKV for Win32", "string");`

`std::string result;`

`mmkv->getString("string", result);`

`std::cout << "string = " << result << std::endl;`

}

MMKV 支持多进程访问，更详细的用法参考 Win32 Tutorial。

问题 & 反馈

常见问题参见 FAQ，欢迎提 issues 提问反馈。

易语言 MMKV 模块

上面是腾讯关于MMKV的介绍，直接复制过来了。更多详情和用例请看GITHUB开源地址。

因为MMKV并不复杂，所以顺手就封装了一份给易语言调用，带了一个简单的使用方法。

封装的是最新的正式版 v1.2.7。