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 পরীক্ষার জন্য অন্তর্নির্মিত সরঞ্জাম রয়েছে। এমুলেটর Folding Postures ট্যাবের মাধ্যমে ভঙ্গি পরিবর্তন সহ ফোল্ডেবল ডিভাইস (Pixel Fold, Galaxy Z Fold) সমর্থন করে। 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 আপডেট উপেক্ষা করা, উল্লম্ব ভাঁজের সাথে বাউন্ডসের ভুল হ্যান্ডলিং এবং সমস্ত ভঙ্গিতে পরীক্ষার অভাব। পরামর্শ দেওয়া হচ্ছে প্রতিটি ভঙ্গি আলাদাভাবে পরীক্ষা করুন এবং তাদের মধ্যে পরিবর্তনের সময় আচরণ যাচাই করুন। ম্যানুয়াল আকার পরীক্ষার পরিবর্তে WindowSizeClass ব্যবহার করলে বাগ 60% কমে যায়।