博客

别再用 React Native Async Storage 了

2023年2月10日 6 分钟阅读

为什么你应该放弃 React Native Async Storage,以及 MMKV 等现代替代方案在性能和安全方面有哪些优势。

别再用 React Native Async Storage 了
React NativeAsync StorageAsyncStorageMMKV存储安全性能

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#benchmarkhttps://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。

参考资料

发布平台

本文同时发布于: