Androidでグローバル変数を宣言する方法！シングルトンクラスを使った実装手順を徹底解説

このチュートリアルでは、Androidアプリでグローバル変数のように使えるデータを宣言し、アプリ全体で共有する方法を解説します。具体的にはシングルトンクラスを作成し、どの画面からでも同じデータを保存・取得できるようにしていきます。

Androidでグローバル変数が必要になるケース

Androidでは各Activityが独立したライフサイクルを持つため、通常のプログラミング言語のように単純にグローバル変数を宣言することは推奨されません。そこで定番となるのが、インスタンスがアプリ内に1つだけしか存在しないことを保証する「シングルトンパターン」です。これにより、画面をまたいで安全にデータを共有できます。

ステップ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:layout_height="match_parent"
    tools:context=".MainActivity"
    android:gravity="center"
    android:orientation="vertical">

    <TextView
        android:id="@+id/tvEvent"
        android:textSize="40sp"
        android:layout_marginTop="30dp"
        android:layout_width="wrap_content"
        android:layout_height="match_parent" />

</LinearLayout>

ステップ3：MainActivity.javaにコードを追加する

src/MainActivity.java に以下のコードを記述します。TextViewをタップすると、シングルトンクラスへデータを保存し、その値を取得して画面に表示する仕組みです。

package com.example.sample;

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 tvEvent;

    @RequiresApi(api = Build.VERSION_CODES.LOLLIPOP)
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        tvEvent = findViewById(R.id.tvEvent);
        tvEvent.setText("Click");

        tvEvent.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                singleToneClass singleToneClass = com.example.sample.singleToneClass.getInstance();
                singleToneClass.setData("this is sample");
                tvEvent.setText(singleToneClass.getData());
            }
        });
    }
}

ステップ4：シングルトンクラスを作成する

続いて、src/SingleToneClass.java という名前で新しいクラスを作成し、以下のコードを記述します。コンストラクタをprivateにし、staticなgetInstance()メソッド経由でのみインスタンスを取得できるようにすることで、アプリ全体で唯一のインスタンスであることが保証されます。

package com.example.sample;

public class singleToneClass {

    String s;

    private static final singleToneClass ourInstance = new singleToneClass();

    public static singleToneClass getInstance() {
        return ourInstance;
    }

    private singleToneClass() {
    }

    public void setData(String s) {
        this.s = s;
    }

    public String getData() {
        return s;
    }
}

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

app/manifests/AndroidManifest.xml に以下のコードを記述します。

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

    <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でプロジェクト内のいずれかのActivityファイルを開き、ツールバーの「Run」アイコンをクリックしてください。デバイス選択画面で自分のスマートフォンを選ぶと、実機上でアプリが起動します。

初期状態では「Click」と表示されています。TextViewをタップすると、シングルトンクラスに保存した「this is sample」という文字列に切り替われば成功です。

まとめ

Androidでグローバル変数のような振る舞いを実現したい場合は、シングルトンクラスを活用するのが効果的です。どのActivityからでも同じインスタンスにアクセスできるため、アプリ全体で共有したい設定値や状態の管理に便利です。ただし、シングルトンはメモリ上に常駐するため、大量のデータやActivityのContext参照を保持するとメモリリークの原因になる点には注意しましょう。用途によってはViewModelやSharedPreferencesなども併せて検討すると、より堅牢な設計になります。