Androidアプリでリストをtxtファイルに保存し、読み込む方法を徹底解説

この記事では、Androidアプリにおいてリスト（文字列データ）をtxtファイルとして内部ストレージに保存する方法と、保存したtxtファイルからリストを読み込んで表示する方法を、実際のコード例とともにわかりやすく解説します。

ステップ1：新しいプロジェクトを作成する

まず、Android Studioを開き、「File」→「New Project」を選択して、必要な項目をすべて入力し、新しいプロジェクトを作成します。

ステップ2：レイアウトファイル（activity_main.xml）を編集する

次に、res/layout/activity_main.xmlに以下のコードを追加します。

<?xml version = "1.0" encoding = "utf-8"?>
<LinearLayout xmlns:android = "https://schemas.android.com/apk/res/android"
   xmlns:tools = "https://schemas.android.com/tools"
   android:layout_width = "match_parent"
   android:layout_height = "match_parent"
   tools:context = ".MainActivity"
   android:orientation = "vertical">
   <EditText
      android:id = "@+id/enterText"
      android:hint = "Please enter text here"
      android:layout_width = "match_parent"
      android:layout_height = "wrap_content" />
   <Button
      android:id = "@+id/save"
      android:text = "Save"
      android:layout_width = "wrap_content"
      android:layout_height = "wrap_content" />
   <TextView
      android:id = "@+id/output"
      android:layout_width = "wrap_content"
      android:textSize = "25sp"
      android:layout_height = "wrap_content" />
</LinearLayout>

上記のコードでは、テキスト入力用のEditText、保存用のButton、そして結果を表示するTextViewを配置しています。ユーザーがボタンをクリックすると、EditTextに入力されたデータを取得し、内部ストレージの /data/data/<パッケージ名>/files/text/sample.txt に保存します。その後、sample.txtからリストデータを読み込み、TextViewに表示する仕組みです。

ステップ3：MainActivity.javaにコードを追加する

続いて、src/MainActivity.javaに以下のコードを記述します。

package com.example.andy.myapplication;
import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.view.View;
import android.widget.Button;
import android.widget.EditText;
import android.widget.TextView;
import android.widget.Toast;
import java.io.BufferedReader;
import java.io.File;
import java.io.FileReader;
import java.io.FileWriter;
import java.io.IOException;
import java.util.ArrayList;
import java.util.Arrays;
public class MainActivity extends AppCompatActivity {
    Button save;
    ArrayList<String> list;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        list = new ArrayList<>();
        final TextView output = findViewById(R.id.output);
        final EditText enterText = findViewById(R.id.enterText);
        save = findViewById(R.id.save);
        save.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                if (!enterText.getText().toString().isEmpty()) {
                    File file = new File(MainActivity.this.getFilesDir(), "text");
                    if (!file.exists()) {
                        file.mkdir();
                    }
                    try {
                        File gpxfile = new File(file, "sample");
                        FileWriter writer = new FileWriter(gpxfile);
                        writer.append(enterText.getText().toString());
                        writer.flush();
                        writer.close();
                        output.setText(readFile());
                        Toast.makeText(MainActivity.this, "Saved your text", Toast.LENGTH_LONG).show();
                    } catch (Exception e) { }
                }
            }
        });
    }
    private String readFile() {
        File fileEvents = new File(MainActivity.this.getFilesDir() + "/text/sample");
        StringBuilder text = new StringBuilder();
        try {
            BufferedReader br = new BufferedReader(new FileReader(fileEvents));
            String line;
            while ((line = br.readLine()) != null) {
                list.add(line);
                text.append(line);
                text.append('\n');
            }
            br.close();
        } catch (IOException e) { }
        String result = Arrays.toString(new ArrayList[]{list});
        return result;
    }
}

このコードのポイントは以下の通りです。

• 保存処理：ボタンがクリックされると、FileWriterを使ってEditTextの内容をsample.txtに書き込みます。
• 読み込み処理：readFile()メソッドでは、BufferedReaderを使ってファイルを1行ずつ読み込み、各行をArrayListに追加します。
• 表示処理：読み込んだリストの内容をTextViewに表示し、保存完了時にトーストで通知します。

ステップ4：AndroidManifest.xmlを編集する

最後に、manifest.xmlに以下のコードを追加します。

<?xml version = "1.0" encoding = "utf-8"?>
<manifest xmlns:android = "https://schemas.android.com/apk/res/android"
    package = "com.example.andy.myapplication">
    <uses-permission android:name = "android.permission.WRITE_EXTERNAL_STORAGE"/>
    <uses-permission android:name = "android.permission.READ_EXTERNAL_STORAGE"/>
    <application
        android:allowBackup = "true"
        android:icon = "@mipmap/ic_launcher"
        android:label = "@string/app_name"
        android:roundIcon = "@mipmap/ic_launcher_round"
        android:supportsRtl = "true"
        android:theme = "@style/AppTheme">
        <activity android:name = ".MainActivity">
            <intent-filter>
                <action android:name = "android.intent.action.MAIN" />
                <category android:name = "android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

ここでは、外部ストレージへの読み書きを行うためのパーミッション（WRITE_EXTERNAL_STORAGEとREAD_EXTERNAL_STORAGE）を宣言しています。なお、内部ストレージのみを扱う場合は、これらのパーミッションは必須ではありません。

アプリを実行して動作を確認する

それでは、実際にアプリケーションを実行してみましょう。Android端末をPCに接続していることを前提とします。Android Studioからアプリを実行するには、プロジェクトのアクティビティファイルのいずれかを開き、ツールバーの「実行（Run）」アイコンをクリックします。実行デバイスとして接続したモバイル端末を選択すると、端末にデフォルト画面が表示されます。

上記の画面でテキストを入力し、「Save」ボタンをクリックすると、以下のように保存されます。

保存結果を確認するには、デバイスエクスプローラーなどで /data/data/<パッケージ名>/files/text/sample.txt を開きます。以下のようにファイルが作成されていることがわかります。

まとめ

本記事では、AndroidアプリでEditTextに入力したテキストを内部ストレージのtxtファイルに保存し、そこからリストとして読み込んで表示する一連の流れを紹介しました。FileWriterによる書き込みとBufferedReaderによる読み込みを組み合わせることで、シンプルなデータの永続化が実現できます。設定データやメモ機能など、さまざまな場面で応用できるテクニックなので、ぜひ実際に試してみてください。