【Android】ランタイム権限で外部ストレージのtxtファイルを読み込む方法

この記事では、Androidアプリにおいてランタイム権限（パーミッション）を使用して、外部ストレージ上のテキストファイルを読み込む方法を解説します。なお、本記事では外部ストレージにあらかじめ「text」フォルダとサンプルファイル（sample.txt）が作成されているものとして進めます。

手順1：新規プロジェクトの作成

Android Studioで新しいプロジェクトを作成します。メニューから「File」⇒「New Project」を選択し、必要な項目を入力してプロジェクトを作成してください。

手順2：レイアウトファイルの編集

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">
    <Button
        android:id="@+id/read"
        android:text="read"
        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>

上記のレイアウトでは、ボタンとTextViewを配置しています。ユーザーがボタンをタップすると、外部ストレージからファイルの内容を読み取り、その結果をTextViewに表示する仕組みです。

手順3：MainActivity.java の実装

src/MainActivity.java に以下のコードを追加します。元のコードでは読み込み処理が重複していたため、共通処理は readFile() メソッドとして整理しています。

package com.example.andy.myapplication;

import android.content.pm.PackageManager;
import android.os.Build;
import android.os.Bundle;
import android.os.Environment;
import android.support.v4.app.ActivityCompat;
import android.support.v4.content.ContextCompat;
import android.support.v7.app.AppCompatActivity;
import android.util.Log;
import android.view.View;
import android.widget.Button;
import android.widget.TextView;
import android.widget.Toast;

import java.io.BufferedReader;
import java.io.File;
import java.io.FileReader;
import java.io.IOException;

public class MainActivity extends AppCompatActivity {
    private static final int PERMISSION_REQUEST_CODE = 100;
    Button read;
    TextView output;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        output = findViewById(R.id.output);
        read = findViewById(R.id.read);
        read.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                String state = Environment.getExternalStorageState();
                if (Environment.MEDIA_MOUNTED.equals(state)) {
                    if (Build.VERSION.SDK_INT >= 23) {
                        if (checkPermission()) {
                            readFile();
                        } else {
                            requestPermission(); // 権限をリクエスト
                        }
                    } else {
                        readFile();
                    }
                }
            }
        });
    }

    // 外部ストレージから sample.txt を読み込む共通処理
    private void readFile() {
        File sdcard = Environment.getExternalStorageDirectory();
        File dir = new File(sdcard.getAbsolutePath() + "/text/");
        if (dir.exists()) {
            File file = new File(dir, "sample.txt");
            StringBuilder text = new StringBuilder();
            try {
                BufferedReader br = new BufferedReader(new FileReader(file));
                String line;
                while ((line = br.readLine()) != null) {
                    text.append(line);
                    text.append('\n');
                }
                br.close();
            } catch (IOException e) {
                // 適切なエラー処理をここに追加してください
            }
            output.setText(text);
        }
    }

    private boolean checkPermission() {
        int result = ContextCompat.checkSelfPermission(MainActivity.this,
                android.Manifest.permission.READ_EXTERNAL_STORAGE);
        return result == PackageManager.PERMISSION_GRANTED;
    }

    private void requestPermission() {
        if (ActivityCompat.shouldShowRequestPermissionRationale(MainActivity.this,
                android.Manifest.permission.READ_EXTERNAL_STORAGE)) {
            Toast.makeText(MainActivity.this,
                    "ファイルを読み込むにはストレージ権限が必要です。アプリ設定から許可してください。",
                    Toast.LENGTH_LONG).show();
        } else {
            ActivityCompat.requestPermissions(MainActivity.this,
                    new String[]{android.Manifest.permission.READ_EXTERNAL_STORAGE},
                    PERMISSION_REQUEST_CODE);
        }
    }

    @Override
    public void onRequestPermissionsResult(int requestCode, String permissions[], int[] grantResults) {
        switch (requestCode) {
            case PERMISSION_REQUEST_CODE:
                if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                    Log.e("value", "Permission Granted, Now you can use local drive.");
                } else {
                    Log.e("value", "Permission Denied, You cannot use local drive.");
                }
                break;
        }
    }
}

このコードでは、まず外部ストレージがマウントされているかを確認し、Android 6.0（API 23）以降であれば READ_EXTERNAL_STORAGE 権限の有無を実行時にチェックします。未許可の場合は権限をリクエストし、許可済みの場合は「/text/sample.txt」を読み込んで内容を行単位でStringBuilderに連結し、TextViewに表示します。

補足： 本記事のコードは旧サポートライブラリ（android.support）を使用しています。最新のAndroid StudioではAndroidXへの移行が必要なため、適宜インポート文を読み替えてください。また、Android 10以降ではスコープストレージの導入により、外部ストレージへのアクセス方法が制限される点にも注意しましょう。

手順4：マニフェストへの権限宣言

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>

ここでは、READ_EXTERNAL_STORAGE と WRITE_EXTERNAL_STORAGE の2つの権限を宣言しています。これにより、アプリが外部ストレージにアクセスできるようになります。

アプリの実行と動作確認

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

上記の画面で「read」ボタンをタップすると、sample.txt の内容が以下のようにTextViewに表示されます。