Jetpack WindowManager: यह क्या है, फोल्डेबल डिवाइस के लिए लाइब्रेरी

Jetpack WindowManager क्या है?

Jetpack WindowManager AndroidX सूट की एक लाइब्रेरी है जो Android उपकरणों पर विंडो और स्क्रीन कॉन्फ़िगरेशन के साथ काम को अमूर्त करती है। यह स्क्रीन विखंडन की समस्या को हल करती है: कॉम्पैक्ट फोन से लेकर फोल्डेबल डिवाइस और डेस्कटॉप मोड वाले टैबलेट तक।

WindowManager से पहले, डेवलपर पुराने Display API और Resources#getConfiguration का उपयोग करते थे, जो फोल्डेबल डिवाइस और मल्टी-विंडो मोड को ध्यान में नहीं रखते थे। WindowManager सभी परिदृश्यों के लिए एक एकीकृत API प्रदान करता है: एक लाइब्रेरी FoldingFeature, WindowMetrics, WindowSizeClass और ScreenContinuity को कवर करती है। यह बॉयलरप्लेट कोड को कम करता है और विभिन्न उपकरणों के लिए इंटरफ़ेस को अनुकूलित करते समय बग को समाप्त करता है।

Google I/O 2024 के अनुसार, Jetpack WindowManager स्थिर संस्करण 1.3 में हिंज सेंसर के लिए समर्थन, खुलने के कोण को निर्धारित करने के लिए API और Jetpack Compose के साथ बेहतर एकीकरण शामिल है। लाइब्रेरी Support Library के माध्यम से Android 10 (API 29) तक पिछड़ी संगत है और डिवाइस क्षमताओं के अनुसार स्वचालित रूप से अनुकूलित होती है।

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 — एक पुरानी स्थिति, संस्करण 1.2 में FLAT द्वारा प्रतिस्थापित की गई।

फोल्ड का अभिविन्यास और निर्देशांक

फोल्ड वर्टिकल (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 मल्टी-विंडो मोड, 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 स्थिति को संरक्षित करने के लिए जिम्मेदार है। जब उपयोगकर्ता फोन को खोलता या मोड़ता है, तो नियंत्रक नई मुद्रा के बारे में एप्लिकेशन को सूचित करता है और सहज संक्रमण के लिए तंत्र प्रदान करता है।

नियंत्रक registerContinuityListener के माध्यम से श्रोताओं को पंजीकृत करता है, जो FoldingFeature ऑब्जेक्ट के साथ एक कॉलबैक स्वीकार करता है। प्रत्येक मुद्रा परिवर्तन पर, कॉलबैक Activity पुनर्निर्माण से पहले फायर होता है, जिससे डेवलपर को मैन्युअल रूप से स्थिति सहेजने का अवसर मिलता है। यदि एप्लिकेशन ViewModel का उपयोग करता है, तो अतिरिक्त हैंडलिंग की आवश्यकता नहीं है — डेटा स्वचालित रूप से सहेजा जाता है।

Jetpack Compose में ScreenContinuity

Compose एप्लिकेशन LocalWindowSizeClass और CompositionLocalProvider के माध्यम से ScreenContinuity का लाभ उठाते हैं। 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 Flow API के माध्यम से FoldingFeature परिवर्तनों की सदस्यता लेता है और एकल-पैनल और दोहरे-पैनल लेआउट के बीच स्विच करता है।

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 WindowManager#logState के माध्यम से सभी FoldingFeature परिवर्तनों को लॉग करता है।

सामान्य गलतियाँ

मुख्य एकीकरण समस्याएँ — मल्टी-विंडो मोड में WindowMetrics अपडेट को अनदेखा करना, वर्टिकल फोल्ड के साथ bounds की गलत हैंडलिंग और सभी मुद्राओं पर परीक्षण की कमी। अनुशंसा की जाती है कि प्रत्येक मुद्रा का अलग-अलग परीक्षण करें और उनके बीच स्विच करते समय व्यवहार की जाँच करें। मैन्युअल आकार जाँच के बजाय WindowSizeClass का उपयोग करने से बग 60% कम हो जाते हैं।