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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

لتفعيل الصور المتحركة التي تعرض إيماءة الرجوع إلى الخلف التنبؤية، عليك تفعيل إيماءة الرجوع إلى الخلف التنبؤية. للموافقة، أضِف android:enableOnBackInvokedCallback="true" إلى علامة <application> أو علامات <activity> الفردية ضمن ملف AndroidManifest.xml.

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

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

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

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

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

تفعيل ميزة "الرجوع إلى الخلف التنبؤي" باستخدام ميزة "إنشاء التنقّل"

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

تؤدي ميزة "التنقّل والإنشاء" إلى التمويه بين الشاشات تلقائيًا عندما يقلب المستخدم الشاشة للخلف:

عند التنقّل، يمكنك إنشاء انتقالات مخصّصة باستخدام رمزَي 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 لتحديد الرسوم المتحركة للانتقال إلى العناصر القابلة للتجميع والخروج منها بشكل عام، وليس فقط للرجوع التوقّعي. في حال ضبط enterTransition وexitTransition فقط، سيتم استخدامهما لكل من التنقّل العادي وإزالة الحزمة الأخيرة. ومع ذلك، يتيح لك استخدام popEnterTransition وpopExitTransition إنشاء صور متحركة مختلفة للتنقّل للخلف.

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

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

لاستخدام العناصر المشترَكة مع ميزة "التنقّل والإنشاء"، يُرجى الاطّلاع على الرجوع التوقّعي باستخدام العناصر المشترَكة.

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

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

تشمل مكونات التصميم المتعدد الأبعاد التي تتيح صورًا متحركة تعرض إيماءة الرجوع إلى الخلف التنبؤية ما يلي:

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

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

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

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

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

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

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

مصادر إضافية

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