التنقل

يشير التنقل إلى التفاعلات التي تتيح للمستخدمين التنقل عبر أجزاء المحتوى المختلفة داخل تطبيقك والدخول إليها والخروج منها.

يتضمّن مكوّن التنقّل في Android Jetpack مكتبة التنقّل والمكوّن الإضافي لنظام Gradle الخاص بـ Safe Args وأدوات لمساعدتك في تنفيذ التنقّل في التطبيق. يتعامل مكوّن التنقّل مع حالات استخدام التنقّل المتنوعة، بدءًا من النقرات البسيطة على الأزرار وحتى الأنماط الأكثر تعقيدًا، مثل أشرطة التطبيقات ولائحة التنقل.

المفاهيم الرئيسية

يقدّم الجدول التالي نظرة عامة على المفاهيم الأساسية في التنقّل والأنواع الرئيسية التي تستخدمها لتنفيذها.

الفكرة

الغرض

النوع

استضِف أصدقاءك وعائلتك

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

رسم بياني

بنية بيانات تحدّد جميع وجهات التنقّل داخل التطبيق وكيفية ارتباطها ببعضها

NavGraph

فئة "متحكم" (Controller)

هو المنسّق المركزي لإدارة التنقّل بين الوجهات. ويوفّر وحدة التحكّم طرقًا للتنقّل بين الوجهات والتعامل مع الروابط لصفحات معيّنة وإدارة الأنشطة السابقة وغير ذلك.

NavController

الوجهة

عقدة في الرسم البياني للتنقّل عندما ينتقل المستخدم إلى هذه العقدة، يعرض المضيف محتواها.

NavDestination

يتم إنشاؤها عادةً عند إنشاء الرسم البياني للتنقّل.

مسار الجولة

يحدِّد الوجهة وأي بيانات مطلوبة بشكلٍ فريد.

يمكنك التنقّل باستخدام المسارات. تأخذك المسارات إلى وجهاتك.

أي نوع بيانات قابل للتسلسل

المزايا والميزات

يوفّر مكوّن التنقّل عددًا من المزايا والميزات الأخرى، بما في ذلك ما يلي:

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

خيارات إطار العمل

يتيح مكوّن التنقّل استخدام إطارَي عمل أساسيَّين لتنفيذ الرسم البياني للتنقّل، وذلك حسب بنية واجهة المستخدم في تطبيقك:

  • ‫Compose: إذا كان تطبيقك مصمَّمًا بالكامل باستخدام Jetpack Compose، استخدِم Navigation Compose. الوجهات في الرسم البياني هي دوال مركّبة.
  • الأجزاء: إذا كان تطبيقك يستخدم Views أو مزيجًا من Views وCompose، استخدِم مكوّن التنقّل المستند إلى الأجزاء. الوجهات في الرسم البياني هي أجزاء يمكن أن تستضيف طرق عرض عادية أو محتوى Compose أو مزيجًا من الاثنين.

بالنسبة إلى التطبيقات التي يتم نقلها من Views إلى Compose، فإنّ الاستراتيجية المقترَحة هي مواصلة استخدام مكوّن التنقّل المستنِد إلى الأجزاء أثناء تحويل الشاشات الفردية إلى Compose. بعد استبدال جميع الأجزاء بدوال مركّبة، يمكنك نقل الرسم البياني للتنقّل إلى Navigation Compose.

إعداد البيئة

لتضمين ميزة التنقّل في مشروعك، أضِف التبعيات التالية إلى ملف build.gradle في تطبيقك:

Groovy

plugins {
  // Kotlin serialization plugin for type safe routes and navigation arguments
  id 'org.jetbrains.kotlin.plugin.serialization' version '2.0.21'
}
  
dependencies {
  def nav_version = "2.10.2"

  // Jetpack Compose Integration
  implementation "androidx.navigation:navigation-compose:$nav_version"

  // Views/Fragments Integration
  implementation "androidx.navigation:navigation-fragment:$nav_version"
  implementation "androidx.navigation:navigation-ui:$nav_version"

  // Feature module support for Fragments
  implementation "androidx.navigation:navigation-dynamic-features-fragment:$nav_version"

  // Testing Navigation
  androidTestImplementation "androidx.navigation:navigation-testing:$nav_version"

  // JSON serialization library, works with the Kotlin serialization plugin.
  implementation "org.jetbrains.kotlinx:kotlinx-serialization-json:1.7.3"
}

Kotlin

plugins {
  // Kotlin serialization plugin for type safe routes and navigation arguments
  kotlin("plugin.serialization") version "2.0.21"
}

dependencies {
  val nav_version = "2.10.2"

  // Jetpack Compose integration
  implementation("androidx.navigation:navigation-compose:$nav_version")

  // Views/Fragments integration
  implementation("androidx.navigation:navigation-fragment:$nav_version")
  implementation("androidx.navigation:navigation-ui:$nav_version")

  // Feature module support for Fragments
  implementation("androidx.navigation:navigation-dynamic-features-fragment:$nav_version")

  // Testing Navigation
  androidTestImplementation("androidx.navigation:navigation-testing:$nav_version")

  // JSON serialization library, works with the Kotlin serialization plugin
  implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.7.3")
}

للحصول على معلومات حول إضافة مكوّنات أخرى للبنية إلى مشروعك، يُرجى الاطّلاع على إضافة مكوّنات إلى مشروعك.

الخطوات التالية

للاطّلاع على المزيد من المستندات والمراجع ذات الصلة بمكوّن التنقّل، يمكنك مراجعة المراجع التالية.

أدلة تفصيلية

لمزيد من المعلومات حول كيفية تنفيذ مضيف التنقّل وNavController، بالإضافة إلى تفاصيل حول كيفية تفاعلهما مع Compose وأُطر عمل واجهة المستخدم الأخرى، يُرجى الاطّلاع على الأدلة التالية:

اختبارات الرموز

الفيديوهات

نماذج