【Android】画像のファイル名からリソースIDを取得する方法を解説

Androidアプリ開発では、画像のファイル名（リソース名）が文字列として分かっている場合に、その画像のリソースIDを動的に取得したいことがあります。本記事では、Resources#getIdentifier()メソッドを使って、画像名からリソースIDを取得する方法を、実際に動作するサンプルコードとともに詳しく解説します。

サンプルアプリの概要

今回は、画面にImageViewを配置し、画像名「ic_launcher_background」から取得したリソースIDをTextViewに表示するシンプルなアプリを作成します。実装手順は次の4ステップです。

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

Android Studioを起動し、メニューから「File」→「New Project」を選択します。必要な項目を入力して新しいプロジェクトを作成しましょう。テンプレートは「Empty Activity」を選択すれば十分です。

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

res/layout/activity_main.xml に以下のコードを追加します。ImageViewと、リソースIDを表示するためのTextViewを縦方向に並べたシンプルなレイアウトです。

<?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:id="@+id/linearLayout"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    tools:context=".MainActivity">

    <ImageView
        android:id="@+id/ivLauncer"
        android:layout_width="match_parent"
        android:layout_height="450dp"
        android:contentDescription="@string/app_name"
        android:src="@drawable/ic_launcher_background" />

    <TextView
        android:id="@+id/tvResourceId"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />
</LinearLayout>

ステップ3：MainActivity.java を編集する

src/MainActivity.java に以下のコードを記述します。ここが本記事の核心となる部分です。

package app.tutorialspoint.com.sample;

import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.widget.TextView;

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // 取得したい画像の名前（拡張子は不要）
        String mDrawableName = "ic_launcher_background";

        // 画像名からリソースIDを取得
        int resID = getResources().getIdentifier(mDrawableName, "drawable", getPackageName());

        TextView tvResourceId = findViewById(R.id.tvResourceId);
        tvResourceId.setText(String.valueOf(resID));
    }
}

getIdentifier()メソッドの解説

リソースIDを取得しているのは次の1行です。

int resID = getResources().getIdentifier(mDrawableName, "drawable", getPackageName());

各引数の意味は以下の通りです。

• 第1引数： リソース名（画像ファイル名から拡張子を除いたもの）
• 第2引数： リソースの種類（"drawable"、"string"、"mipmap" など）
• 第3引数： アプリのパッケージ名（getPackageName() で取得）

なお、指定した名前のリソースが存在しない場合は 0 が返されるため、実用時には戻り値が0でないかどうかをチェックしておくと安全です。

ステップ4：AndroidManifest.xml を確認する

androidManifest.xml は以下のようになります。

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

    <uses-permission android:name="android.permission.VIBRATE" />

    <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スマートフォンをPCに接続しておいてください。Android Studioでプロジェクト内のアクティビティファイルを開き、ツールバーにある「Run」アイコンをクリックします。接続したモバイルデバイスを選択して実行すると、アプリが起動し、画面にはデフォルトの画像が表示され、その下のTextViewに「ic_launcher_background」のリソースID（数値）が表示されます。

注意点：getIdentifier()を使う際の留意事項

getIdentifier()は内部的にリフレクションを利用するため、呼び出しコストが高く、R8（ProGuard）による難読化やリソース圧縮を有効にしている環境では、リソース名が保持されず正しく取得できない場合があります。そのため、リソース名がビルド時に確定しているのであれば、R.drawable.ic_launcher_background のように直接参照する方法が公式にも推奨されています。getIdentifier()は、サーバーから受け取った文字列など、どうしても実行時にリソースを動的に解決する必要があるケースに限定して使うのが良いでしょう。

また、本サンプルは古いSupport Library（android.support.v7.app.AppCompatActivity）を使用しています。最新のAndroid Studioでプロジェクトを作成した場合は、androidx.appcompat.app.AppCompatActivity に読み替えてください。