v1.2.15

v1.2.15 / 2023-01-12

Changes for All platforms

• Log handler now handles all logs from the very beginning, especially the logs in initialization.
• Log handler register method is now deprecated. It's integrated with initialize().
• Fix a bug that lock()/unlock()/try_lock() is not thread-safe.

Flutter

• Reduce the privacy info needed to obtain android sdkInt, avoid unnecessary risk on Android App Review.

iOS & macOS

• Fix a compile error on macOS.
• Fix a bug that some ObjC exceptions are not being caught.
• Add assert on nil MMKV base path, protect from mis-using MMKV in global variable initialization.
• Starting from v1.2.15, one must call +[MMKV initializeMMKV:] manually before calling any MMKV methods.

golang

• Fix a compile error on GCC.

Win32

• Support CMake project on Windows.

v1.2.14

v1.2.14 / 2022-08-10

Changes for All platforms

• Fix a bug that MMKV.getXXX() may return invalid results in multi-process mode.

Android

• Return [] instead of null on empty StringSet from MMKV.decodeStringSet() methods.
• Upgrade Android Compile & Target SDK to 32.

iOS

• Protect from the crash in -[MMKV getObject:forKey:] method when the key-value doesn't exist.

v1.2.13

v1.2.13 / 2022-03-30

Android

• Fix crash on using Ashmem while MMKV_DISABLE_CRYPT macro is defined.

iOS

• Add ability to retrieve key existece while getting value, aka -[MMKV getXXX:forKey:hasValue:] methods.

POSIX

• Add ability to retrieve key existece while getting value, aka MMKV::getXXX(key, defaultValue, hasValue) methods.

Win32

• Add ability to retrieve key existece while getting value, aka MMKV::getXXX(key, defaultValue, hasValue) methods.

v1.2.12

v1.2.12 / 2022-01-17

Changes for All platforms

• Fix a bug that a subsequential clearAll() call may fail to take effect in multi-process mode.
• Hide some OpenSSL symbols to prevent link-time symbol conflict, when an App somehow also static linking OpenSSL.

Android

• Upgrade compileSdkVersion & targetSdkVersion from 30 to 31.

v1.2.11

v1.2.11 / 2021-10-26

Android

• Due to increasing report about crash inside STL, we have decided to make MMKV static linking libc++ by default. Starting from v1.2.11, com.tencent:mmkv-static is the same as com.tencent:mmkv.
• For those still in need of MMKV with shared linking of libc++_shared, you could use com.tencent:mmkv-shared instead.
• Add backup & restore ability.

iOS / macOS

• Add backup & restore ability.
• Support tvOS.
• Fix a compile error on some old Xcode.

Flutter (v1.2.12)

• Add backup & restore ability.

POSIX / golang / Python

• Add backup & restore ability.
• Fix a compile error on Gentoo.

Win32

• Add backup & restore ability.

v1.2.10

v1.2.10 / 2021-06-25

This version is mainly for Android & Flutter.

Android

• Complete JavaDoc documentation for all public methods, classes, and interfaces. From now on, you can find the API reference online.
• Drop the support of armeabi arch. Due to some local build cache mistake, the last version (v1.2.9) of MMKV still has an unstripped armeabi arch inside. This is fixed.
• Change MMKV.mmkvWithID() from returning null to throwing exceptions on any error.
• Add MMKV.actualSize() to get the actual used size of the file.
• Mark MMKV.commit() & MMKV.apply() as deprecated, to avoid some misuse after migration from SharedPreferences to MMKV.

Flutter (v1.2.11)

• Bug Fixed: When building on iOS, occasionally it will fail on symbol conflict with other libs. We have renamed all public native methods to avoid potential conflict.
• Keep up with MMKV native lib v1.2.10.

v1.2.9

v1.2.9 / 2021-05-26

This version is mainly for Android & Flutter.

Android

• Drop the support of armeabi arch. As has been mention in the last release, to avoid some crashes on the old NDK (r16b), and make the most of a more stable libc++, we have decided to upgrade MMKV's building NDK in this release. That means we can't support armeabi anymore. Those who still in need of armeabi can build from sources by following the instruction in the wiki.

We really appreciate your understanding.

Flutter (v1.2.10)

• Bug Fixed: When calling MMKV.encodeString() with an empty string value on Android, MMKV.decodeString() will return null.
• Bug Fixed: After upgrading from Flutter 1.20+ to 2.0+, calling MMKV.defaultMMKV() on Android might fail to load, you can try calling MMKV.defaultMMKV(cryptKey: '\u{2}U') with an encrytion key '\u{2}U' instead.
• Keep up with MMKV native lib v1.2.9.

v1.2.8

v1.2.8 / 2021-05-06

This will be the last version that supports armeabi arch on Android. To avoid some crashed on the old NDK (r16b), and make the most of a more stable libc++, we have decided to upgrade MMKV's building NDK in the next release. That means we can't support armeabi anymore.

We really appreciate your understanding.

Android

• Migrate MMKV to Maven Central Repository. For versions older than v1.2.7 (including), they are still available on JCenter.
• Add MMKV.disableProcessModeChecker(). There are some native crash reports due to the process mode checker. You can disable it manually.
• For the same reason described above (native crashed), MMKV will now turn off the process mode checker on a non-debuggable app (aka, a release build).
• For MMKV to detect whether the app is debuggable or not, when calling MMKV.initialize() to customize the root directory, a context parameter is required now.

iOS / macOS

• Min iOS support has been upgrade to iOS 9.
• Support building by Xcode 12.

Flutter

• Support null-safety.
• Upgrade to flutter 2.0.
• Fix a crash on the iOS when calling encodeString() with an empty string value.

Known Issue on Flutter

• When calling encodeString() with an empty string value on Android, decodeString() will return null. This bug will be fixed in the next version of Android Native Lib. iOS does not have such a bug.

Win32

• Fix a compile error on Visual Studio 2019.

v1.2.7

v1.2.7 / 2020-12-25

Happy holidays everyone!

Changes for All platforms

• Fix a bug when calling sync() with false won't do msync() asynchronous and won't return immediately.

Android

• Fix an null pointer exception when calling putStringSet() with null.
• Complete review of all MMKV methods about Java nullable/nonnull annotation.
• Add API for MMKV.initialize() with both Context and LibLoader parammeters.

Flutter

• Fix a crash on the iOS simulator when accessing the default MMKV instance.
• Fix a bug on iOS when initing the default MMKV instance with a crypt key, the instance is still in plaintext.

Golang

Add golang for POSIX platforms. Most things actually work!. Check out the wiki for information.

MMKV for Golang

Add MMKV support for Golang on POSIX platforms. Most things actually work!
Check out the wiki for more info.