@react-native-ohos/react-native-mmkv 3.3.1-1

package/harmony/reactNativeMMKV/src/main/cpp/MMKV/flutter/.vscode/launch.json

@@ -0,0 +1,162 @@
+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "mmkv",
+            "cwd": "mmkv",
+            "request": "launch",
+            "type": "dart"
+        },
+        {
+            "name": "mmkv (profile mode)",
+            "cwd": "mmkv",
+            "request": "launch",
+            "type": "dart",
+            "flutterMode": "profile"
+        },
+        {
+            "name": "mmkv (release mode)",
+            "cwd": "mmkv",
+            "request": "launch",
+            "type": "dart",
+            "flutterMode": "release"
+        },
+        {
+            "name": "mmkv_android",
+            "cwd": "mmkv_android",
+            "request": "launch",
+            "type": "dart"
+        },
+        {
+            "name": "mmkv_android (profile mode)",
+            "cwd": "mmkv_android",
+            "request": "launch",
+            "type": "dart",
+            "flutterMode": "profile"
+        },
+        {
+            "name": "mmkv_android (release mode)",
+            "cwd": "mmkv_android",
+            "request": "launch",
+            "type": "dart",
+            "flutterMode": "release"
+        },
+        {
+            "name": "mmkv_ios",
+            "cwd": "mmkv_ios",
+            "request": "launch",
+            "type": "dart"
+        },
+        {
+            "name": "mmkv_ios (profile mode)",
+            "cwd": "mmkv_ios",
+            "request": "launch",
+            "type": "dart",
+            "flutterMode": "profile"
+        },
+        {
+            "name": "mmkv_ios (release mode)",
+            "cwd": "mmkv_ios",
+            "request": "launch",
+            "type": "dart",
+            "flutterMode": "release"
+        },
+        {
+            "name": "mmkv_ohos",
+            "cwd": "mmkv_ohos",
+            "request": "launch",
+            "type": "dart"
+        },
+        {
+            "name": "mmkv_ohos (profile mode)",
+            "cwd": "mmkv_ohos",
+            "request": "launch",
+            "type": "dart",
+            "flutterMode": "profile"
+        },
+        {
+            "name": "mmkv_ohos (release mode)",
+            "cwd": "mmkv_ohos",
+            "request": "launch",
+            "type": "dart",
+            "flutterMode": "release"
+        },
+        {
+            "name": "mmkv_platform_interface",
+            "cwd": "mmkv_platform_interface",
+            "request": "launch",
+            "type": "dart"
+        },
+        {
+            "name": "mmkv_platform_interface (profile mode)",
+            "cwd": "mmkv_platform_interface",
+            "request": "launch",
+            "type": "dart",
+            "flutterMode": "profile"
+        },
+        {
+            "name": "mmkv_platform_interface (release mode)",
+            "cwd": "mmkv_platform_interface",
+            "request": "launch",
+            "type": "dart",
+            "flutterMode": "release"
+        },
+        {
+            "name": "mmkv_win32",
+            "cwd": "mmkv_win32",
+            "request": "launch",
+            "type": "dart"
+        },
+        {
+            "name": "mmkv_win32 (profile mode)",
+            "cwd": "mmkv_win32",
+            "request": "launch",
+            "type": "dart",
+            "flutterMode": "profile"
+        },
+        {
+            "name": "mmkv_win32 (release mode)",
+            "cwd": "mmkv_win32",
+            "request": "launch",
+            "type": "dart",
+            "flutterMode": "release"
+        },
+        {
+            "name": "example",
+            "cwd": "mmkv\\example",
+            "request": "launch",
+            "type": "dart"
+        },
+        {
+            "name": "example (profile mode)",
+            "cwd": "mmkv\\example",
+            "request": "launch",
+            "type": "dart",
+            "flutterMode": "profile"
+        },
+        {
+            "name": "example (release mode)",
+            "cwd": "mmkv\\example",
+            "request": "launch",
+            "type": "dart",
+            "flutterMode": "release"
+        },
+        {
+            "name": "Flutter (lib\\main.dart)",
+            "type": "dart",
+            "request": "launch",
+            "cwd": "mmkv\\example",
+            "program": "lib\\main.dart"
+        },
+        {
+            "name": "Flutter (lib/main.dart)",
+            "type": "dart",
+            "request": "launch",
+            "cwd": "mmkv/example",
+            "program": "lib/main.dart"
+        }
+    ]
+}

