डेस्कटॉप विंडोिंग का समर्थन

डेस्कटॉप विंडोइंग की मदद से, उपयोगकर्ता एक साथ कई ऐप्लिकेशन चला सकते हैं. इसके लिए, वे ऐप्लिकेशन की विंडो का साइज़ बदल सकते हैं. इससे उन्हें डेस्कटॉप जैसा अनुभव मिलता है.

इमेज 1 में, डेस्कटॉप विंडोइंग की सुविधा चालू होने पर स्क्रीन का लेआउट देखा जा सकता है. इन बातों का ध्यान रखें:

  • उपयोगकर्ता एक साथ कई ऐप्लिकेशन इस्तेमाल कर सकते हैं.
  • टास्कबार, डिसप्ले के सबसे नीचे एक तय जगह पर होता है. इसमें, चल रहे ऐप्लिकेशन दिखते हैं. उपयोगकर्ता, ऐप्लिकेशन को पिन कर सकते हैं, ताकि उन्हें तुरंत ऐक्सेस किया जा सके.
  • पसंद के मुताबिक बनाया जा सकने वाला नया हेडर बार, हर विंडो के सबसे ऊपरी हिस्से को कंट्रोल के साथ सजाता है. जैसे, विंडो को छोटा और बड़ा करना.
पहली इमेज. टैबलेट पर डेस्कटॉप विंडोइंग की सुविधा.

Android टैबलेट पर, ऐप्लिकेशन डिफ़ॉल्ट रूप से फ़ुल स्क्रीन मोड में खुलते हैं. डेस्कटॉप विंडोइंग में किसी ऐप्लिकेशन को लॉन्च करने के लिए, स्क्रीन पर सबसे ऊपर मौजूद विंडो हैंडल को दबाकर रखें. इसके बाद, हैंडल को यूज़र इंटरफ़ेस (यूआई) में खींचें और छोड़ें, जैसा कि इमेज 2 में दिखाया गया है.

जब कोई ऐप्लिकेशन डेस्कटॉप विंडोइंग में खुला होता है, तो अन्य ऐप्लिकेशन भी डेस्कटॉप विंडो में खुलते हैं.

दूसरी इमेज. डेस्कटॉप विंडोइंग मोड में जाने के लिए, ऐप्लिकेशन विंडो के हैंडल को दबाकर रखें और खींचें.

उपयोगकर्ता, विंडो हैंडल पर टैप या क्लिक करके या कीबोर्ड शॉर्टकट मेटा बटन (Windows, Command या Search) + Ctrl + डाउन ऐरो का इस्तेमाल करके, विंडो हैंडल के नीचे दिखने वाले मेन्यू से भी डेस्कटॉप विंडोइंग को चालू कर सकते हैं.

उपयोगकर्ता, डेस्कटॉप विंडोइंग की सुविधा से बाहर निकलने के लिए, सभी चालू विंडो बंद कर सकते हैं. इसके अलावा, वे डेस्कटॉप विंडो के सबसे ऊपर मौजूद विंडो हैंडल को पकड़कर, ऐप्लिकेशन को स्क्रीन के सबसे ऊपर खींचकर छोड़ सकते हैं. Meta + H कीबोर्ड शॉर्टकट का इस्तेमाल करके भी डेस्कटॉप विंडोइंग मोड से बाहर निकला जा सकता है. इससे ऐप्लिकेशन फिर से फ़ुल स्क्रीन मोड में चलने लगते हैं.

डेस्कटॉप विंडोइंग पर वापस जाने के लिए, हाल ही की स्क्रीन में डेस्कटॉप स्पेस टाइल पर टैप या क्लिक करें.

डेस्कटॉप जैसे एनवायरमेंट के लिए, अपने ऐप्लिकेशन के लेआउट को ऑप्टिमाइज़ करना

डेस्कटॉप के लिए डिज़ाइन करना, मोबाइल के लिए डिज़ाइन करने से काफ़ी अलग हो सकता है. इसकी वजह है कि डेस्कटॉप पर स्क्रीन का साइज़ बड़ा होता है, माउस और कीबोर्ड इनपुट ज़्यादा सटीक होते हैं, और ज़्यादा प्रॉडक्टिविटी की उम्मीद होती है.

Jetpack WindowManager एक ऐसा एपीआई उपलब्ध कराता है जो डेवलपर को यह तय करने में मदद करता है कि डेस्कटॉप यूज़र इंटरफ़ेस (यूआई) कब दिखाना है. आम तौर पर, इसमें ज़्यादा जानकारी होती है, नेविगेशन के अलग-अलग पैटर्न होते हैं, और माउस इंटरैक्शन को ऑप्टिमाइज़ किया जाता है.

