Android 앱의 백그라운드·포그라운드 전환 감지 방법 (단계별 코드 예제)

Android 앱 포그라운드/백그라운드 전환 감지하기

앱이 백그라운드로 이동했다가 다시 포그라운드로 돌아오는 시점을 감지하면, 푸시 알림 처리, 데이터 자동 동기화, 사용자 경험 최적화 등 다양한 기능을 구현하는 데 큰 도움이 됩니다. 이 글에서는 ActivityManager를 활용해 앱의 실행 상태를 확인하는 기본적인 방법을 단계별로 살펴봅니다.

1단계 — Android Studio에서 새 프로젝트 생성

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"
    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 하나로 구성된 간단한 세로(Vertical) LinearLayout입니다.

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

핵심 로직은 isApplicationBroughtToBackground() 메서드에 있습니다. ActivityManager를 통해 현재 실행 중인 태스크 목록을 가져온 뒤, 최상위(top) Activity의 패키지 이름과 현재 앱의 패키지 이름을 비교합니다. 두 값이 다르면 우리 앱이 백그라운드에 있다는 의미이며, 같다면 앱이 포그라운드에서 실행 중임을 알 수 있습니다.

4단계 — 앱 실행 및 결과 확인

실제 Android 기기를 컴퓨터에 연결한 상태라고 가정합니다. Android Studio에서 프로젝트의 액티비티 파일 중 하나를 연 뒤, 툴바의 Run 버튼을 클릭합니다. 옵션 목록에서 연결된 모바일 기기를 선택하면, 기기 화면에 앱의 기본 화면과 함께 현재 상태가 표시됩니다.

참고: 최신 Android에서의 대안

위 예제에서 사용한 getRunningTasks() API는 Android 5.0(API 21)부터 보안 정책 변경으로 인해 자기 앱 외의 정보는 제대로 반환하지 않으며, 공식적으로 deprecated 상태입니다. 따라서 실제 프로덕션 환경에서는 Android Jetpack의 ProcessLifecycleOwner(lifecycle-process 라이브러리)를 사용해 앱 전체의 포그라운드/백그라운드 전환을 감지하는 것이 권장됩니다. 또는 각 Activity의 onStart()/onStop() 콜백에서 참조 카운트를 관리하는 방식으로도 동일한 효과를 얻을 수 있습니다.