Androidアプリでギャラリーから画像を選択して表示する方法を解説

この記事では、Androidアプリで端末の画像ギャラリーから画像を選択し、画面に表示する方法を、実際のコード例とともに段階的に解説します。Intentを使ったギャラリー連携の基本を学びたい方に最適な内容です。

全体の流れ

実装は以下の4つのステップで行います。

1. Android Studioで新規プロジェクトを作成する
2. レイアウトファイル（activity_main.xml）を作成する
3. MainActivity.java にギャラリー選択の処理を実装する
4. AndroidManifest.xml に必要な権限を追加する

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

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

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

次に、res/layout/activity_main.xml に以下のコードを追加します。画面には選択した画像を表示するImageViewと、ギャラリーを開くためのButtonを配置しています。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
    xmlns:android="https://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent">
    <ImageView
        android:id="@+id/imageView"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:layout_weight="1"/>
    <Button
        android:id="@+id/buttonLoadPicture"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_weight="0"
        android:text="Load Picture"
        android:layout_gravity="center"/>
</LinearLayout>

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

src/MainActivity.java に以下のコードを追加します。ボタンがタップされると ACTION_PICK インテントでギャラリーが起動し、ユーザーが選択した画像のUriを受け取ってImageViewに表示する仕組みです。

import android.app.Activity;
import android.content.Intent;
import android.net.Uri;
import android.os.Bundle;
import android.provider.MediaStore;
import android.view.View;
import android.widget.Button;
import android.widget.ImageView;
public class MainActivity extends Activity {
    ImageView imageView;
    Button button;
    private static final int PICK_IMAGE = 100;
    Uri imageUri;
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        imageView = (ImageView)findViewById(R.id.imageView);
        button = (Button)findViewById(R.id.buttonLoadPicture);
        button.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                openGallery();
            }
        });
    }
    private void openGallery() {
        Intent gallery = new Intent(Intent.ACTION_PICK, MediaStore.Images.Media.INTERNAL_CONTENT_URI);
        startActivityForResult(gallery, PICK_IMAGE);
    }
    @Override
    protected void onActivityResult(int requestCode, int resultCode, Intent data){
        super.onActivityResult(requestCode, resultCode, data);
        if (resultCode == RESULT_OK && requestCode == PICK_IMAGE){
            imageUri = data.getData();
            imageView.setImageURI(imageUri);
        }
    }
}

コードのポイント：

• openGallery()：Intent.ACTION_PICK を使って内部ストレージの画像一覧（ギャラリー）を呼び出します。
• PICK_IMAGE：リクエストコードとして定数を用意し、結果の判別に使用します。
• onActivityResult()：ユーザーが画像を選択した結果を受け取り、data.getData() で画像のUriを取得して ImageView にセットします。

ステップ4：AndroidManifest.xml への権限追加

androidManifest.xml に以下のコードを記述します。外部ストレージ上の画像を読み取るため、READ_EXTERNAL_STORAGE 権限の宣言が必要です。

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

アプリの実行と動作確認

それでは、アプリを実行してみましょう。ここでは実機のAndroidスマートフォンがパソコンに接続されているものとします。

Android Studioからアプリを起動するには、プロジェクト内のアクティビティファイルを開き、ツールバーの「Run」アイコンをクリックします。表示された候補から接続中のモバイルデバイスを選択すると、実機の画面にアプリが起動します。

「Load Picture」ボタンをタップするとギャラリーが開き、好きな画像を選択することで、その画像がアプリの画面に表示されます。

まとめ

本記事では、ACTION_PICK インテントと startActivityForResult() を組み合わせることで、Androidの標準ギャラリーから画像を選択し、アプリ内に表示する基本的な実装方法を紹介しました。なお、近年のAndroidでは Activity Result API の利用が推奨されており、よりモダンな実装に置き換えることも可能です。まずは本記事の基本形を理解したうえで、応用していきましょう。