Shared Preferences для хранения данных
Используйте `shared_preferences` для локального хранения небольших объемов данных, например пользовательских настроек и предпочтений, в виде пар «ключ — значение».
«Shared Preferences для хранения данных» — бесплатный урок Flutter Mobile Development на CoddyKit. Это урок 1 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения Flutter Mobile Development, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс Flutter Mobile Development содержит 4 уроков всего.
Части этого урока еще не переведены и отображаются на английском.
What are Shared Preferences?
When building mobile apps, you often need to store small bits of data locally on the device. This could be anything from a user's dark mode preference to their last logged-in status.
shared_preferences is a Flutter package that helps you do just that! It provides a simple way to store key-value pairs of primitive data types.
Why Use Shared Preferences?
- Simple Data: Ideal for storing simple data types like booleans, integers, doubles, strings, and lists of strings.
- User Settings: Perfect for saving user preferences, app settings, or theme choices.
- Lightweight: It's a quick and easy way to persist small amounts of data without needing a full database.
Think of it like a small digital notepad for your app's temporary memory!
Installing the Package
To use shared_preferences, you first need to add it to your project's dependencies.
Open your pubspec.yaml file and add the following line under dependencies:
dependencies:
flutter:
sdk: flutter
shared_preferences: ^2.2.2 # Add this lineSaving Your First Preference
Once the package is added, you can start saving data. You'll need to get an instance of SharedPreferences and then use methods like setBool(), setString(), etc.
Remember to use await because these operations are asynchronous!
import 'package:shared_preferences/shared_preferences.dart';
Future<void> saveSetting() async {
SharedPreferences prefs = await SharedPreferences.getInstance();
await prefs.setBool('isDarkMode', true);
print('Dark mode setting saved!');
}Run It: Saving a Boolean
Try running this example to see how a boolean value is saved. We'll set a 'welcomeShown' flag to true.
import 'package:flutter/widgets.dart';
import 'package:shared_preferences/shared_preferences.dart';
void main() async {
WidgetsFlutterBinding.ensureInitialized();
SharedPreferences prefs = await SharedPreferences.getInstance();
// Save a boolean value
await prefs.setBool('welcomeShown', true);
print('welcomeShown saved: ${prefs.getBool('welcomeShown')}');
}Retrieving Saved Data
To get data back, you use corresponding get methods like getBool(), getString(), etc. These methods return a nullable type (e.g., bool?) because the key might not exist.
It's good practice to provide a default value using the ?? operator if the key is not found.
import 'package:shared_preferences/shared_preferences.dart';
Future<bool> getSetting() async {
SharedPreferences prefs = await SharedPreferences.getInstance();
// Get 'isDarkMode', default to false if not found
bool isDark = prefs.getBool('isDarkMode') ?? false;
return isDark;
}Run It: Loading a Boolean
Let's load the welcomeShown preference we saved earlier. Notice how we handle the case where it might not exist by providing a default of false.
import 'package:flutter/widgets.dart';
import 'package:shared_preferences/shared_preferences.dart';
void main() async {
WidgetsFlutterBinding.ensureInitialized();
SharedPreferences prefs = await SharedPreferences.getInstance();
// Load 'welcomeShown', default to false if not present
bool welcomeShown = prefs.getBool('welcomeShown') ?? false;
print('Is welcome screen already shown? $welcomeShown');
// Let's try to load a key that doesn't exist
String? userName = prefs.getString('userName');
print('User Name: ${userName ?? 'Guest'}');
}Saving Other Data Types
shared_preferences supports several basic data types:
setString(key, value)for textsetInt(key, value)for whole numberssetDouble(key, value)for decimal numberssetStringList(key, value)for lists of strings
There are corresponding get methods for each type.
Run It: Saving Mixed Data
This example demonstrates saving and loading a string, an integer, and a list of strings. See how different types are handled.
import 'package:flutter/widgets.dart';
import 'package:shared_preferences/shared_preferences.dart';
void main() async {
WidgetsFlutterBinding.ensureInitialized();
SharedPreferences prefs = await SharedPreferences.getInstance();
// Save different data types
await prefs.setString('userName', 'Coddy');
await prefs.setInt('score', 12345);
await prefs.setStringList('favoriteFoods', ['Pizza', 'Sushi', 'Tacos']);
print('All data saved!');
// Load and print them
String? name = prefs.getString('userName');
int? score = prefs.getInt('score');
List<String>? foods = prefs.getStringList('favoriteFoods');
print('User Name: ${name ?? 'N/A'}');
print('Score: ${score ?? 0}');
print('Favorite Foods: ${foods ?? []}');
}Deleting Preferences
You can also remove stored preferences:
remove(key): Deletes a specific key-value pair.clear(): Deletes ALL data stored by your app usingshared_preferences. Use with caution!
Both methods are asynchronous and return a Future<bool> indicating success.
Quick Check
You want to store a user's preferred language, which is a single string like 'en_US' or 'es_ES'. Which shared_preferences method is the most appropriate for saving this data?
Recap & Next Steps
Great job! You've learned how to use shared_preferences to store and retrieve small, simple data locally in your Flutter applications.
- It's ideal for user settings and preferences.
- Supports basic types: bool, int, double, string, and List<String>.
- Operations are asynchronous (use
await). - Remember to handle null values when retrieving data.
Next, you'll explore more structured data storage with SQLite databases!
Часто задаваемые вопросы
Урок «Shared Preferences для хранения данных» бесплатный?
Да — полный текст урока «Shared Preferences для хранения данных» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс Flutter Mobile Development, подпишись на CoddyKit PRO. Курс Flutter Mobile Development содержит 4 уроков всего.
Чему я научусь в уроке «Shared Preferences для хранения данных»?
Используйте `shared_preferences` для локального хранения небольших объемов данных, например пользовательских настроек и предпочтений, в виде пар «ключ — значение». Ты практикуешь Flutter Mobile Development с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.
Нужен ли мне опыт, чтобы начать Flutter Mobile Development?
Предыдущий опыт не требуется. Flutter Mobile Development на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 1 из 4.
Сколько времени занимает урок «Shared Preferences для хранения данных»?
Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.
Можно ли писать и запускать код в этом уроке Flutter Mobile Development?
Да. Каждый урок Flutter Mobile Development включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.
Все уроки этого курса
- Shared Preferences для хранения данных
- Интеграция базы данных SQLite
- Операции с файловой системой
- Hive и локальное хранилище NoSQL