记录一下MMKV使用

最新推荐文章于 2026-02-25 05:23:21 发布

原创最新推荐文章于 2026-02-25 05:23:21 发布 · 1k 阅读

23 ·

CC 4.0 BY-SA版权

文章标签：

#java #开发语言 #android

最近项目上有同事建议使用MMKV去实现一个自研特性功能的用户习惯持久化功能，说是较传统的SharePreference有很大的效率和性能提升，在此研究记录一下使用方法。

MMKV（Mini-Memory-KV）是腾讯开源的高性能键值存储框架，在 Android 开发中，它在特定场景下可以替代SharedPreferences甚至部分替代ContentProvider。

以下从技术实现、性能对比和适用场景三个维度分析其优势：

一、MMKV vs SharedPreferences

1. 核心优势

特性	SharedPreferences	MMKV
存储方式	XML 文件，全量读写	mmap 内存映射，增量更新
读写性能	慢（尤其大数据量）	快（接近内存操作）
多线程安全	需手动处理（`apply()`/`commit()`）	原生支持（读写锁分离）
跨进程支持	不可靠（`MODE_MULTI_PROCESS` 已弃用）	原生支持（文件锁机制）
数据类型	仅基础类型（需手动序列化复杂对象）	支持 `Parcelable`、`byte[]` 等
数据安全性	崩溃可能导致数据丢失	双缓冲区 + 原子写入，避免数据损坏

2. 关键技术实现

mmap 内存映射：
MMKV 使用 Linux 的 mmap() 系统调用将文件直接映射到内存，读写操作无需频繁进行用户空间与内核空间的切换，避免了传统文件 IO 的开销。
增量更新：
SharedPreferences 在写入时需全量重写整个 XML 文件，而 MMKV 仅更新变化的部分，大幅提升性能。
双缓冲区机制：
MMKV 在写入时使用双缓冲区，确保原子性操作，避免因应用崩溃导致的数据损坏。

二、MMKV vs ContentProvider

1. 替代场景分析

场景	ContentProvider	MMKV
跨进程数据共享	原生支持（基于 Binder）	支持（需手动处理 IPC）
结构化数据	适合（配合 SQLite）	不适合（仅键值对）
权限控制	支持（`android:permission`）	不支持（需手动实现）
数据访问封装	提供标准化 CRUD 接口	需自定义接口
性能	中等（IPC 开销）	高（本地操作）

2. MMKV 替代 ContentProvider 的条件

仅限单应用内的跨进程场景：
MMKV 可通过文件锁实现简单跨进程数据同步，但缺乏 ContentProvider 的权限控制和标准化接口。
数据结构简单：
若只需存储键值对（如配置信息、用户状态），MMKV 比 ContentProvider 更轻量高效。
高性能需求：
ContentProvider 的 IPC 调用存在开销，而 MMKV 的 mmap 直接操作内存，适合高频读写场景。

三、MMKV 的典型应用场景

替代 SharedPreferences
- 高频读写场景（如用户偏好设置、埋点数据）
- 存储大数据量（如序列化的用户信息）
- 跨进程数据共享（如主进程与 Service 通信）
部分替代 ContentProvider
- 单应用内的跨进程简单数据共享（如多进程配置同步）
- 无需复杂查询的键值存储（如用户登录状态）
其他优势场景
- 存储 Parcelable 对象（如地理位置、设备信息）
- 替代 SQLite 存储简单数据（减少数据库开销）

四、使用注意事项

不适合复杂结构化数据
MMKV 是键值存储，不支持 SQL 查询，若需关联查询或事务操作，仍需使用 SQLite + ContentProvider。
跨进程需谨慎
虽支持跨进程，但缺乏 ContentProvider 的权限控制机制，需手动处理安全问题。
数据迁移成本
从 SharedPreferences 迁移时，需处理旧数据兼容问题。
支持的数据类型

（1）支持Java 中基础类型：boolean、int、long、float、double、byte[]
（2）支持 Java 中类和容器：String、Set< String >
（3）支持任何实现了Parcelable的类型

五、总结

MMKV 的核心优势在于高性能、简单易用、跨进程支持，适合替代 SharedPreferences 处理各类本地存储场景，也能在特定条件下（单应用内简单数据共享）部分替代 ContentProvider。但它并非万能方案，需根据数据复杂度、是否跨应用等因素选择合适的技术。

六、案例Demo

使用MMKV + Gson的形式去做保存SimInfo。

添加依赖

implementation 'com.google.code.gson:gson:2.8.8'

序列化SimInfo

package com.viktor.myapp.provider;

import com.google.gson.annotations.SerializedName;

