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

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

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

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

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

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

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

تفعيل ميزة "الرجوع التنبؤي" باستخدام Navigation Compose

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

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

أثناء التنقّل، يمكنك إنشاء انتقالات مخصّصة باستخدام 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,
)
PredictiveBackSnippets.kt

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

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

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

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

لاستخدام العناصر المشترَكة مع Navigation Compose، راجِع مقالة الرجوع التوقّعي باستخدام العناصر المشترَكة.

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

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

تشمل مكوّنات Material التي تتيح إيماءات الرجوع إلى الخلف التنبؤية ما يلي:

• SearchBar
• ModalBottomSheet
• ModalDrawerSheet/DismissibleDrawerSheet
• ModalNavigationDrawer/DismissibleNavigationDrawer

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

اختبار الصورة المتحركة لإيماءة الرجوع إلى الخلف التنبؤية

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

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

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

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

مراجع إضافية

• درس تطبيقي حول الترميز: إضافة صور متحركة تعرض إيماءة الرجوع إلى الخلف التنبؤية
• صور متحرّكة متقدّمة للتنسيق في فيديو Compose