안드로이드 앱에서 '홈' 버튼 클릭 이벤트를 감지하는 방법

개요

안드로이드에서는 보안과 사용자 경험 보호를 위해 홈 버튼의 기본 동작을 직접 재정의(오버라이드)하는 것이 공식적으로 허용되지 않습니다. 하지만 onUserLeaveHint() 콜백 메서드를 활용하면 사용자가 홈 버튼을 눌러 앱을 떠나는 시점을 감지하고, 그에 맞는 동작(예: 토스트 메시지 표시, 상태 저장 등)을 수행할 수 있습니다.

이 글에서는 실제 예제를 통해 홈 버튼 클릭을 감지하는 방법을 단계별로 살펴보겠습니다.

1단계 — 새 프로젝트 생성

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

2단계 — 레이아웃 작성

res/layout/activity_main.xml 파일에 아래 코드를 추가합니다. 화면 중앙에 "Press Home Button"이라는 문구를 표시하는 간단한 TextView를 배치했습니다.

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout 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"
    tools:context=".MainActivity">
    <TextView
        android:text="Press Home Button"
        android:textSize="16sp"
        android:textStyle="bold"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_centerInParent="true"/>
</RelativeLayout>

3단계 — MainActivity 구현

src/MainActivity.java에 다음 코드를 추가합니다. 핵심은 onUserLeaveHint() 메서드입니다. 이 메서드는 사용자가 홈 버튼을 누르거나 다른 앱으로 전환하여 현재 액티비티를 벗어나는 순간 시스템에 의해 호출됩니다.

import androidx.appcompat.app.AppCompatActivity;
import android.os.Bundle;
import android.widget.Toast;
public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }
    @Override
    protected void onUserLeaveHint(){
        Toast.makeText(getApplicationContext(), "Home Button is Pressed", Toast.LENGTH_SHORT).show();
        super.onUserLeaveHint();
    }
}

4단계 — 매니페스트 설정

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 Studio에서 프로젝트의 액티비티 파일 중 하나를 연 뒤 툴바의 Run 아이콘을 클릭하세요. 실행 옵션에서 본인의 모바일 기기를 선택하면, 기기 화면에 아래와 같은 기본 화면이 표시됩니다.

앱이 실행된 상태에서 홈 버튼을 누르면 "Home Button is Pressed"라는 토스트 메시지가 잠시 표시되는 것을 확인할 수 있습니다. 이처럼 onUserLeaveHint()를 활용하면 홈 버튼뿐만 아니라 최근 앱 버튼을 통한 앱 전환 시점까지 감지할 수 있어, 백그라운드 전환 시 데이터 저장이나 알림 처리 등 다양한 용도로 활용할 수 있습니다.