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

package/harmony/reactNativeMMKV/src/main/cpp/MMKV/Android/MMKV/mmkv/src/main/java/com/tencent/mmkv/MMKVContentChangeNotification.java

@@ -0,0 +1,34 @@
+/*
+ * Tencent is pleased to support the open source community by making
+ * MMKV available.
+ *
+ * Copyright (C) 2025 THL A29 Limited, a Tencent company.
+ * All rights reserved.
+ *
+ * Licensed under the BSD 3-Clause License (the "License"); you may not use
+ * this file except in compliance with the License. You may obtain a copy of
+ * the License at
+ *
+ *       https://opensource.org/licenses/BSD-3-Clause
+ *
+ * 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.
+ */
+
+package com.tencent.mmkv;
+
+/**
+ * Inter-process content change notification.
+ * Triggered by any method call, such as getXXX() or setXXX() or {@link MMKV#checkContentChangedByOuterProcess()}.
+ */
+public interface MMKVContentChangeNotification {
+    /**
+     * Inter-process content change notification.
+     * Triggered by any method call, such as getXXX() or setXXX() or {@link MMKV#checkContentChangedByOuterProcess()}.
+     * @param mmapID The unique ID of the changed MMKV instance.
+     */
+    void onContentChangedByOuterProcess(String mmapID);
+}

package/harmony/reactNativeMMKV/src/main/cpp/MMKV/Android/MMKV/mmkv/src/main/java/com/tencent/mmkv/MMKVContentProvider.java

