Jetpack WindowManager: bu nədir, qatlanan cihazlar üçün kitabxana

Jetpack WindowManager nədir?

Jetpack WindowManager — AndroidX paketindən olan kitabxana, Android cihazlarında pəncərələr və ekran konfiqurasiyaları ilə işi abstraksiya edir. Ekranların parçalanması problemini həll edir: kompakt telefonlardan qatlanan cihazlara və desktop rejimi olan planşetlərə qədər.

WindowManager-in yaranmasından əvvəl proqramçılar köhnəlmiş Display API və Resources#getConfiguration-dan istifadə edirdilər ki, bunlar qatlanan cihazları və multi-window rejimlərini nəzərə almırdı. WindowManager bütün ssenarilər üçün vahid API təmin edir: bir kitabxana FoldingFeature, WindowMetrics, WindowSizeClass və ScreenContinuity-ni əhatə edir. Bu, boilerplate-kodun miqdarını azaldır və interfeysin müxtəlif cihazlara uyğunlaşdırılması zamanı səhvləri aradan qaldırır.

Google I/O 2024 məlumatlarına görə, Jetpack WindowManager stabil versiyası 1.3 menteşə sensorları, açılma bucağını təyin etmək üçün API və Jetpack Compose ilə təkmilləşdirilmiş inteqrasiyanı əhatə edir. Kitabxana Support Library vasitəsilə Android 10 (API 29)-a qədər geriyə uyğundur və avtomatik olaraq cihazın imkanlarına uyğunlaşır.

FoldingFeature: cihazın qatlanması ilə iş

FoldingFeature — qatlanan cihazlarla işləmək üçün Jetpack WindowManager-in mərkəzi sinifi. O, qatlanmanın fiziki vəziyyəti haqqında bütün məlumatları inkapsulyasiya edir: vəziyyət (HALF_OPENED, FLAT, TABLE_TOP), oriyentasiya (VERTICAL, HORIZONTAL), menteşə koordinatları və dərəcə ilə açılma bucağı.

FoldingFeature vəziyyətləri

Kitabxana dörd qatlanma vəziyyəti müəyyən edir. STATE_FLAT — cihaz tam açılıb, ekran düzdür. STATE_HALF_OPENED — cihaz qismən yığılıb, ekran 30 ilə 160 dərəcə arasında bucaq altındadır. STATE_TABLE_TOP — cihaz notebook duruşunda səthdə dayanır. STATE_FULLY_OPENED — 1.2 versiyasında FLAT ilə əvəz edilmiş köhnəlmiş vəziyyətdir.

Qatlanmanın oriyentasiyası və koordinatları

Qatlama şaquli (VERTICAL_FOLD) və ya üfüqi (HORIZONTAL_FOLD) ola bilər. Bounds — tətbiq pəncərəsinin koordinatlarında qatlama sahəsini təsvir edən düzbucaqlı. Proqramçı bu məlumatları UI elementlərini qatlamanın yuxarısına və aşağısına yerləşdirmək üçün istifadə edir, məzmunun kritik sahə ilə üst-üstə düşməsinin qarşısını alır.

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 və WindowSizeClass

WindowMetrics — WindowManager 1.0-dan etibarən mövcud olan, tətbiq pəncərəsinin dəqiq ölçülərini almaq üçün API. Display#getSize-dən fərqli olaraq, WindowMetrics multi-window rejimini, DeX-i və pəncərənin sərbəst formasını nəzərə alır. Metriklər currentWindowMetrics (cari ölçü) və maximumWindowMetrics (cihazda mümkün olan maksimum ölçü) qaytarır.

WindowSizeClass — WindowManager 1.1-də ortaya çıxan təsnifatçı. Ekranları üç kateqoriyaya ayırır: Compact (en 600dp-dən az — telefon), Medium (600–840dp — portret oriyentasiyasında planşet) və Expanded (840dp-dən çox — landşaft oriyentasiyasında planşet). Bu sinif adaptiv düzülüşü sadələşdirir, onlarla ölçü yoxlamasını bir təsnifatla əvəz edir.

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

