Локальное хранилище Flutter

В этом разделе будут представлены решения для локального хранения в Flutter, включая SharedPreferences, файловое хранилище и базы данных SQLite.


SharedPreferences - легковесное хранилище

SharedPreferences подходит для хранения простых данных в виде пар ключ-значение.

Добавить зависимость

dependencies:
  shared_preferences: ^2.0.0

Пример: использование SharedPreferences

import 'package:shared_preferences/shared_preferences.dart';

// Сохранить данные
Future<void> saveData() async {
  final prefs = await SharedPreferences.getInstance();

  // Сохранить строку
  await prefs.setString('username', 'Zhang San');

  // Сохранить целое число
  await prefs.setInt('age', 25);

  // Сохранить логическое значение
  await prefs.setBool('isLoggedIn', true);

  // Сохранить список (JSON-строка)
  await prefs.setStringList('tags', ['flutter', 'dart']);
}

// Чтение данных
Future<void> loadData() async {
  final prefs = await SharedPreferences.getInstance();

  final username = prefs.getString('username') ?? '';
  final age = prefs.getInt('age') ?? 0;
  final isLoggedIn = prefs.getBool('isLoggedIn') ?? false;
  final tags = prefs.getStringList('tags') ?? [];

  print('Имя пользователя: $username');
  print('Возраст: $age');
  print('Вход выполнен: $isLoggedIn');
  print('Теги: $tags');
}

// Удалить данные
Future<void> deleteData() async {
  final prefs = await SharedPreferences.getInstance();

  // Удалить один
  await prefs.remove('username');

  // Удалить все
  await prefs.clear();
}

Файловое хранилище

Используйте path_provider, чтобы получить каталог документов приложения для файлового хранилища.

Добавить зависимость

dependencies:
  path_provider: ^2.0.0

Пример: чтение/запись файла

import 'dart:io';
import 'package:path_provider/path_provider.dart';

// Получить каталог документов
Future<Directory> get _documentDirectory async {
  return await getApplicationDocumentsDirectory();
}

// Запись файла
Future<void> writeFile() async {
  final dir = await _documentDirectory;
  final file = File('${dir.path}/my_file.txt');

  // Записать текст
  await file.writeAsString('Hello Flutter!');

  // Записать байты
  final bytes = [72, 101, 108, 108, 111];  // "Hello"
  await file.writeAsBytes(bytes);
}

// Чтение файла
Future<void> readFile() async {
  final dir = await _documentDirectory;
  final file = File('${dir.path}/my_file.txt');

  if (await file.exists()) {
    // Чтение текста
    final content = await file.readAsString();
    print('Содержимое файла: $content');

    // Чтение байтов
    final bytes = await file.readAsBytes();
    print('Байты: $bytes');
  }
}

// Хранение JSON в файле
Future<void> saveJson() async {
  final dir = await _documentDirectory;
  final file = File('${dir.path}/data.json');

  final data = {
    'name': 'Zhang San',
    'age': 25,
    'skills': ['Flutter', 'Dart'],
  };

  // Использовать jsonEncode для сохранения JSON
  await file.writeAsString(jsonEncode(data));
}

База данных SQLite

Использовать sqflite для операций с базой данных SQLite.

Добавить зависимость

dependencies:
  sqflite: ^2.0.0
  path: ^1.8.0

Пример: базовые операции SQLite

import 'package:sqflite/sqflite.dart';
import 'package:path/path.dart';

// Вспомогательный класс для базы данных
class DatabaseHelper {
  static final DatabaseHelper instance = DatabaseHelper._init();
  static Database? _database;

  DatabaseHelper._init();

  Future<Database> get database async {
    if (_database != null) return _database!;
    _database = await _initDB('my_app.db');
    return _database!;
  }

  // Инициализировать базу данных
  Future<Database> _initDB(String filePath) async {
    final dbPath = await getDatabasesPath();
    final path = join(dbPath, filePath);

    return await openDatabase(
      path,
      version: 1,
      onCreate: _createDB,
    );
  }

  // Создание таблицы
  Future<void> _createDB(Database db, int version) async {
    await db.execute('''
      CREATE TABLE users(
        id INTEGER PRIMARY KEY AUTOINCREMENT,
        name TEXT NOT NULL,
        email TEXT NOT NULL,
        age INTEGER
      )
    '
'');
  }

  // Вставка данных
  Future<int> insertUser(Map<String, dynamic> user) async {
    final db = await database;
    return await db.insert('users', user);
  }

  // Запросить всех пользователей
  Future<List<Map<String, dynamic>>> getAllUsers() async {
    final db = await database;
    return await db.query('users');
  }

  // Условный запрос
  Future<List<Map<String, dynamic>>> getUserByName(String name) async {
    final db = await database;
    return await db.query(
      'users',
      where: 'name = ?',
      whereArgs: [name],
    );
  }

  // Обновить данные
  Future<int> updateUser(int id, Map<String, dynamic> user) async {
    final db = await database;
    return await db.update(
      'users',
      user,
      where: 'id = ?',
      whereArgs: [id],
    );
  }

  // Удалить данные
  Future<int> deleteUser(int id) async {
    final db = await database;
    return await db.delete(
      'users',
      where: 'id = ?',
      whereArgs: [id],
    );
  }

  // Закрыть базу данных
  Future<void> close() async {
    final db = await database;
    db.close();
  }
}

// Пример использования
Future<void> dbExample() async {
  final db = DatabaseHelper.instance;

  // Добавить пользователя
  await db.insertUser({
    'name': 'Zhang San',
    'email': 'zhangsan@example.com',
    'age': 25,
  });

  // Запросить все
  final users = await db.getAllUsers();
  print('Список пользователей: $users');

  // Обновить пользователя
  await db.updateUser(1, {'name': 'Li Si', 'age': 30});

  // Удалить пользователя
  await db.deleteUser(1);
}

Выбор решения для хранения данных: используйте SharedPreferences для простых пар ключ-значение, SQLite для сложных структур, а файловое хранилище подходит для больших файлов.

Другие расширения