Jetpack WindowManager: что это, библиотека для складных устройств

Что такое Jetpack WindowManager?

Jetpack WindowManager — библиотека из состава AndroidX, которая абстрагирует работу с окнами и конфигурациями экрана на Android-устройствах. Она решает проблему фрагментации экранов: от компактных телефонов до складных устройств и планшетов с desktop-режимом.

До появления WindowManager разработчики использовали устаревший Display API и Resources#getConfiguration, которые не учитывали складные устройства и multi-window режимы. WindowManager предоставляет единый API для всех сценариев: одна библиотека покрывает FoldingFeature, WindowMetrics, WindowSizeClass и ScreenContinuity. Это снижает количество boilerplate-кода и устраняет баги при адаптации интерфейса под разные устройства.

По данным Google I/O 2024, Jetpack WindowManager стабильная версия 1.3 включает поддержку hinge-сенсоров, API для определения угла раскрытия и улучшенную интеграцию с Jetpack Compose. Библиотека обратно совместима до Android 10 (API 29) через Support Library и автоматически адаптируется под возможности устройства.

FoldingFeature: работа со складкой устройства

FoldingFeature — центральный класс Jetpack WindowManager для работы со складными устройствами. Он инкапсулирует всю информацию о физическом положении складки: состояние (HALF_OPENED, FLAT, TABLE_TOP), ориентацию (VERTICAL, HORIZONTAL), координаты шарнира и угол раскрытия в градусах.

Состояния FoldingFeature

Библиотека определяет четыре состояния складки. STATE_FLAT — устройство полностью разложено, экран плоский. STATE_HALF_OPENED — устройство частично сложено, экран находится под углом от 30 до 160 градусов. STATE_TABLE_TOP — устройство стоит на поверхности в позе ноутбука. STATE_FULLY_OPENED — устаревшее состояние, заменённое на FLAT в версии 1.2.

Ориентация и координаты складки

Складка может быть вертикальной (VERTICAL_FOLD) или горизонтальной (HORIZONTAL_FOLD). Bounds — прямоугольник, описывающий область складки в координатах окна приложения. Разработчик использует эти данные для размещения UI-элементов выше и ниже складки, избегая перекрытия контента критической областью.

val windowManager = WindowManager(context)
val flow = windowManager.foldingFeature()

flow.collect { feature: FoldingFeature ->
    when (feature.state) {
        FoldingFeature.State.FLAT -> showFullScreen(feature.bounds)
        FoldingFeature.State.HALF_OPENED -> splitContentAcrossFold(feature.bounds)
        FoldingFeature.State.TABLE_TOP -> enableTouchpadMode()
    }
}

WindowMetrics и WindowSizeClass

WindowMetrics — API для получения точных размеров окна приложения, доступное с WindowManager 1.0. В отличие от Display#getSize, WindowMetrics учитывает multi-window режим, DeX и свободную форму окна. Метрики возвращают currentWindowMetrics (текущий размер) и maximumWindowMetrics (максимально возможный размер на устройстве).

WindowSizeClass — классификатор, появившийся в WindowManager 1.1. Он делит экраны на три категории: Compact (ширина менее 600dp — телефон), Medium (600–840dp — планшет в портретной ориентации) и Expanded (более 840dp — планшет в ландшафте). Этот класс упрощает адаптивную вёрстку, заменяя десятки проверок размеров одной классификацией.

class MyComposable {
    @Composable
    fun AdaptiveLayout(windowSizeClass: WindowSizeClass) {
        when (windowSizeClass.widthSizeClass) {
            WindowWidthSizeClass.Compact -> CompactScreen()
            WindowWidthSizeClass.Expanded -> ExpandedScreen()
            else -> MediumScreen()
        }
    }
}

ScreenContinuityController и непрерывность экрана

ScreenContinuityController — компонент WindowManager, отвечающий за сохранение состояния Activity при изменении конфигурации складного устройства. Когда пользователь раскладывает или сворачивает телефон, контроллер уведомляет приложение о new позе и предоставляет механизмы для плавного перехода.

Контроллер регистрирует слушателей через registerContinuityListener, который принимает callback с объектом FoldingFeature. При каждом изменении позы callback срабатывает до пересоздания Activity, давая разработчику возможность сохранить состояние вручную. Если приложение использует ViewModel, дополнительная обработка не требуется — данные сохраняются автоматически.

ScreenContinuity в Jetpack Compose

Compose-приложения получают преимущества ScreenContinuity через LocalWindowSizeClass и CompositionLocalProvider. Компоненты автоматически рекомпозируются при изменении WindowMetrics. rememberSaveable сохраняет состояние между рекомпозициями, а Modifier.windowInsets учитывает системные области экрана.

val controller = WindowManager(context).screenContinuityController
controller.registerContinuityListener { feature ->
    if (feature.state == FoldingFeature.State.FLAT) {
        logContinuityEvent("Device unfolded")
    }
}

Примеры интеграции на Kotlin

Рассмотрим полный пример Activity, использующей Jetpack WindowManager для адаптации интерфейса под разные позы складного устройства. WindowManagerActivity подписывается на изменения FoldingFeature через Flow API и переключает layout между одно- и двухпанельным режимами.

class WindowManagerActivity : AppCompatActivity() {
    private lateinit var binding: ActivityWindowBinding

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        binding = ActivityWindowBinding.inflate(layoutInflater)
        setContentView(binding.root)

        val windowManager = WindowManager(this)
        val metrics = windowManager.currentWindowMetrics

        if (metrics.bounds.width() > dpToPx(600)) {
            showDualPaneLayout()
        } else {
            showSinglePaneLayout()
        }
    }

    private fun showDualPaneLayout() {
        binding.content.layoutManager = GridLayoutManager(this, 2)
    }

    private fun showSinglePaneLayout() {
        binding.content.layoutManager = LinearLayoutManager(this)
    }
}

Пример демонстрирует базовый сценарий: приложение проверяет WindowMetrics и выбирает одно- или двухпанельный макет. В реальных проектах рекомендуется использовать WindowSizeClass для более гибкой адаптации и FoldingFeature для обработки складных устройств. Библиотека также поддерживает seamless transition — плавную анимацию при переключении между макетами.

Тестирование и отладка WindowManager

Android Studio включает встроенные инструменты для тестирования Jetpack WindowManager. Эмулятор поддерживает складные устройства (Pixel Fold, Galaxy Z Fold) с переключением поз через вкладку Folding Postures. Layout Inspector показывает текущие WindowMetrics и границы FoldingFeature в реальном времени.

Отладка через ADB

Команда adb shell dumpsys window displays выводит информацию о всех подключённых дисплеях и их конфигурациях. Для симуляции складки используйте adb shell am broadcast -a android.intent.action.SCREEN_ON с дополнительными параметрами позы. WindowManager логирует все изменения FoldingFeature через WindowManager#logState.

Типичные ошибки

Основные проблемы при интеграции — игнорирование обновлений WindowMetrics в multi-window режиме, неправильная обработка bounds при вертикальной складке и отсутствие тестирования на всех позах. Рекомендуется тестировать каждую позу отдельно и проверять поведение при переключении между ними. Использование WindowSizeClass вместо ручных проверок размеров снижает количество багов на 60%.