إتاحة وضع النوافذ على سطح المكتب

تتيح ميزة "العرض في نافذة" للمستخدمين تشغيل تطبيقات متعدّدة في الوقت نفسه في نوافذ تطبيقات يمكن تغيير حجمها، ما يوفّر تجربة استخدام متعدّدة الاستخدامات تشبه تجربة استخدام الكمبيوتر المكتبي.

في الشكل 1، يمكنك الاطّلاع على تنظيم الشاشة مع تفعيل ميزة "العرض في نافذة". ملاحظات:

  • يمكن للمستخدمين تشغيل تطبيقات متعددة جنبًا إلى جنب في الوقت نفسه.
  • يظهر شريط التطبيقات في موضع ثابت في أسفل الشاشة ويعرض التطبيقات قيد التشغيل. يمكن للمستخدمين تثبيت التطبيقات للوصول إليها بسرعة.
  • يُزيّن شريط العناوين الجديد القابل للتخصيص الجزء العلوي من كل نافذة بعناصر تحكّم مثل التصغير والتكبير.
الشكل 1: العرض في نافذة على جهاز لوحي

يتم فتح التطبيقات تلقائيًا في وضع ملء الشاشة على أجهزة Android اللوحية. لتشغيل تطبيق في وضع "العرض في نافذة"، اضغط مع الاستمرار على شريط التحكّم في النافذة في أعلى الشاشة واسحبه داخل واجهة المستخدم، كما هو موضّح في الشكل 2.

عندما يكون أحد التطبيقات مفتوحًا في وضع "العرض في نافذة"، يتم فتح التطبيقات الأخرى في نوافذ سطح المكتب أيضًا.

الشكل 2. اضغط مع الاستمرار على شريط التحكّم في نافذة التطبيق واسحبه لتفعيل ميزة "العرض في نافذة".

يمكن للمستخدمين أيضًا تفعيل ميزة "العرض في نافذة" من القائمة التي تظهر أسفل مقبض النافذة عند النقر على المقبض أو استخدام اختصار لوحة المفاتيح مفتاح Meta (مفتاح Windows أو Command أو مفتاح البحث) + 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()
                }
        }
    }
}

لمزيد من المعلومات، يُرجى الاطّلاع على مقالة التصميم لأجهزة الكمبيوتر المكتبي.

إمكانية تغيير الحجم ووضع التوافق

في وضع "العرض في نافذة"، يمكن تغيير حجم التطبيقات ذات الاتجاه المقفل بحرية. وهذا يعني أنّه حتى إذا كان النشاط مُثبَّتًا على الوضع العمودي، سيظل بإمكان المستخدمين تغيير حجم التطبيق إلى نافذة بالوضع الأفقي.

الشكل 3: تغيير حجم نافذة تطبيق يقتصر على الوضع العمودي إلى الوضع الأفقي

يتم تغيير حجم واجهة المستخدم في التطبيقات التي تم تحديدها على أنّها غير قابلة لتغيير الحجم (أي resizeableActivity = false) مع الحفاظ على نسبة العرض إلى الارتفاع نفسها.

الشكل 4: يتم تغيير حجم واجهة المستخدم لتطبيق غير قابل لتغيير الحجم مع تغيير حجم النافذة.

تطبيقات الكاميرا التي تقفل الاتجاه أو يتم تحديدها على أنّها غير قابلة لتغيير الحجم لها معاملة خاصة لعدسات الكاميرا: يمكن تغيير حجم النافذة بالكامل، ولكن تحتفظ عدسة الكاميرا بنسبة العرض إلى الارتفاع نفسها. من خلال افتراض أنّ التطبيقات تعمل دائمًا في الوضع العمودي أو الأفقي، تضع التطبيقات افتراضات تؤدي إلى أخطاء في حساب اتجاه الصورة أو نسبة العرض إلى الارتفاع في المعاينة أو الصورة التي تم التقاطها، ما يؤدي إلى ظهور صور ممتدة أو جانبية أو مقلوبة.

إلى أن تصبح التطبيقات جاهزة لتنفيذ عدسات كاميرا متجاوبة بالكامل، توفّر المعالجة الخاصة تجربة مستخدم أساسية أكثر تخفّف من الآثار التي قد تسبّبها الافتراضات الخاطئة.

لمزيد من المعلومات حول وضع التوافق لتطبيقات الكاميرا، يُرجى الاطّلاع على وضع توافق الجهاز.

الشكل 5: تحتفظ عدسة الكاميرا بنسبة العرض إلى الارتفاع عند تغيير حجم النافذة.

إدراجات رأس قابلة للتخصيص