lifecycleScope.launch(Dispatchers.Main) {
    lifecycle.repeatOnLifecycle(Lifecycle.State.STARTED) {
        windowInfoTracker.windowEngagementInfo(this@DesktopWindowingActivity)
            .collect { windowEngagementInfo ->
                if(windowEngagementInfo.hasEngagementMode(WindowEngagementInfo.EngagementMode.PRECISE_POINTER)){
                    showDesktopOptimizedUI()
                }else {
                    showTouchOptimizedUI()
                }
        }
    }
}

ज़्यादा जानने के लिए, डेस्कटॉप के लिए डिज़ाइन करना लेख पढ़ें.

साइज़ बदलने की सुविधा और कंपैटबिलिटी मोड

डेस्कटॉप विंडोइंग में, लॉक किए गए ओरिएंटेशन वाले ऐप्लिकेशन का साइज़ आसानी से बदला जा सकता है. इसका मतलब है कि अगर कोई गतिविधि पोर्ट्रेट ओरिएंटेशन में लॉक है, तब भी उपयोगकर्ता ऐप्लिकेशन का साइज़ बदलकर उसे लैंडस्केप ओरिएंटेशन वाली विंडो में देख सकते हैं.

तीसरी इमेज. पोर्ट्रेट मोड में काम करने वाले ऐप्लिकेशन की विंडो का साइज़, लैंडस्केप मोड में बदला जा रहा है.

जिन ऐप्लिकेशन को रीसाइज़ नहीं किया जा सकता (यानी resizeableActivity = false) उनके यूज़र इंटरफ़ेस (यूआई) को स्केल किया जाता है. हालांकि, उनका आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) पहले जैसा ही रहता है.

चौथी इमेज. जिस ऐप्लिकेशन का साइज़ नहीं बदला जा सकता उसका यूज़र इंटरफ़ेस (यूआई), विंडो का साइज़ बदलने पर स्केल होता है.

ओरिएंटेशन को लॉक करने वाले या साइज़ न बदलने वाले कैमरा ऐप्लिकेशन के लिए, कैमरा व्यूफ़ाइंडर को खास तौर पर मैनेज किया जाता है: विंडो का साइज़ पूरी तरह से बदला जा सकता है, लेकिन व्यूफ़ाइंडर का आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) एक जैसा रहता है. यह मानकर कि ऐप्लिकेशन हमेशा पोर्ट्रेट या लैंडस्केप मोड में चलते हैं, ऐप्लिकेशन हार्डकोड करते हैं या अन्य अनुमान लगाते हैं. इससे, झलक या कैप्चर की गई इमेज के ओरिएंटेशन या आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) का गलत हिसाब लगाया जाता है. इस वजह से, इमेज खिंची हुई, साइड में या उल्टी दिखती हैं.

जब तक ऐप्लिकेशन, पूरी तरह से रिस्पॉन्सिव कैमरा व्यूफ़ाइंडर लागू करने के लिए तैयार नहीं हो जाते, तब तक खास ट्रीटमेंट की सुविधा, उपयोगकर्ता को बुनियादी अनुभव देती है. इससे, गलत अनुमानों की वजह से होने वाले असर को कम किया जा सकता है.

कैमरा ऐप्लिकेशन के लिए कंपैटबिलिटी मोड के बारे में ज़्यादा जानने के लिए, डिवाइस का कंपैटबिलिटी मोड देखें.

पांचवीं इमेज. विंडो का साइज़ बदलने पर, कैमरा व्यूफ़ाइंडर का आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) नहीं बदलता.

पसंद के मुताबिक बनाए जा सकने वाले हेडर इनसेट

डेस्कटॉप विंडोइंग में चल रहे सभी ऐप्लिकेशन में हेडर बार होता है. भले ही, वे इमर्सिव मोड में हों. इस बार को पसंद के मुताबिक बनाया जा सकता है, ताकि आपके ऐप्लिकेशन का कॉन्टेंट छिप न जाए. साथ ही, कस्टम यूज़र इंटरफ़ेस (यूआई) एलिमेंट को सीधे हेडर स्पेस में ड्रॉ किया जा सकता है.

कस्टम हेडर लागू करने से पहले और बाद में Chrome.
छठी इमेज. कस्टम हेडर लागू करने से पहले और बाद में Chrome.

लागू करना

