Jetpack WindowManager: bu nima, yig'iladigan qurilmalar uchun kutubxona

Jetpack WindowManager nima?

Jetpack WindowManager — AndroidX paketidan olingan kutubxona bo'lib, Android qurilmalarida oynalar va ekran konfiguratsiyalari bilan ishlashni abstraksiyalashtiradi. U ekranlarning parchalanish muammosini hal qiladi: ixcham telefonlardan tortib yig'iladigan qurilmalar va desktop rejimiga ega planshetlargacha.

WindowManager paydo bo'lishidan oldin dasturchilar eskirgan Display API va Resources#getConfiguration-dan foydalanardilar, ular yig'iladigan qurilmalar va multi-window rejimlarini hisobga olmas edi. WindowManager barcha stsenariylar uchun yagona API taqdim etadi: bitta kutubxona FoldingFeature, WindowMetrics, WindowSizeClass va ScreenContinuity-ni qamrab oladi. Bu boilerplate-kod miqdorini kamaytiradi va interfeysni turli qurilmalarga moslashtirishdagi xatolarni bartaraf etadi.

Google I/O 2024 ma'lumotlariga ko'ra, Jetpack WindowManager barqaror versiyasi 1.3 ilgak sensorlari, ochilish burchagini aniqlash uchun API va Jetpack Compose bilan yaxshilangan integratsiyani o'z ichiga oladi. Kutubxona Support Library orqali Android 10 (API 29) gacha orqaga mos keladi va avtomatik ravishda qurilma imkoniyatlariga moslashadi.

FoldingFeature: qurilmaning yig'ilishi bilan ishlash

FoldingFeature — yig'iladigan qurilmalar bilan ishlash uchun Jetpack WindowManager-ning markaziy sinfi. U yig'ilishning jismoniy holati haqidagi barcha ma'lumotlarni inkapsulyatsiya qiladi: holat (HALF_OPENED, FLAT, TABLE_TOP), orientatsiya (VERTICAL, HORIZONTAL), ilgak koordinatalari va darajadagi ochilish burchagi.

FoldingFeature holatlari

Kutubxona to'rtta yig'ilish holatini belgilaydi. STATE_FLAT — qurilma to'liq ochilgan, ekran tekis. STATE_HALF_OPENED — qurilma qisman yig'ilgan, ekran 30 dan 160 darajagacha burchak ostida. STATE_TABLE_TOP — qurilma noutbuk holatida sirtda turibdi. STATE_FULLY_OPENED — 1.2 versiyasida FLAT bilan almashtirilgan eskirgan holat.

Yig'ilishning orientatsiyasi va koordinatalari

Yig'ilish vertikal (VERTICAL_FOLD) yoki gorizontal (HORIZONTAL_FOLD) bo'lishi mumkin. Bounds — ilova oynasi koordinatalarida yig'ilish maydonini tavsiflovchi to'rtburchak. Dasturchi bu ma'lumotlardan UI elementlarini yig'ilishning yuqorisiga va pastiga joylashtirish, kontentning kritik maydon bilan qoplanishini oldini olish uchun foydalanadi.

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 va WindowSizeClass

WindowMetrics — WindowManager 1.0 dan boshlab mavjud bo'lgan, ilova oynasining aniq o'lchamlarini olish uchun API. Display#getSize dan farqli o'laroq, WindowMetrics multi-window rejimi, DeX va oynaning erkin shaklini hisobga oladi. Metriklar currentWindowMetrics (joriy o'lcham) va maximumWindowMetrics (qurilmada mumkin bo'lgan maksimal o'lcham) ni qaytaradi.

WindowSizeClass — WindowManager 1.1 da paydo bo'lgan tasniflagich. Ekranlarni uch toifaga ajratadi: Compact (kengligi 600dp dan kam — telefon), Medium (600–840dp — portret orientatsiyasidagi planshet) va Expanded (840dp dan ko'p — landshaft orientatsiyasidagi planshet). Bu sinf adaptiv joylashuvni soddalashtiradi, o'nlab o'lcham tekshiruvlarini bitta tasnif bilan almashtiradi.

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

