💾 67. React Native 로컬 저장소 완전 이해하기 - AsyncStorage부터 Realm까지

---

모바일 앱은 오프라인 상황에서도 잘 동작해야 한다.
특히 네트워크가 끊긴 상황에서도 데이터를 보관하고 사용할 수 있는
로컬 저장소(Local Storage)는 앱의 신뢰도와 사용자 경험을 좌우한다.

React Native에서 사용할 수 있는 다양한 저장 방식과
상황별 추천 전략까지 한눈에 정리해본다! 🧠

---

🗂 1. AsyncStorage – 기본 저장소

가장 많이 사용하는 key-value 저장 방식.
설정 없이 간단하게 문자열 데이터를 저장할 수 있다.

npm install @react-native-async-storage/async-storage

import AsyncStorage from '@react-native-async-storage/async-storage';

await AsyncStorage.setItem('nickname', 'jeongmin');
const nick = await AsyncStorage.getItem('nickname');

• 간단하고 바로 쓸 수 있음
• 문자열 저장 위주 (JSON.stringify 필요)
• Promise 기반 비동기 API

🔸 캐시, 세팅값, 최근 검색어 등 간단한 데이터에 적합

---

⚡ 2. MMKV – 빠른 성능의 로컬 DB

Facebook에서 만든 고성능 저장소.
C++ 기반으로 만들어져 속도가 빠르고 안정적이다.

npm install react-native-mmkv

import { MMKV } from 'react-native-mmkv';
const storage = new MMKV();

storage.set('theme', 'dark');
const theme = storage.getString('theme');

• 동기 API → 매우 빠른 접근 속도
• JSON 저장도 지원됨
• 앱 재시작 후에도 값 유지

🔹 성능이 중요한 설정, 다크모드, 토글값 저장에 추천!

---

🔐 3. SecureStore / Keychain – 민감 정보 보안 저장

토큰, 비밀번호, 인증서 등 민감한 정보를 저장할 땐
운영체제 수준의 암호화 저장소를 써야 한다.

import * as SecureStore from 'expo-secure-store';

await SecureStore.setItemAsync('token', 'abcd1234');
const token = await SecureStore.getItemAsync('token');

• 자동 암호화 처리
• iOS: Keychain, Android: Keystore 사용
• expo-secure-store 또는 react-native-keychain 활용 가능

🔒 로그인 세션, 인증 토큰에는 무조건 사용!

---

🧱 4. Realm – 구조화된 로컬 DB

정형화된 테이블 구조가 필요한 경우 Realm을 사용하면 좋다.
SQLLite보다 API가 직관적이고, 오프라인 지원도 뛰어나다.

import Realm from "realm";

const TaskSchema = {
  name: 'Task',
  properties: {
    id: 'int',
    title: 'string',
    done: 'bool',
  }
};

const realm = await Realm.open({ schema: [TaskSchema] });

realm.write(() => {
  realm.create('Task', { id: 1, title: '블로그 쓰기', done: false });
});

• 객체 기반 DB → JSON 구조 저장에 최적
• 쿼리/필터링 가능
• 오프라인 앱에 강력한 성능

📊 대용량 데이터, 리스트, 히스토리 로그 등에 적합

---

🤔 언제 무엇을 써야 할까?

상황	저장소 추천
문자열 캐시, 설정값	AsyncStorage
빠른 토글 상태 등	MMKV
토큰, 비밀번호 저장	SecureStore / Keychain
DB 구조, 대용량 목록	Realm

---

🧠 정리하며 느낀 점

처음엔 다 AsyncStorage로 때려박았던 시절이 있었는데... 😅
이제는 어떤 데이터를 어디에 저장하느냐에 따라
성능과 사용자 경험이 확 달라진다.

특히 보안 처리, 성능 최적화, 오프라인 대응까지 고려한다면
MMKV와 SecureStore는 꼭 써보자!

---

🚀 React Native 앱의 퀄리티는 로컬 데이터 저장 전략에서 갈린다.
단순한 기능 이상으로, 앱의 완성도를 높이는 핵심 포인트다!

---