हेडर बार में कस्टम कॉन्टेंट दिखाने के लिए, सबसे पहले हेडर बार के बैकग्राउंड को पारदर्शी बनाएं. WindowInsetsController के साथ APPEARANCE_TRANSPARENT_CAPTION_BAR_BACKGROUND फ़्लैग का इस्तेमाल करके, ऐसा किया जा सकता है.

window.insetsController?.setSystemBarsAppearance(
    WindowInsetsController.APPEARANCE_TRANSPARENT_CAPTION_BAR_BACKGROUND,
    WindowInsetsController.APPEARANCE_TRANSPARENT_CAPTION_BAR_BACKGROUND
)

हेडर बार को पारदर्शी बनाने के बाद, हेडर एरिया को अपने ऐप्लिकेशन के डिज़ाइन के हिसाब से स्टाइल किया जा सकता है. WindowInsets.isCaptionBarVisible का इस्तेमाल करके पता लगाएं कि बार मौजूद है या नहीं. साथ ही, अपने लेआउट में सही ऊंचाई या पैडिंग लागू करें.

@OptIn(ExperimentalLayoutApi::class)
@Composable
fun CaptionBar() {
    if (WindowInsets.isCaptionBarVisible) {
        Row(
            modifier = Modifier
                .windowInsetsTopHeight(WindowInsets.captionBar)
                .fillMaxWidth()
                .background(if (isSystemInDarkTheme()) Color.White else Color.Black),
            horizontalArrangement = Arrangement.Center,
            verticalAlignment = Alignment.CenterVertically
        ) {
            Text(
                text = "Caption Bar Title",
                style = MaterialTheme.typography.titleMedium,
                modifier = Modifier.padding(4.dp)
            )
        }
    }
}

  • setSystemBarsAppearance(appearance,mask): सिस्टम बार के विज़ुअल स्टाइल को कॉन्फ़िगर करता है. पहला पैरामीटर, टारगेट अपियरेंस फ़्लैग तय करता है. वहीं, दूसरा पैरामीटर मास्क के तौर पर काम करता है, ताकि यह कंट्रोल किया जा सके कि किन फ़्लैग में बदलाव किया जाए.

  • windowInsetsTopHeight(): यह आपके कंपोज़ेबल की ऊंचाई को सिस्टम के हेडर बार के हिसाब से अपने-आप सेट करता है. इससे, आपके कस्टम बैकग्राउंड को कैप्शन एरिया में भरने में मदद मिलती है. इसके लिए, पिक्सल वैल्यू को हार्डकोड करने की ज़रूरत नहीं पड़ती.

  • WindowInsets.captionBar: इससे डेस्कटॉप विंडोइंग के कंट्रोल (बंद करें, बड़ा करें वगैरह) के डाइमेंशन मिलते हैं. इससे डेस्कटॉप विंडोइंग मोड में जाने या उससे बाहर निकलने पर, आपके यूज़र इंटरफ़ेस (यूआई) को अपने-आप छोटा/बड़ा या छिपाया जा सकता है.

ज़्यादा जानकारी के लिए, विंडो इनसेट के बारे में जानकारी लेख पढ़ें. कैप्शन बार में टाइटल के अलावा, अन्य यूज़र इंटरफ़ेस (यूआई) एलिमेंट भी दिखाए जा सकते हैं. जैसे, Google Chrome की तरह टैब, खोज बार या प्रोफ़ाइल अवतार.

बेहतर यूज़र इंटरफ़ेस

यूज़र इंटरफ़ेस (यूआई) को सिस्टम बटन के साथ ओवरलैप होने से बचाने के लिए, Android 15 में WindowInsets#getBoundingRects() तरीका उपलब्ध है. यह तरीका, Rect ऑब्जेक्ट की सूची दिखाता है. ये ऑब्जेक्ट, सिस्टम एलिमेंट के लिए इस्तेमाल की गई जगह के बारे में बताते हैं. कैप्शन बार में बची हुई जगह को सेफ़ ज़ोन कहा जाता है. यहां कस्टम कॉन्टेंट को सुरक्षित तरीके से रखा जा सकता है.

APPEARANCE_LIGHT_CAPTION_BARS का इस्तेमाल करके, हल्के और गहरे रंग वाली थीम के लिए, सिस्टम कैप्शन एलिमेंट के दिखने के तरीके को टॉगल करें. Compose में WindowInsets.Companion.captionBar() या Views में WindowInsets.Type.captionBar() का इस्तेमाल करके, इनसेट ऐक्सेस करें.

ज़्यादा जानकारी के लिए, विंडो इनसेट के बारे में जानकारी लेख पढ़ें.

