دليل نقل البيانات
- دليل نقل البيانات من الإصدار 2 إلى الإصدار 3 من Navigation: دليل مفصّل حول نقل بيانات تطبيق Android من الإصدار 2 إلى الإصدار 3 من Navigation، ويشمل تحديثات التبعيات وتغييرات المسارات وإدارة الحالة واستبدال مكوّنات واجهة المستخدم.
المتطلبات
- الدليل: نقل البيانات إلى ميزة التنقّل الآمن من حيث النوع في Compose: دليل تفصيلي لنقل بيانات تطبيق Android من التنقّل المستند إلى السلاسل إلى ميزة التنقّل الآمن من حيث النوع في Jetpack Compose باستخدام الإصدار 2 من Jetpack Navigation
موارد لمطوّري البرامج
- *التنقل 3 ابحث في المستندات عن مزيد من المعلومات حول الأساسيات أو حفظ حالة التنقّل وإدارتها أو تقسيم رمز التنقّل إلى وحدات أو إنشاء تخطيطات مخصّصة باستخدام Scenes أو إنشاء رسوم متحركة بين الوجهات أو تطبيق منطق أو أغلفة على الوجهات.
وصفات الطعام
أمثلة على الرموز البرمجية التي تعرض الأنماط الشائعة
الاستخدام الأساسي لواجهة برمجة التطبيقات
- أساسي: يعرض الاستخدام الأساسي لواجهة برمجة التطبيقات.
- حزمة الخلف القابلة للحفظ: تعرض هذه العيّنة الاستخدام الأساسي لواجهة برمجة التطبيقات مع حزمة خلفية ثابتة.
- Entry provider DSL: يعرض هذا القسم الاستخدام الأساسي لواجهة برمجة التطبيقات باستخدام entryProvider DSL.
واجهة المستخدم الشائعة
- واجهة المستخدم الشائعة: توضّح كيفية تنفيذ نمط واجهة مستخدم شائع للتنقّل باستخدام شريط تنقّل سفلي وعدّة حِزم احتياطية، حيث يحتوي كل علامة تبويب في شريط التنقّل على سجلّ التنقّل الخاص بها.
الروابط العميقة
- أساسي: يوضّح هذا القسم كيفية تحليل عنوان URL لربط لصفحة في التطبيق من Intent على Android إلى مفتاح تنقّل.
- متقدّمة: توضّح هذه الصفحة كيفية التعامل مع الروابط لصفحات معيّنة باستخدام حزمة احتياطية اصطناعية وكيفية تصحيح سلوك التنقّل "للأعلى".
المَشَاهد
استخدام "المشاهد" المضمّنة
- مربّع الحوار: يعرض كيفية إنشاء مربّع حوار.
إنشاء "مشاهد" مخصّصة
- BottomSheet: توضّح كيفية إنشاء وجهة BottomSheet.
- مشهد عرض على شكل قائمة مع تفاصيل: يوضّح كيفية تنفيذ تنسيقات متجاوبة مع الأجهزة المختلفة لعرض على شكل قائمة مع تفاصيل باستخدام واجهة برمجة التطبيقات Navigation 3 Scenes.
- مشهد ذو لوحتَين: يوضّح كيفية تنفيذ تصاميم تكيُّفية ذات لوحتَين باستخدام واجهة برمجة التطبيقات Navigation 3 Scenes.
Material Adaptive
- عرض على شكل قائمة مع تفاصيل Material: يوضّح هذا التطبيق كيفية تنفيذ تصميم متجاوب على شكل عرض على شكل قائمة مع تفاصيل باستخدام Material 3 Adaptive.
- Material Supporting Pane: يوضّح كيفية تنفيذ تصميم لوحة داعمة متكيّفة باستخدام Material 3 Adaptive.
الصور المتحركة
- الصور المتحركة: توضّح كيفية تجاهل الصور المتحركة التلقائية لجميع الوجهات ولوجهة واحدة.
السلوك الشائع للأنشطة السابقة
- الأنشطة السابقة المتعددة: توضّح هذه الصفحة كيفية إنشاء مسارات متعددة ذات مستوى أعلى، لكل منها الأنشطة السابقة الخاصة به. يتم عرض المسارات ذات المستوى الأعلى في شريط تنقّل يتيح للمستخدمين التبديل بينها. يتم الاحتفاظ بالحالة لكل مسار من المستوى الأعلى، وتظل حالة التنقّل ثابتة عند حدوث تغييرات في الإعدادات وعند إيقاف العملية نهائيًا.
التنقّل الشرطي
- التنقّل الشرطي: التبديل إلى مسار تنقّل مختلف عند استيفاء شرط معيّن على سبيل المثال، للمصادقة أو إعداد المستخدمين لأول مرة.
البنية
- رمز التنقّل المجزّأ (Hilt): يوضّح كيفية فصل رمز التنقّل إلى وحدات منفصلة باستخدام Hilt أو Dagger لتنفيذ عملية إدراج التبعية.
- رمز التنقّل المجزّأ (Koin): يوضّح كيفية فصل رمز التنقّل إلى وحدات منفصلة باستخدام Koin لتوفير التبعية.
استخدام ViewModel
تمرير وسيطات التنقّل
- ViewModel الأساسي: يتم تمرير وسيطات التنقّل إلى
ViewModelتم إنشاؤه باستخدامviewModel()
عرض النتائج
- عرض النتائج كأحداث: عرض النتائج كأحداث في
NavEntryآخر - عرض النتائج كحالة: عرض النتائج كحالة مخزّنة في
CompositionLocal