React Native MMKVとReact Native Async Storageの比較
長い間、React Native Async Storageは、React Nativeアプリケーションでデータを保存するための定番の選択肢でした。しかし、React-Native MMKVの登場によって、開発者はより効率的で高度な選択肢を手にしました。
MMKVは、もともとWeChatアプリのために、効率的で小さく使いやすいモバイル向けのキーバリューストレージのフレームワークとして設計されたものです。
ネイティブのC++ライブラリへの高速な直接バインディングを、シンプルなJavaScriptのAPIを通じてReact Nativeのプラットフォームにもたらしてくれます。React-Native MMKVは今や、React Nativeアプリケーションでのデータ保存の有力な選択肢です。React-Native MMKVの大きな利点のひとつはパフォーマンスです。すべてがC++で書かれているので、AsyncStorageより約30倍高速です。さらに暗号化にも対応しているので、アプリのための安全なストレージになります。「古い」Bridgeの代わりにJSIを使っていることも、速度と効率をさらに高めています。
ベンチマーク
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を組み合わせて使う例です。この2つのライブラリを組み合わせることで、アプリを閉じたり再起動したりしたあとでも、アプリのstateを永続化できます。
アプリのテーマの設定に関する情報と、その設定を変更するメソッドを持つ、AppPersistStoreという独自の型を宣言します。
次に、アプリのstateを永続化するために使うMMKVのインスタンスを作ります。このインスタンスはappPersistStorageという定数に保存します。
それから、StateStorageインターフェースを実装したzustandMMKVStorageというオブジェクトを作ります。このオブジェクトは、値の設定や取得など、appPersistStorageのインスタンスとやり取りするための一連のメソッドを提供する役割を持ちます。
最後に、zustandライブラリのcreate関数を使って、useAppPersistStoreというhookを作ります。このhookは、アプリのテーマの設定の現在のstateと、その設定を変更するメソッドを返します。persistミドルウェアを使うことで、stateが変わるたびに、アプリのstateが自動的にappPersistStorageのインスタンスに保存されるようにしています。
このストアのアクションを呼ぶたびに、その内容が永続化されます。つまり、アプリを閉じたり再起動したりしても、アプリの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"}
/>
);
};
この例では、theme-preferenceというIDでMMKVのストレージを作り、addOnValueChangedListenerメソッドを使ってリスナーを追加しています。リスナーはストレージの変更を監視し、それに応じてアプリのテーマを更新します。
上の例は、意味のある実用的な例というより、React Native MMKVのリスナー機能の使い方を最小限のコードで示すためのものです。コードスニペットでは、リスナーを使ってストレージの変更を監視し、変更されたキーの新しい値をログに出しています。
Expoで使う
React native mmkvはExpoと互換性がありますが、ネイティブモジュールの上に作られているので、(ネイティブのコードが生成されていない)典型的なExpoアプリではそのままでは動きません。ネイティブのコードを生成する必要があります。言い換えると、Expoのprebuild機能を活用する必要があります。
まとめ
React Nativeの開発者として、React NativeアプリケーションのストレージにはReact Native MMKVを強くおすすめします。このライブラリには、jotai、redux-persist、mobx-persist、zustand-persist-middlewareといったほかの人気の状態管理ライブラリと統合する方法のドキュメントもあり、どんなプロジェクトにも簡単に組み込めます。
React Native Async Storageと比べると、React Native MMKVには、高いパフォーマンス、暗号化への対応、使いやすいAPIなど、いくつかの決定的な利点があります。async/awaitやPromiseが不要な完全に同期的な呼び出しによって、より速く効率的な選択肢になっています。
ですので、React Nativeアプリのために信頼できて安全なストレージを探しているなら、React Native MMKVの利用をぜひ検討してください。
参考資料
掲載先
この記事は次の場所でも公開しています。