[Android][View] decor view

공식 레퍼런스 문서에서의 등장

https://developer.android.com/reference/android/view/Window#getDecorView()

Window  |  Android Developers

 

Window의 getDecorView()로 반환되는 객체.

 

public abstract View getDecorView()

 

Returns the top-level window decor view. This value cannot be null.

발번역

최상단 윈도우 decor view를 반환함. null을 반환할 수 없음.

 

Retrieve the top-level window decor view (containing the standard window frame/decorations and the client's content inside of that), which can be added as a window to the window manager.

발번역

최상단 윈도우 decor view(기본  윈도우 프레임/장식과 윈도우 프레임/장식 안에 클라이언트의 콘텐츠를 포함한다.)를 반환한다. decor view는 window manager에 window로 추가될 수 있다. 

 

스택오버플로우 및 다른 블로그 글

윈도우의 프레임? 윈도우의 장식? 누군가가 이미 나와 같은 질문은 한 것을 찾았다.

https://stackoverflow.com/questions/23276847/what-is-an-android-decorview

What is an Android DecorView?

 

애석하게도 답변에서 링크 걸어준 블로그의 글은 더 이상 남아있지 않은 듯 하다.

 

The DecorView is the view that actually holds the window’s background drawable. Calling getWindow().setBackgroundDrawable() from your Activity changes the background of the window by changing the DecorView‘s background drawable. As mentioned before, this setup is very specific to the current implementation of Android and can change in a future version or even on another device.

발번역

DecorView는 윈도우의 백그라운드 드러워블을 실제로 가지고 있는 뷰입니다. Activity에서 getWindow().setBackgroundDrawable()을 호출해 DecorView의 백그라운드 드로워블을 바꿈으로써 윈도우의 백그라운드를 바꿉니다. 전에 언급했듯이, 이 설정은 Android의 현재 구현에는 아주 특별해서 차후 버전이나 다른 단말에서는 바뀔 수 있습니다. 

 

the decor view is the true root of the Window's view hierarchy. It contains both the "decor" (i.e. the window's title (action bar?), or a dialog's "frame" (~= the view which draws the actual pixels of the dialog frame, as seen in pre-Holo) and also contains the app-supplied content view. AFAIK it exists entirely within the bounds of the window, and does not surround it, and is not itself a window in any sense. 

발번역

decor view는 윈도우의 뷰 계층의 진짜 루트입니다. 이건 "decor"(즉, 윈도우의 타이틀(액션바?))나 다이얼로그의 "프레임"(~=pre Holo에서 보이듯이, 다이얼로그 프레임의 실제 픽셀을 그리는 뷰)을 포함하고 앱이 제공하는 콘텐츠 뷰도 또한 포함합니다. 제가 알기론 이것은 윈도우의 경계 안쪽에 전부를 차지하고 있고, 경계를 두르지는 않습니다. 어떤 의미로든 윈도우 자체는 아닙니다.

 

DecorView를 설명해주는 다른 글을 찾았다.

https://medium.com/@yonghan_89267/android-window-8c2edbcdebe8

Android Window

 

DecorView는 Activity의 최상단 루트 뷰로, 윈도우의 배경을 담당하는 듯 하다.

 

쓰임

decor view를 통해 시스템 바(화면 상단의 상태 바 + 화면 하단의 네비게이션 바)의 노출, 숨김 등의 제어가 가능하다는 것을 알았다. 공부하다 보니 Android R을 기준으로 기능 구현 방식이 달라진다. 내용이 길어져서 관련된 상세 내용은 다른 글에서 작성하려고 한다. > 작성했다. 시스템바 제어 글 

 

전체 화면 모드 사용 설정 시

2023년 2월 16일 기준으로, 이 한국어 번역 문서는 Android R 이전 방식을 설명한다.

https://developer.android.com/training/system-ui/immersive?hl=ko 

전체 화면 모드 사용 설정  |  Android 개발자  |  Android Developers

 

원문에서 Android R 이후 버전 방식으로 전체 화면 모드 설정 방법을 설명한다.

https://developer.android.com/develop/ui/views/layout/immersive#kotlin

Hide system bars for immersive mode  |  Android Developers

 

 

시스템 상태 표시줄 제어

Android R 이전 방식을 설명한다.

https://developer.android.com/training/system-ui/dim?hl=ko 

시스템 표시줄 흐리게 하기  |  Android 개발자  |  Android Developers

 

시스템 상태 표시줄 변경 리스너 제공

Android R 이전 방식을 설명한다.

https://developer.android.com/training/system-ui/visibility?hl=ko 

UI 가시성 변경에 응답  |  Android 개발자  |  Android Developers