ScreenContinuityController və ekran davamlılığı

ScreenContinuityController — qatlanan cihazın konfiqurasiyası dəyişərkən Activity vəziyyətini qorumaq üçün WindowManager komponenti. İstifadəçi telefonu açdıqda və ya yığdıqda, kontroller tətbiqi yeni duruş barədə xəbərdar edir və hamar keçid üçün mexanizmlər təqdim edir.

Kontroller registerContinuityListener vasitəsilə dinləyiciləri qeydiyyatdan keçirir, bu da FoldingFeature obyekti ilə callback qəbul edir. Hər duruş dəyişikliyində callback Activity-nin yenidən yaradılmasından əvvəl işə düşür, proqramçıya vəziyyəti əl ilə saxlamaq imkanı verir. Tətbiq ViewModel istifadə edirsə, əlavə emal tələb olunmur — məlumatlar avtomatik saxlanılır.

Jetpack Compose-da ScreenContinuity

Compose tətbiqləri ScreenContinuity-nin üstünlüklərini LocalWindowSizeClass və CompositionLocalProvider vasitəsilə əldə edir. Komponentlər WindowMetrics dəyişdikdə avtomatik olaraq rekompoze olunur. rememberSaveable rekompozisiyalar arasında vəziyyəti qoruyur, Modifier.windowInsets isə ekranın sistem sahələrini nəzərə alır.

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

Kotlin-də inteqrasiya nümunələri

Qatlanan cihazın müxtəlif duruşlarına uyğunlaşmaq üçün Jetpack WindowManager istifadə edən Activity-nin tam nümunəsinə baxaq. WindowManagerActivity Flow API vasitəsilə FoldingFeature dəyişikliklərinə abunə olur və layout-u bir- və iki-panel rejimləri arasında dəyişir.

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

Nümunə əsas ssenarini göstərir: tətbiq WindowMetrics-i yoxlayır və bir- və ya iki-panel düzülüşü seçir. Real layihələrdə daha çevik uyğunlaşma üçün WindowSizeClass və qatlanan cihazların işlənməsi üçün FoldingFeature istifadə etmək tövsiyə olunur. Kitabxana həmçinin seamless transition — düzülüşlər arasında keçid zamanı hamar animasiyanı dəstəkləyir.

WindowManager-in test edilməsi və sazlanması

Android Studio Jetpack WindowManager-in test edilməsi üçün daxili alətlər ehtiva edir. Emulator Folding Postures bölməsi vasitəsilə duruşların dəyişdirilməsi ilə qatlanan cihazları (Pixel Fold, Galaxy Z Fold) dəstəkləyir. Layout Inspector real vaxtda cari WindowMetrics və FoldingFeature sərhədlərini göstərir.

ADB vasitəsilə sazlama

adb shell dumpsys window displays əmri bütün qoşulmuş displeylər və onların konfiqurasiyaları haqqında məlumatı çıxarır. Qatlanmanı simulyasiya etmək üçün əlavə duruş parametrləri ilə adb shell am broadcast -a android.intent.action.SCREEN_ON istifadə edin. WindowManager FoldingFeature-dəki bütün dəyişiklikləri WindowManager#logState vasitəsilə qeyd edir.

Tipik səhvlər

İnteqrasiya zamanı əsas problemlər — multi-window rejimində WindowMetrics yeniləmələrinin nəzərə alınmaması, şaquli qatlamada bounds-un səhv işlənməsi və bütün duruşlarda test edilməməsidir. Tövsiyə olunur hər duruşu ayrıca test etmək və onlar arasında keçid zamanı davranışı yoxlamaq. Ölçülərin əl ilə yoxlanması əvəzinə WindowSizeClass istifadə etmək səhvlərin sayını 60% azaldır.