@@ -0,0 +1,174 @@
+/*
+ * 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.
+ *
+ * Licensed under the BSD 3-Clause License (the "License"); you may not use
+ * this file except in compliance with the License. You may obtain a copy of
+ * the License at
+ *
+ *       https://opensource.org/licenses/BSD-3-Clause
+ *
+ * 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.
+ */
+
+package com.tencent.mmkv;
+
+import android.app.ActivityManager;
+import android.content.ComponentName;
+import android.content.ContentProvider;
+import android.content.ContentResolver;
+import android.content.ContentValues;
+import android.content.Context;
+import android.content.pm.PackageManager;
+import android.content.pm.ProviderInfo;
+import android.database.Cursor;
+import android.net.Uri;
+import android.os.Bundle;
+import android.util.Log;
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+
+/**
+ * A helper class for MMKV based on Anonymous Shared Memory. {@link MMKV#mmkvWithAshmemID}
+ */
+public class MMKVContentProvider extends ContentProvider {
+
+    static protected final String KEY = "KEY";
+    static protected final String KEY_SIZE = "KEY_SIZE";
+    static protected final String KEY_MODE = "KEY_MODE";
+    static protected final String KEY_CRYPT = "KEY_CRYPT";
+    static protected final String FUNCTION_NAME = "mmkvFromAshmemID";
+
+    static private Uri gUri;
+    @Nullable
+    static protected Uri contentUri(Context context) {
+        if (MMKVContentProvider.gUri != null) {
+            return MMKVContentProvider.gUri;
+        }
+        if (context == null) {
+            return null;
+        }
+        String authority = queryAuthority(context);
+        if (authority == null) {
+            return null;
+        }
+        MMKVContentProvider.gUri = Uri.parse(ContentResolver.SCHEME_CONTENT + "://" + authority);
+        return MMKVContentProvider.gUri;
+    }
+
+    @NonNull
+    private Bundle mmkvFromAshmemID(String ashmemID, int size, int mode, String cryptKey) throws RuntimeException {
+        MMKV mmkv = MMKV.mmkvWithAshmemID(getContext(), ashmemID, size, mode, cryptKey);
+        ParcelableMMKV parcelableMMKV = new ParcelableMMKV(mmkv);
+        Log.i("MMKV", ashmemID + " fd = " + mmkv.ashmemFD() + ", meta fd = " + mmkv.ashmemMetaFD());
+        Bundle result = new Bundle();
+        result.putParcelable(MMKVContentProvider.KEY, parcelableMMKV);
+        return result;
+    }
+
+    @Nullable
+    private static String queryAuthority(Context context) {
+        try {
+            ComponentName componentName = new ComponentName(context, MMKVContentProvider.class.getName());
+            PackageManager mgr = context.getPackageManager();
+            if (mgr != null) {
+                ProviderInfo providerInfo = mgr.getProviderInfo(componentName, 0);
+                if (providerInfo != null) {
+                    return providerInfo.authority;
+                }
+            }
+        } catch (Exception e) {
+            e.printStackTrace();
+        }
+        return null;
+    }
+
+    @Override
+    public boolean onCreate() {
+        Context context = getContext();
+        if (context == null) {
+            return false;
+        }
+
+        return true;
+    }
+
+    protected static String getProcessNameByPID(@NonNull Context context, int pid) {
+        if (pid == android.os.Process.myPid()) {
+            return MMKVProcessUtil.getCurrentProcessName(context);
+        }
+        ActivityManager manager = (ActivityManager) context.getSystemService(Context.ACTIVITY_SERVICE);
+        if (manager != null) {
+            // clang-format off
+            for (ActivityManager.RunningAppProcessInfo processInfo
+                    : manager.getRunningAppProcesses()) {
+                if (processInfo.pid == pid) {
+                    return processInfo.processName;
+                }
+            }
+            // clang-format on
+        }
+        return "";
+    }
+
+    @Nullable
+    @Override
+    public Bundle call(@NonNull String method, @Nullable String mmapID, @Nullable Bundle extras) {
+        if (method.equals(MMKVContentProvider.FUNCTION_NAME)) {
+            if (extras != null) {
+                int size = extras.getInt(MMKVContentProvider.KEY_SIZE);
+                int mode = extras.getInt(MMKVContentProvider.KEY_MODE);
+                String cryptKey = extras.getString(MMKVContentProvider.KEY_CRYPT);
+                try {
+                    return mmkvFromAshmemID(mmapID, size, mode, cryptKey);
+                } catch (Exception e) {
+                    Log.e("MMKV", e.getMessage());
+                    return null;
+                }
+            }
+        }
+        return null;
+    }
+
+    @Nullable
+    @Override
+    public String getType(@NonNull Uri uri) {
+        return null;
+    }
+
+    @Nullable
+    @Override
+    public Cursor query(@NonNull Uri uri,
+                        @Nullable String[] projection,
+                        @Nullable String selection,
+                        @Nullable String[] selectionArgs,
+                        @Nullable String sortOrder) {
+        throw new java.lang.UnsupportedOperationException("Not implement in MMKV");
+    }
+
+    @Override
+    public int update(@NonNull Uri uri,
+                      @Nullable ContentValues values,
+                      @Nullable String selection,
+                      @Nullable String[] selectionArgs) {
+        throw new java.lang.UnsupportedOperationException("Not implement in MMKV");
+    }
+
+    @Override
+    public int delete(@NonNull Uri uri, @Nullable String selection, @Nullable String[] selectionArgs) {
+        throw new java.lang.UnsupportedOperationException("Not implement in MMKV");
+    }
+
+    @Nullable
+    @Override
+    public Uri insert(@NonNull Uri uri, @Nullable ContentValues values) {
+        throw new java.lang.UnsupportedOperationException("Not implement in MMKV");
+    }
+}

package/harmony/reactNativeMMKV/src/main/cpp/MMKV/Android/MMKV/mmkv/src/main/java/com/tencent/mmkv/MMKVHandler.java

