Androidアプリがバックグラウンド・フォアグラウンドに切り替わるタイミングを検出する方法

はじめに

本記事では、Androidアプリがバックグラウンドに移動したとき、あるいはフォアグラウンドに復帰したときのタイミングを検出する方法を解説します。アプリの状態監視は、通知制御やデータ同期、ユーザー体験の最適化など、多くの場面で役立つ実装テクニックです。

手順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"
    android:orientation="vertical"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <TextView
        android:id="@+id/text"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:textSize="30sp" />

</LinearLayout>

このコードでは、アプリの状態を表示するためのTextViewを配置しています。

手順3：MainActivity.javaへの実装

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

package com.example.myapplication;

import android.app.ActivityManager;
import android.content.ComponentName;
import android.content.Context;
import android.os.Bundle;
import android.support.v4.app.FragmentActivity;
import android.widget.TextView;
import java.util.List;

public class MainActivity extends FragmentActivity {

    TextView textView;

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        textView = findViewById(R.id.text);

        if (!isApplicationBroughtToBackground()) {
            textView.setText("Application is foreground");
        }
    }

    private boolean isApplicationBroughtToBackground() {
        ActivityManager am = (ActivityManager)
                this.getSystemService(Context.ACTIVITY_SERVICE);
        List<ActivityManager.RunningTaskInfo> tasks = am.getRunningTasks(1);
        if (!tasks.isEmpty()) {
            ComponentName topActivity = tasks.get(0).topActivity;
            if (!topActivity.getPackageName().equals(this.getPackageName())) {
                return true;
            }
        }
        return false;
    }
}

上記のコードでは、ActivityManager の getRunningTasks() メソッドを使って、現在画面の最前面に表示されているタスク（アクティビティ）のパッケージ名を取得し、自アプリのパッケージ名と一致するかどうかを判定しています。一致しない場合は、アプリがバックグラウンドに移動したと判断できます。

アプリの実行と確認

それではアプリを実行してみましょう。Android端末をパソコンに接続し、Android Studioからプロジェクト内の任意のアクティビティファイルを開いて、ツールバーの「Run」アイコンをクリックします。実行デバイスとして接続したモバイル端末を選択すると、端末にデフォルト画面が表示されます。

補足：より現代的な検出方法

なお、getRunningTasks() はAPIレベル21（Android 5.0）以降で非推奨となっており、他アプリの情報は取得できなくなっています。近年の開発では、Jetpackが提供する ProcessLifecycleOwner を利用する方法が推奨されています。以下のように実装することで、アプリ全体のフォアグラウンド／バックグラウンド遷移を簡単かつ確実に検出できます。

ProcessLifecycleOwner.get().getLifecycle()
    .addObserver(new DefaultLifecycleObserver() {
        @Override
        public void onStart(@NonNull LifecycleOwner owner) {
            // アプリがフォアグラウンドに復帰したときの処理
        }

        @Override
        public void onStop(@NonNull LifecycleOwner owner) {
            // アプリがバックグラウンドに移動したときの処理
        }
    });

プロジェクトの状況やサポート対象のOSバージョンに応じて、適切な手法を選択してください。