تحتوي جميع التطبيقات التي تعمل في وضع "العرض في نافذة" على شريط عنوان، حتى في الوضع المجسم. يمكنك تخصيص هذا الشريط لمنع حجب محتوى تطبيقك ورسم عناصر في واجهة المستخدم مخصّصة مباشرةً في مساحة العنوان.

متصفّح Chrome قبل تنفيذ العناوين المخصّصة وبعده
الشكل 6 متصفّح Chrome قبل تنفيذ العناوين المخصّصة وبعده

التنفيذ

لرسم محتوى مخصّص في شريط العنوان، تتمثّل الخطوة الأولى في جعل خلفية شريط العنوان شفافة. يمكنك تحقيق ذلك باستخدام علامة APPEARANCE_TRANSPARENT_CAPTION_BAR_BACKGROUND مع WindowInsetsController.

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. يمكنك الوصول إلى المساحات المتروكة باستخدام WindowInsets.Companion.captionBar() في Compose أو WindowInsets.Type.captionBar() في Views.

لمزيد من المعلومات، يُرجى الاطّلاع على لمحة عن العناصر المضمّنة في النافذة.

تعدُّد المهام وإتاحة فتح نسختين من التطبيق

تُعدّ ميزة "تعدُّد المهام" أساسية في ميزة "العرض في نافذة"، ويمكن أن يؤدي السماح بنسخ متعددة من تطبيقك إلى زيادة إنتاجية المستخدمين بشكل كبير.

بدءًا من الإصدار 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>

ملاحظة: في ميزة &quot;العرض في نافذة&quot; على أجهزة الكمبيوتر المكتبي والبيئات الأخرى التي تتيح استخدام نوافذ متعددة، يتم فتح المهام الجديدة في نافذة جديدة، لذا يُرجى التحقّق من تجربة المستخدم في أي وقت يبدأ فيه تطبيقك مهام متعددة.

إدارة نُسخ التطبيقات باستخدام إيماءات السحب

في وضع النوافذ المتعددة، يمكن للمستخدمين بدء مثيل تطبيق جديد عن طريق سحب عنصر في واجهة المستخدم (مثل علامة تبويب أو مستند) خارج نافذة التطبيق. يمكن للمستخدمين أيضًا نقل العناصر بين مثيلات مختلفة من التطبيق نفسه.

الشكل 7: ابدأ نسخة جديدة من Chrome عن طريق سحب علامة تبويب خارج نافذة سطح المكتب.

نقل البيانات باستخدام ميزة السحب والإفلات

لإعداد دالة مركّبة كمصدر سحب لعملية السحب والإفلات في فتح نسختين من التطبيق، ما يسمح للمستخدمين بسحب المحتوى إلى نسخة أخرى من تطبيقك، أو إنشاء نسخة جديدة من خلال إفلات المحتوى في منطقة فارغة من الشاشة، استخدِم المعدِّل dragAndDropSource. في دالة lambda، يجب عرض 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: يسمح للمستخدمين ببدء مثيل جديد من تطبيقك عن طريق إفلات المحتوى الذي تم سحبه في منطقة فارغة من الشاشة، إذا لم تتعامل أي نافذة أخرى مع عملية الإفلات.
    • عند استخدام هذه العلامة، يجب تقديم IntentSender باستخدام ClipData.Item.Builder#setIntentSender()، والذي يستخدمه النظام لبدء النشاط الجديد في حال حدوث عملية إفلات لم يتم التعامل معها.

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 للتحقّق مما إذا كانت البيانات الواردة (نوع MIME) متوافقة.
  • الأذونات: يمكنك استدعاء requestDragAndDropPermissions(event) للوصول إلى البيانات.
  • المعالجة: استخرِج البيانات في دالة الاستدعاء onDrop.

تحسينات إضافية

يمكنك تخصيص عمليات تشغيل التطبيقات ونقلها من وضع "العرض في نافذة" إلى وضع ملء الشاشة.

تحديد الحجم والموضع التلقائيَين

لا تحتاج بعض التطبيقات إلى نافذة كبيرة لتقديم قيمة للمستخدم، حتى إذا كانت قابلة لتغيير الحجم. يمكنك استخدام طريقة ActivityOptions#setLaunchBounds() لتحديد حجم وموضع تلقائيين عند بدء نشاط.

الدخول إلى وضع ملء الشاشة من مساحة سطح المكتب

يمكن للتطبيقات الانتقال إلى وضع ملء الشاشة من خلال استدعاء Activity#requestFullScreenMode(). تعرض طريقة التطبيق بملء الشاشة مباشرةً من ميزة &quot;العرض في نافذة&quot;.