【Android開発】SharedPreferencesを使ってアクティビティ間でデータを受け渡す方法を解説

Androidアプリ開発では、ある画面（アクティビティ）から別の画面へデータを受け渡したい場面が多くあります。一般的には Intent のエクストラを使う方法が定番ですが、本記事では SharedPreferences（共有プリファレンス） を利用してデータを渡す方法を、ステップごとのサンプルコード付きでわかりやすく解説します。

SharedPreferencesとは？

SharedPreferencesは、キーと値のペア形式で少量のデータを永続的に保存できる仕組みです。通常は設定情報の保存に使われますが、この仕組みを応用すると、異なるアクティビティ間で同じストレージを読み書きすることで、データの受け渡しを実現できます。

実装手順

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

Android Studioを開き、「File」→「New Project」を選択して、必要な項目を入力し、新しいプロジェクトを作成します。

ステップ2：メイン画面のレイアウトを作成する

res/layout/activity_main.xml に以下のコードを追加します。テキスト入力用のEditTextと、次の画面へ遷移するButtonを配置しています。

<?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:layout_width = "match_parent"
   android:layout_height = "match_parent"
   android:layout_margin = "16dp"
   android:orientation = "vertical"
   tools:context = ".MainActivity">
   <EditText
      android:id = "@+id/edit_text"
      android:layout_width = "match_parent"
      android:layout_height = "wrap_content"
      android:layout_gravity = "center"
      android:hint = "Enter something to pass"
      android:inputType = "text" />
   <Button
      android:id = "@+id/button"
      android:layout_width = "wrap_content"
      android:layout_height = "wrap_content"
      android:layout_gravity = "center"
      android:layout_marginTop = "16dp"
      android:text = "Next" />
</LinearLayout>

ステップ3：MainActivityに入力値を保存する処理を書く

src/MainActivity.java に以下のコードを追加します。ボタンがタップされると、EditTextに入力された文字列を取得し、SharedPreferencesに「value」というキーで保存した後、SecondActivityへ遷移します。

package com.example.myapplication;
import android.content.Intent;
import android.content.SharedPreferences;
import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.view.View;
import android.widget.Button;
import android.widget.EditText;

public class MainActivity extends AppCompatActivity {
   @Override
   protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.activity_main);
      final EditText editText = findViewById(R.id.edit_text);
      Button button = findViewById(R.id.button);
      button.setOnClickListener(new View.OnClickListener() {
         @Override
         public void onClick(View v) {
            String value = editText.getText().toString().trim();
            SharedPreferences sharedPref = getSharedPreferences("myKey", MODE_PRIVATE);
            SharedPreferences.Editor editor = sharedPref.edit();
            editor.putString("value", value);
            editor.apply();
            Intent intent = new Intent(MainActivity.this, SecondActivity.class);
            startActivity(intent);
         }
      });
   }
}

ステップ4：2つ目の画面のレイアウトを作成する

res/layout/activity_second.xml に以下のコードを追加します。受け取ったデータを表示するための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:layout_width = "match_parent"
   android:layout_height = "match_parent"
   android:layout_margin = "16dp"
   android:orientation = "vertical"
   tools:context = ".SecondActivity">
   <TextView
      android:id = "@+id/text_view"
      android:layout_width = "match_parent"
      android:layout_height = "wrap_content"
      android:layout_gravity = "center" />
</LinearLayout>

ステップ5：SecondActivityでデータを読み出す

src/SecondActivity.java に以下のコードを追加します。同じ「myKey」という名前でSharedPreferencesを取得し、保存された文字列を読み込んでTextViewに表示します。

package com.example.myapplication;
import android.content.SharedPreferences;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.widget.TextView;

public class SecondActivity extends AppCompatActivity {
   @Override
   protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.activity_second);
      TextView textView = findViewById(R.id.text_view);
      SharedPreferences sharedPreferences = getSharedPreferences("myKey", MODE_PRIVATE);
      String value = sharedPreferences.getString("value","");
      textView.setText(value);
   }
}

ステップ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 = ".MainActivity">
         <intent-filter>
            <action android:name = "android.intent.action.MAIN" />
            <category android:name = "android.intent.category.LAUNCHER" />
         </intent-filter>
      </activity>
      <activity android:name = ".SecondActivity"></activity>
   </application>
</manifest>

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

それでは、実際にアプリを起動してみましょう。Android端末をパソコンに接続していることを前提に説明します。Android Studioから任意のアクティビティファイルを開き、ツールバーの実行アイコンをクリックしてください。接続中の端末を選択すると、スマートフォンにアプリが起動します。

最初の画面で適当な文字列を入力して「Next」ボタンをタップすると、その文字列がSharedPreferences経由で次の画面に引き継がれ、TextViewに表示されるはずです。

まとめ

このように、SharedPreferencesを使えばシンプルなコードでアクティビティ間のデータ受け渡しが可能です。ただし、SharedPreferencesは本来、設定値などの永続的な保存を目的とした仕組みのため、一時的なデータ受け渡しにはIntentのエクストラを使用するのがベストプラクティスとされています。用途に応じて使い分けることで、より堅牢なアプリ設計につながります。