public class SimInfo {
    @SerializedName("simId")
    private String simId;
    
    @SerializedName("carrierName")
    private String carrierName;
    
    @SerializedName("phoneNumber")
    private String phoneNumber;
    
    @SerializedName("countryCode")
    private String countryCode;
    
    @SerializedName("isDefault")
    private boolean isDefault;
    
    public SimInfo(String simId, String carrierName, String phoneNumber, String countryCode, boolean isDefault) {
        this.simId = simId;
        this.carrierName = carrierName;
        this.phoneNumber = phoneNumber;
        this.countryCode = countryCode;
        this.isDefault = isDefault;
    }
    
    public String getSimId() { return simId; }
    public void setSimId(String simId) { this.simId = simId; }
    
    public String getCarrierName() { return carrierName; }
    public void setCarrierName(String carrierName) { this.carrierName = carrierName; }
    
    public String getPhoneNumber() { return phoneNumber; }
    public void setPhoneNumber(String phoneNumber) { this.phoneNumber = phoneNumber; }
    
    public String getCountryCode() { return countryCode; }
    public void setCountryCode(String countryCode) { this.countryCode = countryCode; }
    
    public boolean isDefault() { return isDefault; }
    public void setDefault(boolean isDefault) { this.isDefault = isDefault; }

    @Override
    public String toString() {
        return "SimInfo{" +
                "simId='" + simId + '\'' +
                ", carrierName='" + carrierName + '\'' +
                ", phoneNumber='" + phoneNumber + '\'' +
                ", countryCode='" + countryCode + '\'' +
                ", isDefault=" + isDefault +
                '}';
    }
}

创建SimInfoManager单例去管理增删改查操作，并且做了简单的缓存。

package com.viktor.myapp.provider;

import android.content.Context;
import com.google.gson.Gson;
import com.google.gson.reflect.TypeToken;
import com.tencent.mmkv.MMKV;
import java.lang.reflect.Type;
import java.util.ArrayList;
import java.util.List;
import java.util.concurrent.locks.ReentrantLock;

/**
 * SIM信息管理类，负责SIM卡信息的内存缓存和持久化存储
 * 采用单例模式，使用MMKV进行数据持久化，Gson进行JSON序列化
 */
public class SimInfoManager {
    private static volatile SimInfoManager sInstance;
    private final MMKV mMkv;
    private final Gson mGson;
    private final List<SimInfo> mSimInfoListCache;
    private final ReentrantLock mLock = new ReentrantLock();
    private static final String SIM_INFO_KEY = "sim_info_list";

    /**
     * 私有构造方法，初始化MMKV和Gson，并从MMKV加载数据
     * @param context 上下文对象，用于初始化MMKV
     */
    private SimInfoManager(Context context) {
        MMKV.initialize(context);
        //默认支持单进程通信
        //this.mMkv = MMKV.defaultMMKV();
        //如需要多进程访问，标志位 MMKV.MULTI_PROCESS_MODE
        this.mMkv = MMKV.mmkvWithID("user_sim_data", MMKV.MULTI_PROCESS_MODE);
        this.mGson = new Gson();
        this.mSimInfoListCache = loadFromMMKV();
    }

    /**
     * 获取单例实例
     * @param context 上下文对象
     * @return SimInfoManager的唯一实例
     */
    public static SimInfoManager getInstance(Context context) {
        if (sInstance == null) {
            synchronized (SimInfoManager.class) {
                if (sInstance == null) {
                    sInstance = new SimInfoManager(context);
                }
            }
        }
        return sInstance;
    }

    /**
     * 从MMKV加载SIM信息列表
     * @return 加载的SIM信息列表，若不存在则返回空列表
     */
    private List<SimInfo> loadFromMMKV() {
        String json = mMkv.getString(SIM_INFO_KEY, null);
        if (json == null) {
            return new ArrayList<>();
        }
        Type type = new TypeToken<List<SimInfo>>(){}.getType();
        return mGson.fromJson(json, type);
    }

    /**
     * 将当前SIM信息列表保存到MMKV
     * 采用ReentrantLock保证线程安全
     */
    private void saveToMMKV() {
        mLock.lock();
        try {
            String json = mGson.toJson(mSimInfoListCache);
            mMkv.putString(SIM_INFO_KEY, json);
        } finally {
            mLock.unlock();
        }
    }

    /**
     * 获取所有SIM信息
     * @return SIM信息列表的拷贝，防止外部修改内部缓存
     */
    public List<SimInfo> getAllSimInfo() {
        mLock.lock();
        try {
            return new ArrayList<>(mSimInfoListCache);
        } finally {
            mLock.unlock();
        }
    }

