Flutter Mobile Development · レッスン

データのためのShared Preferences

`shared_preferences`を使って、ユーザー設定や環境設定などの少量のデータをキーバリューペアとしてローカルに保存します。

「データのためのShared Preferences」はCoddyKit上の無料Flutter Mobile Developmentレッスンです。これはレッスン1/4です。下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。これは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 line

Saving 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 text
setInt(key, value) for whole numbers
setDouble(key, value) for decimal numbers
setStringList(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 using shared_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時間対応のAIチューター）、Flutter Mobile Developmentコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 Flutter Mobile Developmentコースには全4レッスンが含まれています。

「データのためのShared Preferences」で何を学びますか？

`shared_preferences`を使って、ユーザー設定や環境設定などの少量のデータをキーバリューペアとしてローカルに保存します。ブラウザで直接実行するハンズオンコードでFlutter Mobile Developmentを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。

Flutter Mobile Developmentを始めるのに経験は必要ですか？

事前経験は必要ありません。CoddyKitのFlutter Mobile Developmentは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。これはレッスン1/4です。

「データのためのShared Preferences」レッスンにはどのくらい時間がかかりますか？

ほとんどのCoddyKitレッスンは約5～10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。

このFlutter Mobile Developmentレッスンでコードを書いて実行できますか？

はい。すべてのFlutter Mobile Developmentレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。

このコースのすべてのレッスン

← Flutter Mobile Developmentに戻る