더 넓은 화면 설정

앱이 콘텐츠를 그리는 위치를 완전히 제어하도록 허용하려면 다음 설정 단계를 따르세요. 이 단계를 따르지 않으면 앱이 시스템 UI 뒤에 검은색이나 단색을 그리거나 소프트웨어 키보드와 동기화되지 않을 수 있습니다.

  1. Android 15 이상에서 더 넓은 화면을 적용하려면 Android 15 (API 수준 35) 이상을 타겟팅하세요. 앱이 시스템 UI 뒤에 표시됩니다. 인셋을 처리하여 앱의 UI를 조정할 수 있습니다.
  2. 원하는 경우 Activity.onCreate()에서 enableEdgeToEdge()를 호출하여 이전 Android 버전에서 앱이 더 넓은 화면을 사용할 수 있도록 합니다.
  3. 활동의 AndroidManifest.xml 항목에서 android:windowSoftInputMode="adjustResize"을 설정합니다. 이 설정을 사용하면 앱이 소프트웨어 IME의 크기를 인셋으로 수신할 수 있으므로 앱에서 IME가 표시되거나 사라질 때 적절한 레이아웃과 패딩을 적용할 수 있습니다.

    <!-- In your AndroidManifest.xml file: -->
    <activity
      android:name=".ui.MainActivity"
      android:label="@string/app_name"
      android:windowSoftInputMode="adjustResize"
      android:theme="@style/Theme.MyApplication"
      android:exported="true">
    
  4. 중요한 UI가 시스템 표시줄이나 디스플레이 컷아웃과 겹치지 않도록 인셋을 처리합니다. 눈금자, 패딩 수정자 또는 인셋 크기 수정자를 사용하여 인셋을 처리할 수 있습니다. 일부 Material 구성요소는 인셋을 자동으로 처리하거나 ScaffoldPaddingValues 매개변수와 같이 인셋 처리를 용이하게 하는 매개변수가 있습니다. 하나의 인셋 처리 방법을 선택합니다. 예를 들어 이러한 접근 방식은 서로 바꿔 사용할 수 있는 경우가 많으므로 Scaffold, Modifier.safeDrawingPadding() 또는 Modifier.fitInside(WindowInsetsRulers.SafeDrawing.current)를 사용합니다.