안드로이드에서 현재 포그라운드 액티비티 컨텍스트 가져오는 방법

이 튜토리얼에서는 안드로이드 앱에서 현재 화면에 표시되고 있는(포그라운드) 액티비티의 컨텍스트를 가져오는 방법을 단계별로 살펴봅니다.

핵심 아이디어는 간단합니다. Application 클래스에 현재 액티비티의 참조를 저장해 두고, 액티비티의 생명주기 콜백(onResume, onPause, onDestroy)을 통해 이 참조를 갱신하거나 해제하는 방식입니다.

구현 순서

1단계 — 새 프로젝트 생성

Android Studio에서 File → New Project를 선택한 후, 프로젝트 생성에 필요한 모든 세부 정보를 입력하여 새 프로젝트를 만듭니다.

2단계 — MyApp.java 작성

현재 액티비티 참조를 보관할 애플리케이션 클래스입니다. src/MyApp.java 파일에 다음 코드를 추가합니다.

package app.tutorialspoint.com.sample;
import android.app.Activity;
import android.app.Application;

public class MyApp extends Application {
    private Activity mCurrentActivity = null;

    @Override
    public void onCreate() {
        super.onCreate();
    }

    public Activity getCurrentActivity() {
        return mCurrentActivity;
    }

    public void setCurrentActivity(Activity mCurrentActivity) {
        this.mCurrentActivity = mCurrentActivity;
    }
}

MyApp 클래스는 Application을 상속하며, 앱 전체에서 공유되는 단일 인스턴스 안에 mCurrentActivity 필드를 통해 현재 활성화된 액티비티를 저장합니다.

3단계 — MyBaseActivity.java 작성

모든 액티비티가 공통으로 상속받을 기본 액티비티 클래스입니다. 생명주기 콜백에서 자동으로 참조를 관리하도록 구현합니다.

package app.tutorialspoint.com.sample;
import android.app.Activity;
import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;

public class MyBaseActivity extends AppCompatActivity {
    protected MyApp mMyApp;

    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        mMyApp = (MyApp) this.getApplicationContext();
    }

    protected void onResume() {
        super.onResume();
        mMyApp.setCurrentActivity(this);
    }

    protected void onPause() {
        clearReferences();
        super.onPause();
    }

    protected void onDestroy() {
        clearReferences();
        super.onDestroy();
    }

    private void clearReferences() {
        Activity currActivity = mMyApp.getCurrentActivity();
        if (this.equals(currActivity)) {
            mMyApp.setCurrentActivity(null);
        }
    }
}

액티비티가 화면에 나타날 때(onResume) 자기 자신을 현재 액티비티로 등록하고, 화면에서 사라지거나 종료될 때(onPause, onDestroy) 자신이 저장된 참조와 일치하는 경우에만 참조를 해제합니다. 이렇게 하면 다른 액티비티의 참조를 실수로 지우는 일을 방지할 수 있습니다.

4단계 — MainActivity.java 작성

실제로 현재 액티비티 컨텍스트를 가져오는 사용 예시입니다. src/MainActivity.java 파일에 다음 코드를 추가합니다.

package app.tutorialspoint.com.sample;
import android.app.Activity;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        Activity currentActivity =
                ((MyApp) getApplicationContext()).getCurrentActivity();
    }
}

애플리케이션 컨텍스트를 MyApp으로 캐스팅한 뒤 getCurrentActivity()를 호출하면, 현재 포그라운드에 있는 액티비티의 참조를 손쉽게 얻을 수 있습니다.

5단계 — AndroidManifest.xml 설정

마지막으로 androidManifest.xml에서 애플리케이션의 android:name 속성에 .MyApp을 지정하여 커스텀 Application 클래스가 사용되도록 설정합니다.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android"
    package="app.tutorialspoint.com.sample">

    <uses-permission android:name="android.permission.CALL_PHONE" />

    <application
        android:name=".MyApp"
        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>

        <activity android:name=".MyBaseActivity" />
    </application>
</manifest>

정리

이 방식의 장점은 별도의 외부 라이브러리 없이 순수 자바 코드만으로 현재 포그라운드 액티비티를 추적할 수 있다는 점입니다. 다만 액티비티 참조를 오래 들고 있으면 메모리 누수가 발생할 수 있으므로, 반드시 생명주기 콜백에서 참조를 적절히 해제하는 것이 중요합니다. 또한 최신 안드로이드 개발 환경에서는 androidx.appcompat.app.AppCompatActivity를 사용하는 것이 권장됩니다.