Локальное хранилище 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();
}
// Сохранить данные
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));
}
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);
}
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 для сложных структур, а файловое хранилище подходит для больших файлов.