v1.0.17

v1.0.17 / 2019-01-25

iOS / macOS

What's new

• Redirect logging of MMKV is supported now.
• Dynamically disable logging of MMKV is supported now.
• Add method migrateFromUserDefaults to import from NSUserDefaults.

Android

What's new

• Redirect logging of MMKV is supported now.
• Dynamically disable logging of MMKV is supported now.
  Note: These two are breaking changes for interface MMKVHandler, update your implementation with wantLogRedirecting() & mmkvLog() for v1.0.17. (Interface with default method requires API level 24, sigh...)
• Add option to use custom library loader initialize(String rootDir, LibLoader loader). If you're facing System.loadLibrary() crash on some low API level device, consider using ReLinker to load MMKV. Example can be found in mmkvdemo.
• Fix a potential corruption of meta file on multi-process mode.
• Fix a potential crash when the meta file is not valid on multi-process mode.

Win32

• Redirect logging of MMKV is supported now.
• Dynamically disable logging of MMKV is supported now.
• Fix a potential corruption of meta file on multi-process mode.

v1.0.16

v1.0.16 / 2019-01-04

iOS / macOS

What's new

• Customizing root folder of MMKV is supported now.
• Customizing folder for specific MMKV is supported now.
• Add method getValueSizeForKey: to get value's size of a key.

Android

What's new

• Customizing root folder of MMKV is supported now.
• Customizing folder for specific MMKV is supported now.
• Add method getValueSizeForKey() to get value's size of a key.
• Fix a potential crash when the meta file is not valid.

Win32

MMKV for Windows is released now. Most things actually work!

v1.0.15

v1.0.15 / 2018-12-13

iOS / macOS

What's new

• Storing NSString/NSData/NSDate directly by calling setString/getSring, setData/getData, setDate/getDate.
• Fix a potential crash due to divided by zero.

Android

What's new

• Fix a stack overflow crash due to the callback feature introduced by v1.0.13.
• Fix a potential crash due to divided by zero.

Win32

MMKV for Win32 in under construction. Hopefully will come out in next release. For those who are interested, check out branch dev_win32 for the latest development.

v1.0.14

v1.0.14 / 2018-11-30

iOS / macOS

What's new

• Setting nil value to reset a key is supported now.
• Rename boolValue(forKey:) to bool(forKey:) for Swift.

Android

What's new

• Parcelable objects can be stored directly into MMKV now.
• Setting null value to reset a key is supported now.
• Fix an issue that MMKV's file size might expand unexpectly large in some case.
• Fix an issue that MMKV might crash on multi-thread removing and getting on the same key.

v1.0.13

v1.0.13 / 2018-11-09

iOS / macOS

What's new

• Special chars like / are supported in MMKV now. The file name of MMKV with special mmapID will be encoded with md5 and stored in seperate folder.
• Add callback for MMKV error handling. You can make MMKV to recover instead of discard when crc32 check fail happens.
• Add trim and close operation. Generally speaking they are not necessary in daily usage. Use them if you worry about disk / memory / fd usage.
• Fix an issue that MMKV's file size might expand unexpectly large in some case.

Known Issues

• Setting nil value to reset a key will be ignored. Use remove instead.

Android

What's new

• Add static linked of libc++ to trim AAR size. Use it when there's no other lib in your App embeds libc++_shared.so. Or if you already have an older version of libc++_shared.so that doesn't agree with MMKV.
  Add implementation 'com.tencent:mmkv-static:1.0.13' to your App's gradle setting to integrate.
• Special chars like / are supported in MMKV now. The file name of MMKV with special mmapID will be encoded with md5 and stored in seperate folder.
• Add callback for MMKV error handling. You can make MMKV to recover instead of discard when crc32 check fail happens.
• Add trim and close operation. Generally speaking they are not necessary in daily usage. Use them if you worry about disk / memory / fd usage.

Known Issues

• Setting null value to reset a key will be ignored. Use remove instead.
• MMKV's file size might expand unexpectly large in some case.

v1.0.12

v1.0.12 / 2018-10-18

iOS / macOS

What's new

• Fix mlock fail on some devices
• Fix a performance issue caused by mistakenly merge of test code
• Fix CocoaPods integration error of macOS

Android / 2018-10-24

What's new

• Fix remove() causing data inconsistency on MULTI_PROCESS_MODE

v1.0.11

v1.0.11 / 2018-10-12

iOS / macOS

What's new

• Port to macOS
• Support NSCoding
  You can store NSArray/NSDictionary or any object what implements <NSCoding> protocol.
• Redesign Swift interface
• Some performance improvement

Known Issues

• MMKV use mmapID as its filename, so don't contain any / inside mmapID.
• Storing a value of 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.

Android

What's new

• Some performance improvement

Known Issues

• Getting a MMKV instance with mmapID that contains / may fail.
  MMKV uses mmapID as its filename, so don't contain any / inside mmapID.
• Storing a value of 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.
• registerOnSharedPreferenceChangeListener not supported.
  This is intended. We believe doing data-change-listener inside a storage framework smells really bad to us. We suggest using something like event-bus to notify any interesting clients.