@@ -0,0 +1,63 @@
+/*
+ * 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.
+ *
+ * Licensed under the BSD 3-Clause License (the "License"); you may not use
+ * this file except in compliance with the License. You may obtain a copy of
+ * the License at
+ *
+ *       https://opensource.org/licenses/BSD-3-Clause
+ *
+ * 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.
+ */
+
+package com.tencent.mmkv;
+
+/**
+ * Callback handler for MMKV.
+ * Callback is called on the operating thread of the MMKV instance.
+ */
+public interface MMKVHandler {
+    /**
+     * By default MMKV will discard all data on crc32-check failure. {@link MMKVRecoverStrategic#OnErrorDiscard}
+     * @param mmapID The unique ID of the MMKV instance.
+     * @return Return {@link MMKVRecoverStrategic#OnErrorRecover} to recover any data on the file.
+     */
+    MMKVRecoverStrategic onMMKVCRCCheckFail(String mmapID);
+
+    /**
+     * By default MMKV will discard all data on file length mismatch. {@link MMKVRecoverStrategic#OnErrorDiscard}
+     * @param mmapID The unique ID of the MMKV instance.
+     * @return Return {@link MMKVRecoverStrategic#OnErrorRecover} to recover any data on the file.
+     */
+    MMKVRecoverStrategic onMMKVFileLengthError(String mmapID);
+
+    /**
+     * @return Return False if you don't want log redirecting.
+     */
+    boolean wantLogRedirecting();
+
+    /**
+     * Log Redirecting.
+     * @param level The level of this log.
+     * @param file The file name of this log.
+     * @param line The line of code of this log.
+     * @param function The function name of this log.
+     * @param message The content of this log.
+     */
+    void mmkvLog(MMKVLogLevel level, String file, int line, String function, String message);
+
+    /**
+     * handle the log in NDK native code
+     * @return a native log handler with signature of void log(int level, const char *file, int line, const char *function, const char *message)
+     * return 0 to indicate no native handler
+     */
+    long getNativeLogHandler();
+}

package/harmony/reactNativeMMKV/src/main/cpp/MMKV/Android/MMKV/mmkv/src/main/java/com/tencent/mmkv/MMKVLogLevel.java

@@ -0,0 +1,52 @@
+/*
+ * Tencent is pleased to support the open source community by making
+ * MMKV available.
+ *
+ * Copyright (C) 2025 THL A29 Limited, a Tencent company.
+ * All rights reserved.
+ *
+ * Licensed under the BSD 3-Clause License (the "License"); you may not use
+ * this file except in compliance with the License. You may obtain a copy of
+ * the License at
+ *
+ *       https://opensource.org/licenses/BSD-3-Clause
+ *
+ * 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.
+ */
+
+package com.tencent.mmkv;
+
+/**
+ * The levels of MMKV log.
+ */
+public enum MMKVLogLevel {
+    /**
+     * Debug level. Not available for release/production build.
+     */
+    LevelDebug,
+
+    /**
+     * Info level. The default level.
+     */
+    LevelInfo,
+
+    /**
+     * Warning level.
+     */
+    LevelWarning,
+
+    /**
+     * Error level.
+     */
+    LevelError,
+
+    /**
+     * Special level for disabling all logging.
+     * It's highly NOT suggested to turn off logging. Makes it hard to diagnose online/production bugs.
+     */
+    LevelNone
+}

package/harmony/reactNativeMMKV/src/main/cpp/MMKV/Android/MMKV/mmkv/src/main/java/com/tencent/mmkv/MMKVProcessUtil.java