मल्टीटास्किंग और एक से ज़्यादा इंस्टेंस की सुविधा

डेस्कटॉप विंडोइंग की मुख्य सुविधा मल्टीटास्किंग है. अपने ऐप्लिकेशन के कई इंस्टेंस की अनुमति देने से, उपयोगकर्ताओं की प्रॉडक्टिविटी काफ़ी बढ़ सकती है.

Android 15 से, PROPERTY_SUPPORTS_MULTI_INSTANCE_SYSTEM_UI का इस्तेमाल किया जा सकता है. AndroidManifest.xml में इस प्रॉपर्टी को सेट करके, यह तय किया जाता है कि सिस्टम यूज़र इंटरफ़ेस (यूआई) में, ऐप्लिकेशन को कई इंस्टेंस में लॉन्च करने के विकल्प (जैसे, "नई विंडो" बटन) उपलब्ध होने चाहिए.

<application>
    <property
        android:name="android.window.PROPERTY_SUPPORTS_MULTI_INSTANCE_SYSTEM_UI"
        android:value="true" />
</application>

ध्यान दें: डेस्कटॉप विंडोइंग और अन्य मल्टी-विंडो एनवायरमेंट में, नए टास्क नई विंडो में खुलते हैं. इसलिए, जब भी आपका ऐप्लिकेशन कई टास्क शुरू करे, तो उपयोगकर्ता अनुभव की दोबारा जांच करें.

खींचकर छोड़ने के जेस्चर की मदद से, ऐप्लिकेशन के इंस्टेंस मैनेज करना

मल्टी-विंडो मोड में, उपयोगकर्ता ऐप्लिकेशन की विंडो से बाहर किसी यूज़र इंटरफ़ेस (यूआई) एलिमेंट (जैसे, कोई टैब या दस्तावेज़) को खींचकर, ऐप्लिकेशन का नया इंस्टेंस शुरू कर सकते हैं. उपयोगकर्ता, एक ही ऐप्लिकेशन के अलग-अलग इंस्टेंस के बीच भी एलिमेंट को मूव कर सकते हैं.

सातवीं इमेज. डेस्कटॉप विंडो से किसी टैब को बाहर खींचकर छोड़ें और Chrome का एक नया इंस्टेंस शुरू करें.

खींचने और छोड़ने की सुविधा का इस्तेमाल करके डेटा ट्रांसफ़र करना

एक से ज़्यादा इंस्टेंस के लिए, खींचने और छोड़ने की सुविधा का इस्तेमाल करके, किसी कंपोज़ेबल को खींचने के सोर्स के तौर पर कॉन्फ़िगर किया जा सकता है. इससे उपयोगकर्ता, आपके ऐप्लिकेशन के किसी दूसरे इंस्टेंस में कॉन्टेंट को खींचकर छोड़ सकते हैं. इसके अलावा, स्क्रीन के किसी खाली हिस्से पर कॉन्टेंट को छोड़कर, नया इंस्टेंस बनाया जा सकता है. इसके लिए, dragAndDropSource मॉडिफ़ायर का इस्तेमाल करें. इसके लैम्डा में, DragAndDropTransferData को रिटर्न करें. साथ ही, ट्रांसफ़र किए जाने वाले डेटा वाले ClipData को पास करें. इसके अलावा, एक से ज़्यादा इंस्टेंस के व्यवहार को कॉन्फ़िगर करने के लिए फ़्लैग पास करें.

Android 15 में, डेस्कटॉप-स्टाइल विंडोविंग और एक से ज़्यादा इंस्टेंस इंटरैक्शन के लिए दो मुख्य फ़्लैग जोड़े गए हैं:

  • DRAG_FLAG_GLOBAL_SAME_APPLICATION: इससे पता चलता है कि ड्रैग ऑपरेशन, विंडो की सीमाओं को पार कर सकता है. ऐसा एक ही ऐप्लिकेशन के कई इंस्टेंस के लिए होता है. जब इस फ़्लैग के सेट होने पर startDragAndDrop() को कॉल किया जाता है, तब सिर्फ़ एक ही ऐप्लिकेशन की दिखने वाली विंडो, ड्रैग ऑपरेशन में हिस्सा ले सकती हैं और खींचे गए कॉन्टेंट को पा सकती हैं.

