التنقّل 3

‫Navigation 3 هي مكتبة تنقّل مصمَّمة للعمل مع Compose. باستخدام Navigation 3، يمكنك التحكّم بشكل كامل في سجلّ الرجوع، ويمكنك التنقّل بين الوجهات من خلال إضافة عناصر إلى قائمة وإزالتها منها. ويتيح إنشاء نظام مرن للتنقّل في التطبيق من خلال توفير ما يلي:

  • اتّفاقيات تصميم نموذج لمكدّس الرجوع، حيث يمثّل كل إدخال في مكدّس الرجوع المحتوى الذي انتقل إليه المستخدم
  • واجهة مستخدم يتم تعديلها تلقائيًا عند إجراء تغييرات على سجلّ الرجوع (بما في ذلك الرسوم المتحركة)
  • نطاق للعناصر في سجلّ الأنشطة السابقة، ما يسمح بالاحتفاظ بالحالة أثناء وجود عنصر في سجلّ الأنشطة السابقة
  • نظام تنسيق متكيّف يتيح عرض وجهات متعدّدة في الوقت نفسه، ما يتيح التبديل بسلاسة بين هذه التنسيقات
  • آلية تتيح للمحتوى التواصل مع التنسيق الرئيسي (البيانات الوصفية)
  • التواصل بين وجهات مختلفة لعرض النتائج بين الشاشات

يمكنك تنفيذ Navigation 3 بالطرق التالية:

  1. حدِّد المحتوى الذي يمكن للمستخدمين الانتقال إليه في تطبيقك، مع تحديد مفتاح فريد لكل جزء من المحتوى، وأضِف دالة لتحويل هذا المفتاح إلى المحتوى. اطّلِع على حلّ المفاتيح للوصول إلى المحتوى.
  2. أنشئ حزمة الأنشطة السابقة التي يتم إدراج المفاتيح فيها وإزالتها منها أثناء تنقّل المستخدمين في تطبيقك. اطّلِع على إنشاء حزمة الأنشطة السابقة.
  3. استخدِم NavDisplay لعرض سجلّ الأنشطة السابقة في تطبيقك. عندما يتغير سجلّ الرجوع، يتم تعديل واجهة المستخدم لعرض المحتوى ذي الصلة. اطّلِع على عرض حزمة الرجوع.
  4. عدِّل استراتيجيات المشهد في NavDisplay حسب الحاجة لإتاحة التنسيقات التكيّفية والأنظمة الأساسية المختلفة.
  5. توفير روابط لصفحات معيّنة للتنقّل مباشرةً إلى الوجهات

يمكنك الاطّلاع على رمز المصدر الكامل الخاص بـ Navigation 3 على AOSP.

تحسينات على Jetpack Navigation

يقدّم الإصدار 3 من Navigation تحسينات على واجهة برمجة التطبيقات الأصلية Jetpack Navigation API، وذلك من خلال ما يلي:

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

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

عيّنات التعليمات البرمجية

يحتوي مستودع وصفات الاستخدام على أمثلة حول كيفية استخدام اللبنات الأساسية في Navigation 3 لحلّ مشاكل التنقّل الشائعة.