@@ -0,0 +1,100 @@
+/*
+ * Tencent is pleased to support the open source community by making
+ * MMKV available.
+ *
+ * Copyright (C) 2025 THL A29 Limited, a Tencent company.
+ * All rights reserved.
+ *
+ * Licensed under the BSD 3-Clause License (the "License"); you may not use
+ * this file except in compliance with the License. You may obtain a copy of
+ * the License at
+ *
+ *       https://opensource.org/licenses/BSD-3-Clause
+ *
+ * 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.
+ */
+
+package com.tencent.mmkv;
+
+import android.app.ActivityManager;
+import android.app.Application;
+import android.content.Context;
+import android.os.Build;
+import android.text.TextUtils;
+
+import androidx.annotation.NonNull;
+
+import java.lang.reflect.Method;
+import java.util.List;
+
+/**
+ * Get current process name for AppStore review
+ */
+class MMKVProcessUtil {
+
+    private static String currentProcessName = "";
+
+    public static String getCurrentProcessName(@NonNull Context context) {
+        if (!TextUtils.isEmpty(currentProcessName)) {
+            return currentProcessName;
+        }
+
+        currentProcessName = getCurrentProcessNameByApplication();
+        if (!TextUtils.isEmpty(currentProcessName)) {
+            return currentProcessName;
+        }
+
+        currentProcessName = getCurrentProcessNameByActivityThread();
+        if (!TextUtils.isEmpty(currentProcessName)) {
+            return currentProcessName;
+        }
+
+        currentProcessName = getCurrentProcessNameByActivityManager(context);
+        return currentProcessName;
+    }
+
+    @NonNull
+    private static String getCurrentProcessNameByApplication() {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
+            return Application.getProcessName();
+        }
+        return "";
+    }
+
+    @NonNull
+    private static String getCurrentProcessNameByActivityThread() {
+        String processName = "";
+        try {
+            Method declaredMethod = Class.forName("android.app.ActivityThread").
+                    getDeclaredMethod("currentProcessName");
+            declaredMethod.setAccessible(true);
+            final Object invoke = declaredMethod.invoke(null);
+            if (invoke instanceof String) {
+                processName = (String) invoke;
+            }
+        } catch (Throwable e) {
+            e.printStackTrace();
+        }
+        return processName;
+    }
+
+    private static String getCurrentProcessNameByActivityManager(@NonNull Context context) {
+        int pid = android.os.Process.myPid();
+        ActivityManager am = (ActivityManager) context.getSystemService(Context.ACTIVITY_SERVICE);
+        if (am != null) {
+            List<ActivityManager.RunningAppProcessInfo> runningAppList = am.getRunningAppProcesses();
+            if (runningAppList != null) {
+                for (ActivityManager.RunningAppProcessInfo processInfo : runningAppList) {
+                    if (processInfo.pid == pid) {
+                        return processInfo.processName;
+                    }
+                }
+            }
+        }
+        return "";
+    }
+}

package/harmony/reactNativeMMKV/src/main/cpp/MMKV/Android/MMKV/mmkv/src/main/java/com/tencent/mmkv/MMKVRecoverStrategic.java

@@ -0,0 +1,36 @@
+/*
+ * 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.
+ *
+ * Licensed under the BSD 3-Clause License (the "License"); you may not use
+ * this file except in compliance with the License. You may obtain a copy of
+ * the License at
+ *
+ *       https://opensource.org/licenses/BSD-3-Clause
+ *
+ * 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.
+ */
+
+package com.tencent.mmkv;
+
+/**
+ * The recover strategic of MMKV on errors. {@link MMKV#registerHandler}
+ */
+public enum MMKVRecoverStrategic {
+    /**
+     * The default strategic is to discard everything on errors.
+     */
+    OnErrorDiscard,
+
+    /**
+     * The recover strategic will try to recover as much data as possible.
+     */
+    OnErrorRecover,
+}

package/harmony/reactNativeMMKV/src/main/cpp/MMKV/Android/MMKV/mmkv/src/main/java/com/tencent/mmkv/NameSpace.java

