الملاحة جيتباك 3 الإصدار 1.0 مستقر 🎉. المضي قدمًا واستخدامه في تطبيقات الإنتاج الخاصة بك اليوم. JetBrains هي يستخدمونه بالفعل في تطبيق KotlinConf الخاص بهم.
إن Navigation 3 عبارة عن مكتبة تنقل جديدة تم إنشاؤها من الألف إلى الياء لتشمل Jetpack Compose ولاية. فهو يمنحك التحكم الكامل في مجموعتك الخلفية، ويساعدك على الاحتفاظ بحالة التنقل، ويسمح لك بإنشاء تخطيطات قابلة للتكيف بسهولة (مثل تفاصيل القائمة). حتى أن هناك إصدارًا متعدد المنصات من JetBrains.
لماذا مكتبة جديدة؟
تم تصميم مكتبة Jetpack Navigation الأصلية (الآن Nav2) منذ 7 سنوات، وعلى الرغم من أنها تخدم أهدافها الأصلية بشكل جيد وقد تم تحسينها بشكل متكرر، إلا أن الطريقة التي يتم بها إنشاء التطبيقات الآن قد تغيرت بشكل أساسي.
أصبحت البرمجة التفاعلية مع واجهة المستخدم التعريفية هي القاعدة الآن. يتبنى Nav3 هذا النهج. على سبيل المثال، نافديسبلاي (مكون Nav3 UI الذي يعرض الشاشات الخاصة بك) يراقب ببساطة قائمة المفاتيح (كل واحد يمثل شاشة) مدعومة بحالة الإنشاء ويقوم بتحديث واجهة المستخدم الخاصة به عندما تتغير تلك القائمة.
الشكل 1. نافديسبلاي يلاحظ التغييرات في القائمة المدعومة بحالة الإنشاء.
يمكن أن يجعل Nav2 أيضًا من الصعب الحصول على ملف مصدر واحد للحقيقة لحالة التنقل الخاصة بك لأن لها حالتها الداخلية الخاصة. باستخدام Nav3، يمكنك توفير حالتك الخاصة، مما يمنحك التحكم الكامل.
وأخيرًا، لقد طلبت المزيد من المرونة وقابلية التخصيص. بدلاً من وجود واجهة برمجة تطبيقات واحدة متجانسة، يوفر Nav3 واجهات برمجة تطبيقات أصغر حجمًا ومنفصلة (أو “كتل بناء”) يمكن دمجها معًا لإنشاء وظائف معقدة. يستخدم Nav3 نفسه هذه العناصر الأساسية لتوفير إعدادات افتراضية معقولة لحالات استخدام التنقل المحددة جيدًا.
هذا النهج يسمح لك بما يلي:
اقرأ المزيد عن تصميمه وميزاته في إطلاق مدونة.
الهجرة من الملاحة 2
إذا كنت تستخدم Nav2 بالفعل، على وجه التحديد تأليف الملاحة، يجب أن تفكر في الانتقال إلى Nav3. ولمساعدتك في ذلك، هناك دليل الهجرة. الخطوات الرئيسية هي:
-
أضف الملاحة 3 التبعيات.
-
قم بتحديث طرق التنقل الخاصة بك للتنفيذ مفتاح التنقل. لا تحتاج مساراتك إلى تنفيذ هذه الواجهة لاستخدام Nav3، ولكن إذا فعلت ذلك، فيمكنك الاستفادة من ميزات Nav3 تذكرNavBackStack وظيفة لإنشاء كومة الظهر المستمرة.
-
قم بإنشاء فئات للاحتفاظ بحالة التنقل الخاصة بك وتعديلها – هذا هو المكان الذي يتم فيه الاحتفاظ بمجموعاتك الخلفية.
-
يستبدل NavController مع هذه الطبقات.
-
انقل وجهاتك من نافهوست‘s نافغراف في دخولProvider.
-
يستبدل نافهوست مع نافديسبلاي.
تجربة ترحيل وكيل الذكاء الاصطناعي
قد ترغب في تجربة استخدام وكيل الذكاء الاصطناعي لقراءة دليل الترحيل وتنفيذ الخطوات في مشروعك. لمحاولة هذا مع الجوزاء في وضع الوكيل في Android Studio:
-
يحفظ هذه النسخة تخفيض السعر من الدليل في مشروعك.
-
الصق هذه المطالبة إلى الوكيل (ولكن لا تضغط على زر الإدخال): “ترحيل هذا المشروع إلى التنقل 3 باستخدام “.
-
اكتب @migration-guide.md – سيؤدي ذلك إلى توفير الدليل كسياق للوكيل.
كما هو الحال دائمًا، تأكد من مراجعة التغييرات التي أجراها وكيل الذكاء الاصطناعي بعناية – فقد يرتكب أخطاء!
نود أن نسمع أداءك أو أداء وكيلك، من فضلك أرسل ملاحظاتك هنا.
وصفات التنقل اللذيذة للسيناريوهات الشائعة
بالنسبة لحالات الاستخدام الشائعة ولكن الدقيقة، لدينا مستودع وصفات. يوضح هذا كيفية دمج واجهات Nav3 API بطريقة معينة، مما يسمح لك باختيار الوصفة أو تعديلها وفقًا لاحتياجاتك الخاصة. إذا تبين أن إحدى الوصفات تحظى بشعبية كبيرة، فسنفكر في “تدرج” الأجزاء غير الدقيقة منها في مكتبة Nav3 الأساسية أو المكتبات الإضافية.
الشكل 2. يمكن أن تتحول وصفات التعليمات البرمجية المفيدة إلى مكتبة.
يوجد حاليا 19 وصفات، بما في ذلك:
كان نعمل حاليًا على وصفة للروابط العميقة، بالإضافة إلى أ التكامل كوين، ولدي الكثير من الخطط الأخرى. ان مهندس من JetBrains وقد نشر أيضًا أ إنشاء نسخة متعددة المنصات من الوصفات.
إذا كانت لديك حالة استخدام شائعة وترغب في رؤية وصفة لها، من فضلك تقديم طلب وصفة.
ملخص
لبدء استخدام Nav3، راجع المستندات و الوصفات. بالإضافة إلى ذلك، ترقب لمدة أسبوع كامل من المحتوى الفني بما في ذلك:
-
فيديو تفصيلي حول واجهة برمجة التطبيقات (API) يغطي الوحدات النمطية والرسوم المتحركة والتخطيطات التكيفية.
-
بث حي اسألني أي شيء (AMA) مع المهندسين الذين قاموا ببناء Nav3.
يبدأ أسبوع Nav3 Spotlight في الأول من ديسمبر 2025.
كما هو الحال دائما، إذا وجدت أي مشاكل، من فضلك ملف لهم هنا.

