창 크기 클래스 사용

窗口大小类别是一组主观的视口划分点，有助于您 设计、开发和测试自适应布局。这些断点平衡了布局简单性与灵活性，以便针对独特情形优化您的应用。

窗口大小类别将应用中可用的显示区域分类为： 紧凑、中等、展开、较大或超大。可用宽度和高度是单独分类的，因此在任何时间点，应用都有两个窗口大小类别：宽度窗口大小类别和高度窗口大小类别。但由于垂直滚动的普遍存在，可用宽度通常比可用高度更重要；因此，宽度窗口大小类别很可能与应用的界面更相关。

图 1.基于宽度的窗口大小类别图示。
图 2.基于高度的窗口大小类别图示。

如图所示，划分点可让您继续从设备和配置的角度考虑布局。每个大小类别断点代表了典型设备场景的大多数情况，当您考虑基于断点的布局设计时，这可能是一个有用的参考框架。

大小类别 划分点 设备表示
较小的宽度 宽度 < 600dp 99.96% 的手机处于竖屏模式
中等宽度 600dp ≤ 宽度 < 840dp 93.73% 的平板电脑处于竖屏模式，

大多数展开的大型内部显示屏处于竖屏模式
展开宽度 840dp ≤ 宽度 < 1200dp 97.22% 的平板电脑处于横屏模式，

大多数展开的大型内屏在横向模式下至少处于展开宽度
较大宽度 1200dp ≤ 宽度 < 1600dp 大型平板电脑显示屏
超大宽度 宽度 ≥ 1600dp 桌面显示屏
较小的高度 高度 < 480dp 99.78% 的手机处于横屏模式
中等高度 480dp ≤ 高度 < 900dp 96.56% 的平板电脑处于横屏模式，

97.59% 的手机处于竖屏模式
展开高度 高度 ≥ 900dp 94.25% 的平板电脑处于竖屏模式

虽然使用实体设备直观地查看大小类别很有用，但窗口大小类别不是由设备屏幕的尺寸明确决定的。窗口大小类别不适用于 isTablet类型的逻辑。相反，窗口大小类别由应用可用的窗口大小决定，而与应用运行的设备类型无关，这具有两个重要含义：

  • 实体设备不能保证特定的窗口大小类别。由于多种原因，应用可用的屏幕空间可能与设备的屏幕尺寸不同。在移动设备上，分屏模式可以在两个应用之间分割屏幕。在 ChromeOS 中，Android 应用可以呈现在可任意调整大小的桌面式窗口中。 可折叠设备可以有两个大小不同的屏幕，分别可通过折叠或展开设备使用。

  • 窗口大小类别可能会在应用的整个生命周期内发生变化。 在应用运行时，设备屏幕方向变化、多任务处理和折叠/展开可能会改变可用的屏幕空间量。因此，窗口大小类别是动态的，应用的界面应相应地调整。

窗口大小类别与 Material Design 布局指南中的紧凑、中等和展开划分点一一对应。此外，还添加了较大和超大划分点，以便更好地定位桌面和连接的显示屏。

使用窗口大小类别来做出高级应用布局决策，如决定是否使用特定的规范布局以利用额外的屏幕空间。

androidx.compose.material3.adaptive 라이브러리의 currentWindowAdaptiveInfo() 최상위 함수를 사용하여 현재 WindowSizeClass를 계산합니다. 이 함수는 windowSizeClass가 포함된 WindowAdaptiveInfo 인스턴스를 반환합니다. 대형 및 특대형 중단점을 지원하려면 true로 설정된 supportLargeAndXLargeWidth 매개변수를 함수 호출에 추가합니다. 다음 예에서는 창 크기 클래스를 계산하고 창 크기 클래스가 변경될 때마다 업데이트를 받는 방법을 보여줍니다.

val windowSizeClass = currentWindowAdaptiveInfo().windowSizeClass
AdaptiveLayoutSnippets.kt

창 크기 클래스를 사용하여 레이아웃 관리하기

창 크기 클래스를 사용하면 앱 레이아웃을 디스플레이 공간으로 변경할 수 있습니다. 예를 들어 기기를 접거나 펼칠 때 앱이 변경되면 기기 방향이 변경되거나 앱 창의 크기가 멀티 윈도우에서 조절됨 있습니다.

창 크기를 전달하여 디스플레이 크기 변경을 처리하는 로직 현지화 다른 앱 상태와 마찬가지로 클래스를 상태로 중첩된 컴포저블로 축소합니다.

@Composable
fun MyApp(
    windowSizeClass: WindowSizeClass = currentWindowAdaptiveInfo(supportLargeAndXLargeWidth = true).windowSizeClass
) {
    // Decide whether to show the top app bar based on window size class.
    val showTopAppBar = windowSizeClass.isHeightAtLeastBreakpoint(WindowSizeClass.HEIGHT_DP_MEDIUM_LOWER_BOUND)

    // MyScreen logic is based on the showTopAppBar boolean flag.
    MyScreen(
        showTopAppBar = showTopAppBar,
        /* ... */
    )
}
AdaptiveLayoutSnippets.kt

测试窗口大小类别

在进行布局更改时，请测试所有窗口大小的布局行为，尤其是在紧凑、中等和展开断点宽度下。

如果您的某个现有布局适合较小的屏幕，请首先针对展开宽度大小类别优化布局，因为此大小类别可以为额外的内容或界面变化提供最大的空间。然后，决定什么布局对中等宽度大小类别有意义，并考虑添加专用布局。

后续步骤

如需详细了解如何使用窗口大小类别创建自适应布局，请参阅以下内容：

如需详细了解如何让应用在所有设备和屏幕尺寸上都表现出色，请参阅：

이전
다양한 디스플레이 크기 지원
다음
멀티 윈도우 모드 지원