KotlinでAndroidアプリの内部・外部ストレージの空き容量を取得する方法

この記事では、Kotlinを使用してAndroidアプリ内で内部・外部ストレージの空き容量を取得する方法を、サンプルコードとともにステップごとに解説します。

空き容量の取得には、Android SDKが提供する StatFs クラスを利用します。StatFs はUnix系OSの statfs() システムコールをラップしたクラスで、指定したパスのファイルシステムに関する情報（ブロックサイズや利用可能なブロック数など）を取得できます。

ステップ1：新規プロジェクトの作成

Android Studioを起動し、「File」→「New Project」を選択して、必要な項目をすべて入力のうえ、新しいプロジェクトを作成してください。

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

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

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout 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">
    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_centerHorizontal="true"
        android:layout_marginTop="50dp"
        android:text="Tutorials Point"
        android:textAlignment="center"
        android:textColor="@android:color/holo_green_dark"
        android:textSize="32sp"
        android:textStyle="bold" />
    <TextView
        android:id="@+id/textView"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_centerInParent="true"
        android:textAlignment="center"
        android:textColor="@android:color/background_dark"
        android:textSize="24sp"
        android:textStyle="bold" />
</RelativeLayout>

このレイアウトでは、取得した空き容量の結果を表示するための TextView を画面中央に配置しています。

ステップ3：MainActivity.kt の実装

src/MainActivity.kt に以下のコードを追加します。

import android.os.Bundle
import android.os.Environment
import android.os.StatFs
import android.widget.TextView
import androidx.appcompat.app.AppCompatActivity
class MainActivity : AppCompatActivity() {
    lateinit var textView: TextView
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        title = "KotlinApp"
        textView = findViewById(R.id.textView)
        val stat = StatFs(Environment.getExternalStorageDirectory().getPath())
        val bytesAvailable: Long
        bytesAvailable = stat.blockSizeLong * stat.availableBlocksLong
        val megAvailable = bytesAvailable / (1024 * 1024)
        textView.text = "Available Internal/External free Space: " + megAvailable + "MB"
    }
}

コードのポイント

• StatFs：ストレージのパスを渡すことで、そのファイルシステムの状態を取得できるクラスです。
• blockSizeLong × availableBlocksLong：ブロックサイズと利用可能なブロック数を掛け合わせることで、空き容量をバイト単位で算出しています。
• バイト→MB変換：取得した値を 1024 × 1024 で割ることで、メガバイト（MB）単位に変換して表示しています。

ステップ4：AndroidManifest.xml の確認

androidManifest.xml は以下のようになります。このサンプルでは特別な権限は不要ですが、プロジェクトに合わせて適宜設定してください。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android" package="app.com.q1">
    <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からアプリを実行するには、プロジェクト内のいずれかのアクティビティファイルを開き、ツールバーにある実行アイコンをクリックします。表示された選択肢から接続中のモバイルデバイスを選択すると、端末上にアプリが起動し、ストレージの空き容量が画面に表示されます。