@@ -0,0 +1,214 @@
+/*
+ * Tencent is pleased to support the open source community by making
+ * MMKV available.
+ *
+ * Copyright (C) 2025 THL A29 Limited, a Tencent company.
+ * All rights reserved.
+ *
+ * Licensed under the BSD 3-Clause License (the "License"); you may not use
+ * this file except in compliance with the License. You may obtain a copy of
+ * the License at
+ *
+ *       https://opensource.org/licenses/BSD-3-Clause
+ *
+ * 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.
+ */
+
+package com.tencent.mmkv;
+
+import static com.tencent.mmkv.MMKV.SINGLE_PROCESS_MODE;
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+
+/**
+ * a facade wraps custom root directory
+ */
+public final class NameSpace {
+    private final String rootDir;
+
+    // make it internal
+    NameSpace(String dir) {
+        rootDir = dir;
+    }
+
+    /**
+     * @return The root folder of this NameSpace.
+     */
+    public String getRootDir() {
+        return rootDir;
+    }
+
+    /**
+     * Create an MMKV instance with an unique ID (in single-process mode).
+     *
+     * @param mmapID The unique ID of the MMKV instance.
+     * @throws RuntimeException if there's an runtime error.
+     */
+    @NonNull
+    public MMKV mmkvWithID(String mmapID) throws RuntimeException {
+        long handle = MMKV.getMMKVWithID(mmapID, SINGLE_PROCESS_MODE, null, rootDir, 0, false);
+        return MMKV.checkProcessMode(handle, mmapID, SINGLE_PROCESS_MODE);
+    }
+
+    /**
+     * Create an MMKV instance in single-process or multi-process mode.
+     *
+     * @param mmapID The unique ID of the MMKV instance.
+     * @param mode   The process mode of the MMKV instance, defaults to {@link #SINGLE_PROCESS_MODE}.
+     * @throws RuntimeException if there's an runtime error.
+     */
+    @NonNull
+    public MMKV mmkvWithID(String mmapID, int mode) throws RuntimeException {
+        long handle = MMKV.getMMKVWithID(mmapID, mode, null, rootDir, 0, false);
+        return MMKV.checkProcessMode(handle, mmapID, mode);
+    }
+
+    /**
+     * Create an MMKV instance in single-process or multi-process mode.
+     *
+     * @param mmapID The unique ID of the MMKV instance.
+     * @param mode   The process mode of the MMKV instance, defaults to {@link #SINGLE_PROCESS_MODE}.
+     * @param expectedCapacity The file size you expected when opening or creating file
+     * @throws RuntimeException if there's an runtime error.
+     */
+    @NonNull
+    public MMKV mmkvWithID(String mmapID, int mode, long expectedCapacity) throws RuntimeException {
+        long handle = MMKV.getMMKVWithID(mmapID, mode, null, rootDir, expectedCapacity, false);
+        return MMKV.checkProcessMode(handle, mmapID, mode);
+    }
+
+    /**
+     * Create an MMKV instance in customize process mode, with an encryption key.
+     *
+     * @param mmapID   The unique ID of the MMKV instance.
+     * @param mode     The process mode of the MMKV instance, defaults to {@link #SINGLE_PROCESS_MODE}.
+     * @param cryptKey The encryption key of the MMKV instance (no more than 16 bytes).
+     * @throws RuntimeException if there's an runtime error.
+     */
+    @NonNull
+    public MMKV mmkvWithID(String mmapID, int mode, @Nullable String cryptKey) throws RuntimeException {
+        long handle = MMKV.getMMKVWithID(mmapID, mode, cryptKey, rootDir, 0, false);
+        return MMKV.checkProcessMode(handle, mmapID, mode);
+    }
+
+    /**
+     * Create an MMKV instance in customize process mode, with an encryption key.
+     *
+     * @param mmapID   The unique ID of the MMKV instance.
+     * @param mode     The process mode of the MMKV instance, defaults to {@link #SINGLE_PROCESS_MODE}.
+     * @param cryptKey The encryption key of the MMKV instance (no more than 32 bytes).
+     * @param aes256   Use AES 256 key length.
+     * @throws RuntimeException if there's an runtime error.
+     */
+    @NonNull
+    public MMKV mmkvWithID(String mmapID, int mode, @Nullable String cryptKey, boolean aes256) throws RuntimeException {
+        long handle = MMKV.getMMKVWithID(mmapID, mode, cryptKey, rootDir, 0, aes256);
+        return MMKV.checkProcessMode(handle, mmapID, mode);
+    }
+
+    /**
+     * Create an MMKV instance with customize settings all in one.
+     *
+     * @param mmapID   The unique ID of the MMKV instance.
+     * @param mode     The process mode of the MMKV instance, defaults to {@link #SINGLE_PROCESS_MODE}.
+     * @param cryptKey The encryption key of the MMKV instance (no more than 16 bytes).
+     * @param expectedCapacity The file size you expected when opening or creating file
+     * @throws RuntimeException if there's an runtime error.
+     */
+    @NonNull
+    public MMKV mmkvWithID(String mmapID, int mode, @Nullable String cryptKey, long expectedCapacity)
+            throws RuntimeException {
+        long handle = MMKV.getMMKVWithID(mmapID, mode, cryptKey, rootDir, expectedCapacity, false);
+        return MMKV.checkProcessMode(handle, mmapID, mode);
+    }
+
+    /**
+     * Create an MMKV instance with customize settings all in one.
+     *
+     * @param mmapID   The unique ID of the MMKV instance.
+     * @param mode     The process mode of the MMKV instance, defaults to {@link #SINGLE_PROCESS_MODE}.
+     * @param cryptKey The encryption key of the MMKV instance (no more than 32 bytes).
+     * @param aes256   Use AES 256 key length.
+     * @param expectedCapacity The file size you expected when opening or creating file
+     * @throws RuntimeException if there's an runtime error.
+     */
+    @NonNull
+    public MMKV mmkvWithID(String mmapID, int mode, @Nullable String cryptKey, boolean aes256, long expectedCapacity)
+            throws RuntimeException {
+        long handle = MMKV.getMMKVWithID(mmapID, mode, cryptKey, rootDir, expectedCapacity, aes256);
+        return MMKV.checkProcessMode(handle, mmapID, mode);
+    }
+
+    /**
+     * backup one MMKV instance to dstDir
+     *
+     * @param mmapID   the MMKV ID to backup
+     * @param dstDir   the backup destination directory
+     */
+    public boolean backupOneToDirectory(String mmapID, String dstDir) {
+        return MMKV.backupOneToDirectory(mmapID, dstDir, rootDir);
+    }
+
+    /**
+     * restore one MMKV instance from srcDir
+     *
+     * @param mmapID   the MMKV ID to restore
+     * @param srcDir   the restore source directory
+     */
+    public boolean restoreOneMMKVFromDirectory(String mmapID, String srcDir) {
+        return MMKV.restoreOneMMKVFromDirectory(mmapID, srcDir, rootDir);
+    }
+
+    // TODO: we can't have these functionality because we can't know for sure
+    //  that each instance inside NameSpace has been upgraded successfully or not.
+    //  The workaround is to manually call backup/restore on each instance of NameSpace.
+//    /**
+//     * backup all MMKV instance to dstDir
+//     *
+//     * @param dstDir the backup destination directory
+//     * @return count of MMKV successfully backuped
+//     */
+//    public long backupAllToDirectory(String dstDir) {
+//        return MMKV.backupAllToDirectory(dstDir, rootDir);
+//    }
+//
+//    /**
+//     * restore all MMKV instance from srcDir
+//     *
+//     * @param srcDir the restore source directory
+//     * @return count of MMKV successfully restored
+//     */
+//    public long restoreAllFromDirectory(String srcDir) {
+//        return MMKV.restoreAllFromDirectory(srcDir, rootDir);
+//    }
+
+    /**
+     * Check whether the MMKV file is valid or not.
+     * Note: Don't use this to check the existence of the instance, the result is undefined on nonexistent files.
+     */
+    public boolean isFileValid(String mmapID) {
+        return MMKV.isFileValid(mmapID, rootDir);
+    }
+
+    /**
+     * remove the storage of the MMKV, including the data file & meta file (.crc)
+     * Note: the existing instance (if any) will be closed & destroyed
+     *
+     * @param mmapID   The unique ID of the MMKV instance.
+     */
+    public boolean removeStorage(String mmapID) {
+        return MMKV.removeStorage(mmapID, rootDir);
+    }
+
+    /**
+     * check existence of the MMKV file
+     * @param mmapID   The unique ID of the MMKV instance.
+     */
+    public boolean checkExist(String mmapID) {
+        return MMKV.checkExist(mmapID, rootDir);
+    }
+}