ScreenContinuityController va ekran uzluksizligi

ScreenContinuityController — yig'iladigan qurilma konfiguratsiyasi o'zgarganda Activity holatini saqlash uchun WindowManager komponenti. Foydalanuvchi telefonni ochganda yoki yig'ganda, kontroller ilovani yangi holat haqida xabardor qiladi va silliq o'tish mexanizmlarini taqdim etadi.

Kontroller registerContinuityListener orqali tinglovchilarni ro'yxatdan o'tkazadi, u FoldingFeature obyekti bilan callback qabul qiladi. Har bir holat o'zgarishida callback Activity qayta yaratilishidan oldin ishga tushadi va dasturchiga holatni qo'lda saqlash imkoniyatini beradi. Agar ilova ViewModel dan foydalansa, qo'shimcha ishlov talab qilinmaydi — ma'lumotlar avtomatik saqlanadi.

Jetpack Compose-da ScreenContinuity

Compose ilovalari ScreenContinuity afzalliklarini LocalWindowSizeClass va CompositionLocalProvider orqali oladi. Komponentlar WindowMetrics o'zgarganda avtomatik ravishda qayta kompozitsiyalanadi. rememberSaveable qayta kompozitsiyalar orasida holatni saqlaydi, Modifier.windowInsets esa ekranning tizim sohalarini hisobga oladi.

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

Kotlin-da integratsiya misollari

Yig'iladigan qurilmaning turli holatlariga moslashish uchun Jetpack WindowManager dan foydalanadigan to'liq Activity misolini ko'rib chiqamiz. WindowManagerActivity Flow API orqali FoldingFeature o'zgarishlariga obuna bo'ladi va layout-ni bir va ikki panel rejimlari o'rtasida almashtiradi.

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

Misol asosiy stsenariyni ko'rsatadi: ilova WindowMetrics-ni tekshiradi va bir yoki ikki panel joylashuvini tanlaydi. Haqiqiy loyihalarda yanada moslashuvchan moslashish uchun WindowSizeClass va yig'iladigan qurilmalarni qayta ishlash uchun FoldingFeature dan foydalanish tavsiya etiladi. Kutubxona shuningdek seamless transition — layout-lar o'rtasida o'tishda silliq animatsiyani qo'llab-quvvatlaydi.

WindowManager-ni test qilish va nosozliklarni tuzatish

Android Studio Jetpack WindowManager-ni test qilish uchun o'rnatilgan vositalarni o'z ichiga oladi. Emulator Folding Postures yorlig'i orqali holatlarni almashtirish bilan yig'iladigan qurilmalarni (Pixel Fold, Galaxy Z Fold) qo'llab-quvvatlaydi. Layout Inspector real vaqtda joriy WindowMetrics va FoldingFeature chegaralarini ko'rsatadi.

ADB orqali nosozliklarni tuzatish

adb shell dumpsys window displays buyrug'i barcha ulangan displeylar va ularning konfiguratsiyalari haqida ma'lumot chiqaradi. Yig'ilishni simulyatsiya qilish uchun qo'shimcha holat parametrlari bilan adb shell am broadcast -a android.intent.action.SCREEN_ON dan foydalaning. WindowManager FoldingFeature-dagi barcha o'zgarishlarni WindowManager#logState orqali qayd qiladi.

Oddiy xatolar

Integratsiyadagi asosiy muammolar — multi-window rejimida WindowMetrics yangilanishlarini e'tiborsiz qoldirish, vertikal yig'ilishda bounds-ni noto'g'ri qayta ishlash va barcha holatlarda test qilmaslik. Tavsiya etiladi har bir holatni alohida test qilish va ular o'rtasida o'tishda xatti-harakatni tekshirish. O'lchamlarni qo'lda tekshirish o'rniga WindowSizeClass dan foydalanish xatolar sonini 60% ga kamaytiradi.