Como você persiste dados localmente no React Native?

Question

Accepted Answer

Aplicações React Native frequentemente precisam **armazenar dados localmente** — preferências do usuário, dados em cache, tokens de autenticação, conteúdo offline. As opções incluem **AsyncStorage** (chave-valor), **MMKV** (rápido), **SQLite** e **armazenamento seguro** para dados sensíveis. Escolher a opção correta é importante.

## Opções de armazenamento local

```text
ASYNCSTORAGE → simple async KEY-VALUE storage (the common basic option):
  → store strings (serialize objects to JSON); for settings, small data, simple caching
  → async API; persists across app launches
MMKV → a very FAST key-value storage (by WeChat) — faster than AsyncStorage, synchronous;
  popular modern choice for performance
SQLITE (e.g. expo-sqlite, react-native-sqlite, WatermelonDB) → relational DATABASE for
  STRUCTURED/large data, queries, relationships, offline-first apps
SECURE STORAGE → expo-secure-store / react-native-keychain for SENSITIVE data (tokens,
  credentials) — ENCRYPTED (keychain/keystore)
```

## Exemplo com AsyncStorage

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

await AsyncStorage.setItem('user', JSON.stringify(user));   // store (serialize)
const json = await AsyncStorage.getItem('user');
const user = json ? JSON.parse(json) : null;                 // retrieve (parse)
```

## Escolhendo a opção correta

```text
Simple settings/small data → AsyncStorage (or MMKV for speed)
Structured/large/relational/offline data → SQLite / WatermelonDB
SENSITIVE data (auth tokens, passwords) → SECURE storage (encrypted) — NOT AsyncStorage
  (which is NOT secure/encrypted — a common security mistake)
→ Match storage to the data's size, structure, and sensitivity.
```

## Por que isso importa

Entender como persistir dados localmente no React Native é valioso porque **aplicativos comumente precisam armazenar dados no dispositivo** (preferências, dados em cache, tokens, conteúdo offline), portanto é conhecimento prático útil para construir aplicativos reais.

A persistência local é uma necessidade quase universal, e React Native oferece várias opções.

Entender as **opções** — **AsyncStorage** (o simples armazenamento de chave-valor assíncrono comum para configurações e dados pequenos), **MMKV** (uma alternativa de chave-valor moderna e muito rápida), **SQLite/WatermelonDB** (bancos de dados relacionais para dados estruturados, grandes ou offline-first com consultas), e **armazenamento seguro** (expo-secure-store/react-native-keychain para dados sensíveis) — e **quando usar cada uma** é o conhecimento-chave.

Escolher a **opção correta** importa: AsyncStorage ou MMKV para dados simples, SQLite para dados estruturados/grandes/offline, e crucialmente **armazenamento seguro para dados sensíveis** como tokens de autenticação e credenciais (que devem ser criptografados via keychain/keystore da plataforma — um ponto de segurança importante, já que **AsyncStorage não é seguro/criptografado e não deve armazenar segredos**, um erro comum).

Alinhar o armazenamento ao tamanho, estrutura e sensibilidade dos dados reflete decisões apropriadas e evita problemas (ferramenta errada ou credenciais armazenadas de forma insegura).

Saber sobre soluções offline-first (WatermelonDB) é valioso para aplicativos que precisam de suporte offline robusto.

Como aplicativos comumente precisam de persistência local (configurações, cache, tokens, dados offline) e React Native oferece opções para diferentes necessidades, e como escolher apropriadamente (especialmente usando armazenamento seguro para dados sensíveis) é importante para construir aplicativos reais corretamente e com segurança, entender a persistência de dados locais no React Native é um conhecimento valioso e praticamente relevante — uma necessidade comum em aplicativos reais, importante tanto para funcionalidade (armazenar os dados corretos da forma correta) quanto para segurança (proteger dados sensíveis com armazenamento seguro, não AsyncStorage), e útil para construir aplicativos que lembram o estado e funcionam offline.