더 넓은 화면 디스플레이 수동으로 설정하기

다음을 호출하여 앱에서 더 넓은 디스플레이를 사용 설정할 수 있습니다. enableEdgeToEdge 대부분의 앱에서는 이것으로 충분합니다. 이 가이드에서는 더 넓은 화면에 콘텐츠를 표시할 수 있습니다. enableEdgeToEdge

앱을 전체 화면으로 배치하기

WindowCompat.setDecorFitsSystemWindows(window, false) 사용 다음 코드와 같이 시스템 표시줄 뒤에 앱을 배치합니다. 예:

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)
  WindowCompat.setDecorFitsSystemWindows(window, false)
}

자바

@Override
public void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  WindowCompat.setDecorFitsSystemWindows(getWindow(), false);
}

시스템 표시줄 색상 변경

더 넓은 화면 레이아웃에서 작동할 때 앱은 기본 화면의 색상을 시스템 표시줄을 아래로 스크롤해서 그 아래에 있는 콘텐츠가 표시되도록 합니다. 앱 실행 후 이 단계를 수행하면 시스템이 사용자의 모든 시각적 보호를 처리합니다. 동작 탐색 모드와 버튼 모드의 인터페이스입니다.

  • 동작 탐색 모드: 시스템이 동적 색상 적응을 배경의 콘텐츠에 따라 시스템 표시줄의 내용이 색이 변하는 것을 볼 수 있습니다. 있습니다. 다음 예에서 탐색 메뉴의 핸들은 밝은 콘텐츠 위에 있으면 어두운 색, 밝은 콘텐츠 위에 있으면 밝은 색으로 어두운 콘텐츠
를 통해 개인정보처리방침을 정의할 수 있습니다. <ph type="x-smartling-placeholder">
</ph> <ph type="x-smartling-placeholder"> <ph type="x-smartling-placeholder">
</ph> 그림 1. 동작 탐색의 색상 변경 있습니다.
  • 버튼 모드: 시스템에서 버튼에 반투명 버튼을 스크림 시스템 표시줄 뒤 (API 수준 29 이상) 또는 투명한 시스템 (API 수준 28 이하의 경우)
를 통해 개인정보처리방침을 정의할 수 있습니다. <ph type="x-smartling-placeholder">
</ph> <ph type="x-smartling-placeholder">반투명 시스템 표시줄을 보여주는 이미지</ph> <ph type="x-smartling-placeholder">
</ph> 그림 2. 시스템 표시줄 뒤의 반투명 스크림
  • 상태 표시줄 콘텐츠 색상: 상태 표시줄 콘텐츠의 색상을 제어합니다. 시간 및 아이콘으로 표시됩니다.
를 통해 개인정보처리방침을 정의할 수 있습니다. <ph type="x-smartling-placeholder">
</ph> <ph type="x-smartling-placeholder">상태 표시줄 콘텐츠 색상 표시 이미지</ph> <ph type="x-smartling-placeholder">
</ph> 그림 3. 상태 표시줄 콘텐츠 색상입니다.

themes.xml 파일을 수정하여 탐색 메뉴의 색상을 설정할 수 있습니다. 선택적으로, 상태 표시줄을 투명으로, 상태 표시줄 콘텐츠 색상을 어둡게 합니다.

<!-- values-v29/themes.xml -->
<style name="Theme.MyApp">
  <item name="android:navigationBarColor">
     @android:color/transparent
  </item>

  <!-- Optional: set to transparent if your app is drawing behind the status bar. -->
  <item name="android:statusBarColor">
     @android:color/transparent
  </item>

  <!-- Optional: set for a light status bar with dark content. -->
  <item name="android:windowLightStatusBar">
    true
  </item>
</style>

WindowInsetsController API 지원 라이브러리를 사용하는 것이 좋습니다. WindowInsetsControllerCompat 가능한 경우 대신 WindowInsetsControllerCompat API를 사용할 수 있습니다. theme.xml: 상태 표시줄의 콘텐츠 색상을 제어합니다. 이렇게 하려면 setAppearanceLightNavigationBars() 드림 함수: true를 전달하여 탐색의 전경 색상을 다음과 같이 변경합니다. 기본 색상으로 되돌리려면 밝은 색상 또는 false를 사용합니다.

Kotlin

val windowInsetsController =
      ViewCompat.getWindowInsetsController(window.decorView)

windowInsetsController?.isAppearanceLightNavigationBars = true

Java

WindowInsetsControllerCompat windowInsetsController =
      ViewCompat.getWindowInsetsController(getWindow().getDecorView());
if (windowInsetsController == null) {
    return;
}

windowInsetsController.setAppearanceLightNavigationBars(true);