AndroidでstartActivityForResultを使いこなす！画面間のデータ受け渡しを実装する完全ガイド

AndroidでstartActivityForResultを管理する方法

本記事では、Androidアプリ開発においてstartActivityForResultを使用して、別のアクティビティから結果データを受け取る方法を解説します。この仕組みを使うと、ある画面（アクティビティ）から別の画面を起動し、その画面が終了したタイミングで元の画面に結果を返すことができます。例えば、設定画面での選択結果や、フォーム入力の内容を前の画面に反映させたい場合などに活用できます。

ここでは、実際に動作するサンプルプロジェクトを作成しながら、実装の手順をステップごとに見ていきましょう。

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

Android Studioを起動し、「File」→「New Project」を選択して新しいプロジェクトを作成します。必要な項目（プロジェクト名、パッケージ名、保存先など）を入力してプロジェクトを完成させましょう。

手順2：activity_main.xmlにレイアウトを記述する

まず、メイン画面のレイアウトファイル res/layout/activity_main.xml に以下のコードを追加します。

<?xml version = "1.0" encoding = "utf-8"?>
<LinearLayout 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:gravity = "center"
    android:layout_height = "match_parent"
    tools:context = ".MainActivity"
    android:orientation = "vertical">
    <TextView
        android:id = "@+id/actionEvent"
        android:textSize = "40sp"
        android:layout_marginTop = "30dp"
        android:layout_width = "wrap_content"
        android:layout_height = "match_parent" />
</LinearLayout>

上記のコードでは、結果データを表示するためのTextViewを1つ配置しています。後ほど、このTextViewにSecondActivityから返された文字列をセットします。

手順3：MainActivity.javaに処理を記述する

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

import android.content.Intent;
import android.os.Build;
import android.os.Bundle;
import android.support.annotation.RequiresApi;
import android.support.v7.app.AppCompatActivity;
import android.view.View;
import android.widget.TextView;

public class MainActivity extends AppCompatActivity {
    TextView actionEvent;
    @RequiresApi(api = Build.VERSION_CODES.LOLLIPOP)
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        actionEvent = findViewById(R.id.actionEvent);
        actionEvent.setText("Click");
        actionEvent.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                Intent i = new Intent(MainActivity.this, SecondActivity.class);
                startActivityForResult(i, 1);
            }
        });
    }
    @Override
    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
        super.onActivityResult(requestCode, resultCode, data);
        if (requestCode == 1) {
            if (resultCode == RESULT_OK) {
                String returnString = data.getStringExtra("result");
                actionEvent.setText(returnString);
            }
        }
    }
}

このコードのポイントは以下の通りです。

• TextViewがクリックされると、Intentを使ってSecondActivityを起動し、リクエストコード「1」を指定してstartActivityForResult()を呼び出します。
• SecondActivityが終了すると、onActivityResult()が呼ばれます。
• リクエストコードが「1」かつ結果コードがRESULT_OKの場合、Intentから「result」というキーで文字列を取り出し、TextViewに表示します。

手順4：SecondActivity.javaを作成する

続いて、結果を返す側のアクティビティである src/SecondActivity.java に以下のコードを追加します。

import android.app.Activity;
import android.content.Intent;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;

public class SecondActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_second);
        Intent returnIntent = new Intent();
        returnIntent.putExtra("result","data from seconActivity");
        setResult(Activity.RESULT_OK,returnIntent);
        finish();
    }
}

ここでは、起動と同時にIntentオブジェクトを作成し、putExtra()で「result」というキーに返したい文字列を格納しています。その後、setResult()で結果コードRESULT_OKと一緒にIntentをセットし、finish()でアクティビティを終了することで、呼び出し元に結果が返されます。

手順5：activity_second.xmlを記述する

SecondActivity用のレイアウトファイル activity_second.xml には、以下のように最小限のレイアウトを定義します。

<?xml version = "1.0" encoding = "utf-8"?>
<android.support.constraint.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 = ".SecondActivity">
</android.support.constraint.ConstraintLayout>

手順6：AndroidManifest.xmlにアクティビティを登録する

最後に、AndroidManifest.xml にSecondActivityを登録します。マニフェストに宣言されていないアクティビティは起動できないため、この作業は必須です。

<?xml version = "1.0" encoding = "utf-8"?>
<manifest xmlns:android = "https://schemas.android.com/apk/res/android"
    package = "com.example.myapplication">
    <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 = ".SecondActivity">
        </activity>
        <activity android:name = ".MainActivity" android:configChanges = "keyboardHidden|orientation|screenSize">
            <intent-filter>
                <action android:name = "android.intent.action.MAIN" />
                <action android:name = "android.net.conn.CONNECTIVITY_CHANGE" />
                <category android:name = "android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

アプリを実行して動作を確認する

それでは、アプリを実行してみましょう。実機のAndroidスマートフォンをPCに接続していることを確認してください。Android Studioのツールバーにある「Run」アイコンをクリックし、接続したデバイスを選択してアプリをインストール・起動します。

起動直後は、以下のように「Click」と表示された初期画面が表示されます。

次に、TextViewをタップしてください。SecondActivityが起動し、すぐに結果データを返して終了するため、TextViewの表示が「data from seconActivity」に切り替わります。これにより、画面間のデータ受け渡しが正しく機能していることが確認できます。

補足：最新のAndroid開発ではActivity Result APIが推奨される

なお、startActivityForResult()およびonActivityResult()はAPIレベル30（Android 11）以降で非推奨（Deprecated）となっています。現在の開発では、Jetpackが提供するActivity Result API（registerForActivityResult()）を使用することが推奨されています。こちらはコールバックベースの設計になっており、リクエストコードの管理が不要になるため、より安全で可読性の高いコードを書くことが可能です。新規プロジェクトでは、ぜひActivity Result APIの利用も検討してみてください。