Android 플랫폼은 상태 표시줄 및 탐색 메뉴와 같은 시스템 UI를 그리는 역할을 합니다. 이 시스템 UI는 사용자가 사용 중인 앱과 관계없이 표시됩니다.
WindowInsets는 앱이 올바른 영역에 그려지고 UI가 시스템 UI에 의해 가려지지 않도록 시스템 UI에 관한 정보를 제공합니다.

Android 14 (API 수준 34) 이하에서는 기본적으로 앱의 UI가 시스템 표시줄과 디스플레이 컷아웃 아래에 그려지지 않습니다.
Android 15 (API 수준 35) 이상에서는 앱이 SDK 35를 타겟팅하면 시스템 표시줄과 디스플레이 컷아웃 아래에 앱이 그려집니다. 이렇게 하면 더 원활한 사용자 환경이 제공되고 앱에서 사용 가능한 창 공간을 최대한 활용할 수 있습니다.
시스템 UI 뒤에 콘텐츠를 표시하는 것을 더 넓은 화면을 활용한다고 합니다. 이 페이지에서는 다양한 유형의 인셋, 더 넓은 화면을 사용하는 방법, 인셋 API를 사용하여 UI에 애니메이션을 적용하고 앱 콘텐츠가 시스템 UI 요소에 가려지지 않도록 하는 방법을 알아봅니다.
인셋 기본사항
앱이 더 넓은 화면에 콘텐츠를 표시하는 경우 중요한 콘텐츠와 상호작용이 시스템 UI에 의해 가려지지 않도록 해야 합니다. 예를 들어 버튼이 탐색 메뉴 뒤에 배치되면 사용자가 버튼을 클릭하지 못할 수 있습니다.
시스템 UI의 크기와 배치 위치에 관한 정보는 인셋을 사용하여 지정됩니다.
시스템 UI의 각 부분에는 크기와 배치 위치를 설명하는 상응하는 유형의 인셋이 있습니다. 예를 들어 상태 표시줄 인셋은 상태 표시줄의 크기와 위치를 제공하고 탐색 메뉴 인셋은 탐색 메뉴의 크기와 위치를 제공합니다. 각 인셋 유형은 상단, 왼쪽, 오른쪽, 하단의 네 가지 픽셀 크기로 구성됩니다. 이러한 크기는 시스템 UI가 앱 창의 해당 측면에서 얼마나 멀리 확장되는지를 지정합니다. 따라서 이러한 유형의 시스템 UI와 겹치지 않도록 앱 UI를 그만큼 인셋해야 합니다.
이러한 기본 제공 Android 인셋 유형은 WindowInsets를 통해 사용할 수 있습니다.
상태 표시줄을 설명하는 인셋입니다. 알림 아이콘과 기타 표시기가 포함된 상단 시스템 UI 표시줄입니다. |
|
상태 표시줄이 표시될 때의 상태 표시줄 인셋입니다. 몰입형 전체 화면 모드로 전환하여 상태 표시줄이 숨겨진 경우 기본 상태 표시줄 인셋은 비어 있지만 이러한 인셋은 비어 있지 않습니다. |
|
탐색 메뉴를 설명하는 인셋입니다. 기기의 왼쪽, 오른쪽 또는 하단에 있는 시스템 UI 표시줄로, 작업 표시줄 또는 탐색 아이콘을 설명합니다. 이는 사용자가 선호하는 탐색 방법과 작업 표시줄과의 상호작용에 따라 런타임 시 변경될 수 있습니다. |
|
탐색 메뉴가 표시될 때의 탐색 메뉴 인셋입니다. 탐색 메뉴가 숨겨져 있으면 (몰입형 전체 화면 모드로 전환되어) 기본 탐색 메뉴 인셋은 비어 있지만 이 인셋은 비어 있지 않습니다. |
|
자유 형식 창에 있는 경우 시스템 UI 창 장식을 설명하는 인셋입니다(예: 상단 제목 표시줄). |
|
표시되는 경우의 자막 표시줄 인셋입니다. 자막 표시줄이 숨겨져 있으면 기본 자막 표시줄 인셋은 비어 있지만 이러한 인셋은 비어 있지 않습니다. |
|
상태 표시줄, 탐색 메뉴, 자막 표시줄을 포함하는 시스템 표시줄 인셋의 합집합입니다. |
|
시스템 표시줄이 표시될 때의 시스템 표시줄 인셋입니다. 몰입형 전체 화면 모드로 전환하여 시스템 표시줄이 숨겨진 경우 기본 시스템 표시줄 인셋은 비어 있지만 이러한 인셋은 비어 있지 않습니다. |
|
소프트웨어 키보드가 차지하는 하단 공간의 크기를 설명하는 인셋입니다. |
|
현재 키보드 애니메이션 이전에 소프트웨어 키보드가 차지한 공간의 양을 설명하는 인셋입니다. |
|
현재 키보드 애니메이션 후 소프트웨어 키보드가 차지할 공간의 양을 설명하는 인셋입니다. |
|
탐색 UI에 관한 자세한 정보를 설명하는 인셋 유형으로, 앱이 아닌 시스템에서 '탭'을 처리하는 공간의 크기를 제공합니다. 동작 탐색을 사용하는 투명한 탐색 메뉴의 경우 시스템 탐색 UI를 통해 일부 앱 요소를 탭할 수 있습니다. |
|
탭 가능한 요소가 표시될 때의 인셋입니다. 탭할 수 있는 요소가 숨겨져 있으면 (몰입형 전체 화면 모드로 전환되어) 기본 탭할 수 있는 요소 인셋은 비어 있지만 이러한 인셋은 비어 있지 않습니다. |
|
시스템이 탐색 동작을 가로채는 인셋의 양을 나타내는 인셋입니다. 앱은 |
|
항상 시스템에서 처리하며 |
|
디스플레이 컷아웃 (노치 또는 핀홀)과 겹치지 않도록 하는 데 필요한 간격을 나타내는 인셋입니다. |
|
Waterfall 디스플레이의 곡선 영역을 나타내는 인셋입니다. 워터폴 디스플레이에는 화면이 기기 측면을 따라 감싸기 시작하는 화면 가장자리를 따라 곡선 영역이 있습니다. |
이러한 유형은 콘텐츠가 가려지지 않도록 하는 세 가지 '안전' 인셋 유형으로 요약됩니다.
이러한 '안전한' 인셋 유형은 기본 플랫폼 인셋에 따라 다양한 방식으로 콘텐츠를 보호합니다.
WindowInsets.safeDrawing를 사용하여 시스템 UI 아래에 그려서는 안 되는 콘텐츠를 보호합니다. 이는 인셋의 가장 일반적인 사용 사례로, 시스템 UI에 의해 가려진 콘텐츠를 (부분적으로 또는 완전히) 그리지 않도록 합니다.WindowInsets.safeGestures를 사용하여 동작으로 콘텐츠를 보호합니다. 이렇게 하면 시스템 동작이 앱 동작 (예: 하단 시트, 캐러셀 또는 게임의 동작)과 충돌하지 않습니다.WindowInsets.safeContent를WindowInsets.safeDrawing및WindowInsets.safeGestures의 조합으로 사용하여 콘텐츠에 시각적 중복과 동작 중복이 없도록 합니다.
추천 서비스
- 참고: JavaScript가 사용 중지되어 있으면 링크 텍스트가 표시됩니다.
- Material 구성요소 및 레이아웃
CoordinatorLayout를 Compose로 이전- 기타 고려사항