← 글 목록

notes

Android- Title

Android Title 설정과 앱 화면·액션바에 표시되는 제목 관리 메모.

제목을 supportActionBar?.title로 바꾸다 말고, 몰입형 화면에서 상태 표시줄(status bar)을 숨기는 쪽 문서를 따라가 봤다. 예전 API랑 새 API가 섞여 있어서 버전별로 적어 둔다.

하고 싶은 것

콘텐츠가 화면을 더 쓰게 — 영상, 갤러리, 게임형 웹뷰.

현대적 방식 (WindowInsetsController)

window.insetsController?.let { controller ->
    controller.hide(WindowInsets.Type.statusBars())
    controller.systemBarsBehavior =
        WindowInsetsController.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE
}

ActionBar/Toolbar까지 숨기려면:

supportActionBar?.hide()

예전 플래그 (레거시 코드에서 만남)

window.decorView.systemUiVisibility = View.SYSTEM_UI_FLAG_FULLSCREEN

API 30+에선 deprecated. 유지보수할 때만 읽고, 새로 쓰면 InsetsController.

레이아웃이 상태바 뒤로 들어가게

android:fitsSystemWindows="true"

또는 Compose WindowCompat.setDecorFitsSystemWindows(window, false) + inset padding.

함정

  • 플래그는 해당 DecorView가 보일 때만 유지. 다른 Activity 갔다 오면 다시 세팅
  • 스와이프로 바를 잠깐 보여 주는 behavior를 안 주면 사용자가 시계를 못 봄
  • 노치/컷아웃은 DisplayCutout / windowLayoutInDisplayCutoutMode도 같이 봄

액션바 타이틀 문자열만 바꾸려면 보통:

supportActionBar?.title = "상세"
// 또는 Manifest label / android:label