NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev, #1948 most downloaded on pub.dev
A common platform interface for the MMKV plugin.
Latest stable
2.4.0
Last release 8 months ago
19 Mar 2026
Ships on a steady schedule
a new release about every 3 months
Most releases are documented
notes for 8 of 12 stable releases
Nothing withdrawn
no release was ever pulled
3 years old
12 releases · first in 2024
Drag across the ruler to compare, or tap a release to open it.
Change: Merged MMKVContentChangeNotification into MMKVHandler. The old MMKVContentChangeNotification interface is now @Deprecated.
This release introduces a unified MMKVHandler callback interface across all platforms, replacing scattered per-callback registration with a single, OO-style handler. It also adds the MMKVConfig all-in-one configuration and several bug fixes.
MMKVHandler interface. All callbacks (log redirecting, error handling, content change notification, content loaded notification) are now grouped in a single handler registered via registerHandler(). The old per-callback registerLogHandler() / registerErrorHandler() / registerContentChangeHandler() / registerContentLoadedHandler() APIs have been removed.onMMKVContentLoadSuccessfully callback, triggered when an MMKV file is loaded/mapped successfully.MMKVConfig for all-in-one instance configuration, supporting all options (mode, cryptKey, aes256, expectedCapacity, enableKeyExpire, expiredInSeconds, enableCompareBeforeSet, recover, itemSizeLimit) in a single struct/class.defaultMMKV(config) variant for creating the default instance with full configuration.delete file failure on corrupted files.m_file not valid for isDiskOfMMAPFileCorrupted().absolutePath() calls as much as possible.MMKVContentChangeNotification into MMKVHandler. The old MMKVContentChangeNotification interface is now @Deprecated.fcntl() OFD lock failure on ashmem (#1637).expectedCapacity.getBytes() with string_view key for ObjC++.NameSpace instance.tryAtomicRename().expectedCapacity.MMKVHandler callback interface.Your coding agent can read these notes before it upgrades. Set up the MCP server →
This release is a breaking change and introduces AES-256 encryption for enhanced security.
This release is a breaking change and introduces AES-256 encryption for enhanced security.
reKey() method with the new key and set the aes256 parameter to true, e.g., reKey(newKey, aes256=true). After this, you should use the new key for all future loads of this instance.ReadOnly mode.weakly_canonical() exception caused by an invalid file path.armv7k to the "Excluded Architectures" setting for your Apple Watch App or Extension target.armv7k support.relativePath: parameter. If you were using these methods, please migrate to those using the rootPath: parameter instead.armv7 support.This is a feature release that brings full desktop support to Flutter. It also includes key bug fixes and enhancements for Android and other platforms
This is a feature release that brings full desktop support to Flutter. It also includes key bug fixes and enhancements for Android and other platforms.
MMKVHandler.getNativeLogHandler() to allow native handling of MMKV logs from C++ code, improving performance.Long.MAX_VALUE was misinterpreted as a negative number.MMKV_APPLE flag was not set.This is a hot fix version mainly for Android/Linux platforms. It’s highly recommended for v2.2.0~v2.2.1 users.
This is a hot fix version mainly for Android/Linux platforms. It’s highly recommended for v2.2.0~v2.2.1 users.
## v2.2.1 / 2025-04-25 ### Changes for All platforms * Add importFrom(). ### Android * Fix a bug on initialization.
importFrom().Drop deprecated armv7 AES hardware acceleration.
We introduce the Mayfly FD (short-lived file descriptor) enhancement, reducing MMKV's fd footprint by half and more. For a single-process mode MMKV instance, the fd footprint is reduced to zero (except Android/OHOS, details below). For a multi-process mode MMKV instance, the fd footprint is reduced by half, for we still need a long-lived fd to inter-process lock the shared memory.
checkExist() to check if a MMKV instance exists on disk.checkProcessMode(), it’s never been used.+mmkvGroupPath to get the group folder for MMKV multi-process storage.Happy Chinese New Year! This is a breaking change version for the Android/OHOS platform. Read the change log bellow and upgrade carefully.
Happy Chinese New Year!
This is a breaking change version for the Android/OHOS platform. Read the change log bellow and upgrade carefully.
NameSpace feature that easily supports customizing a root directory.ReadOnly mode.NameSpace feature. Starting from v2.1.0, MMKV will try to migrate them back to normal when possible.F_OFD_SETLK instead of F_SETLK.NameSpace feature. Starting from v2.1.0, MMKV will try to migrate them back to normal when possible.F_OFD_SETLK instead of F_SETLK.NameSpace functionality.mlock() protection given that we are iOS 13+.F_OFD_SETLK instead of F_SETLK.This release is a breaking change release, especially for Android.
This release is a breaking change release, especially for Android.
MMKV_DISABLE_CRYPT is defined and MMKV is built by source in DEBUG.random() with rand() to fix a compile error.Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per month.