Сравнение React Native MMKV и React Native Async Storage
Довольно долгое время React Native Async Storage был стандартным выбором для хранения данных в приложениях на React Native. Однако с появлением React-Native MMKV у разработчиков появился более эффективный и продвинутый вариант.
MMKV изначально создавался как эффективный, компактный и удобный фреймворк для хранения пар ключ/значение на мобильных устройствах для приложения WeChat.
Он переносит свои быстрые прямые биндинги к нативной библиотеке на C++ на платформу React Native через простой JavaScript API. Сейчас React-Native MMKV стал заметным вариантом хранения данных в приложениях на React Native. Одно из главных преимуществ React-Native MMKV: производительность. Поскольку всё написано на C++, он примерно в 30 раз быстрее AsyncStorage. Кроме того, он поддерживает шифрование, так что это ещё и безопасное хранилище для вашего приложения. Использование JSI вместо «старого» Bridge дополнительно повышает скорость и эффективность.
Бенчмарк
https://github.com/mrousavy/react-native-mmkv#benchmark
Без Async/Await
React-Native MMKV также предлагает полностью синхронные вызовы, поэтому им легко пользоваться без async/await и Promise. В этом его отличие от AsyncStorage, который требует асинхронной работы. С react-native-mmkv можно легко сохранять и получать данные через простые геттеры и сеттеры. Посмотрим, как инициализировать хранилище с помощью 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 middleware-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 для работы со светлой и тёмной темой приложения. Сочетание этих двух библиотек позволяет сохранять состояние приложения даже после того, как приложение закрыли или перезапустили.
Мы объявляем собственный тип AppPersistStore, который содержит информацию о выбранной теме приложения и метод для её изменения.
Затем мы создаём экземпляр MMKV, который будет использоваться для сохранения состояния приложения. Этот экземпляр хранится в константе appPersistStorage.
После этого мы создаём объект zustandMMKVStorage, который реализует интерфейс StateStorage. Этот объект отвечает за набор методов, через которые мы работаем с экземпляром appPersistStorage, например записываем и читаем значения.
Наконец, с помощью функции create из библиотеки zustand мы создаём hook useAppPersistStore, который возвращает текущую выбранную тему приложения, а также метод для её изменения. Мы используем middleware persist, чтобы состояние приложения автоматически сохранялось в экземпляр appPersistStorage при каждом изменении.
Каждый раз, когда мы вызываем любое действие этого store, результат сохраняется. Это значит, что даже если приложение закроют или перезапустят, его состояние останется таким же, каким было при последнем использовании. Так пользователь получает одинаковый опыт, независимо от того, когда и как он пользуется приложением.
Вот как мы в итоге будем использовать этот 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"}
/>
);
};
В этом примере мы создали хранилище MMKV с ID theme-preference и добавили к нему слушатель с помощью метода addOnValueChangedListener. Слушатель следит за изменениями в хранилище и соответственно обновляет тему в приложении.
Пример выше задуман как иллюстрация работы слушателей в React Native MMKV с минимальным количеством кода, а не как содержательный пример. В этом фрагменте слушатель следит за изменениями в хранилище и выводит в лог новые значения изменённого ключа.
Использование с 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.
Ресурсы
Где опубликовано
Эта статья также опубликована на: