التنقّل 3

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

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

على مستوى عالٍ، يمكنك تنفيذ Navigation 3 بالطرق التالية:

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

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

تحسينات على "التنقّل في Jetpack"

يحسّن Navigation 3 واجهة برمجة التطبيقات الأصلية "التنقّل في Jetpack" بالطرق التالية:

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

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

نماذج الرموز البرمجية

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