Android MMKV - 性能强悍的存储工具(腾讯出品)

MMKV 是基于 mmap 内存映射的 key-value 组件，底层序列化/反序列化使用 protobuf 实现，性能高，稳定性强。从 2015 年中至今在微信上使用，其性能和稳定性经过了时间的验证.

起源

微信作为一个即时通讯项目,需要记录数据比较多.需要频繁的操作记录的数据,需要一个性能强悍的存储组件,他们考察了 SharedPreferences、NSUserDefaults、SQLite 等常见组件，发现都没能满足如此苛刻的性能要求。考虑到这个防 crash 方案最主要的诉求还是实时写入，而 mmap 内存映射文件刚好满足这种需求，就尝试通过它来实现一套 key-value 组件。MMKV 就应运而生了.

MMKV 原理

• 内存准备
  通过mmap 内存映射文件，提供一段可供随时写入的内存块，App 只管往里面写数据，由操作系统负责将内存回写到文件，不必担心 crash 导致数据丢失。
• 数据组织
  数据序列化方面我们选用 protobuf 协议，pb 在性能和空间占用上都有不错的表现。
• 写入优化
  考虑到主要使用场景是频繁地进行写入更新，我们需要有增量更新的能力。我们考虑将增量 kv 对象序列化后，append 到内存末尾。
• 空间增长
  使用 append 实现增量更新带来了一个新的问题，就是不断 append 的话，文件大小会增长得不可控。我们需要在性能和空间上做个折中。

支持的数据类型

• 支持以下 Java 语言基础类型：
  boolean、int、long、float、double、byte[]
• 支持以下 Java 类和容器：
  String、Set<String>,任何实现了Parcelable的类型

性能对比

重复读写操作 1k 次 MMKV 和 SharedPreferences、SQLite 性能对比( 机型:华为 Mate 20 Pro，版本:Android 10)

单进程.png 多进程.png

要求

• MMKV 支持 API level 16 以上平台；
• MMKV 需使用 NDK r16b 或以上进行编译 (通过源码引入 MMKV 的话)

使用

1. 引用

    // 从 v1.2.8 起, MMKV 迁移到 Maven Central
    implementation 'com.tencent:mmkv:1.2.12'

2. 在 App 启动时初始化 MMKV

package com.wu.material.application

import android.util.Log
import androidx.multidex.MultiDexApplication
import com.tencent.mmkv.MMKV
import com.wu.material.util.MmkvUtils


/**
 * @author wkq
 *
 * @date 2022年03月17日 16:59
 *
 *@des Application 初始化操作
 *
 */

class MaterialApplication : MultiDexApplication() {

    override fun onCreate() {
        super.onCreate()
    //初始化腾讯MMKV(数据存储)
      MMKV.initialize(this)
  //自定义路径
    //var dir = this.getFilesDir().getAbsolutePath() + "/mmkv"
    //MMKV.initialize(context, dir )
    }
}

注意:
一些 Android 设备（API level 19）在安装/更新 APK 时可能出错, 导致 libmmkv.so 找不到。然后就会遇到 java.lang.UnsatisfiedLinkError 之类的 crash。有个开源库 ReLinker 专门解决这个问题，你可以用它来加载 MMKV

String dir = getFilesDir().getAbsolutePath() + "/mmkv";
MMKV.initialize(dir, new MMKV.LibLoader() {
    @Override
    public void loadLibrary(String libName) {
        ReLinker.loadLibrary(MyApplication.this, libName);
    }
});

3.数据存储

