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, стабилна верзија 1.3 Jetpack WindowManager-а укључује подршку за сензоре шарке, 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()
        }
    }
}

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

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)
    }
}