v2.3.0

Change: Dropped support for the armv7k architecture on Apple Watch. To adapt, you should add armv7k to the &quot;Excluded Architectures&quot; setting for your Apple Watch App or Extension target.
Important: Do not upgrade to this version if you need to maintain armv7k support.
Change: Dropped deprecated methods that use the relativePath: parameter. If you were using these methods, please migrate to those using the rootPath: parameter instead.

v2.3.0 / 2025-12-03 (Breaking Change)

This release is a breaking change and introduces AES-256 encryption for enhanced security.

Feature: Added AES-256 encryption functionality. To upgrade an existing encrypted MMKV instance to AES-256, first load it using the old key. Then, call the 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.
Fix: Resolved a crash that occurred when loading an empty file in ReadOnly mode.
Fix: Added protection against the weakly_canonical() exception caused by an invalid file path.
Fix: Fixed an issue where the file size could change during multi-process loading.
Fix: Corrected a bug where a single key could be overridden incorrectly when upgrading from a v1.1.x version.

This release is a breaking change and introduces AES-256 encryption for enhanced security.

Feature: Added AES-256 encryption functionality. To upgrade an existing encrypted MMKV instance to AES-256, first load it using the old key. Then, call the 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.
Fix: Resolved a crash that occurred when loading an empty file in ReadOnly mode.
Fix: Added protection against the weakly_canonical() exception caused by an invalid file path.
Fix: Fixed an issue where the file size could change during multi-process loading.
Fix: Corrected a bug where a single key could be overridden incorrectly when upgrading from a v1.1.x version.