package/harmony/reactNativeMMKV/src/main/cpp/MMKV/flutter/.vscode/settings.json

@@ -0,0 +1,12 @@
+{
+    "files.associations": {
+        "xstring": "cpp",
+        "xlocale": "cpp",
+        "algorithm": "cpp",
+        "functional": "cpp",
+        "type_traits": "cpp",
+        "xtr1common": "cpp",
+        "xutility": "cpp"
+    },
+    "cmake.ignoreCMakeListsMissing": true
+}

package/harmony/reactNativeMMKV/src/main/cpp/MMKV/flutter/mmkv/CHANGELOG.md

@@ -0,0 +1,196 @@
+# MMKV for Flutter Change Log
+## v2.3.0 / 2025-12-03
+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.
+
+## v2.2.4 / 2025-09-25
+This is a hotfix release mainly for iOS/macOS CocoaPods users.
+
+* Improve the performance of MMBuffer a little bit in some cases.
+* iOS/macOS: Make MMKV and MMKVCore podspec define modules.
+
+## v2.2.3 / 2025-08-20
+This is a feature release that brings **full desktop support to Flutter**.
+* **Added Full Desktop Support**: MMKV for Flutter now officially supports **Windows**, **macOS**, and **Linux**.
+* **Example App**: The example application has been updated to run on all new desktop platforms.
+
+## v2.2.2 / 2025-05-08
+This is a hot fix version mainly **for Android platforms**. It’s highly recommended for v2.2.0~v2.2.1 users.
+* Improve file lock consistency for Mayfly FD MMKV instances.
+* Fix a potential Android ANR on multi-process mode MMKV init/creation.
+
+## v2.2.1 / 2025-4-25
+* Add `importFrom()`.
+* Fix Android initialize bug.
+
+## v2.2.0 / 2025-04-24
+* Add `checkExist()`.
+* Add `isFileValid()`.
+* Add `groupPath()` for iOS.
+* Reduce file descriptor usage by a half and more.
+* Improve multi-process access efficiency by about 20%.
+* Fix `checkContentChangedByOuterProcess()` not working bug.
+
+## v2.1.1 / 2025-03-06
+This is a **critical hotfix** for v2.1.0. It's highly recommended to upgrade as soon as possible.
+* Fix a bug that MMKV instance from non-namespace fails to create.
+
+## v2.1.0 / 2025-02-18
+* **Breaking change**: Migrate legacy MMKV in a custom directory to normal MMKV. Historically Android/OHOS mistakenly use mmapKey as mmapID, which will be problematic with the `NameSpace` feature. Starting from v2.1.0, MMKV will try to migrate them back to normal when possible.  
+  It's highly recommended that you **upgrade to v2.0.2 first** with **forward support** of normal MMKV in a custom directory.
+* Improve inter-process locking by using `F_OFD_SETLK` instead of `F_SETLK` in Android/OHOS.
+* Improve directory creation on `ReadOnly` mode.
+* Add protection from bad disk records of MMKV files.
+* Fix FileLock not being unlocked on destruction.
+
+## v2.0.2 / 2024-12-27
+* Add version limitation of < v2.1.0 on MMKV platform plugins.
+
+## v2.0.1 / 2024-10-25
+* Fix breaking changes on platform interface package.
+
+## v1.3.10 / 2024-10-25
+* Rollback some breaking changes on platform interface package.
+
+## v2.0.0 / 2024-10-21
+* Support read-only mode.
+* Add add log/error/content-change callback for Flutter & ArtTS
+* Bump Android minSdkVersion to 23.
+* Drop 32-bit arch support.
+
+## v1.3.9 / 2024-07-26
+This will be **the last LTS release of MMKV for Flutter**.
+* Modify the dependency of native lib in a way that no Dart package update is needed for any LTS release in the future.
+* Fix a data corruption bug on an encrypted MMKV with only one key value stored.
+* Make encryption more resilient from brute force cracking.
+* Fix a bug that pthread_mutex is not being destroyed correctly.
+* Android: Use an alternative way to get the process name to avoid potential App review issues.
+* Android: Upgrade to NDK 26.3.11579264.
+
+## v1.3.8 / 2024-07-12
+* Add support for **HarmonyOS NEXT**.
+
+## v1.3.7 / 2024-07-08
+**Sync with Latest Android Native Binary:**
+
+This Long Term Support (LTS) release primarily reintroduces support for the ARMv7 architecture and lowers the minimum SDK version requirement to 21. Please note that only critical bug fixes will be applied to the 1.3.x series. New features will be introduced in version 2.0 and later, which will discontinue support for 32-bit architectures and raise the minimum SDK version requirement to 23.
+
+## v1.3.6 / 2024-07-05
+* Android: MMKV will try to load libmmkv.so before Dart code, to reduce the error of loading library in Android.
+* Android: Use the latest ashmem API if possible.
+* Android: Use the latest API to get the device API level.
+
+## v1.3.5 / 2024-04-24
+* Migrate to federated plugins to avoid the iOS rename headache. From now on, no more renaming from `mmkv` to `mmkvflutter` is needed.
+* Bump iOS Deployment Target to iOS 12.
+* Bump Android minSdkVersion to 23.
+
+## v1.3.4 / 2024-03-15
+* Make `trim()` more robust in multi-process mode.
+
+## v1.3.3 / 2024-01-25
+* Add `removeStorage()` static method to safely delete underlying files of an MMKV instance.
+* Add protection from a potential crash of a multi-process MMKV loading due to the MMKV file not being valid.
+* Add back the lazy load feature. It was first introduced in v1.2.16. But it was rollbacked in v1.3.0 of potential ANR & file corruption. Now it's clear that the bug was caused by something else, it's time to bring it back.
+* **Optimize loading speed** by using shared inter-process lock unless there's a need to truncate the file size, which is rare.
+* Make these two lately added features **more robust**: customizing the initial file size & optimizing write speed when there's only one key inside MMKV.
+* On the Xcode 15 build, an App will crash on iOS 14 and below. Previously we have recommended some workarounds (check the v1.3.2 release note for details). Now you can use Xcode 15.1 to fix this issue.
+
+## v1.3.2 / 2023-11-20
+Among most of the features added in this version, the credit goes to @kaitian521.
+
+* Add the feature of customizing the **initial file size** of an MMKV instance.
+* **Optimize write speed** when there's only one key inside MMKV, the new key is the same as the old one, and MMKV is in `SINGLE_PROCESS_MODE`.
+* **Optimize write speed** by overriding from the beginning of the file instead of append in the back, when there's zero key inside MMKV, and MMKV is in `SINGLE_PROCESS_MODE`.
+* Add the feature of `clearAll()` with keeping file disk space unchanged, **reducing the need to expand file size** on later insert & update operations. This feature is off by default, you will have to call it with relative params or newly added methods. 
+* Add the feature of **comparing values before setting/encoding** on the same key.
+* Fix a potential bug that the MMKV file will be invalid state after a successful expansion but a failure `zeroFill()`, will lead to a crash.
+* Fix a potential crash due to other module/static lib turn-off **RTTI**, which will cause MMKV to fail to catch `std::exception`.
+* Fix several potential crash due to the MMKV file not being valid.
+* Android: Use the `-O2` optimization level by default, which will **reduce native lib size** and improve read/write speed a little bit.
+* Android: Experimantal use `@fastNative` annotation on `enableCompareBeforeCompare()` to speed up JNI call.
+* Turn-off mlock() protection in background on iOS 13+. We have **verified it on WeChat** that the protection is no longer needed from at least iOS 13. Maybe iOS 12 or older is also not needed, but we don't have the chance to verify that because WeChat no longer supports iOS 12.
+
+#### Known Issue
+* On Xcode 15 build, App will crash on iOS 14 and below. The bug is introduced by Apple's new linker. The official solutions provided by Apple are either:
+  * Drop the support of iOS 14.
+  * Add `-Wl,-weak_reference_mismatches,weak` or `-Wl,-ld_classic` options to the `OTHER_LDFLAGS` build setting of Xcode 15. Note that these options are **not recognized** by older versions of Xcode.
+  * Use older versions of Xcode, or **wait for Xcode 15.2**.
+
+## v1.3.1 / 2023-8-11
+This is a hotfix version. It's **highly recommended** that v1.2.16 & v1.3.0 users upgrade as soon as possible.
+* Fix a critical bug that might cause multi-process MMKV corrupt. This bug was introduced in v1.2.16.
+* Add the ability to filter expired keys on `count()` & `allKeys()` methods when auto key expiration is turn on.
+* Reduce the `msync()` call on newly created MMKV instances.
+
+## v1.3.0 / 2023-06-14
+* Add auto key expiration feature. Note that this is a breaking change, once upgrade to auto expiration, the MMKV file is not valid for older versions of MMKV (v1.2.16 and below) to correctly operate.
+* Roll back the lazy load optimization due to reported ANR issues. It was introduced in v1.2.16.
+* The version is now the same as the MMKV native library.
+* Starting from v1.3.0, Flutter for Android will use `com.tencent:mmkv`. Previously it's `com.tencent:mmkv-static`. It's the same as `com.tencent:mmkv` starting from v1.2.11.
+
+## v1.2.17 / 2023-04-20
+* Optimization: The actual file content is lazy loaded now, saving time on MMKV instance creation, and avoiding lock waiting when a lot of instances are created at the same time.
+* Fix a bug when restoring a loaded MMKV instance the meta file might mistakenly report corrupted.
+* Fix a crash on decoding an empty list.
+* Remove deprecated dependence.
+* Make the script more robust to fix the iOS Flutter plugin name.
+* Keep up with MMKV native lib v1.2.16.
+
+## v1.2.16 / 2023-01-12
+* Reduce the privacy info needed to obtain android sdkInt, avoid unnecessary risk on Android App Review.
+* 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().
+* Keep up with MMKV native lib v1.2.15.
+
+## v1.2.15 / 2022-08-10
+* Fix a bug that `MMKV.decodeXXX()` may return invalid results in multi-process mode.
+* Upgrade to Flutter 3.0.
+* Keep up with MMKV native lib v1.2.14.
+
+## v1.2.14 / 2022-03-30
+* Replace the deprecated `device_info` package with `device_info_plus`.
+* Keep up with MMKV native lib v1.2.13.
+
+## v1.2.13 / 2022-01-17
+* 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.
+* Upgrade Android `compileSdkVersion` & `targetSdkVersion` from `30` to `31`.
+* Keep up with MMKV native lib v1.2.12.
+
+## v1.2.12 / 2021-10-26
+* Add backup & restore ability.
+* Keep up with MMKV native lib v1.2.11.
+
+## v1.2.11 / 2021-06-25
+* 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.10 / 2021-05-26
+* 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')` instead.
+* Keep up with MMKV native lib v1.2.9, which drops the **armeabi** arch on Android.
+
+## v1.2.9 / 2021-05-06
+* Support null-safety.
+* Upgrade to Flutter 2.0.
+* Keep up with MMKV native lib v1.2.8, which migrates the Android Native Lib to Maven Central Repository.
+* Fix `MMKV.encodeString()` crash on iOS with an empty string value.
+
+### Known Issue
+* When calling `MMKV.encodeString()` with an empty string value on Android, `MMKV.decodeString()` will return `null`. This bug will be fixed in the next version of Android Native Lib. iOS does not have such a bug.
+
+## v1.2.8 / 2020-12-25
+* Keep up with MMKV native lib v1.2.7, which fix the `MMKV.sync(false)` not being asynchronous bug.
+* Fix `MMKV.defaultMMKV()` crash on iOS simulator.
+* Fix `MMKV.defaultMMKV(cryptKey)` not encrypted as expected bug on iOS.
+
+## v1.2.7 / 2020-11-27
+Fix iOS symbol not found bug.
+
+## v1.2.6 / 2020-11-27
+The first official flutter plugin of MMKV. Most things actually work!

