Kotlin으로 안드로이드 앱 로그아웃 시 뒤로 가기 버튼 비활성화하는 방법

이 튜토리얼에서는 Kotlin을 사용하여 안드로이드 애플리케이션에서 로그아웃 처리 도중 뒤로 가기(Back) 버튼 동작을 비활성화하는 방법을 단계별로 살펴봅니다.

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"
    xmlns:tools="https://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:gravity="center"
    android:orientation="vertical"
    android:padding="16dp"
    tools:context=".MainActivity">

    <ImageView
        android:id="@+id/imageView"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:src="@drawable/image" />

</LinearLayout>

3단계 — MainActivity.kt 작성

src/MainActivity.kt에 다음 코드를 추가합니다. 핵심은 onBackPressed() 메서드를 오버라이드하면서 부모 메서드인 super.onBackPressed()를 호출하지 않는 것입니다. 이렇게 하면 기본 뒤로 가기 동작이 차단되고, 대신 토스트 메시지가 표시됩니다.

import android.os.Bundle
import android.widget.Toast
import androidx.appcompat.app.AppCompatActivity

class MainActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
    }

    override fun onBackPressed() {
        // super.onBackPressed()를 호출하지 않으면 뒤로 가기가 비활성화됩니다.
        Toast.makeText(applicationContext, "뒤로 가기가 비활성화되었습니다", Toast.LENGTH_SHORT).show()
    }
}

4단계 — AndroidManifest.xml 설정

androidManifest.xml 파일에 아래 코드를 추가합니다.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android" package="app.com.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 Studio에서 프로젝트의 액티비티 파일 중 하나를 연 뒤, 툴바의 Run 아이콘을 클릭하세요. 기기 목록에서 자신의 모바일 기기를 선택하면, 해당 기기에 앱의 기본 화면이 표시됩니다.

이제 뒤로 가기 버튼을 눌러 보세요. 화면이 종료되지 않고 “뒤로 가기가 비활성화되었습니다”라는 토스트 메시지만 나타나는 것을 확인할 수 있습니다. 로그아웃 화면이나 결제 진행 중과 같이 사용자가 임의로 이전 화면으로 돌아가는 것을 막아야 할 때 유용하게 활용할 수 있습니다.

참고: 최신 Android 버전에서의 권장 방식

onBackPressed()는 Android 13(API 33)부터 공식적으로 지원 중단(deprecated)되었습니다. 최신 프로젝트에서는 예측적 뒤로 가기(Predictive Back) 제스처와의 호환성을 위해 OnBackPressedDispatcher와 OnBackPressedCallback을 사용하는 것이 좋습니다.

import android.os.Bundle
import android.widget.Toast
import androidx.activity.OnBackPressedCallback
import androidx.appcompat.app.AppCompatActivity

class MainActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        onBackPressedDispatcher.addCallback(this, object : OnBackPressedCallback(true) {
            override fun handleOnBackPressed() {
                Toast.makeText(applicationContext,
                    "뒤로 가기가 비활성화되었습니다", Toast.LENGTH_SHORT).show()
            }
        })
    }
}

두 방식 모두 결과는 동일하지만, 신규 프로젝트라면 OnBackPressedDispatcher 기반 구현을 사용하는 것이 장기적인 유지보수 측면에서 더 안전합니다.