إعداد ميزة "إيماءة إظهار شاشة الرجوع"

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

صورة متحركة تعرض إيماءة إظهار شاشة الرجوع إلى الشاشة الرئيسية
صورة متحركة تعرض إيماءة إظهار شاشة الرجوع بين الأنشطة
صورة متحركة تنبؤية للانتقال بين المهام

تفعيل الصور المتحركة التلقائية للنظام

تتوفّر الصور المتحركة للنظام للرجوع إلى الشاشة الرئيسية والتنقّل بين الأنشطة والمهام على الأجهزة التي تعمل بنظام التشغيل Android 15 والإصدارات الأحدث للتطبيقات التي تم نقلها إلى واجهات برمجة التطبيقات المتوافقة لمعالجة الرجوع.

  • الرجوع إلى الشاشة الرئيسية: لإعادة المستخدم إلى الشاشة الرئيسية
  • الانتقال بين الأنشطة: يشير ذلك إلى الانتقال بين الأنشطة داخل التطبيق.
  • بين المهام: الانتقالات بين المهام.

يتم تفعيل هذه الصور المتحركة تلقائيًا على Android 15 والإصدارات الأحدث. على الأجهزة التي تعمل بنظام التشغيل Android 13 أو 14، يمكن للمستخدمين تفعيلها من خلال خيارات المطوّرين.

للحصول على تأثيرات الحركة في النظام، يجب تحديث تبعية AndroidX Activity إلى الإصدار 1.6.0 أو إصدار أحدث.

تفعيل ميزة "إيماءة إظهار شاشة الرجوع" باستخدام Navigation Compose

لاستخدام ميزة "إيماءة إظهار شاشة الرجوع" في Navigation Compose، تأكَّد من استخدام الإصدار navigation-compose 2.8.0 أو إصدار أحدث من المكتبة.

تتلاشى ميزة Navigation Compose تلقائيًا بين الشاشات عندما يمرّر المستخدم سريعًا للرجوع:

الشكل 2. الصورة المتحركة التلقائية للتلاشي التدريجي داخل تطبيق SociaLite

عند التنقّل، يمكنك إنشاء انتقالات مخصّصة باستخدام popEnterTransition وpopExitTransition. عند تطبيق هذه المُعدِّلات على NavHost، تتيح لك تحديد كيفية تحريك شاشات الدخول والخروج. ويمكنك استخدامها لإنشاء مجموعة متنوعة من التأثيرات، مثل تغيير الحجم أو التلاشي أو الانزلاق.

في هذا المثال، يتم استخدام scaleOut ضمن popExitTransition لتصغير الشاشة التي يتم الخروج منها أثناء رجوع المستخدم. بالإضافة إلى ذلك، تحدّد المَعلمة transformOrigin النقطة التي تحدث حولها الحركة المرتبطة بتغيير الحجم. تكون هذه النقطة تلقائيًا في منتصف الشاشة (0.5f, 0.5f). يمكنك تعديل هذه القيمة لتغيير نقطة بداية التكبير أو التصغير.

NavHost(
    navController = navController,
    startDestination = Home,
    popExitTransition = {
        scaleOut(
            targetScale = 0.9f,
            transformOrigin = TransformOrigin(pivotFractionX = 0.5f, pivotFractionY = 0.5f)
        )
    },
    popEnterTransition = {
        EnterTransition.None
    },
    modifier = modifier,
)

ينتج عن هذا الرمز النتيجة التالية:

الشكل 3. صورة متحركة مخصّصة داخل تطبيق SociaLite

يتحكّم العنصران popEnterTransition وpopExitTransition تحديدًا في الصور المتحركة عند إظهار الأنشطة السابقة، باستخدام إيماءة الرجوع مثلاً. يمكنك أيضًا استخدام enterTransition وexitTransition لتحديد الرسوم المتحركة للدخول إلى الدوال المركّبة والخروج منها بشكل عام، وليس فقط لإيماءة إظهار شاشة الرجوع. إذا ضبطت السمتَين enterTransition وexitTransition فقط، سيتم استخدامهما لكل من التنقّل العادي وإزالة الأنشطة السابقة. ومع ذلك، يتيح لك استخدام popEnterTransition وpopExitTransition إنشاء صور متحركة مميّزة للتنقّل للخلف.

الدمج مع انتقالات العناصر المشترَكة

توفّر انتقالات العناصر المشتركة اتصالاً مرئيًا سلسًا بين الدوال المركّبة التي تتضمّن محتوى مشتركًا، وغالبًا ما تُستخدَم للتنقّل.

الشكل 4. انتقال العناصر المشترَكة مع ميزة "إيماءة إظهار شاشة الرجوع" في Navigation Compose

لاستخدام العناصر المشترَكة مع Navigation Compose، يُرجى الاطّلاع على إيماءة إظهار شاشة الرجوع مع العناصر المشترَكة.

إتاحة ميزة "إيماءة إظهار شاشة الرجوع" مع مكوّنات Material Compose

تم تصميم العديد من المكوّنات في مكتبة Material Compose لتعمل بسلاسة مع إيماءات إظهار شاشة الرجوع. لتفعيل إيماءة إظهار شاشة الرجوع في هذه المكوّنات، يجب تضمين أحدث اعتمادية Material3 (androidx.compose.material3:material3-*:1.3.0 أو إصدار أحدث) في مشروعك.

تشمل مكوّنات Material التي تتيح استخدام صور متحركة لإيماءة إظهار شاشة الرجوع ما يلي:

يتم عرض SearchBar وModalBottomSheet تلقائيًا مع إيماءات إظهار شاشة الرجوع. تتطلّب منك ModalNavigationDrawer وModalDrawerSheet وDismissibleDrawerSheet وDismissibleNavigationDrawer تمرير drawerState إلى الدوال المركّبة لمحتوى الورقة الخاصة بها.

اختبار الصورة المتحركة لإيماءة إظهار شاشة الرجوع

إذا كنت لا تزال تستخدم Android 13 أو Android 14، يمكنك اختبار تأثير الرجوع إلى الشاشة الرئيسية.

لاختبار هذه الحركة، اتّبِع الخطوات التالية:

  1. على جهازك، انتقِل إلى الإعدادات > النظام > خيارات المطوّرين.
  2. اختَر صور متحركة تعرض إيماءة إظهار شاشة الرجوع.
  3. افتح تطبيقك المحدَّث واستخدِم إيماءة الرجوع لتجربتها.

تكون هذه الميزة مفعَّلة تلقائيًا على نظام التشغيل Android 15 والإصدارات الأحدث.

مراجع إضافية