المدونة

توقف عن استخدام React Native Async Storage

10 فبراير 2023 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 في الأصل لتكون إطار تخزين key-value للهواتف، فعّالًا وصغيرًا وسهل الاستخدام، لتطبيق WeChat.

وهي تنقل إلى منصة React Native ارتباطاتها السريعة والمباشرة بمكتبة C++ الأصلية عبر واجهة JavaScript بسيطة. أصبحت React-Native MMKV الآن خيارًا بارزًا لتخزين البيانات في تطبيقات React Native. ومن أهم مزاياها الأداء. فبما أن كل شيء مكتوب بلغة C++، فهي أسرع من AsyncStorage بنحو 30 مرة. وفوق ذلك توفر دعمًا للتشفير، ما يجعلها حلًا آمنًا للتخزين في تطبيقك. كما أن استخدام JSI بدل الـ Bridge "القديم" يزيد من سرعتها وكفاءتها.

قياس الأداء (Benchmark)

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 أو Promises. وهذا على عكس AsyncStorage التي تتطلب سلوكًا غير متزامن. مع react-native-mmkv يمكنك تخزين البيانات واسترجاعها بسهولة باستخدام getters وsetters بسيطة. لنرَ كيف نهيئ التخزين باستخدام 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)، ما يسهّل تخزين بنى البيانات المعقدة. يوضح ذلك الكود التالي:

// 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، يحتوي على معلومات تفضيل السمة في التطبيق ودالة لتغيير هذا التفضيل.

بعد ذلك ننشئ نسخة (instance) من MMKV نستخدمها لحفظ حالة تطبيقنا. تُخزَّن هذه النسخة في ثابت اسمه appPersistStorage.

ثم ننشئ كائنًا اسمه zustandMMKVStorage يطبّق الواجهة StateStorage. هذا الكائن مسؤول عن توفير مجموعة من الدوال التي تتيح لنا التعامل مع النسخة appPersistStorage، مثل ضبط القيم واسترجاعها.

وأخيرًا نستخدم الدالة create من مكتبة zustand لإنشاء hook اسمه useAppPersistStore، يعيد الحالة الحالية لتفضيل السمة في التطبيق، ودالة لتغيير هذا التفضيل. ونستخدم الـ middleware المسمى persist لضمان حفظ حالة تطبيقنا تلقائيًا في النسخة appPersistStorage كلما تغيّرت الحالة.

كلما استدعينا أي action من هذا الـ 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;

المستمعات (Listeners) مع 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 بالمعرّف theme-preference وأضفنا إليه مستمعًا باستخدام الدالة addOnValueChangedListener. يستمع المستمع للتغييرات في التخزين ويحدّث السمة في التطبيق بناءً عليها.

الهدف من المثال أعلاه هو توضيح طريقة استخدام ميزة المستمع في React Native MMKV بأقل قدر من الكود، وليس تقديم مثال ذي معنى. في مقتطف الكود يُستخدم المستمع للاستماع إلى التغييرات في التخزين وطباعة القيم الجديدة للمفتاح الذي تغيّر.

الاستخدام مع Expo

مكتبة React native mmkv متوافقة فعلًا مع expo، لكن بما أنها مبنية على native modules، فلن تعمل مباشرة في تطبيق expo عادي (لا يحتوي على كود native مولَّد). نحتاج إلى توليد الكود الـ native، أي بعبارة أخرى نحتاج إلى الاستفادة من ميزة prebuild في expo.


الخلاصة

بصفتي مطور 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 أو Promises، تجعلها خيارًا أسرع وأكثر كفاءة.

لذلك، إذا كنت تبحث عن حل تخزين موثوق وآمن لتطبيق React Native الخاص بك، فأنصحك بأن تفكر في استخدام React Native MMKV.

المصادر

منشور أيضًا على

هذا المقال منشور أيضًا على: