NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev, #1929 most downloaded on pub.dev
Android platform implementation of MMKV.
Latest stable
2.4.3
Last release 1 months ago
16 Oct 2026
Ships fairly regularly
a new release about every 2 months
Some releases are documented
notes for 14 of 25 stable releases
Nothing withdrawn
no release was ever pulled
3 years old
25 releases · first in 2024
Drag across the ruler to compare, or tap a release to open it.
This is a bugfix release based on v2.4.2, focused on encryption, expiration, imports, and file recovery. It also adds Android KMP initialization witho
This is a bugfix release based on v2.4.2, focused on encryption, expiration, imports, and file recovery. It also adds Android KMP initialization without an explicit Context and non-expired-key enumeration on Apple platforms.
Upcoming compatibility change: The release after v2.4.3 will raise the minimum supported versions from iOS 13.0 to iOS 15.0 and from watchOS 6.0 to watchOS 9.0, to align with Xcode 27's supported deployment targets. The minimum deployment targets in v2.4.3 remain unchanged.
importFrom() (#1688) and removeStorage(). Callers must still prevent concurrent use of an instance being removed.MMKV.initialize() without an explicit Context using AndroidX App Startup. Explicit Context initialization remains available.enumerateKeys: safe when callbacks read expired values.enumerateNonExpiredKeys: to filter expired keys at the start of enumeration.libmmkv.so is unavailable for the device ABI (#1687).sendfile() transfers.Your coding agent can read these notes before it upgrades. Set up the MCP server →
This is a hotfix release based on v2.4.1. It adds targeted encrypted-write and backup/restore checks, fixes Kotlin Multiplatform consistency issues, a
This is a hotfix release based on v2.4.1. It adds targeted encrypted-write and backup/restore checks, fixes Kotlin Multiplatform consistency issues, and repairs native package build/link regressions.
.crc.PBUtility.h include its MMBuffer dependency directly.This is a maintenance release based on v2.4.0. It focuses on data-safety fixes, encrypted-file compatibility, packaging/build cleanup, and experimenta
This is a maintenance release based on v2.4.0. It focuses on data-safety fixes, encrypted-file compatibility, packaging/build cleanup, and experimental Kotlin Multiplatform support for Android and iOS.
close() semantics.uint16_t holder limit could overflow key/value metadata and corrupt subsequent reads.expireDuration overflow bug (#1665). Very large expiration durations are now clamped safely instead of wrapping around.-Wmissing-braces warnings in Android, Win32, and POSIX demo code.Core/cbridge) for MMKV Core, with NameSpace support and a pure C demo. The C bridge is also used by the KMP iOS package.com.tencent:mmkv-kmp:2.4.1. The API and artifact layout may change in a future release.iosArm64, iosSimulatorArm64, and iosX64.com.tencent:mmkv:2.4.1 AAR. iOS embeds MMKV Core through the C bridge in the published native KLIBs.close() semantics.ANDROID_ABI is defined, including local Android artifact publication builds.MMKVAppExtension-static.+[MMKV unregisterHandler] as the correctly spelled handler-unregistration API. The previous typo'd +unregiserHandler remains available for source/binary compatibility and forwards to the new API.close() semantics.@tencent/mmkv package metadata and documentation for v2.4.1.close() semantics.-Wmissing-braces warnings in Win32 file handling code.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.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 hotfix release mainly for iOS/macOS CocoaPods users.
This is a hotfix release mainly for iOS/macOS CocoaPods users.
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.Fix a performance issue caused by mistakenly merge of test code
What's new
mlock fail on some devicesWhat's new
remove() causing data inconsistency on MULTI_PROCESS_MODESupport NSCoding You can store NSArray/NSDictionary or any object what implements protocol.
What's new
<NSCoding> protocol.Known Issues
/ inside mmapID.type A and getting by type B may not work. MMKV does type erasure while storing values. That means it's hard for MMKV to do value-type-checking, if not impossible.What's new
Known Issues
/ may fail./ inside mmapID.type A and getting by type B may not work.registerOnSharedPreferenceChangeListener not supported.Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per month.