Computer >> 컴퓨터 >  >> 프로그래밍 >> Android

안드로이드 액티비티에서 내비게이션 바를 영구적으로 숨기는 방법

개요

이 튜토리얼에서는 안드로이드 액티비티에서 하단 시스템 내비게이션 바를 영구적으로 숨겨, 마치 게임이나 동영상 플레어처럼 화면 전체를 활용하는 몰입형(Immersive) 전체 화면 모드를 구현하는 방법을 단계별로 살펴봅니다.

1단계: 새 프로젝트 생성

Android Studio를 실행하고 File ⇒ New Project 메뉴로 이동한 후, 필요한 모든 세부 정보를 입력하여 새 프로젝트를 생성합니다.

2단계: 레이아웃 파일 작성

res/layout/activity_main.xml 파일에 아래 코드를 추가합니다.

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout
    xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:app="https://schemas.android.com/apk/res-auto"
    xmlns:tools="https://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">
    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Hello World!"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintTop_toTopOf="parent" />
</androidx.constraintlayout.widget.ConstraintLayout>

3단계: MainActivity 코드 작성

src/MainActivity.java 파일에 다음 코드를 추가합니다. 핵심은 여러 시스템 UI 플래그를 조합하여 사용하는 것입니다.

  • SYSTEM_UI_FLAG_HIDE_NAVIGATION / FULLSCREEN: 내비게이션 바와 상태 표시줄을 숨깁니다.
  • SYSTEM_UI_FLAG_IMMERSIVE_STICKY: 화면을 스와이프하면 일시적으로 UI가 나타나고, 곧 자동으로 다시 숨겨지는 '스티키 몰입 모드'를 활성화합니다.
  • onSystemUiVisibilityChangeListener: 시스템 UI 가시성이 변경될 때마다 플래그를 다시 적용해 내비게이션 바가 계속 숨겨진 상태를 유지하도록 합니다.
  • onWindowFocusChanged: 액티비티가 포커스를 다시 얻을 때도 플래그를 재적용합니다.
import androidx.appcompat.app.AppCompatActivity;
import android.annotation.SuppressLint;
import android.os.Build;
import android.os.Bundle;
import android.view.View;
public class MainActivity extends AppCompatActivity {
    private int currentApiVersion;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        currentApiVersion = android.os.Build.VERSION.SDK_INT;
        final int flags = View.SYSTEM_UI_FLAG_LAYOUT_STABLE |
            View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION |
            View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN | View.SYSTEM_UI_FLAG_HIDE_NAVIGATION |
            View.SYSTEM_UI_FLAG_FULLSCREEN | View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY;
        if (currentApiVersion >= Build.VERSION_CODES.KITKAT) {
            getWindow().getDecorView().setSystemUiVisibility(flags);
            final View decorView = getWindow().getDecorView();
            decorView.setOnSystemUiVisibilityChangeListener(new View.OnSystemUiVisibilityChangeListener() {
                @Override
                public void onSystemUiVisibilityChange(int visibility) {
                    if ((visibility & View.SYSTEM_UI_FLAG_FULLSCREEN) == 0) {
                        decorView.setSystemUiVisibility(flags);
                    }
                }
            });
        }
    }
    @SuppressLint("NewApi")
    @Override
    public void onWindowFocusChanged(boolean hasFocus) {
        super.onWindowFocusChanged(hasFocus);
        if (currentApiVersion >= Build.VERSION_CODES.KITKAT && hasFocus) {
            getWindow().getDecorView().setSystemUiVisibility(View.SYSTEM_UI_FLAG_LAYOUT_STABLE |
                View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION |
                View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN | View.SYSTEM_UI_FLAG_HIDE_NAVIGATION |
                View.SYSTEM_UI_FLAG_FULLSCREEN | View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY);
        }
    }
}

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.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 아이콘을 클릭하세요. 실행 옵션 목록에서 본인의 모바일 기기를 선택하면, 기기 화면에 내비게이션 바가 숨겨진 전체 화면이 표시되는 것을 확인할 수 있습니다.

안드로이드 액티비티에서 내비게이션 바를 영구적으로 숨기는 방법

참고 사항

위에서 사용한 SYSTEM_UI_FLAG 상수들은 API 30(Android 11)부터 공식적으로 지원 중단(deprecated)되었습니다. 최신 안드로이드 버전을 대상으로 개발한다면 WindowInsetsController(또는 호환성을 위한 WindowInsetsControllerCompat)와 BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE 동작을 사용하는 것이 권장됩니다. 다만 이전 버전과의 호환이 필요한 프로젝트에서는 위 방식이 여전히 널리 활용됩니다.