Come persistono i dati localmente in Flutter?

Question

Accepted Answer

Le app spesso hanno bisogno di **archiviare dati localmente** sul dispositivo — preferenze utente, dati in cache, contenuti offline. Flutter offre diverse opzioni — **shared_preferences** (chiave-valore), **SQLite** (relazionale) e altre — ciascuna adatta a esigenze diverse.

## Opzioni di archiviazione locale

```text
SHARED_PREFERENCES → simple KEY-VALUE storage (settings, flags, small data):
  → store primitives (strings, ints, bools) — like a simple persistent map
  → for: user preferences, tokens, simple flags (NOT large/structured data)
SQLITE (sqflite) → a full relational DATABASE on the device:
  → tables, SQL queries — for STRUCTURED, larger data; complex queries; relationships
HIVE / ISAR → fast NoSQL local databases (key-value/object stores) — popular, fast,
  Dart-native (no SQL); good for structured local data
FILE storage → read/write files directly (path_provider for directories)
SECURE storage → flutter_secure_storage for SENSITIVE data (tokens, credentials) —
  encrypted (keychain/keystore)
```

## Esempio shared_preferences

```dart
final prefs = await SharedPreferences.getInstance();
await prefs.setString('username', 'Ann');      // store
final name = prefs.getString('username');        // retrieve
await prefs.setBool('darkMode', true);
```

## Scelta dell'opzione giusta

```text
Simple settings/flags → shared_preferences (easy key-value)
Structured/large data, queries → SQLite (sqflite) or Hive/Isar
Sensitive data (tokens, passwords) → flutter_secure_storage (ENCRYPTED — don't put
  secrets in shared_preferences, which is NOT secure)
Files → file storage (path_provider)
→ Match the storage to the data's size, structure, and sensitivity.
```

## Perché è importante

Comprendere come persistere i dati localmente è prezioso perché **le app comunemente hanno bisogno di archiviare dati sul dispositivo** — preferenze utente, dati in cache, contenuti offline, token di autenticazione — quindi è utile conoscenza pratica per costruire app reali.

La persistenza locale è un'esigenza quasi universale (ricordare impostazioni, cache per l'uso offline, memorizzazione dati di sessione), e Flutter offre diverse opzioni adatte a esigenze diverse.

Comprendere le **opzioni** — **shared_preferences** (semplice archiviazione chiave-valore per impostazioni, flag e dati piccoli), **SQLite/sqflite** (un database relazionale completo per dati strutturati più grandi con query e relazioni), **Hive/Isar** (database NoSQL nativi Dart veloci e popolari per dati locali strutturati), archiviazione file e **archiviazione sicura** (`flutter_secure_storage` per dati sensibili) — e **quando usare ciascuno** è la conoscenza chiave.

Scegliere l'**opzione giusta** è importante: shared_preferences per impostazioni semplici, SQLite o Hive/Isar per dati strutturati/grandi, archiviazione file per file, e crucialmente **archiviazione sicura per dati sensibili** come token e credenziali (che devono essere crittografati via keychain/keystore della piattaforma — un punto di sicurezza importante, dato che **shared_preferences non è sicuro e non dovrebbe contenere segreti**, un errore comune).

Matching dello storage con la dimensione, struttura e sensibilità dei dati riflette decisioni solide e evita problemi (come usare lo strumento sbagliato per il lavoro o archiviare credenziali in modo non sicuro).

Poiché le app comunemente hanno bisogno di persistenza locale (impostazioni, cache, dati offline, token) e Flutter offre diverse opzioni per esigenze diverse, e poiché comprenderle e scegliere appropriatamente (specialmente usando archiviazione sicura per dati sensibili) è prezioso per costruire app reali correttamente, comprendere la persistenza dei dati locali in Flutter è conoscenza preziosa e praticamente rilevante — un'esigenza comune nelle app reali, importante sia per la funzionalità (archiviare i dati giusti nel modo giusto) che per la sicurezza (proteggere dati sensibili con archiviazione sicura), e un'abilità utile per costruire app che ricordano lo stato e funzionano offline.