    /**
     * 根据SIM ID获取SIM信息
     * @param simId SIM卡唯一标识
     * @return 对应的SIMInfo对象，若不存在则返回null
     */
    public SimInfo getSimInfoById(String simId) {
        mLock.lock();
        try {
            for (SimInfo info : mSimInfoListCache) {
                if (info.getSimId().equals(simId)) {
                    return info;
                }
            }
            return null;
        } finally {
            mLock.unlock();
        }
    }

    /**
     * 添加或更新SIM信息
     * 若已存在相同ID的SIM信息，则先删除再添加（去重更新）
     * @param simInfo 要添加的SIM信息对象
     */
    public void addSimInfo(SimInfo simInfo) {
        mLock.lock();
        try {
            mSimInfoListCache.removeIf(info -> info.getSimId().equals(simInfo.getSimId()));
            mSimInfoListCache.add(simInfo);
            saveToMMKV();
        } finally {
            mLock.unlock();
        }
    }

    /**
     * 更新SIM信息
     * 复用addSimInfo方法的去重特性实现更新
     * @param simInfo 要更新的SIM信息对象
     */
    public void updateSimInfo(SimInfo simInfo) {
        addSimInfo(simInfo); // 利用add方法的去重特性
    }

    /**
     * 根据SIM ID删除SIM信息
     * @param simId 要删除的SIM卡唯一标识
     */
    public void deleteSimInfo(String simId) {
        mLock.lock();
        try {
            boolean removed = mSimInfoListCache.removeIf(info -> info.getSimId().equals(simId));
            if (removed) {
                saveToMMKV();
            }
        } finally {
            mLock.unlock();
        }
    }

    /**
     * 清除所有SIM信息
     * 同时清空内存缓存和MMKV中的数据
     */
    public void clearAll() {
        mLock.lock();
        try {
            mSimInfoListCache.clear();
            mMkv.remove(SIM_INFO_KEY);
        } finally {
            mLock.unlock();
        }
    }
}

创建 button去模拟插入和查询数据

package com.viktor.myapp;


import android.os.Bundle;
import android.os.Handler;
import android.os.HandlerThread;
import android.os.Message;
import android.util.Log;
import android.view.View;


import androidx.annotation.NonNull;
import androidx.appcompat.app.ActionBar;
import androidx.appcompat.app.AppCompatActivity;

import com.viktor.myapp.provider.SimInfo;
import com.viktor.myapp.provider.SimInfoManager;

import java.util.List;

public class MainActivity extends AppCompatActivity {
    private static final String TAG = MainActivity.class.getSimpleName();
    private SimInfoManager mSimInfoManager;
    private Handler mHandler;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        setActionBar();

        HandlerThread thread = new HandlerThread("SimInfoHandler");
        thread.start();
        mHandler = new Handler(thread.getLooper());
        
        mSimInfoManager = SimInfoManager.getInstance(this);

        findViewById(R.id.btn_add_sim_info).setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                mHandler.post(new Runnable() {
                    @Override
                    public void run() {
                        //插入2个sim info
                        SimInfo simInfo1 = new SimInfo("1",  "CMCC", "13366668888", "CN", false);
                        SimInfo simInfo2 = new SimInfo("2",  "CU", "18866668888", "CN", true);
                        mSimInfoManager.addSimInfo(simInfo1);
                        mSimInfoManager.addSimInfo(simInfo2);

                        try {
                            // 1s后查询打印一下sim info信息
                            Thread.sleep(1000);

                            List<SimInfo> simInfoList = mSimInfoManager.getAllSimInfo();
                            for (SimInfo info : simInfoList) {
                                Log.d(TAG, "sim info : " + info.toString());
                            }
                        } catch (InterruptedException e) {
                            Log.e(TAG, "sleep error");
                        }
                    }
                });
            }
        });
    }

    private void setActionBar() {
        ActionBar actionBar = getSupportActionBar();
        if (actionBar != null) {
            Log.d(TAG, "actionBar");
            actionBar.setDisplayHomeAsUpEnabled(true);
            actionBar.setCustomView(R.layout.title);
            actionBar.show();
        }
    }
}

2025-07-19 11:48:54.782 16166-16166 MainActivity            com.viktor.myapp                     D  sim info : SimInfo{simId='1', carrierName='CMCC', phoneNumber='13366668888', countryCode='CN', isDefault=false}
2025-07-19 11:48:54.782 16166-16166 MainActivity            com.viktor.myapp                     D  sim info : SimInfo{simId='2', carrierName='CU', phoneNumber='18866668888', countryCode='CN', isDefault=true}