Androidでプログラムからディレクトリを作成する方法をステップ解説

このチュートリアルでは、Androidアプリでプログラム的にディレクトリ（フォルダ）を作成する方法を、実際のコード例とともにステップ形式で解説します。

手順1：新しいプロジェクトを作成する

Android Studioを起動し、メニューから「File」→「New Project」を選択します。必要な項目をすべて入力して、新しいプロジェクトを作成しましょう。

手順2：レイアウトファイル（activity_main.xml）を編集する

res/layout/activity_main.xml に以下のコードを記述します。

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout
    xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:app="https://schemas.android.com/apk/res-auto"
    xmlns:tools="https://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">
<TextView
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="Hello World!"
    app:layout_constraintBottom_toBottomOf="parent"
    app:layout_constraintLeft_toLeftOf="parent"
    app:layout_constraintRight_toRightOf="parent"
    app:layout_constraintTop_toTopOf="parent" />
</androidx.constraintlayout.widget.ConstraintLayout>

手順3：MainActivity.java を編集する

src/MainActivity.java に以下のコードを追加します。ここでは、外部ストレージ直下に「Sample Directory」という名前のディレクトリを作成しています。

package com.app.sample;

import androidx.appcompat.app.AppCompatActivity;
import android.os.Bundle;
import android.os.Environment;
import android.widget.Toast;
import java.io.File;

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // 外部ストレージ直下に作成するディレクトリを指定
        File file = new File(Environment.getExternalStorageDirectory(), "Sample Directory");
        boolean success;

        if (!file.exists()) {
            Toast.makeText(getApplicationContext(),
                    "ディレクトリが存在しないため、作成します",
                    Toast.LENGTH_LONG).show();
            // ディレクトリを作成
            success = file.mkdirs();
        } else {
            success = true;
        }

        if (success) {
            Toast.makeText(getApplication(),
                    "ディレクトリを作成しました",
                    Toast.LENGTH_LONG).show();
        } else {
            Toast.makeText(this,
                    "ディレクトリの作成に失敗しました",
                    Toast.LENGTH_LONG).show();
        }
    }
}

手順4：AndroidManifest.xml に権限を追加する

Manifests/AndroidManifest.xml に以下のコードを記述します。外部ストレージへ書き込むためには、WRITE_EXTERNAL_STORAGE 権限の宣言が必要です。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android"
    package="com.app.sample">
    <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>

アプリを実行してみよう

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

補足：ランタイムパーミッションとスコープストレージに注意

Android 6.0（API 23）以降では、WRITE_EXTERNAL_STORAGE 権限について、マニフェストへの宣言に加えて実行時にユーザーへ許可を求める必要があります。さらに、Android 10以降で導入されたスコープストレージにより、他アプリと共有されるストレージ領域への自由なアクセスは制限されています。アプリ専用の領域でよい場合は、getExternalFilesDir() を使えば権限なしでディレクトリを作成できるため、用途に応じて適切な方法を選択することをおすすめします。