【Android】アプリが初回起動かどうかをプログラムで判定する方法

Androidアプリの初回起動をプログラムで判定する方法

この記事では、SharedPreferencesを使って、Androidアプリが初めて起動されたのかどうかをプログラムで判定する方法を解説します。初回起動時にのみ表示したいチュートリアル画面やウェルカムメッセージなどを実装する際に役立つテクニックです。

実装手順

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

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

ステップ2：レイアウトファイルの編集

res/layout/activity_main.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 = ".MainActivity">
   <TextView
      android:id = "@+id/frstTime"
      android:layout_width = "match_parent"
      android:layout_height = "wrap_content"
      android:text = "Hello World!"
      android:textSize = "30sp"
      app:layout_constraintBottom_toBottomOf = "parent"
      app:layout_constraintLeft_toLeftOf = "parent"
      app:layout_constraintRight_toRightOf = "parent"
      app:layout_constraintTop_toTopOf = "parent" />
</android.support.constraint.ConstraintLayout>

上記のコードでは、画面中央にTextViewを1つ配置しています。ユーザーがアプリを開いたときに初回起動かどうかを判定し、その結果に応じてTextViewに表示するテキストを切り替える仕組みです。

ステップ3：MainActivity.java の編集

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

package com.example.andy.myapplication;
import android.content.Context;
import android.content.SharedPreferences;
import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.widget.TextView;
public class MainActivity extends AppCompatActivity {
    SharedPreferences sharedPreferences;
    SharedPreferences.Editor sharedEditor;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        sharedPreferences = getPreferences(Context.MODE_PRIVATE);
        sharedEditor = sharedPreferences.edit();
        TextView frstTime = findViewById(R.id.frstTime);
        if (isItFirestTime()) {
            frstTime.setText("First Time");
        } else {
            frstTime.setText("Not a First Time");
        }
    }
    public boolean isItFirestTime() {
        if (sharedPreferences.getBoolean("firstTime", true)) {
            sharedEditor.putBoolean("firstTime", false);
            sharedEditor.commit();
            return true;
        } else {
            return false;
        }
    }
}

コードの仕組み

この実装のポイントは、getPreferences(Context.MODE_PRIVATE)で取得したSharedPreferencesに「firstTime」というキーでboolean値を保存している点です。デフォルト値をtrueに設定しているため、初回起動時には必ずtrueが返されます。そのタイミングでfalseを書き込むことで、2回目以降の起動を正確に検出できます。

アプリの実行と動作確認

実際のAndroid端末をパソコンに接続し、Android Studioからアプリを実行してみましょう。プロジェクト内のアクティビティファイルを開き、ツールバーの「Run」アイコンをクリックして、接続した端末を選択します。

初回起動時には「First Time」というメッセージが表示され、2回目以降に起動した場合は「Not a First Time」と表示されます。これにより、アプリの初回起動判定が正しく機能していることを確認できます。