Flutter Mobile Development · レッスン

ファイルシステム操作

デバイスのファイルシステムからデータを読み書きし、大きなファイルやカスタムデータ形式を保存できるようにします。

「ファイルシステム操作」はCoddyKit上の無料Flutter Mobile Developmentレッスンです。これはレッスン3/4です。下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。これはFlutter Mobile Development学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 Flutter Mobile Developmentコースには全4レッスンが含まれています。

このレッスンの一部はまだ翻訳されておらず、英語で表示されています。

Storing Data in Files

Sometimes, your app needs to store data directly on the device. This is where file system operations come in! Unlike shared_preferences (for small key-value data) or sqflite (for structured data), file system operations allow you to manage files directly.

You can store larger pieces of data, like images, audio, or custom formatted text files, that don't fit well into a database or simple key-value pairs.

Where to Store Files?

Before you can read or write files, your app needs to know where it can store them. Flutter provides the path_provider package to help you find common directory paths safely across different platforms (iOS, Android, web, desktop).

Application Documents Directory: This is where your app can store user-specific data that should persist.
Temporary Directory: For data that doesn't need to persist across app launches, like cached files.

Getting Application Path

Let's use path_provider to get the application documents directory. Remember to add path_provider to your pubspec.yaml first!

dependencies: flutter: sdk: flutter path_provider: ^2.0.11

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

void main() async {
  // Get the application documents directory
  Directory appDocDir = await getApplicationDocumentsDirectory();
  String appDocPath = appDocDir.path;

  print('App Documents Path: $appDocPath');
}

Creating a File Reference

Once you have a directory path, you can create a File object. This object represents the file at that specific path on the device's storage. It doesn't mean the file actually exists yet, it's just a reference.

You'll combine the directory path with your desired filename to construct the full file path.

Constructing a File Path

Here's how you can combine the application documents path with a filename to create a File object. We'll use a simple text file name for our example.

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

void main() async {
  Directory appDocDir = await getApplicationDocumentsDirectory();
  String appDocPath = appDocDir.path;

  // Define a filename
  String fileName = 'my_data.txt';

  // Create a File object
  File file = File('$appDocPath/$fileName');

  print('File path reference created: ${file.path}');
  // At this point, the file might not exist on disk yet.
}

Saving Content to Files

The File object provides methods to write data. The most common ones are writeAsString() for text and writeAsBytes() for binary data. These operations are asynchronous, so you'll use await.

writeAsString(String contents, {FileMode mode = FileMode.write}): Writes text. FileMode.write overwrites, FileMode.append adds to the end.
writeAsBytes(List<int> bytes, {FileMode mode = FileMode.write}): Writes raw bytes.

Writing a Simple Text File

Let's write some text content to our my_data.txt file. If the file doesn't exist, writeAsString will create it. If it does exist, it will overwrite its content by default.

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

void main() async {
  Directory appDocDir = await getApplicationDocumentsDirectory();
  String appDocPath = appDocDir.path;
  String fileName = 'my_data.txt';
  File file = File('$appDocPath/$fileName');

  String content = 'Hello, CoddyKit learners!\nThis is a test message.';

  try {
    await file.writeAsString(content);
    print('Content written to ${file.path}');
    print('File exists: ${await file.exists()}');
  } catch (e) {
    print('Error writing file: $e');
  }
}

Reading Content from Files

Just as you can write, you can also read content back from files. The readAsString() method is perfect for text files, while readAsBytes() is used for binary data.

It's good practice to check if a file exists() before trying to read from it to prevent errors.

Reading a File's Content

Now, let's read the content we just wrote back from my_data.txt. We'll first check if the file exists to be safe.

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

void main() async {
  Directory appDocDir = await getApplicationDocumentsDirectory();
  String appDocPath = appDocDir.path;
  String fileName = 'my_data.txt';
  File file = File('$appDocPath/$fileName');

  if (await file.exists()) {
    try {
      String content = await file.readAsString();
      print('Content read from ${file.path}:\n$content');
    } catch (e) {
      print('Error reading file: $e');
    }
  } else {
    print('File does not exist: ${file.path}');
  }
}

Removing Files

When data is no longer needed, you can delete files from the device's storage. The delete() method on a File object will remove it. This operation is also asynchronous.

Be careful when deleting files, as this action is usually irreversible!

Check Your Understanding

Which of the following statements about Flutter file system operations are TRUE?

Lesson Summary

Great job! In this lesson, you've learned how to interact with the device's file system in Flutter:

Used path_provider to find appropriate storage directories.
Created File objects to reference specific files.
Wrote content to files using writeAsString().
Read content from files using readAsString().
Understood how to delete files with delete().

File system operations are crucial for storing large, custom-formatted, or sensitive data directly on the device. Next, you can explore more advanced data handling or move on to other Flutter topics!

よくある質問

「ファイルシステム操作」レッスンは無料ですか？

はい。「ファイルシステム操作」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し（組み込みコードエディタと24時間対応のAIチューター）、Flutter Mobile Developmentコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 Flutter Mobile Developmentコースには全4レッスンが含まれています。

「ファイルシステム操作」で何を学びますか？

デバイスのファイルシステムからデータを読み書きし、大きなファイルやカスタムデータ形式を保存できるようにします。ブラウザで直接実行するハンズオンコードでFlutter Mobile Developmentを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。

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

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

「ファイルシステム操作」レッスンにはどのくらい時間がかかりますか？

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

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

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

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

← Flutter Mobile Developmentに戻る