【Android】アプリの初回起動時にだけアクティビティを表示する方法

はじめに

この記事では、Androidアプリが初めて起動されたときにだけアクティビティを表示する方法を解説します。ウェルカム画面やオンボーディング画面など、「最初の一回だけ見せたい画面」を実装したい場合に役立つテクニックです。

仕組みはシンプルで、SharedPreferencesに「以前に起動したことがあるか」を示すフラグを保存し、その値によってアクティビティを表示するか終了するかを判定します。

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

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

手順2：レイアウトファイルを作成する

res/layout/activity_main.xml に以下のコードを記述します。

<?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:orientation="vertical"
    tools:context=".MainActivity">
    <TextView
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:gravity="center"
        android:text="I will be launched once only" />
</LinearLayout>

画面中央に「I will be launched once only」というテキストを表示するだけのシンプルなレイアウトです。

手順3：MainActivity.java を実装する

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

package app.com.sample;
import androidx.appcompat.app.AppCompatActivity;
import android.content.Context;
import android.content.SharedPreferences;
import android.os.Bundle;
public class MainActivity extends AppCompatActivity {
    String prevStarted = "prevStarted";
    @Override
    protected void onResume() {
        super.onResume();
        SharedPreferences sharedpreferences = getSharedPreferences(getString(R.string.app_name), Context.MODE_PRIVATE);
        if (!sharedpreferences.getBoolean(prevStarted, false)) {
            SharedPreferences.Editor editor = sharedpreferences.edit();
            editor.putBoolean(prevStarted, Boolean.TRUE);
            editor.apply();
        } else {
            finish();
        }
    }
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }
}

コードのポイント

• onResume() 内で、SharedPreferencesから prevStarted フラグを読み込みます。
• フラグが false（＝初回起動）の場合は、フラグを true に書き込み、アクティビティを通常どおり表示します。
• フラグがすでに true の場合は finish() を呼び出して、アクティビティを即座に終了させます。

これにより、アプリの初回起動時にだけこのアクティビティが表示され、2回目以降の起動では自動的に閉じられるようになります。

手順4：AndroidManifest.xml を確認する

androidManifest.xml に以下のコードを記述します。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android" package="app.com.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でプロジェクト内のアクティビティファイルを開き、ツールバーの「Run」アイコンをクリックしてください。デバイスを選択して実行すると、モバイル端末に以下のような初期画面が表示されます。

まとめ

SharedPreferencesに起動済みフラグを保存しておくだけで、初回起動時に限りアクティビティを表示する処理を簡単に実装できます。数行のコードで実現できるため、初回限定の案内画面やチュートリアル表示などへの応用も容易です。ぜひ自分のプロジェクトでも試してみてください。