package/harmony/reactNativeMMKV/src/main/cpp/MMKV/flutter/mmkv/LICENSE

@@ -0,0 +1,193 @@
+Tencent is pleased to support the open source community by making MMKV available.  
+Copyright (C) 2018 THL A29 Limited, a Tencent company.  All rights reserved.
+If you have downloaded a copy of the MMKV binary from Tencent, please note that the MMKV binary is licensed under the BSD 3-Clause License.
+If you have downloaded a copy of the MMKV source code from Tencent, please note that MMKV source code is licensed under the BSD 3-Clause License, except for the third-party components listed below which are subject to different license terms.  Your integration of MMKV into your own projects may require compliance with the BSD 3-Clause License, as well as the other licenses applicable to the third-party components included within MMKV.
+A copy of the BSD 3-Clause License is included in this file.
+
+Other dependencies and licenses:
+
+Open Source Software Licensed Under the OpenSSL License: 
+----------------------------------------------------------------------------------------
+1. OpenSSL  1.1.0i
+Copyright (c) 1998-2018 The OpenSSL Project.  
+All rights reserved.
+Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)  
+All rights reserved.
+
+
+Terms of the OpenSSL License:
+---------------------------------------------------
+LICENSE ISSUES:
+--------------------------------------------------------------------
+
+The OpenSSL toolkit stays under a dual license, i.e. both the conditions of the OpenSSL License and the original SSLeay license apply to the toolkit.
+See below for the actual license texts.
+
+OpenSSL License:
+--------------------------------------------------------------------
+Copyright (c) 1998-2018 The OpenSSL Project.  All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+
+3. All advertising materials mentioning features or use of this software must display the following acknowledgment:
+"This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
+
+4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to endorse or promote products derived from this software without prior written permission. For written permission, please contact openssl-core@openssl.org.
+
+5. Products derived from this software may not be called "OpenSSL" nor may "OpenSSL" appear in their names without prior written permission of the OpenSSL Project.
+
+6. Redistributions of any form whatsoever must retain the following acknowledgment: "This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (http://www.openssl.org/)"
+
+THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 
+====================================================================
+* This product includes cryptographic software written by Eric Young (eay@cryptsoft.com).  This product includes software written by Tim Hudson (tjh@cryptsoft.com).
+
+
+Original SSLeay License:
+--------------------------------------------------------------------
+Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
+All rights reserved.
+ 
+This package is an SSL implementation written by Eric Young (eay@cryptsoft.com).
+The implementation was written so as to conform with Netscapes SSL.
+ 
+This library is free for commercial and non-commercial use as long as the following conditions are aheared to. The following conditions apply to all code found in this distribution, be it the RC4, RSA, lhash, DES, etc., code; not just the SSL code. The SSL documentation included with this distribution is covered by the same copyright terms except that the holder is Tim Hudson (tjh@cryptsoft.com).  
+
+Copyright remains Eric Young's, and as such any Copyright notices in the code are not to be removed.  If this package is used in a product, Eric Young should be given attribution as the author of the parts of the library used. This can be in the form of a textual message at program startup or in documentation (online or textual) provided with the package. 
+  
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+1. Redistributions of source code must retain the copyright notice, this list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+3. All advertising materials mentioning features or use of this software must display the following acknowledgement:" This product includes cryptographic software written by Eric Young (eay@cryptsoft.com)" The word 'cryptographic' can be left out if the rouines from the library being used are not cryptographic related :-).
+4. If you include any Windows specific code (or a derivative thereof) from the apps directory (application code) you must include an acknowledgement: "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
+ 
+THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 
+  
+The licence and distribution terms for any publically available version or derivative of this code cannot be changed.  i.e. this code cannot simply be copied and put under another distribution licence [including the GNU Public Licence.]
+
+
+
+Open Source Software Licensed Under the Apache License, Version 2.0: 
+The below software in this distribution may have been modified by THL A29 Limited (“Tencent Modifications”). All Tencent Modifications are Copyright (C) 2018 THL A29 Limited.
+----------------------------------------------------------------------------------------
+1. MultiprocessSharedPreferences  v1.0
+Copyright (C) 2014 seven456@gmail.com
+
+
+Terms of the Apache License, Version 2.0:
+--------------------------------------------------------------------
+Apache License Version 2.0, January 2004 http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+“License” shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document.
+
+“Licensor” shall mean the copyright owner or entity authorized by the copyright owner that is granting the License.
+
+“Legal Entity” shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, “control” means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity.
+
+“You” (or “Your”) shall mean an individual or Legal Entity exercising permissions granted by this License.
+
+“Source” form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files.
+
+“Object” form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types.
+
+“Work” shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below).
+
+“Derivative Works” shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof.
+
+“Contribution” shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, “submitted” means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as “Not a Contribution.”
+
+“Contributor” shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions:
+
+a) 	You must give any other recipients of the Work or Derivative Works a copy of this License; and
+
+b) 	You must cause any modified files to carry prominent notices stating that You changed the files; and
+
+c) 	You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and
+
+d) 	If the Work includes a “NOTICE” text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. 
+
+You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License. 
+
+5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages.
+9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
+
+APPENDIX: How to apply the Apache License to your work
+To apply the Apache License to your work, attach the following boilerplate notice, with the fields enclosed by brackets "[]" replaced with your own identifying information. (Don't include the brackets!) The text should be enclosed in the appropriate comment syntax for the file format. We also recommend that a file or class name and description of purpose be included on the same "printed page" as the copyright notice for easier identification within third-party archives.
+
+Copyright [yyyy] [name of copyright owner]
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+http://www.apache.org/licenses/LICENSE-2.0
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+
+
+Open Source Software Licensed Under the zlib License: 
+The below software in this distribution may have been modified by THL A29 Limited (“Tencent Modifications”). All Tencent Modifications are Copyright (C) 2018 THL A29 Limited.
+----------------------------------------------------------------------------------------
+1. zlib  v1.2.11
+Copyright (C) 1995-2017 Jean-loup Gailly and Mark Adler
+
+Terms of the zlib License:
+--------------------------------------------------------------------
+
+This software is provided 'as-is', without any express or implied
+warranty.  In no event will the authors be held liable for any damages
+arising from the use of this software.
+
+Permission is granted to anyone to use this software for any purpose,
+including commercial applications, and to alter it and redistribute it
+freely, subject to the following restrictions:
+
+1. The origin of this software must not be misrepresented; you must not
+   claim that you wrote the original software. If you use this software
+   in a product, an acknowledgment in the product documentation would be
+   appreciated but is not required.
+2. Altered source versions must be plainly marked as such, and must not be
+   misrepresented as being the original software.
+3. This notice may not be removed or altered from any source distribution.
+
+
+Open Source Software Licensed Under the BSD 3-Clause License: 
+----------------------------------------------------------------------------------------
+1. pybind11 v2.5.0
+Copyright (c) 2016 Wenzel Jakob <wenzel.jakob@epfl.ch>, All rights reserved.
+
+Terms of the BSD 3-Clause License:
+--------------------------------------------------------------------
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+Neither the name of [copyright holder] nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.