React Native MMKV 与 React Native Async Storage 对比
在相当长的一段时间里,React Native Async Storage 一直是 React Native 应用存储数据的首选。不过,React-Native MMKV 的出现给了开发者一个更高效、更先进的选择。
MMKV 最初是为微信应用设计的一个高效、小巧、易用的移动端键值存储框架。
它通过简单的 JavaScript API,把对原生 C++ 库的快速直接绑定带到了 React Native 平台。如今 React-Native MMKV 已经是 React Native 应用数据存储的主流选择之一。React-Native MMKV 的一大优势是性能。由于全部用 C++ 编写,它比 AsyncStorage 快约 30 倍。此外,它还支持加密,可以作为应用的安全存储方案。它使用 JSI 而不是“旧的” Bridge,这进一步提升了速度和效率。
基准测试
MMKV 与其他存储库对比:从存储中读取一个值 1000 次。 在 iPhone 11 Pro 上以毫秒计,越低越好。
https://github.com/mrousavy/react-native-mmkv#benchmark
不需要 Async/Await
React-Native MMKV 还提供完全同步的调用,不用 async/await 或 Promise 就能轻松使用。AsyncStorage 则不同,它必须以异步方式工作。有了 react-native-mmkv,你可以用简单的 getter 和 setter 存取数据。来看看如何用 react-native-mmkv 初始化存储:
import { MMKV } from "react-native-mmkv";
export const appStorage = new MMKV({
id: "my-app-storage",
});
从存储中读取数据同样简单,如下所示:
// set a new key/value pair using react-native-mmkv
appStorage.set("username", "John");
const username = appStorage.getString("username");
// below is how you would do using react-native-async-storage
await AsyncStorage.setItem("username", "John");
const username = await AsyncStorage.getItem("username");
React-Native MMKV 也支持对象存储,可以轻松保存复杂的数据结构。代码如下:
// Objects
// using react-native-mmkv
const user = {
username: "John",
role: "Admin",
};
appStorage.set("user", JSON.stringify(user));
const jsonUser = appStorage.getString("user");
const userObject = JSON.parse(jsonUser);
// using react-native-async-storage
await AsyncStorage.setItem("user", JSON.stringify(user));
const jsonUser = await AsyncStorage.getItem("user");
const userObject = JSON.parse(jsonUser);
从存储中删除数据也一样简单,如下所示:
// to remove specific item from the storage in mmkv
appStorage.delete("username");
// below is how you would do using react-native-async-storage
await AsyncStorage.removeItem("username");
真实案例:Zustand persist 中间件与 React Native MMKV
React-Native MMKV 可以和流行的状态管理库集成,比如 jotai、redux-persist、mobx-persist 和 zustand-persist-middleware。这样开发者就能在现有的状态管理方案里,用上 MMKV 高效、快速、易用的存储能力。集成之后,状态管理体验顺畅而简洁,开发者管理和持久化应用数据也更轻松。
import { Appearance } from "react-native";
import { MMKV } from "react-native-mmkv";
import create from "zustand";
import { persist, StateStorage } from "zustand/middleware";
type AppPersistStore = {
isDarkTheme: boolean;
setIsDarkTheme: (preference: boolean) => void;
};
export const appPersistStorage = new MMKV({ id: "app-persist-storage" });
const zustandMMKVStorage: StateStorage = {
setItem: (name, value) => {
return appPersistStorage.set(name, value);
},
getItem: (name) => {
const value = appPersistStorage.getString(name);
return value ?? null;
},
removeItem: (name) => {
return appPersistStorage.delete(name);
},
};
export const useAppPersistStore = create<
AppPersistStore,
[["zustand/persist", AppPersistStore]]
>(
persist(
(set, get) => ({
isDarkTheme: Appearance.getColorScheme() === "dark",
setIsDarkTheme: (preference) => set({ isDarkTheme: preference }),
}),
{
name: "app-persist-storage",
getStorage: () => zustandMMKVStorage,
serialize: (state) => JSON.stringify(state),
deserialize: (state) => JSON.parse(state),
}
)
);
上面的代码片段演示了如何把 zustand-persist-middleware 和 react-native-mmkv 结合起来,处理应用的浅色/深色主题。这两个库组合使用,可以持久化应用的 state,即使应用被关闭或重启也不会丢失。
我们声明了一个自定义类型 AppPersistStore,它包含应用的主题偏好信息,以及一个修改该偏好的方法。
接着,我们创建一个 MMKV 实例,用来持久化应用的 state。这个实例保存在名为 appPersistStorage 的常量中。
然后,我们创建一个实现 StateStorage 接口的对象 zustandMMKVStorage。这个对象负责提供一组方法,让我们可以和 appPersistStorage 实例交互,比如设置和读取值。
最后,我们用 zustand 库的 create 函数创建一个名为 useAppPersistStore 的 hook,它返回应用当前的主题偏好 state,以及修改该偏好的方法。我们使用 persist 中间件,确保每当 state 发生变化时,都会自动保存到 appPersistStorage 实例中。
每次调用这个 store 里的任意 action,都会被持久化。也就是说,即使应用被关闭或重启,应用的 state 也会和上次使用时保持一致。无论用户何时、以何种方式使用应用,都能获得一致的体验。
下面是最终使用这个 hook 的方式:
import * as React from "react";
import { Button } from "react-native";
import { useAppPersistStore } from "./app-persist";
const Home: React.FC = () => {
// here we have our mmkv and zustand persist-middleware hook that we have initialized previously
const { isDarkTheme, setIsDarkTheme } = useAppPersistStore();
return (
<Button
onPress={() => setIsDarkTheme(!isDarkTheme)}
title={isDarkTheme ? "Dark Theme" : "Light theme"}
/>
);
};
export default Home;
react-native-mmkv 的监听器
我们可以用 React Native MMKV 的监听器功能来跟踪存储中的变化。当存储里某个特定的值发生变化时,如果需要执行某些操作,这个功能就很有用。
下面是在 React Native 应用中使用监听器的示例:
import * as React from "react";
import { Button } from "react-native";
import { MMKV } from "react-native-mmkv";
const storage = new MMKV({ id: "theme-preference" });
const Home: React.FC = () => {
const [isDarkTheme, setIsDarkTheme] = React.useState(false);
React.useEffect(() => {
const listener = storage.addOnValueChangedListener((changedKey) => {
const newValue = storage.getString(changedKey);
if (changedKey === "isDarkTheme") {
// update the theme in the app based on the updated value in the storage
console.log(`New theme preference: ${newValue}`);
}
});
return () => {
listener.remove();
};
}, []);
const toggleTheme = () => {
const newPreference = !isDarkTheme;
setIsDarkTheme(newPreference);
storage.set("isDarkTheme", JSON.stringify(newPreference));
};
return (
<Button
onPress={toggleTheme}
title={isDarkTheme ? "Dark Theme" : "Light Theme"}
/>
);
};
在这个例子里,我们创建了一个 ID 为 theme-preference 的 MMKV 存储,并通过 addOnValueChangedListener 方法为它添加了一个监听器。监听器会监听存储的变化,并据此更新应用的主题。
上面的例子只是想用尽量少的代码来演示 React Native MMKV 监听器功能的用法,并不是一个有实际意义的例子。在这段代码里,监听器用来监听存储的变化,并打印出变化的 key 的新值。
在 Expo 中使用
React native mmkv 确实兼容 expo,但由于它基于原生模块构建,在典型的 expo 应用(没有生成原生代码)中无法开箱即用。我们需要生成原生代码,换句话说,需要用到 expo 的 prebuild 功能。
总结
作为一名 react native 开发者,我非常推荐把 React Native MMKV 作为 React Native 应用的存储方案。这个库提供了与其他流行状态管理库(比如 jotai、redux-persist、mobx-persist 和 zustand-persist-middleware)集成的文档,很容易接入任何项目。
和 React Native Async Storage 相比,React Native MMKV 有几项关键优势,包括高性能、支持加密以及易用的 API。它的调用完全同步,不需要 async/await 或 Promise,因此更快、更高效。
所以,如果你正在为 React Native 应用寻找可靠又安全的存储方案,我建议你考虑 React Native MMKV。
参考资料
发布平台
本文同时发布于: