Androidアプリでテキストファイルを作成し、内部ストレージから読み込む方法を解説

この記事では、Androidアプリ内でテキスト（.txt）ファイルを作成し、内部ストレージに保存したファイルを読み込んで表示する方法を、実際のコード例とともにわかりやすく解説します。EditTextに入力した文字列をボタン操作でファイルに保存し、その内容を読み出してTextViewに表示するという、シンプルながら実用的なサンプルです。

ステップ1：Android Studioで新規プロジェクトを作成する

まずは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を縦方向（vertical）に配置しています。

画面の動作の仕組み

ユーザーが「Save」ボタンをタップすると、EditTextに入力された文字列が取得され、内部ストレージ上の次のパスにテキストファイルとして保存されます。

/data/data/<your.package.name>/files/text/sample.txt

保存後は、sample.txtの内容を読み込んでTextViewに表示します。

ステップ3：MainActivity.javaに処理を記述する

続いて、「src/MainActivity.java」に以下のコードを追加します。

package com.example.andy.myapplication;
import android.os.Bundle;
import android.os.Environment;
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.FileInputStream;
import java.io.FileReader;
import java.io.FileWriter;
import java.io.IOException;
import java.io.InputStreamReader;

public class MainActivity extends AppCompatActivity {
    Button save;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        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) {
                text.append(line);
                text.append('\n');
            }
            br.close();
        } catch (IOException e) { }
        String result = text.toString();
        return result;
    }
}

コードのポイント

• 保存処理： ボタンクリック時にgetFilesDir()で取得したアプリ専用ディレクトリ配下に「text」フォルダを作成し、そこへ「sample」という名前のファイルを出力します。FileWriterを使ってEditTextの内容を書き込み、flush()とclose()で確実にディスクへ反映させます。
• 読み込み処理： readFile()メソッドでは、保存したファイルをBufferedReader＋FileReaderで1行ずつ読み取り、StringBuilderに連結した文字列を返します。
• 空入力チェック： EditTextが空の場合は保存処理を行わないようにしており、意図しない動作を防いでいます。

ステップ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の2つの権限を宣言しています。

アプリの実行と動作確認

それでは、作成したアプリを実際に実行してみましょう。Android端末をPCに接続していることを前提に説明します。Android Studioでアクティビティファイルを開き、ツールバーの「Run」アイコンをクリックしてください。デバイス選択画面で接続中のスマートフォンを選択すると、端末にアプリの初期画面が表示されます。

上記の初期画面で任意のテキストを入力し、「Save」ボタンをタップすると、以下のように保存完了のトーストが表示されるとともに、読み込んだ内容がTextViewに出力されます。

ファイルの保存結果を確認する

保存が正しく行われたかどうかは、内部ストレージの以下のパスにあるファイルを確認することで検証できます。

/data/data/<your.package.name>/files/text/sample.txt

このように、Androidの内部ストレージを使えば、特別なライブラリを導入しなくてもJava標準のI/Oクラスだけでテキストファイルの保存と読み込みが簡単に実装できます。設定データやユーザーの入力履歴などをローカルに保持したい場合にぜひ活用してください。