Jetpack WindowManager 1.5 안정화 버전

Jetpack WindowManager 1.5.0이 이제 안정화 버전으로 출시되었습니다.

이번 출시 빌드는 WindowManager의 강력한 적응성 기반을 바탕으로 구축되어, 모든 화면 크기에서 멋지게 보이는 세련된 적응형 UI를 더욱 쉽게 만들 수 있습니다. Android 생태계가 계속 성장함에 따라 사용자는 휴대전화, 폴더블, 태블릿, 커넥티드 디스플레이, Chromebook, 주차 모드의 자동차 디스플레이에 이르기까지 그 어느 때보다 다양한 기기에서 앱을 사용하고 있습니다.

WindowManager 1.5는 이 다양한 기기 환경에 더 나은 도구를 제공하는 데 중점을 둡니다.

WindowManager 1.5의 새로운 기능

이 안정화 버전에서는 매우 큰 화면을 위한 새로운 중단점을 도입하고 활동 삽입 API를 개선하며 창 측정항목을 계산하는 데 더 많은 유연성을 제공합니다.

새로운 창 크기 클래스: 대형 및 초대형

1.5의 가장 큰 업데이트는 대형과 초대형이라는 두 가지 새로운 너비 창 크기 클래스가 추가된 것입니다.

창 크기 클래스는 적응형 레이아웃을 디자인하고 개발하는 데 도움이 되는 공식적이고 체계적인 표시 영역 중단점 세트입니다. 1.5에서는 일반적인 태블릿을 넘어서는 화면에 대한 가이드가 확대됩니다.

새로운 너비 중단점은 다음과 같습니다.

• 대형: 너비 1200dp~1600dp
• 특대형: 너비가 1,600dp 이상인 경우

디스플레이 너비에 따른 다양한 창 크기 클래스 

이것이 왜 중요할까요?

Android 16 QPR1 베타 2부터 Android는 연결된 디스플레이를 지원하므로 사용자가 기기에 외부 디스플레이를 연결하여 대형 화면이 있는 데스크톱과 같은 도구로 전환할 수 있습니다.

외부 디스플레이에 연결된 휴대전화, 외부 디스플레이에 데스크톱 세션이 표시됨 

이 새로운 기능을 사용할 수 있게 되면 더 큰 디스플레이를 포함하도록 하는 명확한 가이드가 중요합니다. 

이러한 매우 큰 화면에서는 태블릿의 확장 레이아웃을 단순히 확장하는 것만으로는 최상의 사용자 환경을 제공할 수 없습니다. 예를 들어 이메일 클라이언트는 확장된 창 크기 클래스에서 두 개의 창 (편지함과 메시지)을 편안하게 표시할 수 있습니다. 하지만 초대형 데스크톱 모니터에서는 이메일 클라이언트가 3개 또는 4개의 창(예: 편지함, 메일 목록, 전체 메일 내용, 캘린더/작업 패널)을 한 번에 깔끔하게 표시할 수 있습니다.

WindowManager 1.5는 매우 큰 디스플레이 크기에 대한 공식 중단점을 제공하여 생산적이고 정보 밀도가 높은 데스크톱 환경을 위해 특별히 설계된 레이아웃을 도입할 수 있는 명확한 신호를 제공합니다.

창 크기 클래스는 Set<WindowSizeClass> 유형을 확장하는 androidx.window.core.layout 라이브러리 확장 함수인 computeWindowSizeClass()를 사용하여 계산할 수 있습니다. 

프로젝트에 새 창 크기 클래스를 포함하려면 WindowSizeClass.BREAKPOINTS_V1 대신 WindowSizeClass.BREAKPOINTS_V2 세트에서 함수를 호출하면 됩니다.

val currentWindowMetrics =

    WindowMetricsCalculator.getOrCreate()

    .computeCurrentWindowMetrics(LocalContext.current)


val sizeClass = WindowSizeClass.BREAKPOINTS_V2

    .computeWindowSizeClass(currentWindowMetrics)

그런 다음 앱에 최소한 그 정도의 공간이 있다고 확신하는 경우 올바른 레이아웃을 적용합니다.

if(sizeClass.isWidthAtLeastBreakpoint(

    WindowSizeClass.WIDTH_DP_LARGE_LOWER_BOUND)){

    ...

    // window is at least 1200 dp wide


}

적응형 라이브러리

Compose Material 3 Adaptive 라이브러리를 사용하면 창 크기 클래스나 기기 상태와 같은 현재 창 구성에 따라 자동으로 조정되는 적응형 UI를 만들 수 있습니다. 

다행히 라이브러리는 이미 새로운 중단점으로 최신 상태입니다. 버전 1.2 (현재 출시 후보 단계)부터 기본 창 Scaffold 지시어 함수는 대형 및 초대형 창 너비 크기 클래스를 지원합니다.

Gradle 빌드 파일에서 새 중단점을 사용하겠다고 선언하여 선택하기만 하면 됩니다.

currentWindowAdaptiveInfo(

    supportLargeAndXLargeWidth = true)

추가 개선사항

• Activity 임베딩 - 자동 저장 및 복원: 이제 WindowManager에서 Activity 임베딩 분할의 상태를 자동으로 저장하고 복원할 수 있습니다. 이렇게 하면 프로세스 재생성 전반에서 사용자의 레이아웃을 보존하여 더 안정적이고 일관된 환경을 제공할 수 있습니다. 개발자는 더 이상 상태를 수동으로 저장하고 복원할 필요가 없으며 EmbeddingConfiguration#isAutoSaveEmbeddingState 속성을 설정하여 자동을 선택하기만 하면 됩니다.
• 확장된 WindowMetrics: 이제 Activity 컨텍스트뿐만 아니라 Application 컨텍스트에서도 WindowMetrics를 계산할 수 있습니다. 이렇게 하면 앱의 여러 부분에서 창 정보에 더 유연하게 액세스할 수 있습니다.

시작하는 방법

Android 프로젝트에서 새로운 대형 및 초대형 크기 클래스와 기타 1.5 기능을 사용하려면 build.gradle.kts의 앱 종속 항목을 최신 안정화 버전으로 업데이트하세요.

dependencies {
    implementation("androidx.window:window:1.5.0") 

    // or, if you're using the WindowManager testing library:

    testImplementation("androidx.window:window-testing:1.5.0")

}

WindowManager 1.5는 Android 폼 팩터 전반에서 실행되는 완전 적응형 앱을 만들기 위한 또 다른 진전입니다. 변경사항 및 버그 수정의 전체 목록은 공식 출시 노트를 참고하세요.

즐겁게 코딩해 보세요!