Как сохранять данные локально во Flutter?

Question

Accepted Answer

Приложения часто должны **сохранять данные локально** на устройстве — предпочтения пользователя, кэшированные данные, оффлайн-контент. Flutter предлагает несколько вариантов — **shared_preferences** (ключ-значение), **SQLite** (реляционная база данных) и другие — каждый подходит для разных нужд.

## Варианты локального хранилища

```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)
```

## Пример 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);
```

## Выбор правильного варианта

```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.
```

## Почему это важно

Понимание того, как сохранять данные локально, ценно, потому что **приложения часто должны сохранять данные на устройстве** — предпочтения пользователя, кэшированные данные, оффлайн-контент, токены аутентификации — поэтому это полезное практическое знание для создания реальных приложений.

Локальная persistence — это почти универсальная необходимость (запоминание параметров, кэширование для оффлайн-использования, сохранение данных сеанса), и Flutter предлагает несколько вариантов, подходящих для разных нужд.

Понимание **вариантов** — **shared_preferences** (простое хранилище ключ-значение для параметров, флагов и небольших данных), **SQLite/sqflite** (полнофункциональная реляционная база данных для структурированных больших данных с запросами и связями), **Hive/Isar** (быстрые нативные для Dart NoSQL базы данных, популярные для структурированных локальных данных), хранилище файлов и **безопасное хранилище** (`flutter_secure_storage` для чувствительных данных) — и **когда использовать каждый** — это ключевое знание.

Выбор **правильного варианта** важен: shared_preferences для простых параметров, SQLite или Hive/Isar для структурированных/больших данных, хранилище файлов для файлов, и критически важно **безопасное хранилище для чувствительных данных** таких как токены и учетные данные (которые должны быть зашифрованы через платформенный keychain/keystore — важный момент безопасности, поскольку **shared_preferences не безопасен и не должен содержать секреты**, это распространенная ошибка).

Соответствие хранилища размеру, структуре и чувствительности данных отражает обоснованные решения и избегает проблем (таких как использование неправильного инструмента для задачи или небезопасное хранение учетных данных).

Поскольку приложения часто нуждаются в локальной persistence (параметры, кэширование, оффлайн-данные, токены) и Flutter предлагает несколько вариантов для разных нужд, и поскольку понимание их и правильный выбор (особенно использование безопасного хранилища для чувствительных данных) ценно для создания реальных приложений правильно, понимание локальной persistence данных во Flutter — это ценное, практически релевантное знание — распространенная необходимость в реальных приложениях, важное как для функциональности (сохранение правильных данных правильным способом), так и для безопасности (защита чувствительных данных с помощью безопасного хранилища), и полезный навык для создания приложений, которые запоминают состояние и работают в оффлайн-режиме.