KotlinでAndroidアプリがバックグラウンドで動作中かどうかを判定する方法

概要

この記事では、Kotlinを使用してAndroidアプリケーションがバックグラウンドで実行されているかどうかを判定する方法を解説します。ActivityManager.getMyMemoryState()メソッドとRunningAppProcessInfoクラスを組み合わせることで、アプリがフォアグラウンドで動作しているのか、それともバックグラウンドに回っているのかを簡単に取得できます。

実装手順

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

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

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

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

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="https://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:padding="4dp">
    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_centerHorizontal="true"
        android:layout_marginTop="70dp"
        android:background="#008080"
        android:padding="5dp"
        android:text="TutorialsPoint"
        android:textColor="#fff"
        android:textSize="24sp"
        android:textStyle="bold" />
    <TextView
        android:id="@+id/textView"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_centerInParent="true"
        android:text="Checking if Android Application is running in Background"
        android:textAlignment="center"
        android:textColor="@android:color/holo_red_light"
        android:textSize="24sp"
        android:textStyle="bold" />
</RelativeLayout>

ステップ3：MainActivity.ktの実装

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

import android.app.ActivityManager
import android.app.ActivityManager.RunningAppProcessInfo
import android.os.Bundle
import android.widget.Toast
import androidx.appcompat.app.AppCompatActivity
class MainActivity : AppCompatActivity() {
    var appRunningBackground: Boolean = false
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        title = "KotlinApp"
        val runningAppProcessInfo = RunningAppProcessInfo()
        ActivityManager.getMyMemoryState(runningAppProcessInfo)
        appRunningBackground = runningAppProcessInfo.importance != RunningAppProcessInfo.IMPORTANCE_FOREGROUND
        if (appRunningBackground) {
            Toast.makeText(applicationContext, "Your Android Application is Running in Background", Toast.LENGTH_SHORT).show()
        }
        else {
        Toast.makeText(applicationContext, "Your Android Application is not Running in Background", Toast.LENGTH_SHORT).show()
        }
    }
    override fun onPause() {
        super.onPause()
        Toast.makeText(applicationContext, "Your Android Application is Running in Background", Toast.LENGTH_SHORT).show()
    }
}

このコードでは、まずRunningAppProcessInfoのインスタンスを生成し、ActivityManager.getMyMemoryState()に渡すことで現在のプロセスの重要度（importance）を取得しています。取得した値がIMPORTANCE_FOREGROUNDと異なる場合、アプリはバックグラウンドで動作していると判断できます。また、onPause()をオーバーライドすることで、アプリが画面から離れたタイミング（バックグラウンドへ移行した瞬間）も検知できるようにしています。

ステップ4：AndroidManifest.xmlの設定

androidManifest.xmlに以下のコードを追加します。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android"
    package="com.example.q11">
    <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」アイコンをクリックします。表示された選択肢から接続済みのモバイルデバイスを選択すると、端末にデフォルト画面が表示され、アプリの状態に応じてToastメッセージでバックグラウンドでの動作状況を確認できます。