더 넓은 화면 설정

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

  1. Android 15 이상에서 더 넓은 화면에 콘텐츠를 표시하도록 Android 15 (API 수준 35) 이상을 타겟팅합니다. 앱이 시스템 UI 뒤에 표시됩니다. 인셋을 처리하여 앱의 UI를 조정할 수 있습니다.
  2. 선택적으로 enableEdgeToEdge()에서 Activity.onCreate()를 호출합니다. 이렇게 하면 이전 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) 중 하나를 사용합니다.