【Android】内部ストレージにtxtファイルを作成・保存する方法を徹底解説

本記事では、Androidアプリの内部ストレージにtxtファイル（テキストファイル）を作成して保存する方法を、サンプルコードとともに段階的に解説します。テキスト入力欄に入力した内容を、アプリ専用の内部領域に「sample.txt」として書き込むシンプルなサンプルです。

ステップ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" />
</LinearLayout>

このレイアウトでは、テキストを入力するための EditText と、保存処理を実行する Button を縦方向に配置しています。ボタンがタップされると、EditTextに入力された文字列を取得し、内部ストレージの次のパスへファイルとして保存します。

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

ステップ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.Toast;
import java.io.File;
import java.io.FileWriter;
public class MainActivity extends AppCompatActivity {
    Button save;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        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();
                        Toast.makeText(MainActivity.this, "Saved your text", Toast.LENGTH_LONG).show();
                    } catch (Exception e) { }
                }
            }
        });
   }
}

処理の流れは以下の通りです。

• 入力内容が空でないかをチェックする
• getFilesDir() で取得できるアプリ専用ディレクトリ内に「text」フォルダを作成する（存在しない場合のみ）
• FileWriter を使ってテキストをファイルに書き込み、flush() と close() で確実に保存する
• 保存成功時にToastで「Saved your text」と通知する

ステップ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"/>
    <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>

なお、getFilesDir() が指すアプリ専用の内部ストレージへの読み書きは、特別な権限なしで可能です。WRITE_EXTERNAL_STORAGE 権限は、外部ストレージ（共有ストレージ）にもアクセスする場合に必要となるため、ここでは宣言しておくと安心です。

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

それでは、実際にアプリを実行してみましょう。実機のAndroidスマートフォンをPCにUSB接続し、Android Studioでプロジェクトのアクティビティファイルを開いた状態で、ツールバーの「Run」アイコンをクリックします。デバイスを選択して起動すると、端末に以下のような画面が表示されます。

表示された画面に任意のテキストを入力し、Saveボタンをタップします。

保存後、/data/data/<your.package.name>/files/text/sample.txt を確認してみてください。入力したテキストが正しくファイルに書き込まれていることが分かります。ファイルの中身を確認する際は、Android Studioの「Device File Explorer」を使うと簡単です。