Modifier.dragAndDropSource { _ ->
    DragAndDropTransferData(
        clipData = ClipData.newPlainText("label", "Your data"),
        flags = View.DRAG_FLAG_GLOBAL_SAME_APPLICATION
    )
}

  • DRAG_FLAG_START_INTENT_SENDER_ON_UNHANDLED_DRAG: इससे उपयोगकर्ता, स्क्रीन के खाली हिस्से पर कॉन्टेंट को खींचकर और छोड़कर, आपके ऐप्लिकेशन का नया इंस्टेंस शुरू कर सकते हैं. ऐसा तब होता है, जब कोई दूसरी विंडो, छोड़े गए कॉन्टेंट को हैंडल न करती हो.
    • इस फ़्लैग का इस्तेमाल करते समय, आपको ClipData.Item.Builder#setIntentSender() का इस्तेमाल करके IntentSender उपलब्ध कराना होगा. अगर कोई अनहैंडल्ड ड्रॉप होता है, तो सिस्टम इसका इस्तेमाल करके नई गतिविधि लॉन्च करता है.

Modifier.dragAndDropSource { _ ->
    val intent = Intent.makeMainActivity(activity.componentName).apply {
        putExtra("EXTRA_ITEM_ID", itemId)
        flags = Intent.FLAG_ACTIVITY_NEW_TASK or
                Intent.FLAG_ACTIVITY_MULTIPLE_TASK or
                Intent.FLAG_ACTIVITY_LAUNCH_ADJACENT
    }

    val pendingIntent = PendingIntent.getActivity(
        activity, 0, intent, PendingIntent.FLAG_IMMUTABLE
    )

    val data = ClipData(
        "Item $itemId",
        arrayOf(ClipDescription.MIMETYPE_TEXT_INTENT),
        ClipData.Item.Builder().setIntentSender(pendingIntent.intentSender).build()
    )

    DragAndDropTransferData(
        clipData = data,
        flags = View.DRAG_FLAG_GLOBAL_SAME_APPLICATION or
                View.DRAG_FLAG_START_INTENT_SENDER_ON_UNHANDLED_DRAG,
    )
}

ट्रांसफ़र किया गया डेटा पाना

किसी दूसरे इंस्टेंस से डेटा स्वीकार करने के लिए, dragAndDropTarget मॉडिफ़ायर का इस्तेमाल करें. अगर डेटा किसी दूसरे इंस्टेंस या ऐप्लिकेशन से आ रहा है, तो आपको साफ़ तौर पर अनुमतियों का अनुरोध करना होगा.

Modifier.dragAndDropTarget(
    shouldStartDragAndDrop = { event ->
        event.toAndroidDragEvent().clipDescription.hasMimeType(ClipDescription.MIMETYPE_TEXT_PLAIN)
    },
    target = object : DragAndDropTarget {
        override fun onDrop(event: DragAndDropEvent): Boolean {
            requestDragAndDropPermissions(activity, event.toAndroidDragEvent())
            val clipData = event.toAndroidDragEvent().clipData
            val item = clipData?.getItemAt(0)?.text
            if (item != null) {
                // Process the dropped text item here
            }
            return item != null
        }
    }
)

मुख्य चरण:

  • फ़िल्टर: shouldStartDragAndDrop का इस्तेमाल करके देखें कि आने वाला डेटा (एमआईएमई टाइप) काम करता है या नहीं.
  • अनुमतियां: डेटा ऐक्सेस करने के लिए, requestDragAndDropPermissions(event) को कॉल करें.
  • हैंडल: onDrop कॉलबैक में डेटा निकालें.

अन्य ऑप्टिमाइज़ेशन

ऐप्लिकेशन लॉन्च करने के तरीके को पसंद के मुताबिक बनाएं और ऐप्लिकेशन को डेस्कटॉप विंडोइंग से फ़ुल स्क्रीन पर ट्रांज़िशन करें.

डिफ़ॉल्ट साइज़ और पोज़िशन तय करना

सभी ऐप्लिकेशन को उपयोगकर्ताओं को बेहतर अनुभव देने के लिए, बड़ी विंडो की ज़रूरत नहीं होती. भले ही, उनका साइज़ बदला जा सकता हो. किसी गतिविधि को लॉन्च करते समय, डिफ़ॉल्ट साइज़ और पोज़िशन तय करने के लिए, ActivityOptions#setLaunchBounds() तरीके का इस्तेमाल किया जा सकता है.

डेस्कटॉप स्पेस से फ़ुल-स्क्रीन मोड में जाना

Activity#requestFullScreenMode() को कॉल करके, ऐप्लिकेशन फ़ुल-स्क्रीन मोड में जा सकते हैं. इस तरीके से, ऐप्लिकेशन को सीधे डेस्कटॉप विंडोइंग से फ़ुल स्क्रीन में दिखाया जाता है.