/**
     * 存储常规数据
     */
    fun put(key: String, content: Any?): Boolean {
        if (TextUtils.isEmpty(key) || content == null) return false
        var mmkv = MMKV.defaultMMKV();
        try {
            if (content is String) {
                mmkv.encode(key, content!!)
            } else if (content is Double) {
                mmkv.encode(key, content!!)
            } else if (content is Float) {
                mmkv.encode(key, content!!)
            } else if (content is Int) {
                mmkv.encode(key, content!!)
            } else if (content is Parcelable) {
                mmkv.encode(key, content!!)
            } else if (content is ByteArray) {
                mmkv.encode(key, content!!)
            } else if (content is Long) {
                mmkv.encode(key, content!!)
            } else if (content is Boolean) {
                mmkv.encode(key, content!!)
            } else {
                return false
            }
        } catch (exception: Exception) {
            return false
        }
        return true
    }
  /**
     * 存储set集合
     */
    fun putSet(key: String, content: Set<String>): Boolean {
        if (TextUtils.isEmpty(key) || content == null) return false
        var mmkv = MMKV.defaultMMKV();
        mmkv.encode(key, content!!)
        return true
    }

4.数据获取

//   获取数据   int 0  Double 0.0  float 0
    /**
     * 获取String 数据
     */
    fun getString(key: String): String {
        var mmkv = MMKV.defaultMMKV();
        return mmkv.decodeString(key) ?: ""
        String.format("", "%s /天")
    }

    fun getString(key: String, defult: String): String {
        var mmkv = MMKV.defaultMMKV();
        if (TextUtils.isEmpty(mmkv.decodeString(key))) return defult
        return mmkv.decodeString(key) ?: ""
    }

    fun getDouble(key: String): Double {
        var mmkv = MMKV.defaultMMKV();
        return mmkv.decodeDouble(key)
    }

    fun getDouble(key: String, defult: Double): Double {
        var mmkv = MMKV.defaultMMKV();
        if (mmkv.decodeDouble(key) == 0.0) return defult
        return mmkv.decodeDouble(key)
    }

    fun getFloat(key: String): Float {
        var mmkv = MMKV.defaultMMKV();
        return mmkv.decodeFloat(key)
    }

    fun getFloat(key: String, defult: Float): Float {
        var mmkv = MMKV.defaultMMKV();
        if (mmkv.decodeDouble(key) == 0.0) return defult
        return mmkv.decodeFloat(key)
    }

    fun getInt(key: String): Int {
        var mmkv = MMKV.defaultMMKV();
        return mmkv.decodeInt(key)
    }

    fun getInt(key: String, defult: Int): Int {
        var mmkv = MMKV.defaultMMKV();
        if (mmkv.decodeInt(key) == 0) return defult
        return mmkv.decodeInt(key)
    }

    fun getByteArray(key: String): ByteArray? {
        var mmkv = MMKV.defaultMMKV()
        return mmkv.decodeBytes(key) ?: null
    }

    fun getByteArray(key: String, defult: Int): ByteArray? {
        var mmkv = MMKV.defaultMMKV();
        return mmkv.decodeBytes(key) ?: null
    }

    fun getParcelable(key: String, clazz: Class<Parcelable>): Parcelable? {
        var mmkv = MMKV.defaultMMKV()
        return mmkv.decodeParcelable(key, clazz) ?: null
    }

    fun getSet(key: String): Set<String>? {
        var mmkv = MMKV.defaultMMKV()
        return mmkv.decodeStringSet(key) ?: null
    }

5.数据删除

//   删除数据
    fun remove(key: String) {
        var mmkv = MMKV.defaultMMKV()
        mmkv.removeValueForKey(key)
    }
    // 删除多个数据
    fun remove(vararg key: String) {
        var mmkv = MMKV.defaultMMKV()
        var keys = arrayOfNulls<String>(key.size)
        key.forEachIndexed { index, content ->
            keys.set(index, content)
        }
        mmkv.removeValuesForKeys(keys)
    }

6.数据清理

  // 清理所有数据
    fun clearAll() {
        var mmkv = MMKV.defaultMMKV()
        mmkv.clearAll()
    }

总结

MMKV 是腾讯出品的基于mmap内存映射文件技术的一种数据存储的组件,相对于SharedPreferences SQlite 兼容性更好,存读取速度更快.支持常规的各种数据类型.

来都来了,点个赞再走吧!!!

参考

1.MMKV 文档
2.源码地址