التنقّل 3

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

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

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

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

يمكنك الاطّلاع على الرمز المصدر الكامل لـ Navigation 3 على "مشروع Android المفتوح المصدر" (AOSP).

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

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

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

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

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

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