التنقل
androidx.navigation
androidx.navigation.compose
androidx.navigation.dynamicfeatures
androidx.navigation.dynamicfeatures.fragment
androidx.navigation.dynamicfeatures.fragment.ui
androidx.navigation.fragment
androidx.navigation.fragment.compose
androidx.navigation.testing
androidx.navigation.ui
| آخر تحديث | الإصدار المستقر | إصدار محتمل | الإصدار التجريبي | الإصدار الأولي |
|---|---|---|---|---|
| 23 سبتمبر 2026 | 2.10.2 | - | - | - |
تحديد الاعتماديات
لإضافة اعتمادية على Navigation، يجب تضمين مستودع Google Maven في مشروعك. اطّلِع على مستودع Maven من Google لمزيد من المعلومات.
أضِف الاعتماديات الخاصة بالعناصر التي تحتاج إليها في ملف 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") }
Safe Args
如需将 Safe Args
添加到您的项目,请在顶层 build.gradle 文件中包含以下 classpath:
Groovy
buildscript { repositories { google() } dependencies { def nav_version = "2.10.2" classpath "androidx.navigation:navigation-safe-args-gradle-plugin:$nav_version" } }
Kotlin
buildscript { repositories { google() } dependencies { val nav_version = "2.10.2" classpath("androidx.navigation:navigation-safe-args-gradle-plugin:$nav_version") } }
您还必须应用以下两个可用插件之一。
如需生成适用于 Java 模块或 Java 和 Kotlin 混合模块的 Java 语言代码,请将以下行添加到应用或模块的 build.gradle 文件中:
Groovy
plugins { id 'androidx.navigation.safeargs' }
Kotlin
plugins { id("androidx.navigation.safeargs") }
此外,如需生成仅适用于 Kotlin 模块的 Kotlin 语言代码,请添加以下行:
Groovy
plugins { id 'androidx.navigation.safeargs.kotlin' }
Kotlin
plugins { id("androidx.navigation.safeargs.kotlin") }
根据迁移到 AndroidX 文档,您的 gradle.properties 文件中必须具有 android.useAndroidX=true。
للحصول على معلومات حول استخدام إضافات Kotlin، يُرجى الاطّلاع على مستندات ktx.
لمزيد من المعلومات حول الاعتماديات، يُرجى الاطّلاع على إضافة اعتماديات الإصدار.
الملاحظات
تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إعلامنا إذا واجهت مشاكل جديدة أو كانت لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على المشاكل الحالية في هذه المكتبة قبل إنشاء مشكلة جديدة. يمكنك إضافة تصويتك إلى مشكلة حالية من خلال النقر على زر النجمة.
يُرجى الاطّلاع على مستندات Issue Tracker لمزيد من المعلومات.
الإصدار 2.10 من Navigation
الإصدار 2.10.2
23 سبتمبر 2026
تم طرح androidx.navigation:navigation-*:2.10.2. يتضمّن الإصدار 2.10.2 هذه التعديلات.
تحديثات الاعتماديات
- تم تحديث اعتماديات
androidx.lifecycleإلى الإصدار 2.10.0. I4505a9f9a
الإصدار 2.10.1
9 سبتمبر 2026
تم طرح androidx.navigation:navigation-*:2.10.1. يتضمّن الإصدار 2.10.1 هذه التعديلات.
إصلاح الأخطاء
- في الحالات التي يتخطّى فيها
NavHostالصور المتحركة، سيتم الآن أيضًا اعتبارsizeTransformجزءًا من الصور المتحركة التي تم تخطّيها لمنع أي اقتصاص غير متوقّع. (I4f995، b/550924680)
الإصدار 2.10.0
26 أغسطس 2026
تم طرح androidx.navigation:navigation-*:2.10.0. يتضمّن الإصدار 2.10.0 هذه التعديلات.
التغييرات المهمة منذ الإصدار 2.9.0:
- توفّر
NavHostالآن وظيفة زائدة تقبل المَعلمتَينpredictivePopEnterTransitionوpredictivePopExitTransitionللسماح بالانتقال المخصّص أثناء إيماءة إظهار شاشة الرجوع. - تم تعديل
handleDeepLinkلضمان معالجة الروابط العميقة المعترَف بها فقط، بينما سيتم تجاهل جميع الروابط الأخرى. إذا تسبّب ذلك في حدوث خطأ في تطبيقك، ننصحك بالتبديل إلى التنقّل عبر الروابط لصفحات معيّنة المحدّدة في الرسم البياني للتنقّل. بالنسبة إلى اختبارات Robolectric، قد تحتاج إلى استخدام طريقةsetPackageمع حزمة موثوق بها. - تمت إضافة
NavBackStackEntryInfoلعرض لقطات الأنشطة السابقة أثناء أحداث التنقّل. يتيح ذلك استخدام صور متحركة مخصّصة لإيماءة إظهار شاشة الرجوع.
دعم منصات إضافية
- أضافت وحدات
navigation-commonوnavigation-runtimeوnavigation-testingدعمًا لـdesktopوlinuxوmacOSوiOSوjavascriptوWASMوwatchosوtvos.
الإصدار 2.10.0-rc01
12 أغسطس 2026
تم طرح androidx.navigation:navigation-*:2.10.0-rc01. يتضمّن الإصدار 2.10.0-rc01 هذه التعديلات.
التغييرات في السلوك
- تم نقل الحد الأدنى لإصدار حزمة تطوير البرامج (SDK) لخدمة Navigation إلى المستوى 24 من واجهة برمجة التطبيقات مع بقية مكتبات AndroidX. (I972da، b/474169350)
الإصدار 2.10.0-beta01
29 يوليو 2026
تم طرح androidx.navigation:navigation-*:2.10.0-beta01. يتضمّن الإصدار 2.10.0-beta01 هذه التعديلات.
التغييرات في واجهة برمجة التطبيقات
- تم تقديم
NavBackStackEntryInfoلعرض لقطات الأنشطة السابقة أثناء أحداث التنقّل. يتيح ذلك استخدام صور متحركة مخصّصة أكثر ثراءً لإيماءة إظهار شاشة الرجوع. (Icb3b8)
الإصدار 2.10.0-alpha06
1 يوليو 2026
تم طرح androidx.navigation:navigation-*:2.10.0-alpha06. يتضمّن الإصدار 2.10.0-alpha06 هذه التعديلات.
إصلاح الأخطاء
- تم تعديل
handleDeepLinkلضمان معالجة الروابط لصفحات معيّنة في التطبيق التي تم التعرّف عليها فقط (Id4fe3، b/509640056) - تم تغيير
ComposableFragmentلاستخدام الاسم المؤهَّل بالكامل من الوجهة بدلاً من وسيطة الجزء لتضخيم الدوال المركّبة. (I65ded، b/509640586) - تم إصلاح عطل في
FragmentNavigatorكان يؤدي إلى ظهور رسالة الخطأIllegalArgumentExceptionفي أجزاء من الرمز البرمجي عند تحسين العمليات. (I093b0، b/340202276) - تم إصلاح خطأ في ميزة "التنقّل باستخدام الأجزاء" (Navigation with Fragments) حيث يتعذّر استعادة الرسم البياني بشكل صحيح عند ضبطه آليًا. (I41251، b/321147435)
الإصدار 2.10.0-alpha05
19 مايو 2026
تم طرح androidx.navigation:navigation-*:2.10.0-alpha05. يتضمّن الإصدار 2.10.0-alpha05 هذه التعديلات.
الإصدار 2.10.0-alpha04
6 مايو 2026
تم طرح androidx.navigation:navigation-*:2.10.0-alpha04. يتضمّن الإصدار 2.10.0-alpha04 هذه التعديلات.
إصلاح الأخطاء
- تم تحسين
NavHostلتعزيز الحماية منNullPointerExceptionالمحتملة الناتجة عن حالة السباق مع ميزة "إيماءة إظهار شاشة الرجوع". (Ie36c6، b/500945998)
الإصدار 2.10.0-alpha03
22 أبريل 2026
تم طرح androidx.navigation:navigation-*:2.10.0-alpha03. يتضمّن الإصدار 2.10.0-alpha03 هذه التعديلات.
إصلاح الأخطاء
- تم تحديث Compose
compileSdkإلى واجهة برمجة التطبيقات 37. يعني ذلك أنّ الحد الأدنى المطلوب لإصدار AGP هو 9.2.0 عند استخدام Compose. (Id45cd، b/413674743)
مساهمة خارجية
- تمت إضافة الهدفَين
watchosوtvosإلى الوحداتnavigation-commonوnavigation-runtimeوnavigation-testing(I60e46) - ضبط
DefaultNavTransitionsعلى "علني" (Ide293)
الإصدار 2.10.0-alpha02
25 مارس 2026
تم طرح androidx.navigation:navigation-*:2.10.0-alpha02. يتضمّن الإصدار 2.10.0-alpha02 هذه التعديلات.
الإصدار 2.10.0-alpha01
11 مارس 2026
تم طرح androidx.navigation:navigation-*:2.10.0-alpha01. يتضمّن الإصدار 2.10.0-alpha01 هذه التعديلات.
الميزات الجديدة
- توفّر
NavHostالآن وظيفة زائدة تقبل المَعلمتَينpredictivePopEnterTransitionوpredictivePopExitTransitionللسماح بالانتقال المخصّص أثناء إيماءة إظهار شاشة الرجوع. (Iac9b0، b/478294569)
تحديث الحد الأدنى لإصدار حزمة تطوير البرامج (SDK)
- تم تغيير الإعداد التلقائي لـ minSdk من المستوى 21 إلى المستوى 23 من واجهة برمجة التطبيقات مع بقية مكتبات AndroidX. (Ibdfca، b/380448311، b/435705964، b/435705223)
مساهمة خارجية
- تتيح الآن حزم
navigation:navigation-commonوnavigation:navigation-runtimeوnavigation:navigation-testingاستخدام أجهزة الكمبيوتر المكتبي وLinux وmacOS وiOS وJavaScript وWASM بالإضافة إلى Android. شكرًا لـ "كونستانتين تسخوفريبوف" (I035d9 وIec624 وI1615d).
الإصدار 2.9
الإصدار 2.9.8
22 أبريل 2026
تم طرح androidx.navigation:navigation-*:2.9.8. يتضمّن الإصدار 2.9.8 هذه التعديلات.
إصلاح الأخطاء
- تم تحسين
NavHostلتعزيز الحماية منNullPointerExceptionالمحتملة الناتجة عن حالة السباق مع ميزة "إيماءة إظهار شاشة الرجوع". (Ie36c6، b/500945998)
الإصدار 2.9.7
28 يناير 2026
تم طرح androidx.navigation:navigation-*:2.9.7. يتضمّن الإصدار 2.9.7 هذه التعديلات.
إصلاح الأخطاء
- لم يعُد تطبيق Navigation
SafeArgsيواجه مشاكل في تخزين الإعدادات مؤقتًا عند استخدامه مع خدمات Google. (I57cda، b/458071608) - تم إصلاح مشكلة عدم فك ترميز
List<String>في دالة الإنشاءSavedStateHandleللاختبار في navigation-testing. (I26aac،b/454180135)
الإصدار 2.9.6
5 نوفمبر 2025
تم طرح androidx.navigation:navigation-*:2.9.6. يتضمّن الإصدار 2.9.6 هذه التعديلات.
إصلاح الأخطاء
- تم نقل المكوّن الإضافي Navigation
SafeArgsإلى واجهات برمجة التطبيقات الحديثة للمكوّن الإضافي لنظام Gradle المتوافق مع Android، ما يضمن توافقه مع جميع إصدارات AGP 8.4.2 والإصدارات الأحدث. نتيجةً لهذه التغييرات، تم تغيير دليل الإخراج للملفات التي ينشئها المكوّن الإضافي إلى الموقع الجغرافي التلقائي الذي يوفّره AGP. (Ie09d6، I7c431، b/203559535، b/293920476، b/269532448، b/443261197) - لن يتطلّب المكوّن الإضافي
SafeArgsللتنقّل ضبط السمةuseAndroidXعند استخدامه مع الإصدار 9.0.0-alpha04 من "المكوّن الإضافي لنظام Gradle المتوافق مع Android" أو الإصدارات الأحدث. (I6c3a4، b/444746731، b/443106400)
الإصدار 2.9.5
24 سبتمبر 2025
تم طرح androidx.navigation:navigation-*:2.9.5. يتضمّن الإصدار 2.9.5 هذه التعديلات.
إصلاح الأخطاء
- يمكن الآن لـ Navigation Safe Args التعامل مع توافق الإصدار 9.0 من "مكوّن Android الإضافي لبرنامج Gradle" مع لغة Kotlin المضمّنة. (I1d9d76)
تحديث الاعتماديات
- يعتمد المكوّن الإضافي Navigation Safe Args الآن على الإصدار 8.4.2 من المكوّن الإضافي لنظام Gradle المتوافق مع Android. (b/431847270، I5932a)
الإصدار 2.9.4
10 سبتمبر 2025
تم طرح androidx.navigation:navigation-*:2.9.4. يتضمّن الإصدار 2.9.4 هذه التعديلات.
إصلاح الأخطاء
- منع حدوث عطل عند إرسال حدث إيماءة إظهار شاشة الرجوع في منتصف الإطار بعد إيقاف المعالِج في عملية انتقال
NavHost(I5667c، b/384186542)
الإصدار 2.9.3
30 يوليو 2025
تم طرح androidx.navigation:navigation-*:2.9.3. يتضمّن الإصدار 2.9.3 هذه التعديلات.
إصلاح الأخطاء
- تم إصلاح خطأ في
NavControllerتسبّب في حدوثConcurrentModificationExceptionعند استخدامOnDestinationChangedListeners. (If7406، b/417784831) - تم إصلاح خطأ عند استخدام
navigate(uri, navOptions,navigationExtras)حيث تم تجاهل الإضافات. (I67fb7، b/430336813)
الإصدار 2.9.2
16 يوليو 2025
تم طرح androidx.navigation:navigation-*:2.9.2. يتضمّن الإصدار 2.9.2 هذه التعديلات.
إصلاح الأخطاء
- تم إصلاح مشكلة عدم استئناف الإدخال عند إغلاق مربّع الحوار الذي يظهر فوقه (Idb20e، b/418746335)
- تم إصلاح خطأ
MissingFieldExceptionعند اختبارSavedStateHandleباستخدام مسارات تمنع أخطاء الكتابة أثناء استخدامNavTypesمخصّص. (I2f843، b/421002511)
الإصدار 2.9.1
2 يوليو 2025
تم طرح androidx.navigation:navigation-*:2.9.1. يتضمّن الإصدار 2.9.1 هذه التعديلات.
إصلاح الأخطاء
- تم إصلاح مشكلة كانت تؤدي إلى عدم تجاوز
NavEntriesالتي تم إنشاء مثيل لها باستخدام single top حالة CREATED فيLifecycle.State. (I043ba، b/421095236)
الإصدار 2.9.0
7 مايو 2025
تم طرح androidx.navigation:navigation-*:2.9.0. يتضمّن الإصدار 2.9.0 هذه التعديلات.
تغييرات مهمة منذ الإصدار 2.8.0
- يتم الآن إنشاء إجراءات Navigation Safe Args باستخدام التعليق التوضيحي
@CheckResultلضمان استخدامها.
واجهة SupportingPane
- يمكن الآن لمطوّري "أدوات التنقّل المخصّصة" وضع علامة على وجهاتهم تشير إلى أنّها تستخدم واجهة
SupportingPane، ما يوضّح لـNavControllerأنّ هذه الوجهات ستظهر إلى جانب وجهات أخرى. باستخدام هذه الواجهة، يمكنRESUMEDوجهات متعددة في الوقت نفسه، على سبيل المثال.
Compose Kotlin Multiplatform
- يوفّر التنقّل الآن دالة
NavController.handleDeepLink()شائعة جديدة تستخدمNavDeepLinkRequestبدلاً منIntent. يتيح ذلك للأنظمة الأساسية غير Android معالجة الروابط العميقة بشكل صحيح. شكرًا لـ "كونستانتين تسخوفريبوف"! - يوفّر مكوّن Navigation الآن دالة
NavUri، وهي دالة محلّل لغوي شائعة جديدة تمثّل واجهة برمجة تطبيقات متوافقة مع معرّف الموارد المنتظم (URI) في Android على الأنظمة الأساسية الأخرى. يتيح ذلك إنشاء معرّف موارد منتظم (URI) بطريقة مستقلة عن النظام الأساسي. شكرًا لـ "كونستانتين تسخوفريبوف"!
الدوال الآمنة من حيث النوع
- واجهات برمجة التطبيقات التي تمنع أخطاء الكتابة والتي كان من الممكن الوصول إليها سابقًا من خلال طرق
reifiedفقط، أي: تتوفّر الآن إصدارات غير مجسّدة منcomposable<YourScreen>تستخدم مثيلKClassمباشرةً. - تتيح ميزة "منع أخطاء الكتابة" في التنقّل الآن استخدام فئات القيم كمسار أو كنوع وسيطة لمسار.
الإصدار 2.9.0-rc01
23 أبريل 2025
تم طرح androidx.navigation:navigation-*:2.9.0-rc01. يتضمّن الإصدار 2.9.0-rc01 هذه التعديلات.
إصلاح الأخطاء
- تمت إزالة جميع الاستهدافات غير المتوافقة مع نظام Android الأساسي من Jetpack Navigation لأنّ هذه الاستهدافات لا تعمل في الواقع. ويتم الآن توفير رموز برمجية بديلة للأنظمة الأساسية المختلفة بدلاً من ذلك.(I2877d)
الإصدار 2.9.0-beta01
9 أبريل 2025
تم طرح androidx.navigation:navigation-*:2.9.0-beta01. يتضمّن الإصدار 2.9.0-beta01 هذه التعديلات.
التغييرات في واجهة برمجة التطبيقات
- تم تغيير واجهة برمجة التطبيقات الشائعة لـ
parseStringAsNavUriإلى دالة مصنعNavUriتأخذ سلسلة. (I4db6e، b/403616316)
تحديثات الاعتماديات
- تستهدف هذه المكتبة الآن مستوى لغة Kotlin 2.0 وتتطلّب الإصدار 2.0.0 من KGP أو إصدارًا أحدث. (Idb6b5)
الإصدار 2.9.0-alpha09
26 مارس 2025
تم طرح androidx.navigation:navigation-*:2.9.0-alpha09. يتضمّن الإصدار 2.9.0-alpha09 هذه التعديلات.
الميزات الجديدة
- أصبحت وحدة
navigation-testingمتوافقة الآن مع أجهزة الكمبيوتر المكتبي وأنظمة التشغيل Linux وmacOS وiOS بالإضافة إلى Android. (I2b770، b/398265336) - أصبح
NavTypeمتوافقًا الآن مع أجهزة الكمبيوتر المكتبي وLinux وmacOS وiOS بالإضافة إلى Android. (I297d8)
الإصدار 2.9.0-alpha08
12 مارس 2025
تم طرح androidx.navigation:navigation-*:2.9.0-alpha08. يتضمّن الإصدار 2.9.0-alpha08 هذه التعديلات.
إصلاح الأخطاء
- من Navigation
2.8.9: تم إصلاح مشكلة تراجُع في الأداء في Navigation 2.8.8 كانت تتطلّب أن يتطابق الرابط لصفحة معيّنة في التطبيق مع جميع حقول طلب الرابط لصفحة معيّنة في التطبيق أو الغرض منه تمامًا ليتم اعتباره مطابقًا. وأدى ذلك إلى توقّف الروابط لصفحات في التطبيق التي تحتوي على تطابقات جزئية للحقول ولا تحتوي على حقول أخرى. (Ie5e36، b/399826566)
مساهمة خارجية
- دالة محلّل لغوي شائعة جديدة لإنشاء
NavUri. شكرًا لـ "كونستانتين تسخوفريبوف"! (If0a6a)
الإصدار 2.9.0-alpha07
26 فبراير 2025
تم طرح androidx.navigation:navigation-*:2.9.0-alpha07. يتضمّن الإصدار 2.9.0-alpha07 هذه التعديلات.
إصلاح الأخطاء
- تم إصلاح مشكلة كانت تؤدي فيها محاولة
saveStateباستخدام نافذة منبثقة غير شاملة إلى ظهور قيمة savedState فارغة قد تؤدي إلى تعطُّل التطبيق عند الاستعادة. (I9f3e8، b/395091644) - من الإصدار Navigation 2.8.8: تم إصلاح مطابقة
NavDeepLinkحيث يجب أن يتطابق الرابط لصفحة معيّنة وطلب الرابط لصفحة معيّنة تمامًا في معرّف الموارد المنتظم (URI) والإجراء ونوع MIME. لم يعُد يُسمح بالمطابقة إذا تطابق حقل واحد أو حقلان فقط. (I3b029، b/395712033) - من Navigation 2.8.8: تم إصلاح خطأ يتسبب في عدم تطابق المسارات التي تحتوي على مسارات أحرف بدل مع رابط لصفحة معيّنة تمت إضافته (I7ea92، b/389970341)
مساهمة خارجية
- استخرِج واجهات برمجة التطبيقات navigation-common وnavigation-runtime وnavigation-compose إلى المنصة المشتركة. شكرًا لـ "كونستانتين تسخوفريبوف"! (I1e626، Ica76f، Idf479)
المشاكل المعروفة
- بسبب العمل على معالجة الخطأ b/395712033، يُطلب بشكل غير صحيح أن تحتوي الروابط لصفحات معيّنة على جميع الحقول نفسها مثل طلب الرابط لصفحة معيّنة و/أو
Intent. يجب أن تكون الروابط لصفحات معيّنة مطلوبة فقط لمطابقة الحقول التي تحتوي عليها، ويجب تجاهل الحقول غير المضمّنة. تم حلّ هذه المشكلة في إصدار لاحق كجزء من b/399826566.
الإصدار 2.9.0-alpha06
12 فبراير 2025
تم طرح androidx.navigation:navigation-*:2.9.0-alpha06. يتضمّن الإصدار 2.9.0-alpha06 هذه التعديلات.
الميزات الجديدة
- يتم الآن إنشاء إجراءات Navigation Safe Args باستخدام التعليق التوضيحي
@CheckResultلضمان استخدامها. (I14d4c، b/356323084)
إصلاح الأخطاء
- تم إصلاح خطأ في
NavControllerحيث تمت محاولة استعادة حالات backStack بشكل غير صحيح إلى مصفوفة عندما تم حفظها في قائمة. (Idfb9b) - من Navigation
2.8.7: يوفّر Navigation Safe Args الآن إمكانية استخدام الوجهات القابلة للإنشاء. (I35320، b/362791955)
الإصدار 2.9.0-alpha05
29 يناير 2025
تم طرح androidx.navigation:navigation-*:2.9.0-alpha05. يتضمّن الإصدار 2.9.0-alpha05 هذه التعديلات.
إصلاح الأخطاء
- تم إصلاح مشكلة كانت تؤدي إلى ظهور حركة غير متوقّعة عند استخدام Navigation Compose. (I480f4، b/353294030)
- من التنقّل
2.8.6: سيتم تحليل تصنيفاتNavDestinationالمقدَّمة من خلال XML عبرNavType.getلضمان الالتزام بمنطقNavTypeالمخصّص. (I7ec2f، b/388100796) - من Navigation
2.8.6: عند الانتقال إلى نشاط باستخدامdataPattern، سيحاولActivityNavigatorالآن ترميز قيمة الوسيطة باستخدامNavTypeللوسيطة. (I16376، b/383616432) - من Navigation
2.8.5: تم إصلاح مشكلة كانت تؤدي إلى ظهور حركة تغيير حجم غير متوقّعة عند استخدام Navigation Compose واستدعاء navigate في الإطار نفسه الذي تنتهي فيه الحركة الحالية. (I26cb1، b/353294030)
الإصدار 2.9.0-alpha04
11 ديسمبر 2024
تم طرح androidx.navigation:navigation-*:2.9.0-alpha04. يتضمّن الإصدار 2.9.0-alpha04 هذه التعديلات.
الميزات الجديدة
- واجهات برمجة التطبيقات التي تمنع أخطاء الكتابة والتي كان من الممكن الوصول إليها سابقًا من خلال طرق
reifiedفقط، أي: تتوفّر الآن فيcomposable<YourScreen>إصدارات غير مجسّدة تستخدم مثيلKClassمباشرةً.(Ia7eed وId2879 وIbf244 وI17d79 وId09d2 وI54696 وIa47be وI93281 وIc1bf0 وIba4ee وIf56a5 وIcf969 وI67644 وI6f788 وb/382094941 وb/366291612 وb/381938808)
يقدّم الجدول أدناه واجهات برمجة التطبيقات Reified وKClass.
| مُجسَّدة | KClass |
|---|---|
composable<TestClass> { } |
composable(TestClass::class) { } |
navigation<NestedGraph>(startDestination = TestClass::class) |
navigation(route = NestedGraph::class, startDestination = TestClass::class) |
dialog<TestClass> {} |
dialog(TestClass::class) {} |
navDeepLink<TestClass>(baseUri) |
navDeepLink(TestClass::class, baseUri) |
NavDeepLink.Builder.setUriPattern<TestClass>(baseUri) |
NavDeepLink.Builder.setUriPattern(TestClass::class, baseUri) |
NavDestinationBuilder.deepLink<TestDeepLink>(baseUri) { } |
NavDestinationBuilder.deepLink(TestDeepLink::class, baseUri) { } |
navController.getBackStackEntry<TestClass>() |
navController.getBackStackEntry(TestClass::class) |
navController.popBackStack<TestClass>(true) |
navController.popBackStack(TestClass::class, true) |
navController.clearBackStack<TestClass>() |
navController.clearBackStack(TestClass::class) |
NavOptions.setPopUpTo<TestClass>() |
NavOptions.setPopUpTo(TestClass::class) |
navOptions { popUpTo<TestClass> {...} } |
navOptions { popUpTo(TestClass::class) {...} } |
NavGraph.setStartDestination<TestClass>() |
NavGraph.setStartDestination(TestClass::class) |
NavGraph.findNode<TestClass>() |
NavGraph.findNode(TestClass::class) |
backStackEntry.toRoute<TestClass>() |
backStackEntry.toRoute(TestClass::class) |
savedStateHandle.toRoute<TestClass>() |
savedStateHandle.toRoute(TestClass::class) |
التغييرات في واجهة برمجة التطبيقات
- يتم إخفاء دالة
NavGraph.setStartDestinationالزائدة الخاصة بلغة Kotlin لمنع أخطاء الكتابة من مصادر Java. (Ic640c، b/364634035)
إصلاح الأخطاء
- من Navigation
2.8.5: تم حلّ مشكلة حيث يمكن أن يطرحNavHostاستثناءً داخلPredictiveBackHandlerإذا تم إرجاع الأنشطة السابقة إلى إدخال واحد وتم تشغيل زر الرجوع في النظام في الإطار نفسه. (I1a429، b/375343407) - من التنقّل
2.8.5: تم إصلاحNavDestinationNullPointerExceptionعند تعديلstartDestinationفي رسم بياني. (I99421، b/361560785)
مساهمة خارجية
- من Navigation
2.8.5: تتيح ميزة "منع أخطاء الكتابة" في Navigation الآن استخدامList<Enum>كنوع وسيطة للمسار بدون الحاجة إلى أيّNavTypeمخصّص. شكرًا لـ Csaba Kozák. (GH-725، b/375559962)
الإصدار 2.9.0-alpha03
13 نوفمبر 2024
تم طرح androidx.navigation:navigation-*:2.9.0-alpha03. يتضمّن الإصدار 2.9.0-alpha03 هذه التعديلات.
الميزات الجديدة
- تتيح ميزة "منع أخطاء الكتابة" في التنقّل الآن استخدام فئات القيم كمسار أو كنوع وسيطة لمسار. (I9344a، b/374347483)
إصلاح الأخطاء
- تم إصلاح
ConcurrentModificationExceptionقد يحدث عندما يؤديLifecycleObserverمرتبط بـNavBackStackEntryإلى تغيير في الأنشطة السابقة عندما يغيّر المضيفLifecycleOwner، مثل النشاط أو الجزء الذي يتضمّنه، حالة دورة حياته. (Ia9494)
الإصدار 2.9.0-alpha02
30 أكتوبر 2024
تم طرح androidx.navigation:navigation-*:2.9.0-alpha02. يتضمّن الإصدار 2.9.0-alpha02 هذه التعديلات.
مساهمة خارجية
- طريقة
NavController.handleDeepLink(request: NavDeepLinkRequest)شائعة جديدة شكرًا لـ "كونستانتين تسخوفريبوف"! (I3e228)
الإصدار 2.9.0-alpha01
16 أكتوبر 2024
تم طرح androidx.navigation:navigation-*:2.9.0-alpha01. يتضمّن الإصدار 2.9.0-alpha01 هذه التعديلات.
الميزات الجديدة
- يمكن الآن لمتصفّحات Custom Navigators وضع علامة على وجهاتها تشير إلى أنّها تنفّذ واجهة
SupportingPane، ما يشير إلىNavControllerبأنّ هذه الوجهات ستظهر إلى جانب وجهات أخرى. باستخدام هذه الواجهة، يمكنRESUMEDوجهات متعددة في الوقت نفسه، على سبيل المثال. (Id5559) - من Navigation
2.8.3: تمت إضافة عمليات تحقّق جديدة من الأخطاء في الوحداتnavigation-commonوnavigation-runtimeوnavigation-composeللمساعدة في تحديد أي مسارات آمنة من حيث النوع لم يتم إضافة تعليقات توضيحية إليها بشكل صحيح باستخدام@Serializable. يتم تطبيق هذا التحقّق على جميع دوال الإضافاتNavGraphBuilderوNavDeepLinkBuilder. (I4a259 وI95402 وIe601a وId8c6e وI28bda وb/362725816) - من Navigation
2.8.3: تمت إضافة عمليات فحص جديدة لبرنامج lint في الوحداتnavigation-commonوnavigation-runtimeوnavigation-composeللمساعدة في تحديد أي مسارات آمنة من حيث النوع تتضمّن وسيطات Enum لم تتم إضافة تعليقات توضيحية إليها بشكل صحيح باستخدام@Keep. يتم تطبيق هذا التحقّق على جميع دوال الإضافاتNavGraphBuilderوNavDeepLinkBuilder. (I4a259، I95402، Ie601a، Id8c6e، I2b46f، b/358687142)
التغييرات في السلوك
- ستؤدي محاولة استخدام
NavControllerتمDESTROYEDسابقًا إلى ظهورIllegalStateException. (I520da، b/369616172)
إصلاح الأخطاء
- تعديل استثناء "لم يتم العثور على فئة Enum" لاقتراح استخدام التعليق التوضيحي
@Keepفي حال محو فئة Enum في الإصدارات التي تمت إزالة البيانات غير الضرورية منها (I90e79، b/358137294)
المشاكل المعروفة
- هناك مشكلة في قواعد lint الجديدة التي تمت إضافتها في الإصدار
Navigation 2.8.*والتي تتسبب في حدوث خطأObsolete custom lint checkعند محاولة تشغيل lint باستخدام الإصدار 8.4 من "المكوّن الإضافي لنظام Gradle المتوافق مع Android" أو الإصدارات الأحدث. (b/368070326، b/371463741)
الإصدار 2.8
الإصدار 2.8.9
12 مارس 2025
تم طرح androidx.navigation:navigation-*:2.8.9. يتضمّن الإصدار 2.8.9 هذه التعديلات.
إصلاح الأخطاء
- تم إصلاح مشكلة تراجُع في الإصدار 2.8.8 من Navigation كانت تتطلّب أن يتطابق الرابط لصفحة معيّنة في التطبيق مع جميع حقول طلب الرابط لصفحة معيّنة في التطبيق أو الغرض منه تمامًا ليتم اعتباره مطابقًا. وأدى ذلك إلى توقّف الروابط لصفحات في التطبيق التي تحتوي على تطابقات جزئية للحقول ولا تحتوي على حقول أخرى. (Ie5e36، b/399826566)
الإصدار 2.8.8
26 فبراير 2025
تم طرح androidx.navigation:navigation-*:2.8.8. يتضمّن الإصدار 2.8.8 هذه التعديلات.
إصلاح الأخطاء
- تم إصلاح خلل يتعلّق بعدم تطابق المسارات التي تحتوي على مسارات أحرف بدل مع رابط لصفحة معيّنة تمت إضافته. (I7ea92، b/389970341)
- تم إصلاح مطابقة
NavDeepLinkحيث يجب أن يتطابق الرابط لصفحة معيّنة وطلب الرابط لصفحة معيّنة تمامًا في معرّف الموارد المنتظم (URI) والإجراء ونوع MIME. لم يعُد يُسمح بالمطابقة إذا تطابق حقل واحد أو حقلان فقط. (I3227f، b/395712033)
المشاكل المعروفة
- بسبب العمل على معالجة الخطأ b/395712033، يُطلب بشكل غير صحيح أن تحتوي الروابط لصفحات معيّنة على جميع الحقول نفسها مثل طلب الرابط لصفحة معيّنة و/أو
Intent. يجب أن تكون الروابط لصفحات معيّنة مطلوبة فقط لمطابقة الحقول التي تحتوي عليها، ويجب تجاهل الحقول غير المضمّنة. تم حلّ هذه المشكلة في إصدار لاحق كجزء من b/399826566.
الإصدار 2.8.7
12 فبراير 2025
تم طرح androidx.navigation:navigation-*:2.8.7. يتضمّن الإصدار 2.8.7 هذه التعديلات.
إصلاح الأخطاء
- توفّر Navigation Safe Args الآن إمكانية استخدام الوجهات القابلة للإنشاء. (I35320، b/362791955)
الإصدار 2.8.6
29 يناير 2025
تم طرح androidx.navigation:navigation-*:2.8.6. يتضمّن الإصدار 2.8.6 هذه التعديلات.
إصلاح الأخطاء
- سيتم تحليل تصنيفات
NavDestinationالمقدَّمة من خلال XML عبرNavType.getلضمان الالتزام بمنطقNavTypeالمخصّص. (Id366d، b/388100796) - عند الانتقال إلى نشاط باستخدام
dataPattern، سيحاولActivityNavigatorالآن ترميز قيمة الوسيطة باستخدامNavTypeللوسيطة. (I1a71d، b/383616432)
الإصدار 2.8.5
11 ديسمبر 2024
تم طرح androidx.navigation:navigation-*:2.8.5. يتضمّن الإصدار 2.8.5 هذه التعديلات.
إصلاح الأخطاء
- تم إصلاح مشكلة حيث يمكن أن يطرح
NavHostاستثناءً داخلPredictiveBackHandlerإذا تم تقليل الأنشطة السابقة إلى إدخال واحد وتم تشغيل زر الرجوع في النظام في الإطار نفسه. (I1a429، b/375343407) - تم إصلاح
NavDestinationNullPointerExceptionعند تعديلstartDestinationللرسم البياني. (I99421، b/361560785) - تم إصلاح مشكلة كانت تؤدي إلى ظهور حركة تغيير حجم غير متوقعة عند استخدام Navigation Compose واستدعاء التنقّل في الإطار نفسه الذي تنتهي فيه الحركة الحالية. (I26cb1، b/353294030)
- تم إصلاح
ConcurrentModificationExceptionقد يحدث عندما يؤديLifecycleObserverمرتبط بـNavBackStackEntryإلى تغيير في الأنشطة السابقة عندما يغيّر المضيفLifecycleOwner، مثل النشاط أو الجزء الذي يتضمّنه، حالة دورة حياته. (Ia9494)
مساهمة خارجية
- تتيح ميزة "منع أخطاء الكتابة" في التنقّل الآن استخدام
List<Enum>كنوع وسيطة للمسار بدون الحاجة إلى أيّNavTypeمخصّص. شكرًا لـ Csaba Kozák. (GH-725، b/375559962)
الإصدار 2.8.4
13 نوفمبر 2024
تم طرح androidx.navigation:navigation-*:2.8.4. يتضمّن الإصدار 2.8.4 هذه التعديلات.
الميزات الجديدة
- من Navigation
2.9.0-alpha03: تتيح ميزة "منع أخطاء الكتابة" في Navigation الآن استخدام فئة القيمة كمسار أو كنوع وسيطة للمسار (I9344a، b/374347483)
إصلاح الأخطاء
- من Navigation
2.9.0-alpha01: ستؤدي محاولة استخدامNavControllerتمDESTROYEDسابقًا إلى ظهورIllegalStateException. (I520da، b/369616172)
الإصدار 2.8.3
16 أكتوبر 2024
تم طرح androidx.navigation:navigation-*:2.8.3. يتضمّن الإصدار 2.8.3 هذه التعديلات.
الميزات الجديدة
- تمت إضافة عمليات فحص جديدة للوحدات
navigation-commonوnavigation-runtimeوnavigation-composeللمساعدة في تحديد أي مسارات آمنة من حيث النوع لم يتم إضافة تعليقات توضيحية إليها بشكل صحيح باستخدام@Serializable. يتم تطبيق هذا التحقّق على جميع دوال الإضافاتNavGraphBuilderوNavDeepLinkBuilder. (I4a259 وI95402 وIe601a وId8c6e وI28bda وb/362725816) - تمت إضافة عمليات تحقّق جديدة من الأخطاء في الوحدات
navigation-commonوnavigation-runtimeوnavigation-composeللمساعدة في تحديد أي مسارات آمنة من حيث النوع تحتوي على وسيطات Enum لم تتم إضافة تعليقات توضيحية إليها بشكل صحيح باستخدام@Keep. يتم تطبيق هذا التحقّق على جميع دوال الإضافاتNavGraphBuilderوNavDeepLinkBuilder. (I4a259، I95402، Ie601a، Id8c6e، I2b46f، b/358687142)
إصلاح الأخطاء
- تم إصلاح مشكلة كانت تؤدي فيها قواعد lint الجديدة التي تمت إضافتها في
Navigation 2.8.*إلى حدوث خطأObsolete custom lint checkعند محاولة تشغيل lint باستخدام الإصدار 8.4 من "المكوّن الإضافي لنظام Gradle المتوافق مع Android" أو الإصدارات الأحدث. (I1be3d، b/368070326، b/371463741)
المشاكل المعروفة
- ستعرض أداة Navigation lint خطأ Obsolete custom lint check (فحص lint مخصّص قديم) عند محاولة تشغيل lint باستخدام Lint 16 (AGP 8.7) أو إصدار أحدث. (b/371926651)
الإصدار 2.8.2
2 أكتوبر 2024
تم طرح androidx.navigation:navigation-*:2.8.2. يتضمّن الإصدار 2.8.2 هذه التعديلات.
الميزات الجديدة
- تتيح ميزة "منع أخطاء الكتابة" في Navigation الآن استخدام فئات Serializable التي تتضمّن
DoubleوDouble?وDoubleArrayوDoubleArray?وList<Double>وList<Double>?بدون الحاجة إلى أيّNavTypeمخصّص. (I570eb، Ibc4c0، I37461، I5bed4، b/359245753)
إصلاح الأخطاء
- تم تحسين رسالة الخطأ التي تظهر عندما يتعذّر على مكوّن Navigation ربط وسيطة مسار بـ
NavType، وستتضمّن رسالة الخطأ الجديدة اسم الوسيطة والاسم المؤهَّل بالكامل للوسيطة والاسم المؤهَّل بالكامل للمسار. (Id8416، b/346264232)
الإصدار 2.8.1
18 سبتمبر 2024
تم طرح androidx.navigation:navigation-*:2.8.1. يتضمّن الإصدار 2.8.1 هذه التعديلات.
الميزات الجديدة
- تمت إضافة قاعدة جديدة للتحقّق من الأخطاء لضمان استخدام دالة
popBackStackالتي تستخدم نوع فئة مُعاد صياغتها عند محاولةpopBackStackباستخدام واجهات برمجة تطبيقات تمنع أخطاء الكتابة. (Ief161، b/358095343)
إصلاح الأخطاء
- يتطلّب التنقّل الآن أن يحتوي المسار الذي تم تمريره إلى
startDestinationفيNavGraphعلى قيم جميع الوسيطات المطلوبة، بما في ذلك الوسيطات التي لا يمكن أن تكون فارغة ولا تحتوي على قيمة تلقائية. (I18e74، b/362594265) - تمّت إضافة ميزة Navigation Safe Args لدعم السلاسل غير القابلة لأن تكون فارغة، بحيث يتم تحليل قيم "null" وتخزينها في الحزمة كما هي، وهذا يختلف عن السلوك الحالي الذي يتم فيه تحليل قيم "null" إلى كائن فارغ. ينطبق هذا التغيير فقط على أنواع السلاسل غير القابلة للإلغاء. تبقى السلاسل التي يمكن أن تكون فارغة بدون تغيير. (I08b4a، b/348936238)
- لم يعُد بالإمكان الربط بـ "
NavDestination" إلا من خلال رابط لصفحة معيّنة تمت إضافته صراحةً إلى الوجهة. يعني هذا أيضًا أنّه لا يمكنك الانتقال إلى مسار وجهة إلا باستخدام دالة التنقّل التي تأخذ مسارًا نصيًا. يؤدي ذلك إلى إصلاح ثغرة أمنية كانت تتيح الربط العميق لوجهة يُحتمل أن تكون محمية. (Ie30e6)
تحديث الاعتماديات
- يعتمد Navigation Safe Args الآن على الإصدار 1.9.24 من Kotlin بدلاً من الإصدار 2.X، ما يضمن عدم إجبار المطوّرين على التحديث. (a4129a)
- يعتمد Navigation Compose الآن على Compose
1.7.2.
الإصدار 2.8.0
4 سبتمبر 2024
تم طرح androidx.navigation:navigation-*:2.8.0. يتضمّن الإصدار 2.8.0 هذه التعديلات.
تغييرات مهمة منذ الإصدار 2.7.0
منع أخطاء الكتابة في Navigation Kotlin DSL
- يوفّر مكوّن Navigation الآن ميزة "منع أخطاء الكتابة" للغة DSL في Kotlin (التي يستخدمها Navigation Compose) باستخدام Kotlin Serialization للسماح لك بتحديد الوجهات في الرسم البياني للتنقّل من خلال فئات البيانات والعناصر التي تمنع أخطاء الكتابة:
// Define a home destination that doesn't take any arguments
@Serializable
object Home
// Define a profile destination that takes an ID
@Serializable
data class Profile(val id: String)
// Now define your NavHost using type safe objects
NavHost(navController, startDestination = Home) {
composable<Home> {
HomeScreen(onNavigateToProfile = { id ->
navController.navigate(Profile(id))
})
}
composable<Profile> { backStackEntry ->
val profile: Profile = backStackEntry.toRoute()
ProfileScreen(profile)
}
}
لمزيد من المعلومات، يُرجى الاطّلاع على منشور المدوّنة حول ميزة Navigation Compose التي تمنع أخطاء الكتابة.
إيماءة إظهار شاشة الرجوع في Navigation Compose
- تتيح حزمة Navigation Compose الآن استخدام ميزة "إيماءة إظهار شاشة الرجوع" داخل التطبيق من خلال واجهات برمجة التطبيقات
SeekableTransitionStateالجديدة من compose-animation. يتيح لك ذلك استخدام إيماءة الرجوع للاطّلاع على الوجهة السابقة من خلال الانتقال المخصّص قبل اختيار إكمال العملية من خلال الإيماءة المكتملة أو إلغائها.
Navigation Fragment Composable
- تمت إضافة عنصر
navigation-fragment-composeجديد يتضمّن بديلاً لـComposableNavHostFragmentفيNavHostFragmentيتيح لك إضافة وجهات قابلة للإنشاء إلى ملفات XML الخاصة بالتنقّل. يجب التعبير عن كل وجهةcomposableكطريقة@Composableذات مستوى أعلى وبدون وسيطة، ويتم استخدام اسمها المؤهَّل بالكامل كسمةandroid:nameفي كل وجهة. وعند الانتقال إلى إحدى هذه الوجهات، يتم إنشاء جزء يحتوي على المحتوى القابل للإنشاء لعرضه.
// In HomeScreen.kt
@Composable
fun HomeScreen() {
// Your Composable content here
}
// In your navigation.xml
<composable
android:id="@+id/home_screen"
android:name="com.example.HomeScreenKt\$HomeScreen" />
التغييرات الأخرى
- يعتمد Navigation Compose الآن على Compose 1.7.0.
- توفّر ميزة "التنقّل" الآن فئة
CollectionNavType<T>جديدة، وهي فئة فرعية منNavType<T>للوسيطات المستندة إلى المجموعات، مثل القوائم والصفائف والخرائط. أصبحت جميع مصفوفاتNavTypeالتلقائية (IntArrayTypeوLongArrayTypeوFloatArrayTypeوBoolArrayTypeوStringArrayType) تكتسب الآن من هذه الفئة الجديدة. - يتيح
NavTypeالآن استخدام قوائم Int وString وBoolean وFloat وLong.
الإصدار 2.8.0-rc01
21 أغسطس 2024
تم طرح androidx.navigation:navigation-*:2.8.0-rc01. يتضمّن الإصدار 2.8.0-rc01 هذه التعديلات.
إصلاح الأخطاء
- تم إصلاح تعطُّل التنقّل عند تمرير فئات التعداد ذات المستوى الأعلى كوسيطات تمنع أخطاء الكتابة. (I0ba76، b/358137294)
- يعمل الإصدار 2.8 من Navigation الآن بشكل صحيح مع الإصدار 34 من حزمة تطوير البرامج (SDK)، ولن يتم التبديل إلى الإصدار 35 من حزمة تطوير البرامج (SDK) حتى إصدار 2.9 مع بقية مكتبات AndroidX. (b/358798728)
الإصدار 2.8.0-beta07
7 أغسطس 2024
تم طرح androidx.navigation:navigation-*:2.8.0-beta07. يتضمّن الإصدار 2.8.0-beta07 هذه التعديلات.
المشاكل المعروفة
- بسبب b/358137294، لا تتوفّر تلقائيًا سوى التعدادات المضمّنة في فئة أخرى. ستتم إتاحة استخدام التعدادات ذات المستوى الأعلى في الإصدار التالي.
إصلاح الأخطاء
- عند الانتقال إلى وجهات مكرّرة أو مشتركة، ستعطي ميزة التنقّل الأولوية للانتقال إلى أقرب وجهة مطابقة من الموقع الجغرافي الحالي في الرسم البياني. (Ic89a4، b/352006850)
- تمت إضافة
NavType.EnumTypeجديد إلى Navigation Safe Args. يعني ذلك أنّ أنواعEnumلم تعُد تتطلّبNavTypeمخصّصة. يُرجى العِلم أنّSerialNameفيEnumيجب أن يكون الاسم التلقائي المؤهَّل بالكامل. (I66d22، b/346475493) - تمت إضافة ميزة Navigation في Safe Args لتوفير دعم مضمّن لأنواع الوسيطات التي يمكن أن تكون فارغة، بما في ذلك
Int?وLong?وFloat?وBoolean?وEnum<*>?. (I32d13،I1c580،Ifba66،I978b0،Ide076 , b/351994237) - سيستخدم الآن
startDestinationفيNavGraphقيم الوسيطات التلقائية إذا كان مسارstartDestinationالذي تم تمريره إلىNavGraphيساويstartDestination.routeتمامًا. (I13762، b/354046047)
الإصدار 2.8.0-beta06
24 يوليو 2024
تم طرح androidx.navigation:navigation-*:2.8.0-beta06. يتضمّن الإصدار 2.8.0-beta06 هذه التعديلات.
إصلاح الأخطاء
- تم إصلاح مشكلة عدم تحقّق عمليات فحص أداة التحقّق من الأخطاء في
WrongStartDestinationTypeمن عناصر Companion في نوع الفئة الذي تم تمريره، ما يؤدي إلى تعذُّر اكتشاف الخطأ في أداة التحقّق من الأخطاء. (I92b09)
الإصدار 2.8.0-beta05
10 يوليو 2024
تم طرح androidx.navigation:navigation-*:2.8.0-beta05. يتضمّن الإصدار 2.8.0-beta05 هذه التعديلات.
إصلاح الأخطاء
- تم إصلاح عطل في التنقّل في
singleTopعندما يتشاركNavGraphsالمتداخلان مسارstartDestinationنفسه. (I17b94، b/294408596)
الإصدار 2.8.0-beta04
26 يونيو 2024
تم طرح androidx.navigation:navigation-*:2.8.0-beta04. يتضمّن الإصدار 2.8.0-beta04 هذه التعديلات.
إصلاح الأخطاء
- يتيح مكوّن Navigation الآن التنقّل باستخدام سلاسل فارغة في وسيطات المسار. (Ic5dbd، b/339481310)
- تم تحسين رسالة الخطأ الخاصة بأدوات التسلسل المخصّصة التي يتم الإعلان عنها مباشرةً في حقول الفئات من خلال
@Serializable(with =...)لتوضيح أنّ هذه الميزة غير متاحة حاليًا. (I052b0، b/341319151) - يمكن الآن استخدام واجهة برمجة التطبيقات الاختبارية
SavedStateHandleFactoryفي الاختبارات غير المتعلّقة بنظام التشغيل Android، ولكنّها ستتطلّب استخدام Robolectric لإتاحة تحليل الوسيطات باستخدام الحِزم. (I76cdc، b/340966212) - تم إصلاح مشكلة التعطُّل الناتجة عن استعادة الحالة عند استئناف التطبيق بعد إيقاف العملية نهائيًا باستخدام ميزة "التنقّل الآمن من حيث النوع" في Compose. (Ia8f38، b/341801005)
- تم إصلاح مشكلة في Navigation Compose حيث لا يعود
NavBackStackEntryالذي يرجع إليه المستخدم إلى حالة LifecycleRESUMEDبعد إلغاء "إيماءة إظهار شاشة الرجوع". يضمن ذلك أيضًا عودة الوجهة السابقة إلى مكانها بشكل صحيح بدلاً من الانتقال إليه فجأة بعد التمرير السريع. (I97a0c، b/346608857) - عند استخدام ميزة "إيماءة إظهار شاشة الرجوع" مع Navigation Compose، سيتم الآن عرض الوجهة التي يتم إظهارها بترتيب z المناسب، مع عرضها بشكل صحيح فوق الوجهة الواردة. (I2077b، b/345993681)
الإصدار 2.8.0-beta03
12 يونيو 2024
تم طرح androidx.navigation:navigation-*:2.8.0-beta03. يتضمّن الإصدار 2.8.0-beta03 هذه التعديلات.
التغييرات في واجهة برمجة التطبيقات
- يحتوي "
CollectionNavType" على طريقة مجرّدة جديدة من النوع "emptyCollection()". يمكنك إلغاء هذا الإعداد لمعالجة مجموعة فارغة تم تمريرها كوسيطة. (Ie4d84، b/341723133)
إصلاح الأخطاء
- تمت إضافة مستندات حول
NavType.serializeAsValueوserializeAsValuesلتوضيح أنّه يجب ترميز النتائج النهائية باستخدام معرّف الموارد المنتظم (URI). (Ida6bd، b/344943214) - تم إصلاح عطل يحدث عند استدعاء
toRoute<T>باستخدام وسيطةCollectionNavTypeفارغة. عند التنقّل باستخدام قيمة فارغة لـCollectionNavType، ستكون وسيطة الإخراج هي القيمة التلقائية التي تم تحديدها في فئة Serializable، أو القيمة المعروضة لـemptyCollection()في حال عدم توفّر قيمة تلقائية. (I84158، Id630f، b/342672856)
الإصدار 2.8.0-beta02
29 مايو 2024
تم طرح androidx.navigation:navigation-*:2.8.0-beta02. يتضمّن الإصدار 2.8.0-beta02 هذه التعديلات.
إصلاح الأخطاء
- تم إصلاح عطل في
ClassCastExceptionعند استخدامNavBackStackEntry.toRouteمعNavTypeمخصّص يقبل القيمة الفارغة. (I1c29b، b/342239473) - تم إصلاح مشاكل استعادة حالة الأنشطة السابقة في ميزة "التنقّل" التي تحدث عند محاولة استعادة إدخال في الأنشطة السابقة لا يمكن الوصول إليه من خلال رقم التعريف من الوجهة الحالية. بما أنّ المسارات تستند إلى أرقام تعريف، تأثّرت أيضًا الوجهات التي تم إنشاؤها باستخدام المسارات. يؤدي هذا أيضًا إلى إصلاح عطل ناتج عن استدعاء
clearBackStack()الذي واجه المشكلة الأساسية نفسها. (I423c3، b/339908057)
الإصدار 2.8.0-beta01
14 مايو 2024
تم طرح androidx.navigation:navigation-*:2.8.0-beta01. يتضمّن الإصدار 2.8.0-beta01 هذه التعديلات.
التغييرات في واجهة برمجة التطبيقات
- تتضمّن دالة
SavedStateHandle.toRoute()الآن مَعلمةtypeMapلأنواع الوسيطات المخصّصة. (Ie39fb، b/339026523) - تمّت إضافة واجهة برمجة تطبيقات تجريبية إلى
navigation-testingلإنشاءSavedStateHandleمن عنصر Kotlin Serializable. (Id4867، b/339080702)
إصلاح الأخطاء
- تمت إضافة مستندات المَعلمات غير المتوفّرة لدوال Navigation Kotlin DSL. (I26a36)
الإصدار 2.8.0-alpha08
1 مايو 2024
تم طرح androidx.navigation:navigation-*:2.8.0-alpha08. يتضمّن الإصدار 2.8.0-alpha08 هذه التعديلات.
Safe Args في Navigation Compose
- اكتمل العمل على إتاحة ميزة "منع أخطاء الكتابة" في وقت التجميع لكل من Navigation Compose ومستخدمي Navigation Kotlin DSL استنادًا إلى Kotlin Serialization، وأصبحت واجهات برمجة التطبيقات التي كانت تجريبية في السابق مستقرة الآن. (Iea94d، I0eb0d، I873b7، I3a64b، I6c3a2، I11f0b، Ic3032، I8d394، I95710، Ice060، Id0e55، I45f8b، Idcdaf، If5380، I08b23، Ia5c59، b/188693139)
تستخدم هذه الوظيفة Kotlin Serialization للسماح لك بتحديد الوجهات في الرسم البياني للتنقّل من خلال فئات البيانات والعناصر التي تمنع أخطاء الكتابة:
// Define a home destination that doesn't take any arguments
@Serializable
object Home
// Define a profile destination that takes an ID
@Serializable
data class Profile(val id: String)
// Now define your NavHost using type safe objects
NavHost(navController, startDestination = Home) {
composable<Home> {
HomeScreen(onNavigateToProfile = { id ->
navController.navigate(Profile(id))
})
}
composable<Profile> { backStackEntry ->
val profile: Profile = backStackEntry.toRoute()
ProfileScreen(profile)
}
}
لمزيد من المعلومات، يُرجى الاطّلاع على منشور المدوّنة حول ميزة Navigation Compose التي تمنع أخطاء الكتابة.
الميزات الجديدة
- يوفّر عنصر
navigation-fragment-composeالآن تركيبةLocalFragmentمحلية للطرق القابلة للإنشاء ضمنComposableFragment. (If35e5) - يتيح
NavTypeالآن استخدام قوائم Int وString وBoolean وFloat وLong. (I4b6dd، Ia914c، b/188693139)
الإصدار 2.8.0-alpha07
17 أبريل 2024
تم طرح androidx.navigation:navigation-*:2.8.0-alpha07. يتضمّن الإصدار 2.8.0-alpha07 هذه التعديلات.
الميزات الجديدة
تضيف هذه الميزة عنصر
navigation-fragment-composeجديدًا يتضمّن بديلاً لـComposableNavHostFragmentفيNavHostFragmentيتيح لك إضافة وجهاتcomposableإلى ملفات XML الخاصة بالتنقّل. يجب التعبير عن كل وجهةcomposableكطريقة@Composableذات مستوى أعلى وبدون وسيطة، ويتم استخدام اسمها المؤهَّل بالكامل كسمةandroid:nameفي كل وجهة. وعند الانتقال إلى إحدى هذه الوجهات، يتم إنشاء جزء يحتوي على المحتوى القابل للإنشاء لعرضه. (I0ef2e، b/265480755)// In HomeScreen.kt @Composable fun HomeScreen() { // Your Composable content here }// In your navigation.xml <composable android:id="@+id/home_screen" android:name="com.example.HomeScreenKt\$HomeScreen" />
التغييرات في واجهة برمجة التطبيقات
- تمت مواصلة توفير الدعم لـ Safe Args في Navigation Compose باستخدام نهج يستند إلى Kotlin Serialization. لم تكتمل واجهات برمجة التطبيقات هذه، وتم وضع علامة عليها باستخدام التعليق التوضيحي
ExperimentalSafeArgsApi. ستتم إزالة هذا التعليق التوضيحي عند اكتمال واجهة برمجة التطبيقات بالكامل في إصدار مستقبلي. (Iefd95، I409c8، I5b5ac، I7e753، I960f8، I3eabd، I8ed5a، Ied2c9، I9b73c، I554db، Ib3aba، Ia668d، b/188693139)
الإصدار 2.8.0-alpha06
3 أبريل 2024
تم طرح androidx.navigation:navigation-*:2.8.0-alpha06. يتضمّن الإصدار 2.8.0-alpha06 هذه التعديلات.
التغييرات في واجهة برمجة التطبيقات
- بدأنا في إتاحة استخدام Safe Args في Navigation Compose باستخدام نهج يستند إلى Kotlin Serialization. لم تكتمل واجهات برمجة التطبيقات هذه، وتم وضع علامة عليها باستخدام التعليق التوضيحي
ExperimentalSafeArgsApi. ستتم إزالة هذا التعليق التوضيحي عند اكتمال واجهة برمجة التطبيقات بالكامل في إصدار مستقبلي. (I644e7، I98896، I2a1c5، I43a51، I836a1، Ic5eec، I39407، I24e41، If9e14، Ibb13e، If44d3، Icb70f، I8972f، I1d432، Icf32b، I20a14، I262aa، I7de99، I35990، I1033d، b/188693139)
إصلاح الأخطاء
- يستخدم
NavHostالآنAlignment.TopStartكوسيطة contentAlignment التلقائية. يؤدي ذلك إلى جعلها متوافقة مع الإعداد التلقائي لـ "AnimatedContent" ويصلح بعض حالات الانتقال غير المتوقّع من المركز. (I09e72، b/330111602) - عند استخدام إيماءة إظهار شاشة الرجوع أثناء استخدام Navigation Compose، سيكمل
NavHostالآن عملية الانتقال المخصّصة بشكل صحيح بدلاً من إنهائها على الفور. (I99017، b/327292110)
الإصدار 2.8.0-alpha05
20 مارس 2024
تم طرح androidx.navigation:navigation-*:2.8.0-alpha05. يتضمّن الإصدار 2.8.0-alpha05 هذه التعديلات.
الميزات الجديدة
- يمكنك الآن تمرير الوسيطات إلى
startDestinationفيNavGraphمباشرةً في مسارstartDestinationبدون الاعتماد علىdefaultValue. ينطبق ذلك أيضًا علىNavGraphstartDestinationsالمدمجة. (I0e0b5، b/109505019، b/188693139)
التغييرات في واجهة برمجة التطبيقات
- تمت إضافة فئة
CollectionNavType<T>مجرّدة جديدة، وهي فئة فرعية منNavType<T>للوسيطات المستندة إلى المجموعات، مثل القوائم والصفائف والخرائط. (Ic6d63، b/188693139) - أصبحت جميع مصفوفات
NavTypeالتلقائية (IntArrayTypeوLongArrayTypeوFloatArrayTypeوBoolArrayTypeوStringArrayType) الآن من النوعCollectionNavType(Idcf79، b/188693139) - توفّر
NavTypeالآن واجهة برمجة تطبيقاتvalueEqualsجديدة ومفتوحة تحدّد ما إذا كانت قيمتان من النوع نفسه متساويتَين. (I6cb97، b/327229511)
إصلاح الأخطاء
- تسمح معلمات طلب البحث في الروابط لصفحات في التطبيق الآن بالقيم التي تكون على شكل أقواس متعرجة حول اسم الوسيطة (أي
{argName}) كقيم صالحة لـNavTypesالمستندة إلى السلسلة. يؤدي ذلك إلى حلّ مشكلة اعتبار هذه القيمة غير صالحة (أو عدم توفّر قيمة) لجميع الأنواع. (I18302، b/327274038) - يمكن الآن لدوال
NavControllerالتي تتيح المسارات، مثلnavigateأوpopBackStack، مطابقة المسارات التي تم ملؤها بوسيطات من مصفوفةNavTypesبشكل صحيح. (Iea805، b/327229511)
الإصدار 2.8.0-alpha04
6 آذار (مارس) 2024
تم طرح androidx.navigation:navigation-*:2.8.0-alpha04. يتضمّن الإصدار 2.8.0-alpha04 هذه التعديلات.
الميزات الجديدة
- يمكنك الآن تحديد
SizeTranformللانتقالات في Navigation Compose من خلال تعريفها كجزء من عملية الإعداد للدالتَينcomposableو/أوnavigation. (I91062، b/296912651)
إصلاح الأخطاء
- تم إصلاح مشكلة عدم عرض
NavHostفي Compose Navigation للانتقال بشكل صحيح عند استخدام ميزة "الرجوع" في النظام بدون إيماءة. (Iceeae، b/325998468)
الإصدار 2.8.0-alpha03
21 فبراير 2024
تم طرح androidx.navigation:navigation-*:2.8.0-alpha03. يتضمّن الإصدار 2.8.0-alpha03 هذه التعديلات.
التغييرات في واجهة برمجة التطبيقات
- تم الآن وضع علامة
@MainThreadعلىNavBackStackEntry.savedStateHandleلأنّه يستخدم رمزًا برمجيًا يجب أن يكون في سلسلة التعليمات الرئيسية على أي حال. (Ibb988، b/299523245)
إصلاح الأخطاء
- تم إصلاح مشكلة في ميزة "التنقّل" كانت تؤدي إلى
DESTROYEDNavGraphViewModels في وقت مبكر جدًا لأنّViewModelالإدخال المرتبط لم يكن جزءًا من الحالة المحفوظة. (Ib6bb7، b/317581849)
تحديث الاعتماديات
- يعتمد Navigation Compose الآن على الإصدار 1.7.0-alpha03 من Compose.
الإصدار 2.8.0-alpha02
7 فبراير 2024
تم طرح androidx.navigation:navigation-*:2.8.0-alpha02. يتضمّن الإصدار 2.8.0-alpha02 هذه التعديلات.
الميزات الجديدة
- تتيح حزمة Navigation Compose الآن استخدام ميزة "إيماءة إظهار شاشة الرجوع" داخل التطبيق من خلال واجهات برمجة التطبيقات
SeekableTransitionStateالجديدة من compose-animation. يتيح لك ذلك استخدام إيماءة الرجوع للاطّلاع على الوجهة السابقة من خلال الانتقال المخصّص قبل اختيار إكمال العملية من خلال الإيماءة المكتملة أو إلغائها. (I8b8e9)
الإصدار 2.8.0-alpha01
24 يناير 2024
تم طرح androidx.navigation:navigation-*:2.8.0-alpha01. يتضمّن الإصدار 2.8.0-alpha01 هذه التعديلات.
إصلاح الأخطاء
- تم إصلاح تسرُّب
BackStackStateحيث تؤدي طلباتsaveStateالمتعددة في وجهة معيّنة إلى حفظ حالات متعددة، ولكن يمكن استعادة الحالة الأولى فقط. (I598b0، b/309559751) - تم إصلاح مشكلة عدم عرض الوسيطات غير النصية بشكل صحيح عند استخدام دوال
NavigationUIالمساعدة لتعبئة عنوان أشرطة التطبيقات. (#636، b/316676794)
تحديث الاعتماديات
- يعتمد Navigation Compose الآن على Compose
1.7.0-alpha01لإصلاح مشكلة قد تؤدي إلى ظهور حركة تكبير/تصغير غير متوقّعة. (b/297258205)
مساهمة خارجية
- نشكر SimonMarquis على إصلاح مشكلة العرض للوسيطات غير النصية عند استخدام أدوات المساعدة
NavigationUIلتعبئة عنوان أشرطة التطبيقات.
الإصدار 2.7.7
الإصدار 2.7.7
7 فبراير 2024
تم طرح androidx.navigation:navigation-*:2.7.7. يتضمّن الإصدار 2.7.7 هذه التعديلات.
إصلاح الأخطاء
- تم نقل الإصلاح من Navigation
2.8.0-alpha01: تم إصلاح تسرُّبBackStackStateحيث تؤدي طلباتsaveState()المتعددة علىNavBackStackEntryواحد إلى حفظ حالات متعددة، ولكن يمكن استعادة الحالة الأولى المحفوظة فقط. (I598b0، b/309559751) - تم نقل الإصلاح من Navigation
2.8.0-alpha01: تم إصلاح مشكلة عدم عرض الوسيطات غير النصية بشكل صحيح عند استخدام أدوات المساعدةNavigationUIلتعبئة عنوان أشرطة التطبيقات. (#636، b/316676794)
مساهمة خارجية
- نشكر SimonMarquis على إصلاح مشكلة العرض للوسيطات غير النصية عند استخدام أدوات المساعدة
NavigationUIلتعبئة عنوان أشرطة التطبيقات.
الإصدار 2.7.6
الإصدار 2.7.6
13 ديسمبر 2023
تم طرح androidx.navigation:navigation-*:2.7.6. يتضمّن الإصدار 2.7.6 هذه التعديلات.
إصلاح الأخطاء
- تأخذ دالة
NavGraphequals()الآن في الاعتبار عُقد الرسم البياني الآخر بشكل صحيح بدلاً من عُقد الرسم البياني الذي يتم استدعاؤه فقط. سيضمن ذلك عدم اعتبار الرسوم البيانية التي تحتوي على عُقد ذات معرّفات مختلفة متساوية (I401cb، b/311414915)
الإصدار 2.7.5
الإصدار 2.7.5
1 تشرين الثاني (نوفمبر) 2023
تم طرح androidx.navigation:navigation-*:2.7.5. يتضمّن الإصدار 2.7.5 هذه التعديلات.
تحسينات الأداء
- تم تحسين أداء مقارنة رسمَين بيانيَين بشكل كبير (من حيث الوقت وعدد عمليات التخصيص). وهذا يعني أنّ الطلبات، مثل
setGraph، التي تقارن داخليًا الرسم البياني الجديد بالرسم البياني الحالي تكون أسرع بكثير وتؤدي إلى عدد أقل من اللقطات التي يتم تخطّيها. نشكر ميشال زي على التحليل الشامل الذي أدّى إلى هذا التحسين. (I6ad62) - ستعرض واجهة برمجة التطبيقات
NavHostالآن وجهة البدء في مرحلة الإنشاء الأولى بدلاً من الانتظار حتى المرحلة الثانية لقراءة الحالة المعدَّلة. (I439a7، b/304852206)
إصلاح الأخطاء
- تم إصلاح مشكلة تؤدي إلى إزالة الأنشطة السابقة إذا تم استدعاء
setGraphأكثر من مرة باستخدام الرسم البياني نفسه فقط في حال وجود وجهة في الرسم البياني تحتوي على رابط لاتّخاذ إجراء يربط بين وجهتَين. (Ieaed7) - لن تظهر مربّعات الحوار التي تم الانتقال إليها وإغلاقها بسرعة في قائمة
NavController.visibleEntries. (I67586، b/287969970) - عند إزالة إدخال من أعلى المكدّس ثم إجراء تغيير في الإعدادات، سيتم الآن محو
ViewModelالخاص بالإدخال بشكل صحيح إذا كانت قيمةsaveStateهي "خطأ". (Idf242، b/298164648) - تم إصلاح مشكلة حيث يمكن لـ
NavControllerمعالجة الرابط العميق نفسه أكثر من مرة إذا كانت الأنشطة السابقة فارغة تمامًا قبل تغيير الإعدادات أو الاتصال بـsetGraphفقط عندما يكون لدى Intent الواردة علامةFLAG_ACTIVITY_NEW_TASK. (I73c7f)
تحديثات الاعتماديات
- يعتمد التنقّل باستخدام Fragments الآن على Fragment 1.6.2، ما يحلّ مشكلة عدم محو مثيلات
ViewModelمن الأجزاء المضمّنة عند طلبclearBackStack.
الإصدار 2.7.4
الإصدار 2.7.4
4 أكتوبر 2023
تم طرح androidx.navigation:navigation-*:2.7.4. يتضمّن الإصدار 2.7.4 هذه التعديلات.
الميزات الجديدة
- تمت إضافة ميزة تتيح لـ
popUpToاستخدام المسارات مع الوسيطات للسماح بالرجوع إلى إدخال معيّن يستخدم هذه الوسيطات بالضبط، بما يتوافق مع الميزة المتوفّرة فيpopBackStack. (I731f4، b/299255572)
إصلاح الأخطاء
- تم إصلاح مشكلة تؤدي إلى تعطُّل
FragmentNavigatorعند مقاطعة عملية تنقّل بعملية تنقّل أخرى باستخدامpopUpTo. (I3c848، b/301887045) - تم إصلاح المشكلة المتمثّلة في أنّ الضغط على زر الرجوع في النظام يؤدي إلى عدم تحديث
currentDestinationبشكل صحيح ليتطابق مع الجزء المعروض. (Id0d6c، b/289877514) - ستنتقل دورة حياة
DialogFragmentالآن بشكل صحيح إلى الحالةRESUMEDعند إغلاق مربّع الحوار أعلاه. (I88f0d، b/301811387)
الإصدار 2.7.3
الإصدار 2.7.3
20 سبتمبر 2023
تم طرح androidx.navigation:navigation-*:2.7.3. يتضمّن الإصدار 2.7.3 هذه التعديلات.
إصلاح الأخطاء
- تم إصلاح مشكلة في ميزة "التنقّل باستخدام الأجزاء" (Navigation with Fragments) كانت تؤدي إلى احتواء قائمة
visibleEntriesعلى إدخالات غير صحيحة. (I5caa9، b/288520638) - تم إصلاح مشكلة كانت تؤدي إلى عدم تلقّي وجهة "النافذة العائمة" (أي
DialogsوBottomsheetsوما إلى ذلك) استدعاءRESUMEDفي إحدى مراحل النشاط. (I3b866، b/287505132)
الإصدار 2.7.2
الإصدار 2.7.2
6 سبتمبر 2023
تم طرح androidx.navigation:navigation-*:2.7.2. يتضمّن الإصدار 2.7.2 هذه التعديلات.
إصلاح الأخطاء
- يعتمد Navigation الآن على Lifecycle
2.6.2، ما يؤدي إلى إصلاح التفاعل بينrememberSaveableوNavHostفي Navigation Compose الذي قد يتسبب في عدم استعادة حالةrememberSaveableللوجهات وأي نُسخSavedStateHandleمملوكة لـViewModelبشكل صحيح بعد إيقاف العملية نهائيًا وإعادة إنشائها. (b/298059596، b/289436035) - تم إصلاح مشكلة عند عرض مربّعات حوار متعددة في Navigation Compose في الوقت نفسه، حيث تكون مربّعات الحوار المحجوبة جزئيًا (مثل مربّع الحوار غير الأعلى) في حالة دورة حياة
CREATEDبدلاً من حالةSTARTED. (aosp/2728520، b/289257213) - تم إصلاح مشكلة كانت تحدث عند عرض مربّعات حوار متعددة في Navigation Compose في الوقت نفسه، حيث يؤدي إغلاق مربّع الحوار العلوي إلى توقُّف مربّع الحوار العلوي الجديد في حالة دورة الحياة
STARTEDبدلاً من الانتقال بشكل صحيح إلىRESUMED. (aosp/2629401، b/286371387) - لم يعُد Navigation Safe Args ينشئ مهمته بشكل عاجل إذا لم يتم تنفيذها فعليًا. (I0e385، b/260322841)
تحديث الاعتماديات
- يعتمد Navigation Compose الآن على الإصدار 1.5.1 من Compose.
الإصدار 2.7.1
الإصدار 2.7.1
23 أغسطس 2023
تم طرح androidx.navigation:navigation-*:2.7.1. يتضمّن الإصدار 2.7.1 هذه التعديلات.
إصلاح الأخطاء
- تم إصلاح مشكلة في ميزة "التنقّل" (Navigation) في Compose، حيث كان من الممكن أن يظهر خطأ عند محاولة الوصول إلى
Lifecycle.State.DESTROYEDViewModelعند استخدامScaffold. (I1dc11، b/268422136)
الإصدار 2.7.0
الإصدار 2.7.0
9 أغسطس 2023
تم طرح androidx.navigation:navigation-*:2.7.0. يتضمّن الإصدار 2.7.0 هذه التعديلات.
تغييرات مهمة منذ الإصدار 2.6.0
صور متحرّكة من Accompanist
بعد أن أصبح الإصدار AnimatedContent مستقرًا، تمكّنا من نقل الرمز من Accompanist Navigation Animation إلى Navigation Compose نفسه.
وهذا يعني أنّ جميع ميزات ضبط الانتقالات المخصّصة التي كانت متوفّرة في AnimatedNavHost أصبحت متاحة مباشرةً في NavHost.
لن يتم إجراء أي تغييرات إضافية على Accompanist Navigation Animation، وسنوقفه نهائيًا قريبًا، مع تقديم إرشادات حول كيفية العودة إلى Navigation Compose نفسه، ولكن سيكون ذلك عكس دليل نقل البيانات بدون الحاجة إلى إجراء أي تغييرات أخرى على واجهة برمجة التطبيقات إذا كنت تستخدم حاليًا أحدث إصدار أولي من Accompanist (0.31.2-alpha). (b/197140101)
إصلاح الأخطاء
- يعترض NavHost في Navigation Compose الآن بشكل صحيح مكالمات الرجوع في النظام حتى بعد إيقاف النشاط واستئنافه. (Icb6de، b/279118447)
تحديثات الاعتماديات
- يعتمد التنقّل الآن على الإصدار
1.5.0من Compose بدلاً من الإصدار1.1.0.
الإصدار 2.7.0-rc01
26 تموز (يوليو) 2023
تم طرح androidx.navigation:navigation-*:2.7.0-rc01. يتضمّن الإصدار 2.7.0-rc01 هذه التعديلات.
إصلاح الأخطاء
- تم إصلاح مشكلة احتمال بقاء دالتي lambda في
EnterTransitionوExitTransitionاللتين تم إنشاؤهما كجزء منNavHostفي الذاكرة حتى بعد إزالةNavHostمن التركيب. (I893d0)
المشاكل المعروفة
- هناك مشكلة في Navigation 2.6.x، وهي أنّه عند التنقّل باستخدام popUpTo، قد يحدث
IllegalArgumentException. قد يكون من الممكن تجنُّب هذا الاستثناء من خلال إعادة هيكلة الرسم البياني، على غرار النصيحة المقترَحة هنا. (b/287133013)
الإصدار 2.7.0-beta02
28 حزيران (يونيو) 2023
تم طرح androidx.navigation:navigation-*:2.7.0-beta02. يتضمّن الإصدار 2.7.0-beta02 هذه التعديلات.
إصلاح الأخطاء
- تتضمّن Navigation Compose الآن ترتيب Z الصحيح للانتقالات المخصّصة التي تستخدم التنقّل مع خيار
popUpTo. (/Ib1c3a، b/285153947)
الإصدار 2.7.0-beta01
7 يونيو 2023
تم طرح androidx.navigation:navigation-*:2.7.0-beta01. يتضمّن الإصدار 2.7.0-beta01 هذه التعديلات.
إصلاح الأخطاء
- يعترض
NavHostفي Navigation Compose الآن بشكل صحيح مكالمات الرجوع في النظام حتى بعدSTOPPEDوRESUMEDActivity. (Icb6de، b/279118447)
الإصدار 2.7.0-alpha01
24 مايو 2023
تم طرح androidx.navigation:navigation-*:2.7.0-alpha01. يتضمّن الإصدار 2.7.0-alpha01 هذه التعديلات.
صور متحرّكة من Accompanist
بعد أن أصبح الإصدار AnimatedContent مستقرًا، تمكّنا من نقل الرمز من Accompanist Navigation Animation إلى Navigation Compose نفسه.
وهذا يعني أنّ جميع ميزات ضبط الانتقالات المخصّصة التي كانت متوفّرة في AnimatedNavHost أصبحت متاحة مباشرةً في NavHost.
لن يتم إجراء أي تغييرات إضافية على Accompanist Navigation Animation، وسنوقفه نهائيًا قريبًا، مع تقديم إرشادات حول كيفية العودة إلى Navigation Compose نفسه، ولكن سيكون ذلك عكس دليل نقل البيانات بدون الحاجة إلى إجراء أي تغييرات أخرى على واجهة برمجة التطبيقات إذا كنت تستخدم حاليًا أحدث إصدار أولي من Accompanist (0.31.2-alpha). (b/197140101)
إصلاح الأخطاء
- من Navigation
2.6.0-rc02: تم إصلاح مشكلة في ميزة Navigation in Fragments حيث يؤدي التنقّل باستخدامpopUpToوإزالة جزء من الأنشطة السابقة بدون إعادة إنشاء طريقة عرضه إلى توقُّف زر الرجوع في النظام عن العمل. (Ieb8d4، b/281726455)
تحديثات الاعتماديات
- يعتمد التنقّل الآن على Compose
1.5.0-beta01.
الإصدار 2.6.0
الإصدار 2.6.0
7 يونيو 2023
تم طرح androidx.navigation:navigation-*:2.6.0. يتضمّن الإصدار 2.6.0 هذه التعديلات.
تغييرات مهمة في ميزة "التنقّل" منذ الإصدار 2.5.0
- أصبحت الآن السمة
argumentsفيNavBackStackEntryوالسمةargumentsالتي تم تمريرها إلىOnDestinationChangedListenerمجرد نسخة من الوسيطات غير القابلة للتغيير التي تم إنشاؤها عند الانتقال إلى الوجهة. وهذا يعني أنّ أي تغييرات يتم إجراؤها على هذه الحِزم لن تظهر في عمليات الوصول اللاحقة إلىargumentsأو نُسخOnDestinationChangedListenerالأخرى. - يتيح
NavDeepLinkالآن استخدام القيم التلقائية للصفائف، ما يسمح باستخدام مَعلمات طلب البحث المتكررة التي سيتم ربطها بنوع صفيف الوسيطة. يتضمّنNavTypeالآن أيضًا طريقة تلقائية يمكن إلغاؤها لدمج قيمتَين تم تحليلهما. - يمكن الآن للفئات الفرعية المخصّصة من
NavTypeإلغاءserializeAsValueلتسلسل قيمة في سلسلة، ما يسمح بتسلسل وإلغاء تسلسل (عبرparseValue) بالكامل في فئةNavType. تتجاوزStringTypeالآن هذه الطريقة لاستدعاءUri.encodeفيStringالمحدّد.
تغييرات مهمة في Navigation Compose منذ الإصدار 2.5.0
- عند معاينة دالة مركّبة باستخدام
NavHost، سيتم الآن عرضstartDestinationفي NavGraph تلقائيًا. - تتيح الآن كل من
NavController.popBackStack(route)وNavController.getBackStackEntry(route)وNavController.clearBackStack(route)المسارات التي تحتوي على وسيطات تمت تعبئتها جزئيًا أو كليًا. يُرجى العِلم أنّ الوسيطات يجب أن تتطابق تمامًا مع وسيطات الإدخال. - ستؤدي محاولة إنشاء
NavDeepLinkفارغ باستخدامnavDeepLinkKotlin DSL الآن إلى ظهور تحذير من أداة lint يشير إلى أنّ الرابط العميق يحتاج إلى معرّف موارد منتظم (URI) و/أو إجراء و/أو نوع MIME ليكون صالحًا.
تغييرات مهمة في ميزة "التنقّل باستخدام الأجزاء" منذ الإصدار 2.5.0
- لم يعُد تطبيق "
NavHostFragment" يعترض زر الرجوع في النظام نفسه. يتيح ذلك لـ "FragmentManager" الأساسي معالجة ميزة "الرجوع" في النظام. يسمح هذا الإجراء لـ Fragment1.7.0-alpha01والإصدارات الأحدث بتوفير حركة "إيماءة إظهار شاشة الرجوع" داخل التطبيق على أجهزة Android U. - عند استخدام ميزة "التنقّل" مع "الأجزاء"، ستؤدي محاولة إجراء
FragmentTransactionيدويًا لإضافة جزء إلى الأنشطة السابقة فيFragmentManagerإلى ظهورIllegalArgumentException. يجب دائمًا إضافة الأجزاء من خلال واجهة برمجة التطبيقاتnavigate(). - عند استخدام السلسلة النصية الدقيقة
${applicationId}كعنصر نائب في السمتَينapp:dataوapp:dataPatternفي عنصر النشاط لملف XML للتنقّل، سيتم ملء العنصر النائب تلقائيًا باستخدامpackageNameالسياق عند التضخيم. - يستخدم
FragmentNavigatorالآن واجهات برمجة التطبيقات الخاصة بالانتقال عند التنقّل وعرضNavBackStackEntries. يعني ذلك أنّNavBackStackEntryLifecycleسينتظر الآن اكتمال المؤثرات الخاصة للدخول والخروج من الجزء قبل نقلLifecycle.Stateالنهائي. - يستخدم
DialogFragmentNavigatorالآن واجهات برمجة التطبيقات الخاصة بالانتقال عند التنقّل وعرضNavBackStackEntries. هذا يعني أنّNavBackStackEntryLifecycleسينتظر الآن انتقالDialogFragmentLifecycleإلىDESTROYEDقبل الانتقال إلىDESTROYEDبنفسه. - يتيح لك
NavHostFragmentالآن استردادNavControllerفور إرفاقNavHostFragmentبـFragmentManager، بدلاً من الانتظار حتىonCreate(). - يعتمد دعم ميزة "التنقّل" لوحدات الميزات الديناميكية الآن على "مكتبة عرض الميزات في Play" الدقيقة.
- يعتمد Navigation Safe Args الآن على الإصدار 7.3.0 من "المكوّن الإضافي لنظام Gradle المتوافق مع Android". وهذا يعني أنّها متوافقة الآن مع الإصدارات 7.3.0 والإصدارات الأحدث فقط.
تغييرات مهمة في NavigationUI منذ الإصدار 2.5.0
- عند تمرير معرّف رسم بياني للتنقّل إلى
AppBarConfiguration(مثلاً من خلالMenu)، لا يعتبرNavigationUIالآن سوى وجهة البدء لرسم التنقّل هذا كوجهة ذات مستوى أعلى، بدلاً من وضع علامة غير صحيحة على كل وجهة داخل الرسم البياني كوجهة ذات مستوى أعلى. لم يتغيّر سلوك تمرير رقم تعريف وجهة فردية. تتوفّر هذه الوظيفة نفسها للرمز البرمجي الخاص بك من خلال دالةisTopLevelDestinationالجديدة علىAppBarConfiguration. - ستحلّل الآن عمليات دمج
setupWithNavControllerفيNavigationUIللعمل مع شريط التطبيق العلوي قيمR.stringلوسيطاتReferenceTypeالموجودة فيandroid:labelإلى قيم السلسلة بدلاً من إخراج العدد الصحيح للمورد الذي تم إنشاؤه تلقائيًا. - يوفّر
NavigationUIالآن سجلّات عندما يتعذّر عليه التنقّل عبرMenuItemمحدّد.
الإصدار 2.6.0-rc02
24 مايو 2023
تم طرح androidx.navigation:navigation-*:2.6.0-rc02. يتضمّن الإصدار 2.6.0-rc02 هذه التعديلات.
إصلاح الأخطاء
- تم إصلاح مشكلة في ميزة "التنقّل في الأجزاء" (Navigation in Fragments) حيث يؤدي التنقّل باستخدام
popUpToوإزالة جزء من الأنشطة السابقة بدون إعادة إنشاء طريقة عرضه إلى توقُّف زر الرجوع في النظام عن العمل. (Ieb8d4، b/281726455)
الإصدار 2.6.0-rc01
10 مايو 2023
تم طرح androidx.navigation:navigation-*:2.6.0-rc01. يتضمّن الإصدار 2.6.0-rc01 هذه التعديلات.
إصلاح الأخطاء
- تم إصلاح مشكلة في ميزة "التنقّل" (Navigation) باستخدام الأجزاء، حيث تؤدي إزالة جزء من خلال التنقّل باستخدام
popUpToفي الاستدعاء في إحدى مراحل النشاطonResume()إلى حدوثIllegalStateException. (I21884، b/279644470)
الإصدار 2.6.0-beta01
19 أبريل 2023
تم طرح androidx.navigation:navigation-*:2.6.0-beta01. يتضمّن الإصدار 2.6.0-beta01 هذه التعديلات.
الميزات الجديدة
NavBackStackEntryيوفّر الآن عملية تنفيذ مخصّصة لـtoString. (Iff00b)
إصلاح الأخطاء
- عند استخدام ميزة "التنقّل" مع "الأجزاء"، ستؤدي محاولة إجراء
FragmentTransactionيدويًا لإضافة جزء إلى الأنشطة السابقة فيFragmentManagerإلى ظهورIllegalArgumentException. يجب دائمًا إضافة الأجزاء من خلال واجهة برمجة التطبيقاتnavigate(). (I6d38e) - عندما يكون هناك
navigateيضيف إدخالاً وpopBackStackيزيله في الإطار نفسه، سيتم الآن نقل الإدخال العلوي الناتج في الأنشطة السابقة بشكل متّسق إلىRESUMEDLifecycle.State. (Id8067، b/276495952)
الإصدار 2.6.0-alpha09
5 أبريل 2023
تم طرح androidx.navigation:navigation-*:2.6.0-alpha09. يتضمّن الإصدار 2.6.0-alpha09 هذه التعديلات.
إصلاح الأخطاء
- تم إصلاح عمليات التحقّق من المسار غير الصالح، بحيث إذا كان
NavDestinationيحتوي علىNavArgumentغير قابل للإلغاء، يجب أن يحتوي مسار هذه الوجهة على عناصر نائبة للوسيطات التي تحمل الاسم نفسه لـNavArgumentغير القابل للإلغاء. (Ic62bf، b/274697949) - ستتعذّر الآن عمليات التنقّل عبر الروابط لصفحات معيّنة استنادًا إلى
Action/MimeTypeإذا كانت عملية التنقّل لا تتضمّنNavArgumentغير قابل للقيم الفارغة مطلوبًا من قِبلNavDestinationالذي يتطابق معهAction/MimeType. (Ibfa17، b/271777424) - عندما يضبط
NavControllerرسمًا بيانيًا يتضمّن المسار والوجهات نفسها التي يتضمّنها الرسم البياني السابق، يستبدل الآن بشكل صحيح عُقد الرسم البياني الحالية ووجهات الأنشطة السابقة بنُسخ جديدة. يؤدي هذا التحديث إلى إصلاح عطل يحدث عند استخدامonLaunchSingleTopبدون حفظ الحالة في Navigation Compose. يؤدي هذا أيضًا إلى إصلاح خطأ يحدث عند الانتقال إلى وجهات مرتبطة بالرسم البياني الجذر وإنشاء أنشطة سابقة غير صحيحة. (I5bc58، b/275258161، b/275407804)
الإصدار 2.6.0-alpha08
22 مارس 2023
تم طرح androidx.navigation:navigation-*:2.6.0-alpha08. يتضمّن الإصدار 2.6.0-alpha08 هذه التعديلات.
الميزات الجديدة
- يتيح لك
NavHostFragmentالآن استردادNavControllerفور إرفاقNavHostFragmentبـFragmentManager، بدلاً من الانتظار حتىonCreate(). (Ic6382، b/220186282)
إصلاح الأخطاء
- تم إصلاح
NullPointerExceptionعند عرض رسم بياني مدمج يتضمّن وسيطة غير قابلة للإلغاء. (6b3581، b/249988437) - عند استخدام زر الرجوع في النظام بعد التنقّل باستخدام
popUpTo، ستظهر حالةNavControllerفي الإدخال الصحيح. (I3a8ec، b/270447657) - ستُزيل
FragmentNavigatorالآن الإدخالات بشكل صحيح عند إزالة الأنشطة السابقة من خلال زر الرجوع في النظام أوpopBackStack()وما إذا كانت المعاملة تستخدم تأثيرات للجزء أم لا. (I81bdf) - لن تؤدي إضافة أجزاء إلى
FragmentNavigator'sFragmentManagerبدون استخدام التنقّل إلى حدوث عطل بعد الآن. (b17204، b/274167493)
تحديثات الاعتماديات
- يعتمد التنقّل الآن على Lifecycle
2.6.1. (586fe7) - يعتمد مكوّن Navigation الآن على SavedState
1.2.1. (078e4e) - يعتمد مكوّن Navigation الآن على ProfileInstaller
1.3.0. (512f0c)
الإصدار 2.6.0-alpha07
8 مارس 2023
تم طرح androidx.navigation:navigation-*:2.6.0-alpha07. يتضمّن الإصدار 2.6.0-alpha07 هذه التعديلات.
إصلاح الأخطاء
- إنّ صيغ واجهة برمجة التطبيقات
getBackStackEntryوpopBackStackوclearBackStackالتي تستخدم المسارات تستخدم الآن أنماط المسارات مع وسيطات ومعلَمات طلب بحث يمكن أن تكون فارغة (I22294 وb/269302500) - تم إصلاح مشكلة عدم محو الحالة المحفوظة في مدير الأجزاء المرتبط بالأنشطة السابقة التي تم محوها عند استدعاء
clearBackStack()منNavController. (Ic1cce، b/271190202) - تم إصلاح مشكلة في الإصدار 2.6.0-alpha06 كانت تؤدي إلى تمييز
MenuItemغير صحيح فيBottomNavigationViewعند استخدام زر الرجوع في النظام بين علامات التبويب. (I634f6، b/270447657) - تم إصلاح مشكلة في الإصدار 2.6.0-alpha06 تسبّبت في عدم نقل
NavBackStackEntryإلى الحالة RESUMED عند استخدامAnimation. (Ib3589، b/269646882)
الإصدار 2.6.0-alpha06
22 فبراير 2023
تم طرح androidx.navigation:navigation-*:2.6.0-alpha06. يتضمّن الإصدار 2.6.0-alpha06 هذه التعديلات.
الميزات الجديدة
- عند معاينة دالة مركّبة باستخدام
NavHost، سيتم الآن عرضstartDestinationفي NavGraph تلقائيًا. (I2b89f)
التغييرات في واجهة برمجة التطبيقات
- تم الآن إضافة تعليقات توضيحية إلى جميع عمليات التحميل الزائد لـ
NavControllernavigateباستخدام@MainThreadلضمان استدعائها في سلسلة التعليمات الرئيسية. (I2c0b0، b/263427111)
إصلاح الأخطاء
- تم إصلاح عطل يحدث عند محاولة التنقّل أثناء استخدام ميزة "التنقّل الديناميكي في الأجزاء". (I3ee29، b/268360479)
- تم إصلاح الخطأ الذي كان يؤدي إلى عدم تحديث الشريط السفلي إلى العنصر المحدّد الصحيح عند الانتقال إلى جزء آخر من خلال زر الرجوع في النظام (If559f، b/269044426)
المشاكل المعروفة
- عند استخدام ميزة "التنقّل" مع "الأجزاء"، يتعذّر على دورة حياة
NavBackStackEntryالوصول إلىRESUMEDعند استخدام واجهات برمجة التطبيقاتAnimation. (b/269646882) - عند استخدام مكوّن Navigation مع Fragments والتنقّل باستخدام
BottomNavigation، إذا حاولت استعادة أنشطة سابقة تتضمّن إدخالات متعددة، لن يتم تعديلBottomMenuItemبشكل صحيح. (b/270447657) - عند استخدام ميزة "التنقّل" مع "الأجزاء"، بعد استعادة الحالة، لا يتم
DESTROYEDNavBackStackEntryLifecycleعندما يكون الجزء الخاص بهDESTROYED. (b/270610768)
الإصدار 2.6.0-alpha05
8 فبراير 2023
تم طرح androidx.navigation:navigation-*:2.6.0-alpha05. يتضمّن الإصدار 2.6.0-alpha05 هذه التعديلات.
الميزات الجديدة
- تتيح الآن كل من
NavController.popBackStack(route)وNavController.getBackStackEntry(route)وNavController.clearBackStack(route)المسارات التي تحتوي على وسيطات تمت تعبئتها جزئيًا أو كليًا. يُرجى العِلم أنّ الوسيطات يجب أن تتطابق تمامًا مع وسيطات الإدخال. (Iebd28، Ic678c، I3b37b، b/257514373) - يستخدم
FragmentNavigatorالآن واجهات برمجة التطبيقات الخاصة بالانتقال عند التنقّل وعرضNavBackStackEntries. يعني ذلك أنّNavBackStackEntryLifecycleسينتظر الآن اكتمال المؤثرات الخاصة للدخول والخروج من الجزء قبل نقلLifecycle.Stateالنهائي. (I3cb19، b/238686802) - يستخدم
DialogFragmentNavigatorالآن واجهات برمجة التطبيقات الخاصة بالانتقال عند التنقّل وعرضNavBackStackEntries. هذا يعني أنّNavBackStackEntryLifecycleسينتظر الآن انتقالDialogFragmentLifecycleإلىDESTROYEDقبل الانتقال إلىDESTROYEDبنفسه. (I53ee5، b/261213893)
التغييرات في واجهة برمجة التطبيقات
- توفّر
NavigatorStateالآن واجهة برمجة التطبيقاتprepareForTransitionللسماح لـNavigatorبنقلNavBackStackEntriesإلىLifecycle.Stateوسيطة. (I42c21، b/238686802) - يمكنك الآن الوصول إلى الأنشطة السابقة المرتبطة بـ
NavGraphNavigatorأوComposeNavigatorمن خلال سمةbackstack. يعرضComposeNavigatorالآن أيضًا دالة الاستدعاءonTransitionComplete()لوضع علامة علىNavBackStackEntryنفّذ عملية تنقّل أو عمليةpopBackStackعلى أنّها مكتملة. (I02062، I718db، b/257519195)
إصلاح الأخطاء
- لن يتم تنفيذ أي إجراء في حالة Navigator عند استخدام واجهات برمجة التطبيقات
push/popWithTransitionإذا كان يتم التعامل مع الإدخال حاليًا. (Iadbfa، b/261213893) - عند استخدام
launchSingleTopمعNavGraphمدمج، ستتم إضافة جميع الوجهات بدءًا من الوجهة الأصلية إلىstartDestinationبشكل صحيح إلى أعلى حزمة الرجوع. (Id4bea، b/253256629) - سيستبدل التنقّل الآن مثيل
DialogFragmentبشكل صحيح عند التنقّل إلى الوجهة نفسها مع ضبط علامةlaunchSingleTopعلى "صحيح". (I45b5a، b/149572817) - لن يتسبّب SafeArgs في مكوّن Navigation بعد الآن في حدوث خطأ في التجميع عند استخدام وسيطات يبلغ طولها 19 حرفًا بالضبط. (Id60bc، b/257110095)
الإصدار 2.6.0-alpha04
9 نوفمبر 2022
تم طرح androidx.navigation:navigation-*:2.6.0-alpha04. يتضمّن الإصدار 2.6.0-alpha04 هذه التعديلات.
الميزات الجديدة
- يمكن الآن للفئات الفرعية المخصّصة من
NavTypeإلغاءserializeAsValueلتسلسل قيمة في سلسلة، ما يسمح بتسلسل وإلغاء تسلسل (عبرparseValue) بالكامل في فئةNavType. تتجاوزStringTypeالآن هذه الطريقة لاستدعاءUri.encodeفيStringالمحدّد. (Ie5213، b/247637434) - يوفّر
NavigationUIالآن سجلّات عندما يتعذّر عليه التنقّل عبرMenuItemمحدّد. (I2af5a، b/247730357)
إصلاح الأخطاء
- يتم الآن تحليل الروابط لصفحات معيّنة للتنقّل بشكل كسول بدلاً من تحليلها عند إعداد الرسم البياني، ما قد يؤدي إلى تحسين أداء التطبيق عند بدء التشغيل. (Iab0ab)
- تم إصلاح تعطّل ناتج عن الانتقال للأعلى بعد الربط العميق بوجهة تتضمّن وسيطات تلقائية فارغة. (I51c24، b/243183636)
تحديث الاعتماديات
- يعتمد دعم ميزة "التنقّل" لوحدات الميزات الديناميكية الآن على "مكتبة عرض الميزات في Play" الدقيقة. (Ib4ddc)
- يعتمد Navigation Safe Args الآن على الإصدار 7.3.0 من "المكوّن الإضافي لنظام Gradle المتوافق مع Android". وهذا يعني أنّها أصبحت متوافقة فقط مع الإصدارات 7.3.0 والإصدارات الأحدث. (I47e49)
الإصدار 2.6.0-alpha03
24 أكتوبر 2022
تم طرح androidx.navigation:navigation-*:2.6.0-alpha03. يتضمّن الإصدار 2.6.0-alpha03 هذه التعديلات.
إصلاح الأخطاء
- من التنقّل
2.5.3: لن يؤدي استخدامNavHostإلى حدوثNoSuchElementExceptionفي حال عدم توفّر وجهة لإنشاءCrossfade. سيتم الآن تخطّي المقطوعة الموسيقية. (Ieb46e، b/253299416) - من التنقّل
2.5.3: تم إصلاح مشكلة عدم نسيان حالة Compose المحفوظة (مثل استخداماتrememberSaveable) وإزالتها عند إزالة وجهة من الأنشطة السابقة. (I64949)
تحديثات الاعتماديات
- يعتمد التنقّل الآن على Fragment
1.5.4. (Icd424)
الإصدار 2.6.0-alpha02
5 أكتوبر 2022
تم طرح androidx.navigation:navigation-*:2.6.0-alpha02. يتضمّن الإصدار 2.6.0-alpha02 هذه التعديلات.
التغييرات في السلوك
- عند تمرير معرّف رسم بياني للتنقّل إلى
AppBarConfiguration(مثلاً من خلالMenu)، لا يعتبرNavigationUIالآن سوى وجهة البدء لرسم التنقّل هذا كوجهة ذات مستوى أعلى، بدلاً من وضع علامة غير صحيحة على كل وجهة داخل الرسم البياني كوجهة ذات مستوى أعلى. لم يتغيّر سلوك تمرير رقم تعريف وجهة فردية. تتوفّر هذه الوظيفة نفسها للرمز البرمجي الخاص بك من خلال دالةisTopLevelDestinationالجديدة علىAppBarConfiguration. (Ie936e، b/238496771)
إصلاح الأخطاء
- يعتمد مكوّن
navigation:navigation-fragmentالآن على الإصدار1.5.2من Fragment. (I00ba4) - لن يتم تعديل عنصر القائمة المحدّد بعد الآن عند الانتقال إلى وجهة
FloatingWindowمثل مربّع حوار. (I4cde8، b/240308330)
الإصدار 2.6.0-alpha01
7 سبتمبر 2022
تم طرح androidx.navigation:navigation-*:2.6.0-alpha01. يتضمّن الإصدار 2.6.0-alpha01 هذه التعديلات.
الميزات الجديدة
- ستحلّل الآن عمليات دمج
setupWithNavControllerفيNavigationUIللعمل مع شريط التطبيق العلوي قيمR.stringلوسيطاتReferenceTypeالموجودة فيandroid:labelإلى قيم السلسلة بدلاً من إخراج العدد الصحيح للمورد الذي تم إنشاؤه تلقائيًا. (I5f803، b/167959935) - يتيح
NavDeepLinkالآن استخدام القيم التلقائية للصفائف، ما يسمح باستخدام مَعلمات طلب البحث المتكررة التي سيتم ربطها بنوع صفيف الوسيطة. يتضمّنNavTypeالآن أيضًا طريقة تلقائية يمكن إلغاؤها لدمج قيمتَين تم تحليلهما. (Id68c3، b/209977108) - عند استخدام السلسلة النصية الدقيقة
${applicationId}كعنصر نائب في السمتَينapp:dataوapp:dataPatternفي عنصر النشاط لملف XML للتنقّل، سيتم ملء العنصر النائب تلقائيًا باستخدامpackageNameالسياق عند التضخيم. (Iaabde، b/234223561) - ستؤدي محاولة إنشاء
NavDeepLinkفارغ باستخدامnavDeepLinkKotlin DSL الآن إلى ظهور تحذير من أداة lint يشير إلى أنّ الرابط العميق يحتاج إلى معرّف موارد منتظم (URI) و/أو إجراء و/أو نوع MIME ليكون صالحًا. (I08d2f، b/154038883)
التغييرات في واجهة برمجة التطبيقات
- تمت إضافة دالة إضافة جديدة
NavDestinationلتحليل التصنيفات الديناميكية باستخدام وسيطات على شكلandroid:label="{arg}"إلى سلسلة. تتيح هذه الدالة استخدام وسيطاتReferenceTypeمن خلال تحليل قيمR.stringإلى قيم سلاسل. (I07d89، b/236269380)
التغييرات في السلوك
- أصبحت السمة
argumentsفي NavBackStackEntry والسمةargumentsالتي تم تمريرها إلىOnDestinationChangedListenerالآن مجرد نسخة من الوسيطات غير القابلة للتغيير التي تم إنشاؤها عند الانتقال إلى الوجهة. وهذا يعني أنّ أي تغييرات يتم إجراؤها على هذه الحِزم لن تظهر في عمليات الوصول اللاحقة إلىargumentsأو نُسخOnDestinationChangedListenerالأخرى. (I676f5)
إصلاح الأخطاء
- من التنقّل
2.5.2: يحاول التنقّل الديناميكي الآن تثبيت وجهات النشاط من وحدات أخرى بشكل صحيح قبل الانتقال إليها. (Ia2c16، b/240292838) - من Navigation
2.5.2: سيستبدل مكوّن Navigation الآن مثيل Fragment بشكل صحيح عند الانتقال إلى الوجهة نفسها وضبط علامةlaunchSingleTopعلى "صحيح". (I5a2f1، b/237374580) - من Navigation
2.5.2: تم إصلاحIllegalStateExceptionالناتج عن الانتقال إلى رسم بياني مدمج مزدوج يشارك عنصرًا رئيسيًا مع وجهة بدء جديدة منبثقة. (I9f7cb، b/243778589)
الإصدار 2.5
الإصدار 2.5.3
24 أكتوبر 2022
تم طرح androidx.navigation:navigation-*:2.5.3. يتضمّن الإصدار 2.5.3 هذه التعديلات.
إصلاح الأخطاء
- لن يؤدي
NavHostبعد الآن إلى حدوثNoSuchElementExceptionعندما لا تتوفّر وجهة لإنشاءCrossfade. سيتم الآن تخطّي المقطوعة الموسيقية. (Ieb46e، b/253299416) - تم إصلاح مشكلة عدم نسيان حالة Compose المحفوظة (مثل استخدامات
rememberSaveable) وإزالتها عند إزالة وجهة من الأنشطة السابقة. (I64949)
الإصدار 2.5.2
7 سبتمبر 2022
تم طرح androidx.navigation:navigation-*:2.5.2. يتضمّن الإصدار 2.5.2 هذه التعديلات.
إصلاح الأخطاء
- يحاول Dynamic Navigation الآن تثبيت وجهات النشاط من وحدات أخرى بشكل صحيح قبل الانتقال إليها. (Ia2c16، b/240292838)
- سيستبدل مكوّن Navigation الآن مثيل Fragment بشكل صحيح عند الانتقال إلى الوجهة نفسها وضبط العلامة
launchSingleTopعلى "صحيح". (I5a2f1، b/237374580) - تم إصلاح الخطأ
IllegalStateExceptionالناتج عن الانتقال إلى رسم بياني متداخل مزدوج يشارك عنصرًا رئيسيًا مع وجهة بداية جديدة منبثقة. (I9f7cb، b/243778589)
تحديث الاعتماديات
- يعتمد Navigation
2.5.2الآن على Fragment1.5.2. (aosp/2178734)
الإصدار 2.5.1
27 يوليو 2022
تم طرح androidx.navigation:navigation-*:2.5.1. يتضمّن الإصدار 2.5.1 هذه التعديلات.
إصلاح الأخطاء
- لن يتسبب
Navigation Safe Argsبعد الآن في ظهور تحذيرات بشأن الإيقاف النهائي في الفئات التي يتم إنشاؤها عند استخدام أنواع وسيطات مخصّصة يتم حفظها فيBundle. (Id86ed، b/237725966)
تحديثات الاعتماديات
- تعتمد مكتبة Navigation الآن على Lifecycle
2.5.1. (Ib4451) - تعتمد مكتبة Navigation الآن على Activity
1.5.1. (I3efe8) - تعتمد مكتبة Navigation الآن على Fragment
1.5.1. (I56177)
الإصدار 2.5.0
29 يونيو 2022
تم طرح androidx.navigation:navigation-*:2.5.0. يتضمّن الإصدار 2.5.0 هذه التعديلات.
تغييرات مهمة منذ الإصدار 2.4.0
- دمج CreationExtras: أصبح بإمكان
Navigationالآن توفيرViewModelProvider.Factoryبدون حالة من خلالCreationExtrasفي Lifecycle2.5.0.
Navigation SafeArgs
- تمت ترقية اعتمادية
Android Gradle PluginفيNavigation Safe Argsلتعتمد على7.0.4، ما يؤدي إلى إلغاء التوافق مع إصدارات AGP الأقدم من7.0. - تمت إضافة إمكانية استخدام سمة build.gradle لمساحة الاسم بدلاً من applicationId.
التغييرات الأخرى
- لم تعُد واجهة برمجة التطبيقات
visibleEntriesتجريبية، وهي توفّر دالة لاسترداد جميع الإدخالات التي تكون وجهتها مرئية حاليًا وفقًا لـNavController.
الإصدار 2.5.0-rc02
15 يونيو 2022
تم طرح androidx.navigation:navigation-*:2.5.0-rc02. يتضمّن الإصدار 2.5.0-rc02 هذه التعديلات.
إصلاح الأخطاء
- تم إصلاح عطل ناتج عن التبديل السريع بين الوجهات السفلية عند استخدام Navigation Compose
NavHost. (I3979a، b/234054916) - لن يتعطّل
Navigation SafeArgsبعد الآن عند استخدامapplicationIdSuffixومساحة اسم بدون توفّرapplicationId، أو عندما يختلفapplicationIdعن مساحة الاسم. (I754b1، b/233119646) - تتضمّن دالة
NavArgumentالآن دالةtoString()مخصّصة لعرض القيم الداخلية للوسيطة. (I900a8)
الإصدار 2.5.0-rc01
11 مايو 2022
تم طرح androidx.navigation:navigation-*:2.5.0-rc01. يتضمّن الإصدار 2.5.0-rc01 هذه التعديلات.
الميزات الجديدة
- تمت إضافة قاعدة جديدة للتحقّق من الأخطاء البرمجية للتحذير من وضع عناصر
<deeplink>داخل عناصر<activity>في ملفnavigation.xml. (Ic15a5، b/178403185)
إصلاح الأخطاء
- يتم الآن التخلص من النطاقات القابلة للإنشاء في
NavHostوDialogHostبالترتيب المتوقّع، أي يتم التخلص من الدوال المركّبة الداخلية قبل الدوال المركّبة الخارجية. (I157e6) - يستخدم Navigation SafeArgs الآن
PathSensitivity.RELATIVEفيArgumentsGenerationTaskللسماح بإمكانية نقل ذاكرة التخزين المؤقت. وهذا يعني أنّه يمكن الآن إعادة استخدام إدخال ذاكرة التخزين المؤقت من إصدار CI إلى إصدار محلي. (I5f67c، b/173420454) - تم تعديل قاعدة فحص الأخطاء
UnrememberedGetBackStackEntryDetectorلضمان أن طلبrememberالمحيط بطلبgetBackStackEntry()يمرر أيضًا كائنNavBackStackEntryكمفتاح.(Ib7081، b/227382831)
الإصدار 2.5.0-beta01
20 أبريل 2022
تم طرح androidx.navigation:navigation-*:2.5.0-beta01. يتضمّن الإصدار 2.5.0-beta01 هذه التعديلات.
إصلاح الأخطاء
- يستخدم "
DialogNavigator" الآن "popWithTransition" عند تنفيذ طلب "dismiss()". يؤدي ذلك إلى إصلاح حالة السباق عند استخدامViewModelضمن وجهةdialog، ما قد يؤدي إلى حدوثIllegalStateExceptionعند إغلاق مربّع الحوار إما باستخدام زر الرجوع في النظام أو النقر خارج مربّع الحوار للخروج. (Id7376، b/226552301)
تحديثات الاعتماديات
- يعتمد التنقّل الآن على Lifecycle
2.5.0-beta01، ما يؤدي إلى إصلاحIllegalStateExceptionعند دمجNavHostواحد داخلNavHostآخر في علامة تبويب شريط التنقّل السفلي غير الأساسية عند استخدام أنشطة سابقة متعددة.
الإصدار 2.5.0-alpha04
6 أبريل 2022
تم طرح androidx.navigation:navigation-*:2.5.0-alpha04. يتضمّن الإصدار 2.5.0-alpha04 هذه التعديلات.
التغييرات في واجهة برمجة التطبيقات
- لم يعُد "
visibleEntries" ميزة تجريبية. (I4829f، b/225394514)
إصلاح الأخطاء
- يعتمد NavHost الآن على
visibleEntriesمنNavControllerلتحديد الإدخالات التي سيتم إنشاؤها. ويعني ذلك أنّه عند استخدام NavHost مدمج، من المفترض أن يتم الآن عرضNavHostالداخلي بشكل صحيح. (I4ba2b، b/225394514) - يستند الآن
visibleEntriesStateFlowالمقدَّم منNavControllerإلى الحد الأقصى لحالة مراحل النشاط عند الإدخال بدلاً من حالة مراحل النشاط الحالية. يعني ذلك أنّه حتى إذا انخفضت دورة حياة المضيف فيnavControllerعن STARTED، ستظل قائمة الإدخالات المرئية كما هي. (I9e2a8، b/225394514) - يتيح
SavedStateViewFactoryالآن استخدامCreationExtrasحتى عند إعداده باستخدامSavedStateRegistryOwner. إذا تم توفير إضافات، يتم تجاهل الوسيطات التي تم إعدادها. (I6c43b، b/224844583) - يمكن الآن لـ
NavDeepLinkتحليل معرّفات الموارد المنتظمة (URI) باستخدام مَعلمة طلب بحث واحدة بدون قيمة. (I0efe8، b/148905489) - أصبحت السلسلة الفارغة تُعتبر الآن وسيطة صالحة في الروابط العميقة. (I70a0d، b/217399862)
- لن يتعطّل "
Navigation Safe Args" بعد الآن عند استخدام مساحات الاسم وعدم توفّر "AndroidManifest.xml". (I17ccf، b/227229815)
الإصدار 2.5.0-alpha03
23 فبراير 2022
تم طرح androidx.navigation:navigation-*:2.5.0-alpha03. يتضمّن الإصدار 2.5.0-alpha03 هذه التعديلات.
التغييرات في واجهة برمجة التطبيقات
- يمكنك الآن تمرير
CreationExtrasإلىby navGraphViewModelsلإنشاءViewModel. (I29217، b/217618359)
إصلاح الأخطاء
- يتيح
NavDeepLinksالآن استخدام أحرف السطر الجديد المرمّزة والمضمّنة في المسارات أو معرّفات الموارد المنتظمة (URI) للروابط لصفحات معيّنة. (I513d1، b/217815060) - ستعمل
CreationExtrasالآن بشكل صحيح عند استخدامها معNavBackStackEntriesلإنشاء ViewModels. (I69161، b/217617710) - يتيح مكوّن Navigation Safe Args الآن استخدام مساحة الاسم المحدّدة في
build.gradleبدلاً من الحزمة في AndroidManifest. (I659ef، b/217414933)
الإصدار 2.5.0-alpha02
9 فبراير 2022
تم طرح androidx.navigation:navigation-*:2.5.0-alpha02. يتضمّن الإصدار 2.5.0-alpha02 هذه التعديلات.
إصلاح الأخطاء
- من التنقّل
2.4.1: سيضبطNavHostFragmentالآنOnBackPressedDispatcherبشكل صحيح عند استخدام ربط الملفات الشخصية مع الرسوم البيانية المُدمَجة. (Ifbb51، b/214577959) - من Navigation
2.4.1: عند الربط بصفحة معيّنة من خلال عدة عناصرNavGraphمتداخلة، ستتضمّن الأنشطة السابقة الآن وجهات البدء المتوسطة بشكل صحيح. (I504c0، b/214383060)
الإصدار 2.5.0-alpha01
26 يناير 2022
تم طرح androidx.navigation:navigation-*:2.5.0-alpha01. يتضمّن الإصدار 2.5.0-alpha01 هذه التعديلات.
الميزات الجديدة
- يتكامل
NavBackStackEntryالآن مع ViewModel CreationExtras، الذي تم تقديمه كجزء من Lifecycle2.5.0-alpha01. (Ib9fe2، b/207012490)
إصلاح الأخطاء
- تم إصلاح مشكلة تعذُّر الوصول إلى
ViewModelتم إنشاؤه عبرby navGraphViewModels()منonCreate()في Fragment مع ظهور رسالة الخطأIllegalStateException. (I8a14d) - لن يفكّ
NavDeepLinks ترميز الوسيطات مرتين بدون داعٍ، ما يعني أنّه يتم الآن تمرير الوسيطات المناسبة إلى وجهتك النهائية. (I31b0a، b/210711399)
Safe Args
- يعتمد Safe Args الآن على الإصدار 7.0.4 من المكوّن الإضافي لنظام Gradle المتوافق مع Android. يعني ذلك أنّ Navigation Safe Args لن يتوافق بعد الآن مع إصدارات "استوديو Android" الأقدم من 7.0، ولكنّه يتوافق الآن مع الإصدار 7.1.0 من "مكوّن إضافي لنظام Gradle المتوافق مع Android" والإصدارات الأحدث. (I41c88، b/213086135، b/207670704)
الإصدار 2.4.2
الإصدار 2.4.2
6 أبريل 2022
تم طرح androidx.navigation:navigation-*:2.4.2. يتضمّن الإصدار 2.4.2 هذه التعديلات.
إصلاح الأخطاء
- تم نقلها من Navigation
2.5.0-alpha03: يتوافقNavDeepLinksالآن بشكل صحيح مع أحرف السطر الجديد المرمّزة والمضمّنة في المسارات أو معرّفات الموارد المنتظمة (URI) للروابط لصفحات معيّنة. (I513d1، b/217815060) - تم نقلها من Navigation
2.5.0-alpha03: تتيح ميزة Navigation SafeArgs الآن استخدام مساحة الاسم المحدّدة فيbuild.gradleبدلاً من الحزمة في AndroidManifest. (I659ef، b/217414933) - تم نقلها من Navigation
2.5.0-alpha04: لن يتعطّلNavigation Safe Argsبعد الآن عند استخدام مساحات الأسماء وعدم توفّرAndroidManifest.xml. (I17ccf، b/227229815) - تم نقلها من Navigation
2.5.0-alpha04: أصبحت السلسلة الفارغة تُعتبر الآن وسيطات صالحة في الروابط العميقة. (I70a0d، b/217399862)
الإصدار 2.4.1
الإصدار 2.4.1
9 فبراير 2022
تم طرح androidx.navigation:navigation-*:2.4.1. يتضمّن الإصدار 2.4.1 هذه التعديلات.
إصلاح الأخطاء
- سيضبط
NavHostFragmentالآنOnBackPressedDispatcherبشكل صحيح عند استخدام ربط العرض مع الرسوم البيانية المُدمَجة. (Ifbb51، b/214577959) - عند الربط بصفحة معيّنة من خلال عدة عناصر
NavGraphمتداخلة، ستتضمّن الأنشطة السابقة الآن وجهات البدء المتوسطة بشكل صحيح. (I504c0، b/214383060) - تم نقل الإصلاح من Navigation
2.5.0-alpha01: تم إصلاح مشكلة تعذُّر الوصول إلى ViewModel تم إنشاؤه من خلالby navGraphViewModels()منonCreate()في Fragment مع ظهورIllegalStateException. (I8a14d) - تم نقلها من Navigation
2.5.0-alpha01: لم تعُدNavDeepLinks تفكّ ترميز الوسيطات مرتين بدون داعٍ، ما يعني أنّه يتم الآن تمرير الوسيطات التي تم فك ترميزها بشكل صحيح إلى وجهتك النهائية. (I31b0a، b/210711399) - تم نقل الميزة من Navigation
2.5.0-alpha01: يعتمد Safe Args الآن على الإصدار 7.0.4 من "المكوّن الإضافي لنظام Gradle المتوافق مع Android". وهذا يعني أنّ Navigation Safe Args لن يتوافق بعد الآن مع إصدارات "استوديو Android" الأقدم من 7.0، ولكنه يتوافق الآن مع الإصدار 7.1.0 من "مكوّن Android الإضافي لبرنامج Gradle" والإصدارات الأحدث. (I41c88، b/213086135، b/207670704)
الإصدار 2.4.0
الإصدار 2.4.0
26 يناير 2022
تم طرح androidx.navigation:navigation-*:2.4.0. يتضمّن الإصدار 2.4.0 هذه التعديلات.
تغييرات مهمة منذ الإصدار 2.3.0
- تمت إعادة كتابة جميع عناصر Navigation بلغة Kotlin. وقد أدى ذلك إلى تحسين إمكانية قبول القيم الفارغة للفئات التي تستخدم الأنواع العامة (مثل الفئات الفرعية
NavType). تم نقل جميع دوال إضافة Kotlin التي كانت جزءًا من عناصر-ktxإلى عناصرها الرئيسية المعنيّة. سيستمر نشر عناصر-ktx، ولكنها ستكون فارغة تمامًا. - يحتوي العنصر
navigation-fragmentالآن على عملية تنفيذ مُعدّة مسبقًا لتنسيق من جزأين من خلالAbstractListDetailFragmentالجديد. يستخدم هذا الجزءSlidingPaneLayoutلإدارة جزء القائمة (الذي توفّره الفئة الفرعية) وجزء التفاصيل، والذي يستخدمNavHostFragmentكطريقة تنفيذ، كما هو موضّح في مثال التنفيذ. - توفّر طريقة
currentBackStackEntryAsFlow()فيNavControllerعنصرFlowيتم إصداره كلما تغيّر عنصرNavBackStackEntryالحالي. يمكن استخدام هذا المسار كبديل لإدارةOnDestinationChangedListenerيدويًا. - يتيح NavController الآن إمكانية استرداد قائمة بجميع نُسخ
NavBackStackEntryالمرئية على شكلStateFlowمن خلال السمة التجريبيةvisibleEntries. - أصبح من الممكن الآن توسيع فئة
NavTypeلإنشاء أنواع NavTypes مخصّصة. لا تتوفّر الأنواع المخصّصة إلا عند إنشاء الرسم البياني للتنقّل آليًا، مثلاً من خلال لغة DSL الخاصة بالرسم البياني للتنقّل في Kotlin. توفّر ميزة "التنقّل" الآن واجهتَي برمجة التطبيقات
findStartDestination()وgetHierarchy()اللتين يمكن استخدامهما للمساعدة في تنفيذ واجهة مستخدم مخصّصة للتنقّل. findStartDestination()هي دالة إضافة فيNavGraphتحدّد وجهة البدء الفعلية التي سيتم عرضها عند الانتقال إلى الرسم البياني، حتى إذا كانstartDestinationنفسه عبارة عنNavGraphمدمج. getHierarchy()هي دالة فيNavDestinationيمكن استخدامها للتحقّق مما إذا كانت وجهة معيّنة تقع ضمن التسلسل الهرمي لوجهة أخرى.val matchingRoute: Boolean = destination.hierarchy.any { it.route == routeToFind }تم تعديل طُرق
NavigationUIالتي استخدمتBottomNavigationViewلتستخدم بدلاً من ذلك فئتها العليا التي تم تقديمها في Material1.4.0، NavigationBarView. يتيح ذلك استخدام هذه الطرق معNavigationRailView.عند تضخيم عنصر
<action>عبر XML، يمكن لسمات الصور المتحركة استخدام سمات مأخوذة من المظهر باستخدام بنيةapp:enterAnim="?attr/transitionEnter".تُنشئ Safe Args الآن طريقة
fromSavedStateHandle()لكل فئةNavArgs. (#122، b/136967621)class HomeViewModel(savedStateHandle: SavedStateHandle) : ViewModel() { // Create a HomeDestinationArgs class with type safe accessors for each argument // defined on your destination private val args = HomeDestinationArgs.fromSavedStateHandle(savedStateHandle) }
مسارات التنقّل ولغة DSL في Kotlin
كانت الإصدارات السابقة من Navigation تعتمد على أن يكون لكل وجهة معرّف عدد صحيح ثابت يميّزها عن الوجهات الشقيقة ويسمح لك navigate() إلى تلك الوجهة إما مباشرةً أو من خلال إجراء. على الرغم من أنّ هذا النظام لا يزال صالحًا ومفيدًا، لا سيما في الحالات التي تحدّد فيها الرسم البياني للتنقّل بتنسيق XML ويمكنك استخدام ثوابت R.id التي يتم إنشاؤها تلقائيًا أو Safe Args (التي تستخدم هذه الثوابت لإنشاء الرموز البرمجية في وقت الإنشاء)، إلا أنّ هذا النظام من الأعداد الصحيحة الفريدة لم يلتقط المعنى الدلالي والتعبير اللازمين لإتاحة الرسوم البيانية الديناميكية بالكامل التي يتم إنشاؤها آليًا في وقت التشغيل من خلال Navigation Kotlin DSL.
يقدّم هذا الإصدار خيارًا جديدًا لتحديد وجهة بشكل فريد في رسم بياني للتنقّل من خلال مسارها. المسار هو String يحدّد المسار الفريد المؤدي إلى وجهة معيّنة. تم الآن إيقاف جميع طرق Kotlin DSL التي استخدمت معرّف وجهة واستبدالها بواجهة برمجة تطبيقات مكافئة تستخدم مسارًا.
يجب التعامل مع كل مسار على أنّه جزء "المسار" من Uri الذي يحدّد تلك الوجهة، مثل home وprofile/{userId} وprofile/{userId}/friends وما إلى ذلك. عندما تكون هوية الوجهة مرتبطة بجزء معيّن من المحتوى، يجب أن تكون هذه الوسيطات الديناميكية جزءًا من المسار، مع اتّباع القواعد نفسها المتّبعة في الروابط لصفحات معيّنة الضمنية.
جميع واجهات برمجة التطبيقات NavController التي كانت تستخدم معرّفًا فقط أصبحت الآن تتضمّن وظيفة زائدة تستخدم مسارًا String. ويشمل ذلك navigate() وpopBackStack() وpopUpTo() وgetBackStackEntry().
وقد أدى ذلك إلى بعض التغييرات في واجهة برمجة التطبيقات:
- تم إيقاف سمة
popUpToفي Kotlin على Kotlin DSL نهائيًا لصالحpopUpToId. - تم إيقاف واجهة برمجة التطبيقات
getStartDestination()نهائيًا واستبدالها بواجهة برمجة التطبيقاتgetStartDestinationId().
على عكس التنقّل حسب رقم التعريف، يتّبع التنقّل حسب المسار القواعد نفسها التي تتّبعها الروابط العميقة الضمنية، حيث يمكنك التنقّل مباشرةً إلى أي وجهة في أي رسم بياني مدمج، ما يضمن إمكانية استخدام هذه المسارات في المشاريع المتعدّدة الوحدات بدون إضافة رابط عميق مرئي خارجيًا بشكل صريح إلى كل وجهة.
Navigation Compose
توفّر عناصر navigation-compose إمكانية الدمج بين مكوّن التنقّل وJetpack Compose. وتستخدم دوال @Composable كوجهات في تطبيقك.
يوفّر هذا الإصدار ما يلي:
- دالة مركّبة
NavHostتتيح لك إنشاء رسم بياني للتنقّل من خلال لغة Kotlin DSL، باستخدام وجهتَيcomposableوdialog، بالإضافة إلى إتاحة استخدام أدوات التنقّل الاختيارية، مثل تلك المتوفّرة في Accompanist Navigation Material. - يجب إتاحة التلاشي المتداخل بين الوجهات. يمكن استخدام Accompanist Navigation Animation للتحكّم في انتقالات الدخول والخروج باستخدام واجهات برمجة تطبيقات Compose التجريبية.
- تحديد نطاق
Lifecycleلكل وجهة قابلة للإنشاء لا تصل كل وجهة إلى الحالةRESUMEDإلا عند انتهاء أي عمليات انتقال واردة، وتنخفض على الفور إلىSTARTEDعند بدء أي عمليات انتقال صادرة، ما يتيح لك تجنُّب جميع مشاكلIllegalStateExceptionواللمس المتعدّد من خلال تشغيل طلبnavigateفقط عندما تكون قيمةLifecycleهيRESUMED. - تحديد نطاق
ViewModel(من خلال واجهة برمجة التطبيقاتviewModel()في Lifecycle ViewModel Compose2.4.0أوhiltViewModel()في Hilt Navigation Compose1.0.0على مستوى الوجهة، ما يوفّر نطاقًا يستمر بعد تغييرات الإعدادات ويظل في الأنشطة السابقة (عند التخلص من المحتوى القابل للإنشاء) وإشارة فيonCleared()في ViewModel تشير إلى التخلص الدائم من الحالة المرتبطة بـNavBackStackEntryوتنظيفها. - تحديد نطاق حالة
rememberSaveableعلى مستوى الوجهة، ما يضمن حفظ جميع الحالات القابلة للتركيب واستعادتها تلقائيًا عند العودة إلى وجهة معيّنة - دعم كامل لحفظ حالة
NavControllerوحالة وجهتها واستعادتها بعد إيقاف العملية نهائيًا وإعادة إنشائها - الدمج التلقائي مع زر الرجوع في النظام
إتاحة تمرير الوسيطات وإرفاق روابط لصفحات معيّنة بالوجهات وإرجاع نتيجة إلى الوجهات السابقة
توفير أدوات مساعدة محدّدة في
rememberNavController()وcurrentBackStackEntryAsState()للسماح برفع الحالة وربطNavControllerبالدوال المركّبة خارجNavHost(مثل شريط التنقّل السفلي)
val navController = rememberNavController()
Scaffold { innerPadding ->
NavHost(navController, "home", Modifier.padding(innerPadding)) {
composable("home") {
// This content fills the area provided to the NavHost
HomeScreen()
}
dialog("detail_dialog") {
// This content will be automatically added to a Dialog() composable
// and appear above the HomeScreen or other composable destinations
DetailDialogContent()
}
}
}
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التنقّل في Compose.
الأنشطة السابقة المتعددة
NavController مسؤول عن إدارة الأنشطة السابقة للوجهات، وإضافة الوجهات إلى الأنشطة السابقة عند navigate() إليها وإزالتها عند استدعاء popBackStack() أو تفعيل زر الرجوع في النظام. تم توسيع فئة NavOptions الحالية والدمج في عناصر <action> في ملف XML الخاص بالرسم البياني للتنقّل لإتاحة حفظ الأنشطة السابقة واستعادتها.
كجزء من هذا التغيير، تحفظ الآن طرق NavigationUI في onNavDestinationSelected() وBottomNavigationView.setupWithNavController() وNavigationView.setupWithNavController() حالة الوجهات المنبثقة وتستعيدها تلقائيًا، ما يتيح استخدام أنشطة سابقة متعددة بدون أي تغييرات في الرمز البرمجي. عند استخدام ميزة "التنقّل" مع "الأجزاء"، هذه هي الطريقة المقترَحة للدمج مع أنشطة سابقة متعددة.
يتم عرض واجهات برمجة التطبيقات الأساسية لحفظ الحالة واستعادتها من خلال عدد من مساحات العرض:
في Navigation XML، يمكن الآن لعنصر
<action>استخدام السمتَين المنطقيتَينapp:popUpToSaveStateوapp:restoreStateلحفظ حالة أي وجهات تم إظهارها من خلالapp:popUpToواستعادة الحالة المرتبطة بالوجهة التي تم تمريرها على أنّهاapp:destination:<action android:id=”@+id/swap_stack” app:destination=”@id/second_stack” app:restoreState=”true” app:popUpTo=”@id/first_stack_start_destination” app:popUpToSaveState=”true” />في
navOptionsKotlin DSL، يمكنك إضافة السمة المنطقيةrestoreStateوالسمة المنطقيةsaveStateإلى أداة الإنشاءpopUpTo:// Use the navigate() method that takes a navOptions DSL Builder navController.navigate(selectedBottomNavRoute) { launchSingleTop = true restoreState = true popUpTo(navController.graph.findStartDestination().id) { saveState = true } }عند إنشاء عنصر
NavOptionsيدويًا من خلالNavOptions.Builder، يمكنك استخدامsetRestoreState()والتحميل الزائد الجديد إلىsetPopUpTo()الذي يتطلّب مَعلمةsaveStateإضافية.NavOptions navOptions = new NavOptions.Builder() .setLaunchSingleTop(true) .setRestoreState(true) .setPopUpTo(NavGraph.findStartDestination(navController.getGraph()).getId(), false, // inclusive true) // saveState .build(); navController.navigate(selectedBottomNavId, null, navOptions);يمكن الآن أن تتضمّن الطلبات الآلية إلى
popBackStack()مَعلمةsaveStateإضافية.يمكنك استخدام طريقة
clearBackStack()لمحو أي حالة تم حفظها باستخدامpopBackStack()أوpopUpToSaveState.
في جميع الحالات، سيحفظ NavController حالة كل NavBackStackEntry ويستعيدها، بما في ذلك أي نُسخ ViewModel ضمن نطاق وجهة التنقّل. تم تعديل واجهات برمجة تطبيقات Navigator لتمكين كل Navigator من إتاحة حفظ حالته واستعادتها.
التغييرات في السلوك
- يضيف
NavDeepLinkBuilderالآنPendingIntent.FLAG_IMMUTABLEإلىPendingIntentالتي يعرضهاcreatePendingIntent()، ما يضمن عمل واجهة برمجة التطبيقات هذه على النحو المتوقّع عند استهداف Android 12. - يعتمد التنقّل الآن على
Lifecycle
2.3.1ويصنّف الآنsetGraph()وpopBackStack()وnavigateUp()وnavigate()، وهي الطرق التي تعدّلNavBackStackEntryLifecycle، على أنّها@MainThread، ما يؤدي إلى مواءمة التنقّل مع فرض سلسلة التعليمات الرئيسية التي تم تقديمها في Lifecycle2.3.0. - تتحقّق الروابط لصفحات معيّنة الآن من توفّر جميع الوسيطات المطلوبة (التي لا تتضمّن قيمًا تلقائية) في
Uri. NavDeepLinkأصبحت الوسيطات التي تم تحليلها الآن تعتبر علامات الجنيه الإسترليني بنفس طريقة علامات الاستفهام كفاصل بين أجزاء المسار، مما يمنع الوسيطة من الامتداد عبر علامة الجنيه الإسترليني.- عند إنشاء الإجراءات، يضع رمز Kotlin الذي تم إنشاؤه من Safe Args الآن الوسيطات التي لا تتضمّن قيمًا تلقائية قبل تلك التي تتضمّن قيمًا تلقائية كمَعلمات.
- عند إنشاء الوسيطات، يضع Safe Args الآن المَعلمات التي لا تتضمّن قيمًا تلقائية قبل تلك التي تتضمّن قيمًا تلقائية.
- يعتمد Safe-Args الآن على الإصدار 4.2.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android. هذا يعني أنّه من المفترض ألا يظهر لك تحذير بشأن استخدام
applicationIdTextResource.
المشاكل المعروفة
- تم إصلاح مشكلة في Navigation
2.5.0-alpha01: يتعذّر الوصول إلىViewModelتم إنشاؤه من خلالby navGraphViewModels()منonCreate()الخاص بـ Fragment مع ظهورIllegalStateException. (b/213504272) - تم إصلاح المشكلة في Navigation
2.5.0-alpha01: الإصدار 2.4.0 من Safe Args غير متوافق مع الإصدار 7.1.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android والإصدارات الأحدث. (b/213086135) - لا يؤدي الربط بصفحات معيّنة باستخدام عدة رسومات بيانية للتنقّل مدمجة إلى إنشاء حزمة خلفية كاملة بشكل صحيح. (b/214383060)
الإصدار 2.4.0-rc01
15 ديسمبر 2021
تم طرح androidx.navigation:navigation-*:2.4.0-rc01. يتضمّن الإصدار 2.4.0-rc01 هذه التعديلات.
التغييرات في السلوك
NavDeepLinkأصبحت الوسيطات التي تم تحليلها الآن تعتبر علامات الجنيه الإسترليني بنفس طريقة علامات الاستفهام كفاصل بين الوسيطات. (I21309، b/180042703)
إصلاح الأخطاء
- لن تتجاهل الروابط لصفحات معيّنة بعد الآن الوسيطات التي تتضمّن قيمًا مماثلة لاسم العنصر النائب. (If8017، b/207389470)
- لن يتعطّل "
NavController" بعد الآن عند إزالة وجهة مدمجة باستخدام الانتقالات بعد استعادة "NavController". (I0f7c9، b/205021623) - ستظهر رسالة الخطأ عند استخدام
startDestinationغير صالح تلقائيًا في مسار وجهة البدء إذا كان متاحًا. (I86b9d، b/208041894)
إصلاح الأخطاء في Navigation Compose
- تم إصلاح عطل محتمل ناتج عن التبديل السريع بين وجهة البدء ووجهة أخرى باستخدام عناصر قائمة التنقّل في أسفل الشاشة. (Ic8976، b/208887901)
- تتم الآن استعادة وجهة مربّع الحوار بشكل صحيح في أعلى الشاشة بعد تغييرات الإعدادات أو إيقاف العملية نهائيًا. (I4c0dc، b/207386169)
- تم إصلاح مشكلة تعذُّر استرداد
ViewModelمنNavBackStackEntryفي مربّع حوار عند إغلاق مربّع الحوار. (I6b96d، b/206465487) - تم إصلاح مشكلة كانت تحدث عند استخدام وجهات
activityمعNavHostفي Navigation Compose، ما يؤدي إلى إعادة إنشاء لا نهائية. (I8f64c) - تم إصلاح تسرُّب في Navigation Compose حيث كان يحتفظ بمرجع للنشاط القديم بعد تغيير في الإعدادات أو إيقاف العملية نهائيًا. (I4efcb، b/204905432)
إصلاح الأخطاء في Safe Args
- لم يعُد تطبيق "
SafeArgs" يتعطّل عند محاولة استعادة مصفوفات Parcelable المخصّصة بعد إيقاف العملية نهائيًا. (I618e8، b/207315994) - تم إصلاح خلل في Safe Args كان يمنع مصفوفات القيم المنطقية من الحصول على قيمة
null. (I8c396، b/174787525)
الإصدار 2.4.0-beta02
3 نوفمبر 2021
تم طرح androidx.navigation:navigation-*:2.4.0-beta02. يتضمّن الإصدار 2.4.0-beta02 هذه التعديلات.
التغييرات في واجهة برمجة التطبيقات
- عند التعامل مع الروابط العميقة الصريحة والضمنية، تتم الآن إضافة العلامة
saveStateتلقائيًا عند الانتقال إلى رسم بياني آخر، ما يضمن عمل الرموز البرمجية مثلNavigationUI.setupWithNavControllerوالرموز البرمجية التي تستخدم أنشطة سابقة متعددة على النحو المتوقّع. (Ic8807)
التغييرات في السلوك
- يتم الآن تجميع أنماط الروابط العميقة بشكل كسول في NavDeepLink بدلاً من تجميعها أثناء التضخيم. من المفترض أن يؤدي ذلك إلى تحسين وقت تضخيم الرسوم البيانية للتنقّل التي تتضمّن روابط لصفحات في التطبيق. (b8d257، b/184149935)
إصلاح الأخطاء
- تم إصلاح مشكلة كانت تؤدي إلى نقل NavBackStackEntries إلى
Lifecycle.State.CREATEDبعد الانتقال إلىLifecycle.State.STARTEDعند إضافةNavHostمباشرةً إلىsetContent()الخاص بالنشاط. (Ia5ac1، b/203536683) - تم إصلاح حالة السباق التي كانت تؤدي إلى عدم إغلاق مربّع الحوار عند إزالة وجهة
DialogFragmentمن الأنشطة السابقة قبل ظهور مربّع الحوار فعليًا، ما يؤدي إلى حدوث عطل عند إغلاق مربّع الحوار الخاطئ يدويًا من قِبل المستخدم. (I687e5) - تم إصلاح مشكلة تؤدي إلى عرض واجهة برمجة التطبيقات
onNavDestinationSelectedعلىNavigationUIالقيمةtrueحتى إذا لم يتم فعليًاnavigate()إلى الرسم البياني للتنقّل. يستخدم الآن المنطق نفسه المستخدَم داخليًا من قِبلsetupWithNavControllerلتحديدMenuItemالمرتبط بالوجهة الحالية فقط باستخدامhierarchyللوجهة. (I2b053)
الإصدار 2.4.0-beta01
27 أكتوبر 2021
تم طرح androidx.navigation:navigation-*:2.4.0-beta01. يتضمّن الإصدار 2.4.0-beta01 هذه التعديلات.
الميزات الجديدة
- يمكنك الآن استخدام
by navGraphViewModelمع مسار كبديل لاستخدام معرّف، وذلك لإتاحة استخدام Navigation Kotlin DSL مع Fragments بشكل أفضل. (I901e3، b/201446416)
التغييرات في واجهة برمجة التطبيقات
- أصبحت واجهة برمجة التطبيقات
visibleEntriesتجريبية الآن. (I93f6f)
إصلاح الأخطاء
- لن يتم تدمير ViewModels بعد الآن عند مقاطعة عمليات الانتقال من خلال التنقّل ذهابًا وإيابًا بين الشاشات نفسها (Id52d8، b/200817333)
- لم تعُد وسيطات
NavDeepLinkالتي تقبل القيمة الفارغة تتطلّب قيمة تلقائية عند إضافة روابط عميقة إلىNavDestination. (I5aad4، b/201320030) - لم يعُد NavBackStackEntries الذي يتضمّن دورات حياة مختلفة يُعتبر متساويًا. هذا يعني أنّ NavHost سيعيد إنشاء جميع الوجهات بشكل صحيح عند التنقّل باستخدام singleTop وعند إعادة اختيار عناصر القائمة السفلية. (I1b351، b/196997433)
- تم إصلاح مشكلة في
AbstractListDetailFragmentتسبّبت في معالجة السمتَينlayout_widthوlayout_weightفي لوحة القائمة التي تعرضها الدالةonCreateListPaneView()بشكل غير صحيح أو تجاهلهما. (f5fbf3) - تظل الحالة المرئية لوجهات مربّعات الحوار الآن
متزامنة بشكل صحيح مع حالة
DialogFragmentNavigator. يعني ذلك أنّ طلب بيانات واجهة برمجة التطبيقات غير المتزامنةdismiss()يدويًا لـDialogFragmentيؤدي الآن إلى محو جميع وجهات مربّعات الحوار أعلى مربّع الحوار الذي تم إغلاقه الآن بشكل صحيح. لا يؤثر ذلك في الحالات التي تستخدم فيهاpopUpToأوpopBackStack()لإغلاق مربّع الحوار. (I77ba2) AbstractAppBarOnDestinationChangedListenerالآن رسائل خطأ أوضح لـonDestinationChanged(). (Ie742d)
الإصدار 2.4.0-alpha10
29 سبتمبر 2021
تم طرح androidx.navigation:navigation-*:2.4.0-alpha10. يتضمّن الإصدار 2.4.0-alpha10 هذه التعديلات.
الميزات الجديدة
- يتيح NavController الآن إمكانية استرداد قائمة بجميع مثيلات
NavBackStackEntryالمرئية من خلالvisibleEntriesStateFlow (Ia964e) - تتلقّى
rememberNavController()الآن مجموعة اختيارية من مثيلاتNavigatorالتي ستتم إضافتها إلىNavControllerالتي يتم عرضها لتوفير دعم أفضل لـ Navigators الاختيارية، مثل تلك الواردة من Accompanist Navigation Material. (I4619e)
إصلاح الأخطاء
- لن يتعطّل التنقّل الديناميكي بعد الآن عند إعادة إنشاء النشاط. (Ifa6a3، b/197942869)
- تم إصلاح مشكلة في زر الرجوع في النظام تحدث فقط بعد الرجوع إلى وجهة قابلة للإنشاء تحتوي على
NavHost. (3ed148، b/195668143) - تُنشئ SafeArgs الآن الوسيطات لـ
fromBundle()وfromSavedStateHandle()بالترتيب الصحيح للمَعلمات. (I824a8، b/200059831)
الإصدار 2.4.0-alpha09
15 سبتمبر 2021
تم طرح androidx.navigation:navigation-*:2.4.0-alpha09. يتضمّن الإصدار 2.4.0-alpha09 هذه التعديلات.
الميزات الجديدة
- يمكنك الآن استخدام طريقة
clearBackStack()لمحو أي حالة تم حفظها باستخدامpopBackStack()أوpopUpToSaveState. (I80a0f) - يمكنك الآن تمرير قائمة بالوسيطات و/أو الروابط المؤدية إلى صفحات معيّنة إلى أداة إنشاء الرسم البياني للتنقّل المُدمَج، وستتم إضافتها تلقائيًا إلى الرسم البياني الناتج. (I8a470، b/182545357)
التغييرات في واجهة برمجة التطبيقات
- أصبحت دالة
navArgumentKotlin DSL الآن جزءًا منnavigation-commonبدلاً منnavigation-compose. سيتطلب ذلك تحديث عمليات الاستيراد لمواصلة استخدام هذه الدالة. (I1d095)
التغييرات في السلوك
- عند إنشاء الوسيطات، يضع Safe Args الآن المَعلمات التي لا تتضمّن قيمًا تلقائية قبل تلك التي تتضمّن قيمًا تلقائية. (I89709، b/198493585)
إصلاح الأخطاء
- عند استخدام Navigation Compose، لن يتم
DESTROYEDNavGraphs إلا بعدDESTROYEDجميع العناصر الفرعية. (I86552، b/198741720) - لم تعد وسيطات
NavDeepLinkالتي تقبل القيمة الفارغة تتطلّب قيمة تلقائية. (Ia14ef، b/198689811) - عند استدعاء
setGraph()باستخدام رسم بياني جديد، سيتم الآن أيضًا محو أي أنشطة سابقة محفوظة، بالإضافة إلى السلوك السابق المتمثّل في إزالة الأنشطة السابقة. (I97f96) - تم إصلاح مشكلة عدم إرسال إشعارات إلى مثيلات
OnDestinationChangedListenerوcurrentBackStackEntryFlowعند استخدامlaunchSingleTop. (Iaaebc)
تحديثات الاعتماديات
- يعتمد Navigation Compose الآن على Activity Compose 1.3.1. (I05829)
- يعتمد Navigation Compose الآن على
Lifecycle ViewModel Compose
2.4.0-beta01. (Ib86a3)
الإصدار 2.4.0-alpha08
1 سبتمبر 2021
تم طرح androidx.navigation:navigation-*:2.4.0-alpha08. يتضمّن الإصدار 2.4.0-alpha08 هذه التعديلات.
الميزات الجديدة
- أصبح من الممكن الآن توسيع فئة
NavTypeلإنشاء أنواع NavTypes مخصّصة. لا تتوفّر الأنواع المخصّصة إلا عند إنشاء الرسم البياني للتنقّل آليًا، مثلاً من خلال لغة DSL الخاصة بالرسم البياني للتنقّل في Kotlin. (I78440، b/196871885)
التغييرات في السلوك
- عند إنشاء الإجراءات، يضع رمز Kotlin الذي تم إنشاؤه من Safe Args الآن الوسيطات التي لا تتضمّن قيمًا تلقائية قبل تلك التي تتضمّن قيمًا تلقائية كمَعلمات. (Idb697، b/188855904)
- تتحقّق الروابط لصفحات معيّنة الآن من توفّر جميع الوسيطات المطلوبة (التي لا تتضمّن قيمًا تلقائية) في
Uri. (#204، b/185527157)
إصلاح الأخطاء
- لن يؤدي استخدام
getBackStackEntryوpreviousBackStackEntryداخل composable() معremember()إلى حدوث استثناء لعدم وجود وجهة في الأنشطة السابقة. (I75138، b/194313238) - تعيد حزمة Navigation Compose الآن إنشاء العناصر بشكل صحيح عند تغيير وسيطات الأنشطة السابقة واستخدام
launchSingleTop=true. (Iebd69، b/186392337) - لن يظهر
ArrayIndexOutOfBoundsExceptionبعد الآن عند استدعاءsetGraphباستخدام رسم بياني يتضمّن 13 أو 29 وجهة. (I1a9f1، b/195171984) - من المفترض ألا يتسبب منشئ SafeArgs java في ظهور تحذيرات lint عند إنشاء فئات Args. (I1a666، b/185843837)
مساهمة خارجية
- نشكر ospixd على التأكّد من أنّ الروابط لصفحات معيّنة في التطبيق تتحقّق من توفّر جميع الوسيطات المطلوبة (التي لا تتضمّن قيمًا تلقائية) في
Uri. (#204، b/185527157)
الإصدار 2.4.0-alpha07
18 أغسطس 2021
تم طرح androidx.navigation:navigation-*:2.4.0-alpha07. يتضمّن الإصدار 2.4.0-alpha07 هذه التعديلات.
إصلاح الأخطاء
- يحفظ Navigation Compose الآن الحالة بشكل صحيح بعد تغييرات الإعدادات وعند تغيير الرسوم البيانية أثناء استخدام ميزة الأنشطة السابقة المتعددة. (If5a3d، b/195141957)
- لن تؤدي إعادة اختيار علامة التبويب نفسها عند استخدام ميزة Navigation Compose مع الأنشطة السابقة المتعددة إلى ظهور شاشة فارغة. (I860dc، b/194925622)
- يراقب "
NavHost" الآن التغييرات في "Lifecycle.State" لـ "NavBackStackEntry"، ما يعني أنّ استخدام "NavHost" في جزء الآن سيؤدي إلى إعادة إنشائه بشكل صحيح مع تغيُّر مراحل النشاط بدلاً من ظهور شاشة فارغة. (I4eb85، b/195864489) - تم إصلاح مشكلة عدم تحديث حالة
NavControllerبشكل صحيح بعد إغلاقDialogFragmentوإعادة إنشاء نشاطك (أي بعد تغيير الإعدادات). (Icd72b) - تم إصلاح مشكلة كانت تؤدي إلى عدم تحديث معالجة زر الرجوع في نظام NavController عند إغلاق وجهة مربّع الحوار، ما قد يؤدي إلى اعتراض NavController لزر الرجوع على الرغم من عدم توفّر أي أنشطة سابقة لإغلاقها. (If3b34)
- تنشئ Safe-args الآن تلقائيًا طريقة
toSavedStateHandleللوسيطات التي يمكن استخدامها لاختبار رمزViewModel. (If1e2d، b/193353880)
الإصدار 2.4.0-alpha06
4 أغسطس 2021
تم طرح androidx.navigation:navigation-*:2.4.0-alpha06. يتضمّن الإصدار 2.4.0-alpha06 هذه التعديلات.
التغييرات في واجهة برمجة التطبيقات
- تمت إعادة تسمية الطريقتَين
requireSlidingPaneLayout()وrequireDetailPaneNavHostFragment()فيAbstractListDetailFragmentإلىgetSlidingPaneLayout()وgetDetailPaneNavHostFragment()على التوالي. (I34a08)
التغييرات في السلوك
- عند التنقّل باستخدام الصور المتحركة (مثل
Crossfade)، لن تصل السمةLifecycleللوجهة الجديدة إلى السمةRESUMEDإلا بعد اكتمال الصورة المتحركة. (If0543، b/172112072، b/194301889) - يضبط
NavHostفي Navigation Compose الآن الرسم البياني كجزء من عملية الإنشاء الأولى. (Ieb7be)
إصلاح الأخطاء
- لم يعُد يؤدي إزالة الوجهة الأخيرة من الرسم البياني للتنقّل إلى ظهور الخطأ
ClassCastException. (If0543، b/172112072، b/194301889) - تم إصلاح
NullPointerExceptionكان يحدث عند إضافة رابط عميق بدونUriوالتنقّل عبر مسار أو رابط عميق. (938a0c، b/193805425) - تم إصلاح مشكلة في Navigation Compose حيث لا يصل
NavBackStackEntryالمرتبط برابط عميق إلى الحالةRESUMED. (I192c5) - تم إصلاح مشكلة كانت تؤدي إلى عدم تحديث معالجة زر الرجوع في نظام NavController عند إزالة وجهة مربّع حوار، ما قد يؤدي إلى اعتراض NavController لزر الرجوع على الرغم من عدم توفّر أي أنشطة سابقة لإزالتها. (aosp/1782668)
الإصدار 2.4.0-alpha05
21 يوليو 2021
تم طرح androidx.navigation:navigation-*:2.4.0-alpha05. يتضمّن الإصدار 2.4.0-alpha05 هذه التعديلات.
التغييرات في السلوك
- يستخدم
NavHostفي Navigation Compose الآن دائمًا ميزة "التلاشي التدريجي" عند التنقّل بين الوجهات. (I07049، b/172112072) - يمكنك الآن إجراء تغييرات على الرسم البياني لـ NavHost. سيتم اعتبار الرسوم البيانية التي تتضمّن startDestination والوجهات نفسها في الرسم البياني متساوية ولن يتم محو الأنشطة السابقة في
NavController. (I0b8db، b/175392262)
إصلاح الأخطاء
- تم إصلاح
NoSuchElementExceptionعند استدعاءpopBackStack()من داخلLifecycleObserverمرفق بـNavBackStackEntryبسبب تحديثات متكررة لحالة NavController. (I64621) - يسمح
AbstractListDetailFragmentالآن بإزالةSlidingPaneLayoutبالكامل من حزمة APK في حال عدم استخدامAbstractListDetailFragment. (I611ad) - يتجاوز
NavGraphوNavDestinationالآن طريقة equals، لذا سيتم اعتبار كائنَين لهما القيم نفسها متساويَين. (I166eb، b/175392262)
الإصدار 2.4.0-alpha04
1 يوليو 2021
تم طرح androidx.navigation:navigation-*:2.4.0-alpha04. يتضمّن الإصدار 2.4.0-alpha04 هذه التعديلات.
الميزات الجديدة
- يحتوي العنصر
navigation-fragmentالآن على عملية تنفيذ مُعدّة مسبقًا لتنسيق من جزأين من خلالAbstractListDetailFragmentالجديد. يستخدم هذا الجزءSlidingPaneLayoutلإدارة جزء القائمة (الذي توفّره الفئة الفرعية) وجزء التفاصيل، والذي يستخدمNavHostFragmentكطريقة تنفيذ، كما هو موضّح في مثال التنفيذ. (Iac4be، b/191276636) - أصبح
NavHostمن عناصرnavigation-composeيتيح الآن استخدام وجهاتdialogبالإضافة إلى وجهاتcomposable. سيتم عرض كل وجهة من وجهات مربّعات الحوار هذه ضمن دالة مركّبةDialog، تطفو فوق الوجهة الحاليةcomposable. (I011d0)
val navController = rememberNavController()
Scaffold { innerPadding ->
NavHost(navController, "home", Modifier.padding(innerPadding)) {
composable("home") {
// This content fills the area provided to the NavHost
HomeScreen()
}
dialog("detail_dialog") {
// This content will be automatically added to a Dialog() composable
// and appear above the HomeScreen or other composable destinations
DetailDialogContent()
}
}
}
التغييرات في واجهة برمجة التطبيقات
- تمت إعادة تسمية الدالة
addفيNavigatorStateإلىpush. يجب تغيير جميع الطلبات الحالية إلىadd()لتصبح push(). (Ie89fc، b/172112072) - يمكن الآن لمثيلات
Navigatorالمخصّصة استخدام واجهتَي برمجة التطبيقاتpushWithTransactionوpopWithTransitionعلىNavigatorStateلإضافة وجهة أو إزالتها بشكل غير متزامن. يُرجى العِلم أنّ واجهات برمجة التطبيقات هذه لم يتم استخدامها بعد من قِبل أي من المتصفّحات المضمّنة. (Ic4d7c، b/172112072)
التغييرات في السلوك
- يضيف
NavDeepLinkBuilderالآنPendingIntent.FLAG_IMMUTABLEإلىPendingIntentالتي يعرضهاcreatePendingIntent()، ما يضمن عمل واجهة برمجة التطبيقات هذه على النحو المتوقّع عند استهداف Android 12. (If8c52)
إصلاح الأخطاء
- تم إصلاح مشكلة في
<include-dynamic>حيث لا يتم تمرير الوسيطات التي تم تمريرها إلى الرسم البياني بشكل صحيح إلى الرسم البياني المضمّن ديناميكيًا. (I3e115) - تم إصلاح
NullPointerExceptionعند الانتقال إلى وجهة باستخدام وسيطةstring[]بقيمة تلقائية تبلغ@null. (I1fbe8) - إضافة قواعد ProGuard لـ
@Navigator.Name، وحلّ المشاكل عند استخدام الوضع الكامل لـ R8 3.1 (I2add9، b/191654433) - لن يتعطّل SafeArgs بعد الآن عند إنشاء تطبيقك باستخدام إصدارات
Kotlinقبل1.5.0. (Icd1ff، b/190739257)
الإصدار 2.4.0-alpha03
16 يونيو 2021
تم طرح androidx.navigation:navigation-*:2.4.0-alpha03. يتضمّن الإصدار 2.4.0-alpha03 هذه التعديلات.
إصلاح الأخطاء
- تم إصلاح مشكلة كانت تتطلّب إجراء طلبَي
navigate()للانتقال إلى رسم بياني ديناميكي مضمّن. (I7785c، b/188859835) - تم إصلاح مشكلة تراجُع في
Navigation
2.4.0-alpha01حيثsetupActionBarWithNavController()لا يزيل رمز "أعلى" بشكل صحيح عندما تكون في وجهة المستوى الأعلى. (I5d443، b/189868637) - تم إصلاح
IllegalStateExceptionعند استدعاءpopBackStack()بعد إزالة الرسم البياني الجذري لـ NavController. (I2a330، b/190265699) - يتم الآن تطبيق قواعد ProGuard لـ
by navArgs()بشكل صحيح عند استخدامnavigation-commonأو أي عناصر تعتمد عليها. (I68800، b/190082521) - عندما يستدعي
OnDestinationChangedListenerالدالةnavigate()في المرة الأولى التي يتلقّى فيها استدعاءً، يتلقّى الآن استدعاءً ثانيًا بشكل صحيح مع الوجهة التي تم الانتقال إليها. (Ie5f9e، b/190228815) - لم يعُد Safe Args يتعطّل عند استخدامه مع وحدات الميزات الديناميكية والإصدار 7.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android والإصدارات الأحدث. (I69518، b/189966576)
مشكلة معروفة
- سيتعطّل المكوّن الإضافي Safe Args مع ظهور خطأ
Unable to find method ‘’java.lang.String kotlin.text.CarsKt.titleCase(char, java.util.Locale)’’عند استخدام الإصدار6.7.0من Gradle بسبب الاعتماد على إصدار قديم من Kotlin. يمكن حلّ هذه المشكلة من خلال التحديث لاستخدام الإصدار 7.0 من Gradle. (b/190739257)
الإصدار 2.4.0-alpha02
2 يونيو 2021
تم طرح androidx.navigation:navigation-*:2.4.0-alpha02. يتضمّن الإصدار 2.4.0-alpha02 هذه التعديلات.
الميزات الجديدة
- أصبحت المسارات متاحة الآن لوجهات النشاط وFragment ومربّعات الحوار، وكذلك في DynamicNavigation Kotlin DSL. (Ib5544، Ia617b، I22f96، b/188914648، b/188901565)
- أضافت "
NavigationUI" مؤقتًا واجهات برمجة تطبيقات تجريبية للسماح بإيقاف حفظ حالتك. على الرغم من أنّ حفظ الحالة دائمًا هو السلوك الصحيح، لا تزال هناك استخدامات للمكتبات المتوقّفة نهائيًا (أي الأجزاء المحفوظة) التي لا يمكن توفيرها عند حفظ الحالة، لذا يتيح ذلك للتطبيقات التحوّل ببطء عن أي واجهات برمجة تطبيقات غير متوافقة. (Idf93c) توفّر ميزة "التنقّل" الآن واجهتَي برمجة التطبيقات
findDestination()وgetHierarchy()اللتين يمكن استخدامهما للمساعدة في تنفيذ واجهة مستخدم مخصّصة للتنقّل. findDestination()هي دالة إضافة فيNavGraphستحدّد موقع وجهة ضمن الرسم البياني. getHierarchy()هي دالة فيNavDestinationيمكن استخدامها للتحقّق مما إذا كانت وجهة معيّنة تقع ضمن التدرّج الهرمي لوجهة أخرى.(I2932f، b/188183365)val matchingRoute: Boolean = destination.hierarchy.any { it.route == routeToFind }تم تعديل طرق NavigationUI التي كانت تستخدم
BottomNavigationViewلتستخدم بدلاً من ذلك فئتها الفائقة التي تم تقديمها في Material1.4.0، NavigationBarView. يتيح ذلك استخدام هذه الطرق معNavigationRailView. (Ib0b36، b/182938895)عند تضخيم عنصر
<action>عبر XML، يمكن لسمات الصور المتحركة استخدام سمات مأخوذة من المظهر باستخدام بنيةapp:enterAnim="?attr/transitionEnter". (I07bc1، b/178291654)
التغييرات في واجهة برمجة التطبيقات
- تم إيقاف أدوات إنشاء Kotlin DSL التي تستخدم معرّفًا نهائيًا ويجب استبدالها بأدوات إنشاء تستخدم المسارات (I85b42، b/188816479) (I9f58f، b/188816479)
إصلاح الأخطاء
- يستخدم
DialogFragmentNavigatorالآن واجهة برمجة التطبيقاتNavigatorState.pop()لإعلامNavControllerعند إغلاق مربّع حوار من خلال الضغط على زر الرجوع في النظام أو النقر خارجه، ما يضمن أنّ حالةNavControllerمتزامنة دائمًا مع حالة Navigator. (I2ead9) لم يعُد التنقّل يؤدي إلى ظهور
ConcurrentModificationExceptionعند التلاعب بقائمةOnDestinationChangedListenersمن خلال دالة رد اتصالonDestinationChanged. (Ib1707، b/188860458)لم يعُد مكوّن Safe Args يتعطّل عند محاولة إنشاء خصائص الاتجاه في لغة Kotlin. (Id2416، b/188564435)
تم الآن إضافة تعليق توضيحي بشكل صحيح إلى طريقة setId في NavDestination باستخدام
@IdRes، لذا لا تقبل سوى أرقام تعريف الموارد. (I69b80)أصبحت مَعلمة int في
findNodeالآنresIdبدلاً منresid. (I7711d)
تحديث الاعتماديات
- يعتمد Safe-Args الآن على الإصدار 4.2.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android. هذا يعني أنّه من المفترض ألا يظهر لك تحذير بشأن استخدام
applicationIdTextResource. (I6d67b، b/172824579)
الإصدار 2.4.0-alpha01
18 مايو 2021
تم طرح androidx.navigation:navigation-*:2.4.0-alpha01. يتضمّن الإصدار 2.4.0-alpha01 هذه التعديلات.
الميزات الجديدة
- توفّر طريقة
currentBackStackEntryAsFlow()فيNavControllerعنصرFlowيتم إصداره كلما تغيّر عنصرNavBackStackEntryالحالي. يمكن استخدام هذا المسار كبديل لإدارةOnDestinationChangedListenerيدويًا. (I19c4a، #89، b/163947280)
الأنشطة السابقة المتعددة
NavController مسؤول عن إدارة الأنشطة السابقة للوجهات، وإضافة الوجهات إلى الأنشطة السابقة عند navigate() إليها وإزالتها عند استدعاء popBackStack() أو تفعيل زر الرجوع في النظام. تم توسيع فئة NavOptions الحالية والدمج في إدخالات <action> في ملف XML الخاص بالرسم البياني للتنقّل لإتاحة حفظ الأنشطة السابقة واستعادتها. (b/80029773)
كجزء من هذا التغيير، تحفظ الآن طرق NavigationUI في onNavDestinationSelected() وBottomNavigationView.setupWithNavController() وNavigationView.setupWithNavController() حالة الوجهات المنبثقة وتستعيدها تلقائيًا، ما يتيح استخدام أنشطة سابقة متعددة بدون أي تغييرات في الرمز البرمجي. عند استخدام ميزة "التنقّل" مع "الأجزاء"، هذه هي الطريقة المقترَحة للدمج مع أنشطة سابقة متعددة. (Ie07ca)
يتم عرض واجهات برمجة التطبيقات الأساسية لحفظ الحالة واستعادتها من خلال عدد من مساحات العرض:
في Navigation XML، يمكن الآن لعنصر
<action>استخدام السمتَين المنطقيتَينapp:popUpToSaveStateوapp:restoreStateلحفظ حالة أي وجهات تم إظهارها من خلالapp:popUpToواستعادة الحالة المرتبطة بالوجهة التي تم تمريرها على أنّهاapp:destination:<action android:id=”@+id/swap_stack” app:destination=”@id/second_stack” app:restoreState=”true” app:popUpTo=”@id/first_stack_start_destination” app:popUpToSaveState=”true” />في
navOptionsKotlin DSL، يمكنك إضافة السمة المنطقيةrestoreStateوالسمة المنطقيةsaveStateإلى أداة الإنشاءpopUpTo:// Use the navigate() method that takes a navOptions DSL Builder navController.navigate(selectedBottomNavRoute) { launchSingleTop = true restoreState = true popUpTo(navController.graph.startDestinationId) { saveState = true } }عند إنشاء عنصر
NavOptionsيدويًا من خلالNavOptions.Builder، يمكنك استخدامsetRestoreState()والتحميل الزائد الجديد إلىsetPopUpTo()الذي يتطلّب مَعلمةsaveStateإضافية.NavOptions navOptions = new NavOptions.Builder() .setLaunchSingleTop(true) .setRestoreState(true) .setPopUpTo(navController.getGraph().getStartDestinationId(), false, // inclusive true) // saveState .build(); navController.navigate(selectedBottomNavId, null, navOptions);يمكن الآن أن تتضمّن الطلبات الآلية إلى
popBackStack()مَعلمةsaveStateإضافية.
في جميع الحالات، سيحفظ NavController حالة كل NavBackStackEntry ويستعيدها، بما في ذلك أي نُسخ ViewModel ضمن نطاق وجهة التنقّل. تم تعديل واجهات برمجة تطبيقات Navigator لتمكين كل Navigator من إتاحة حفظ حالته واستعادتها.
تم تعديل كل من ComposeNavigator المستخدَم لوجهات composable في Navigation Compose وFragmentNavigator وDynamicFragmentNavigator المستخدَمَين لوجهات <fragment> في Navigation with Fragments لاستخدام واجهات برمجة التطبيقات الجديدة Navigator API وإتاحة حفظ الحالة واستعادتها.
مسارات التنقّل
المسار هو String يحدّد وجهة معيّنة بشكل فريد. على الرغم من أنّ هذا المفهوم كان يُستخدم سابقًا في Navigation Compose فقط، فقد أصبح الآن جزءًا من واجهات برمجة التطبيقات الأساسية في Navigation. ويوفّر ذلك بديلاً لاستخدام معرّفات الأعداد الصحيحة عند إنشاء الرسم البياني من خلال Navigation Kotlin DSL. (b/172823546)
جميع واجهات برمجة التطبيقات التي كانت تستخدم معرّفًا فقط أصبحت الآن تتضمّن حمولة زائدة تستخدم المسار String. ويشمل ذلك navigate() وpopBackStack() وpopUpTo() وgetBackStackEntry().
وقد أدى ذلك إلى بعض التغييرات في واجهة برمجة التطبيقات:
- تم إيقاف سمة
popUpTokotlin نهائيًا في Kotlin DSL واستبدالها بسمةpopUpToId. (I59c73، b/172823546) - تم إيقاف واجهة برمجة التطبيقات
getStartDestination()نهائيًا واستبدالها بواجهة برمجة التطبيقاتgetStartDestinationId(). (I0887f، b/172823546)
بالنسبة إلى المطوّرين الذين يجرون ترقية من الإصدارات السابقة من Navigation Compose إلى الإصدار 2.4.0-alpha01، يعني ذلك أنّ عمليات الاستيراد التالية لطرق الإضافة لم تعُد ضرورية ويجب إزالتها:
import androidx.navigation.compose.navigation
import androidx.navigation.compose.createGraph
import androidx.navigation.compose.getBackStackEntry
import androidx.navigation.compose.navigate
import androidx.navigation.compose.popUpTo
تم استبدال الوسيطة KEY_ROUTE بالسمة route في NavDestination، ما يتيح لك استدعاء navBackStackEntry.destination.route مباشرةً.
التغييرات في واجهة برمجة التطبيقات
- تمت إعادة كتابة جميع عناصر Navigation بلغة Kotlin. وقد أدى ذلك إلى تحسين إمكانية قبول القيم الفارغة للفئات التي تستخدم الأنواع العامة (مثل الفئات الفرعية
NavType). تم نقل جميع دوال إضافة Kotlin التي كانت جزءًا من عناصر-ktxإلى عناصرها الرئيسية المعنيّة. سيستمر نشر عناصر-ktx، ولكنها ستكون فارغة تمامًا. (b/184292145) - يتيح
NavDeepLinkBuilderالآن إضافة وجهات متعددة ومختلفة إلى الأنشطة السابقة التي تم إنشاؤها. (I3ee0d، b/147913689) - إضافة دوال المصنع لـ
DynamicNavHostFragment(Icd515، b/175222619) - يتم الآن عرض المعرّف الفريد لـ
NavBackStackEntryكجزء من واجهة برمجة التطبيقات العامة. (Ie033a) - أصبحت الحقول
nameوargumentودوال التفكيك فيNamedNavArgumentمتاحة للجميع الآن. (#174، b/181320559) - تمت إضافة إضافة
NavBackStackEntry#provideToCompositionLocalsجديدة توفّرNavBackStackEntryإلى العناصر المحلية ذات الصلة. (#175، b/187229439)
Safe Args
تُنشئ Safe Args الآن طريقة
fromSavedStateHandle()لكل فئةNavArgs. (#122، b/136967621)class HomeViewModel(savedStateHandle: SavedStateHandle) : ViewModel() { // Create a HomeDestinationArgs class with type safe accessors for each argument // defined on your destination private val args = HomeDestinationArgs.fromSavedStateHandle(savedStateHandle) }تم تعديل Safe Args ليعتمد على KotlinPoet
1.8.0. (#172، b/183990444)
التغييرات في السلوك
- يعتمد التنقّل الآن على
Lifecycle
2.3.1ويصنّف الآنsetGraph()وpopBackStack()وnavigateUp()وnavigate()، وهي الطرق التي تعدّلNavBackStackEntryLifecycle، على أنّها@MainThread، ما يؤدي إلى مواءمة التنقّل مع فرض سلسلة التعليمات الرئيسية التي تم تقديمها في Lifecycle2.3.0. (b/171125856) - أصبح تحليل وسيطات التعداد من الروابط العميقة غير حساس لحالة الأحرف، ما يسمح لرابط عميق مثل
http://www.example.com/redبمطابقة رابط عميقwww.example.com/{color}حتى عندما تكون قيمة التعداد هيRED. (#152، b/135857840)
توافق Compose
- لا يتوافق
androidx.navigation:navigation-compose:2.4.0-alpha01إلا مع الإصدار1.0.0-beta07من Compose والإصدارات الأحدث.
إصلاح الأخطاء
- تم إصلاح مشكلة كانت تؤدي إلى منح الأولوية للعناصر النائبة للوسيطات اللاحقة على الروابط لصفحات معيّنة التي تحتوي على لاحقة مطابقة تمامًا. (#153، b/184072811)
- يتيح
NavHostFragmentالآن استخدام أدوات تنقّل مخصّصة تستخدم@Navigator.Name("dialog")نفسه كأداة التنقّل التلقائيةDialogFragmentNavigator. (Ib1c2c، b/175979140) - تم تحسين سلوك
NavigatorProvider#addNavigatorلضمان عدم حدوث مشاكل عند استدعائه بشكل متكرر مع المثيل نفسه. (#176، b/187443146)
المساهمات الخارجية
- نشكر simonschiller على توفير الدعم لـ Safe Args من خلال إنشاء طريقة
fromSavedStateHandle()لكل فئةNavArgs. (#122، b/136967621) - نشكر Bradleycorn على جعل تحليل وسيطات التعداد من الروابط العميقة غير حساس لحالة الأحرف. (#152، b/135857840)
- نشكر osipxd على حلّ مشكلة كانت تؤدي إلى منح الأولوية للعناصر النائبة للوسيطات اللاحقة على الروابط لصفحات معيّنة التي تتضمّن لاحقة مطابقة تمامًا. (#153، b/184072811)
- نشكر tatocaster على تحديث Safe Args ليعتمد على KotlinPoet
1.8.0. (#172، b/183990444) - نشكر jossiwolf على جعل الحقلَين
nameوargumentودوال تفكيكNamedNavArgumentعلنية. (#174، b/181320559) - نشكر jossiwolf على تقديم إضافة
NavBackStackEntry#provideToCompositionLocalsجديدة توفّرNavBackStackEntryإلى العناصر المحلية ذات الصلة. (#175، b/187229439) - نشكر jossiwolf على تحسين سلوك
NavigatorProvider#addNavigatorلضمان عدم حدوث مشاكل عند استدعائه بشكل متكرر مع المثيل نفسه. (#176، b/187443146)
الإصدار 1.0.0 من Navigation Compose
الإصدار 1.0.0-alpha10
7 أبريل 2021
تم طرح androidx.navigation:navigation-compose:1.0.0-alpha10. يتضمّن الإصدار 1.0.0-alpha10 هذه التعديلات.
التغييرات في واجهة برمجة التطبيقات
- تقبل دالة
NavHostالآن مَعلمةModifier، والتي يتم تمريرها إلى الحاوية المركّبة التي تلتف حول الدوال المركّبة للوجهة. (I85aca، b/175125483)
إصلاح الأخطاء
- يعمل
NavHostالآن حتى في حال عدم العثور علىOnBackPressedDispatcherOwner، كما هو الحال عند معاينةNavHost. (I7d8b4) - تعتمد Navigation Compose الآن على Navigation
2.3.5، ما يحلّ مشكلة عند استخدامBackHandlerداخل وجهةNavHost. (I7e63b، b/182284739)
الإصدار 1.0.0-alpha09
10 آذار (مارس) 2021
تم طرح androidx.navigation:navigation-compose:1.0.0-alpha09. يتضمّن الإصدار 1.0.0-alpha09 هذه التعديلات.
التغييرات في واجهة برمجة التطبيقات
- تعرض دالة
LocalViewModelStoreOwner.currentالآن قيمةViewModelStoreOwnerقابلة للقيم الفارغة لتحديد ما إذا كانت قيمةViewModelStoreOwnerمتاحة في التركيب الحالي بشكل أفضل. لا تزال واجهات برمجة التطبيقات التي تتطلّبViewModelStoreOwner، مثلviewModel()وNavHost، تُظهر استثناءً في حال عدم ضبطViewModelStoreOwner. (Idf39a)
إصلاح الأخطاء
- تعتمد Navigation Compose الآن على Navigation 2.3.4 الذي يتضمّن إصلاحًا لمحاولة ضبط عنصر ViewModelStore نفسه بعد ضبط الرسم البياني. (I65c24، b/177825470)
الإصدار 1.0.0-alpha08
24 فبراير 2021
تم طرح androidx.navigation:navigation-compose:1.0.0-alpha08. يتضمّن الإصدار 1.0.0-alpha08 هذه التعديلات.
الميزات الجديدة
- يملأ
NavHostالآنLocalSavedStateRegistryOwnerCompositionLocal باستخدامNavBackStackEntryلتلك الوجهة، ما يضمن حفظ أي حالة يتم حفظها مباشرةً فيSavedStateRegistryواستعادتها مع الوجهة. (I435d7، b/179469431)
الإصدار 1.0.0-alpha07
10 فبراير 2021
تم طرح androidx.navigation:navigation-compose:1.0.0-alpha07. يتضمّن الإصدار 1.0.0-alpha07 هذه التعديلات.
تحديثات الاعتماديات
- يعتمد Navigation Compose الآن على Lifecycle ViewModel Compose 1.0.0-alpha01 لتوفير دعم
viewModel()لوجهاتcomposable. (I7a374) - يستخدم
NavHostالآنLocalOnBackPressedDispatcherOwnerالجديد من Activity-Compose 1.3.0-alpha01 للحصول علىOnBackPressedDispatcherالذي تم ضبطه علىNavController. (I65b12)
الإصدار 1.0.0-alpha06
28 يناير 2021
تم طرح androidx.navigation:navigation-compose:1.0.0-alpha06. يتضمّن الإصدار 1.0.0-alpha06 هذه التعديلات.
التغييرات في واجهة برمجة التطبيقات
- تمت إضافة طريقة إضافة
getBackStackEntry(route: String)فيNavControllerتعرض السمةNavBackStackEntryالمرتبطة. (If8931)
الإصدار 1.0.0-alpha05
13 يناير 2021
تم طرح androidx.navigation:navigation-compose:1.0.0-alpha05. يتضمّن الإصدار 1.0.0-alpha05 هذه التعديلات.
تم تعديل الإصدار ليعتمد على Compose 1.0.0-alpha10.
الإصدار 1.0.0-alpha04
16 ديسمبر 2020
تم طرح androidx.navigation:navigation-compose:1.0.0-alpha04. يتضمّن الإصدار 1.0.0-alpha04 هذه التعديلات.
- تم تعديل التطبيق ليتوافق مع الإصدار
1.0.0-alpha09من Compose.
الإصدار 1.0.0-alpha03
2 ديسمبر 2020
تم طرح androidx.navigation:navigation-compose:1.0.0-alpha03. يتضمّن الإصدار 1.0.0-alpha03 هذه التعديلات.
إصلاح الأخطاء
- تم إصلاح مشكلة عدم عمل
popBackStack()وnavigateUp()بعد تغيير الإعدادات أو إيقاف العملية نهائيًا وإعادة إنشائها. (Icea47، b/173281473) - يعمل الآن الانتقال إلى رسم بياني مدمَج ضمن NavHost بشكل صحيح. (I0948d، b/173647694)
الإصدار 1.0.0-alpha02
11 تشرين الثاني (نوفمبر)، 2020
تم طرح androidx.navigation:navigation-compose:1.0.0-alpha02. يتضمّن الإصدار 1.0.0-alpha02 هذه التعديلات.
التغييرات في واجهة برمجة التطبيقات
- يتيح مكوّن Navigation Compose الآن استخدام NavOptions لعمليات popUpTo وlaunchSingleTop (If96c3، b/171468994)
- تمت إضافة دالة تنقّل تستخدم مسارًا بدلاً من معرّف يسمح لك بإنشاء رسومات بيانية متداخلة في Navigation Compose DSL. (I1661d)
- يأتي startDestination الآن قبل المسار في قائمة مَعلمات NavHost (Ie620e)
- يمكنك الآن إنشاء رسم بياني باستخدام المسار كوجهة بداية خارج دالة NavHost مركّبة. (Iceb75)
الإصدار 1.0.0-alpha01
28 أكتوبر 2020
تم طرح android.navigation:navigation-compose:1.0.0-alpha01. يتضمّن الإصدار 1.0.0-alpha01 هذه التعديلات.
الميزات الجديدة
توفّر عناصر navigation-compose إمكانية الدمج بين مكوّن التنقّل وJetpack Compose. وتستخدم دوال @Composable كوجهات في تطبيقك.
يوفّر هذا الإصدار الأوّلي ما يلي:
- دالة
NavHostمركّبة تتيح لك إنشاء رسم بياني للتنقّل من خلال لغة Kotlin DSL. - تحديد نطاق دورة الحياة و
ViewModelوالحالة المحفوظة على مستوى الوجهة - الدمج التلقائي مع زر الرجوع في النظام
- إتاحة تمرير الوسيطات وإرفاق روابط لصفحات معيّنة بالوجهات وإرجاع نتيجة إلى الوجهات السابقة
- توفير أدوات مساعدة محدّدة في
rememberNavController()وcurrentBackStackEntryAsState()للسماح برفع الحالة وربطNavControllerبالدوال المركّبة خارجNavHost(مثل شريط التنقّل السفلي)
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التنقّل في Compose.
الإصدار 2.3.5
الإصدار 2.3.5
7 أبريل 2021
تم طرح androidx.navigation:navigation-*:2.3.5. يتضمّن الإصدار 2.3.5 هذه التعديلات.
الميزات الجديدة
- عند التنقّل باستخدام
NavDeepLinkRequestأوUri، يمكنك الآن الوصول إلىUriوالإجراء ونوع MIME في الوجهة الناتجة من خلال الحصول على الغرض من الوسيطات عبرKEY_DEEP_LINK_INTENT، ما يعكس الوظائف المتاحة حاليًا للربط العميق الخارجي. (I975c3، b/181521877)
إصلاح الأخطاء
- عند إضافة
OnBackPressedCallbacksإلى مُرسِل معNavBackStackEntryكـ LifecycleOwner، يتم الآن اعتراض الرجوع بشكل صحيح بعد أن تصبح مراحل النشاطSTOPPED، ثمSTARTED(Iff94f، b/182284739) - أصبح تحليل نطاق الرابط العميق غير حسّاس لحالة الأحرف، ما يضمن تطابق
www.example.comمع كل منwww.example.comوwww.Example.com. يُرجى العِلم أنّ أسماء مَعلمات طلب البحث لا تزال حسّاسة لحالة الأحرف. (#144، b/153829033) - تم إصلاح
NullPointerExceptionقد يحدث عندما تتضمّن وجهة معيّنة وسيطات تلقائية متعددة غير قابلة للإلغاء وتنتقل إلى تلك الوجهة مع إلغاء مجموعة فرعية فقط من هذه الوسيطات. (aosp/1644827)
تحديثات الاعتماديات
- يعتمد المكوّن الإضافي لنظام Gradle الخاص بـ Navigation Safe Args الآن على المكوّن الإضافي لنظام Gradle الخاص بـ Kotlin بالإصدار 1.4.31. (aosp/1661058، b/181156413)
مساهمة خارجية
- نشكر
bentrengroveعلى طلب السحب الذي يجعل تحليل نطاق الرابط لصفحة معيّنة غير حساس لحالة الأحرف. (#144، b/153829033)
الإصدار 2.3.4
الإصدار 2.3.4
10 آذار (مارس) 2021
تم طرح androidx.navigation:navigation-*:2.3.4. يتضمّن الإصدار 2.3.4 هذه التعديلات.
الميزات الجديدة
- يمكن الآن تحليل وسيطات
ReferenceTypeبشكل صحيح عند إرسالها كجزء من معرّف موارد منتظم (URI) لرابط لصفحة معيّنة. يتيح ذلك استخدام قيمة العدد الصحيح الأوّلية وقيم سداسية عشرية مسبوقة بـ0x. (#127، b/179166693) - أصبح مَعلمة
android:defaultValueلوسيطة معapp:argType="float"يتيح الآن استخدام القيم التلقائية للأعداد الصحيحة، ما يتيح لك استخدامandroid:defaultValue="0"بدلاً من طلب استخدام0.0. (#117، b/173766247)
إصلاح الأخطاء
- تم إصلاح مشكلة توقُّف تقدّم عملية التثبيت عند استخدام ميزة "التنقّل" مع الميزات الديناميكية. (Ib27a7، b/169636207)
- لن يؤدي استدعاء
setViewModelStoreأوsetLifecycleOwnerباستخدام العنصر نفسه الذي تم ضبطه مسبقًا إلى تنفيذ أي عملية (Idf491، b/177825470) - يضيف Safe-Args الآن تعليقات توضيحية للإيقاف على الطرق المناسبة عند استخدام Java. (I8fbc5، b/179463137)
المساهمات الخارجية
- نشكر
JvmNameعلى طلب السحب لضمان إمكانية تحليل وسيطاتReferenceTypeبشكل صحيح الآن عند إرسالها كجزء من معرّف الموارد المنتظم (URI) لرابط لصفحة معيّنة. (#127، b/179166693) - نشكر
tatocasterعلى طلب السحب للسماح باستخدامdefaultValueكوسيطة معapp:argType=”float”، والتي تتيح الآن استخدام القيم التلقائية للأعداد الصحيحة. (#117، b/173766247)
الإصدار 2.3.3
الإصدار 2.3.3
27 يناير 2021
تم طرح androidx.navigation:navigation-*:2.3.3. يتضمّن الإصدار 2.3.3 هذه التعديلات.
إصلاح الأخطاء
- لم يعُد يحدث عطل عند إزالة
NavBackStackEntryقبل نقلLifecycleإلىCREATED. (Ie3ba3) - تم إصلاح مشكلة التراجع الناتجة عن b/171364502 حيث يؤدي الانتقال إلى نشاط بقيمة مورد رسوم متحركة تبلغ
0إلى حدوثResourceNotFoundException. (I7aedb، b/176819931)
الإصدار 2.3.2
الإصدار 2.3.2
2 ديسمبر 2020
تم طرح androidx.navigation:navigation-*:2.3.2. يتضمّن الإصدار 2.3.2 هذه التعديلات.
إصلاح الأخطاء
- تم إصلاح مشكلة تراجُع في
NavigationUIحيث يتعذّر الانتقال إلى النشاط عند استخدام وجهة<activity>معonNavDestinationSelected. (I22e34، b/171364502) - تم إصلاح مشكلة تؤدي فيها
navigation-dynamic-features-fragmentإلى الانتقال إلى الوجهة المثبَّتة حديثًا عدة مرات. (aosp/1486056، b/169636207) - تم إصلاح مشكلة عدم إرسال الوسيطات التلقائية إلى نُسخ
OnDestinationChangedListenerعند استخدامlaunchSingleTop. (I2c5cb) - تم إصلاح مشكلة عدم إنشاء مثيل رسم بياني جديد في الأنشطة السابقة عند الانتقال إلى رسم بياني متداخل للتنقّل. (Ifc831)
- تم إصلاح مشكلة كانت تؤدي إلى عدم تدمير وإزالة الرسم البياني للتنقّل نفسه من الأنشطة السابقة على الفور عند استخدام
navigate()معpopUpToلإزالة الوجهة الأخيرة في الرسم البياني للتنقّل. (I910a3) - يستخدم Navigation SafeArgs الآن الإصدار 1.7.2 من KotlinPoet الذي يضيف إمكانية استخدام وضع واجهة برمجة التطبيقات الصريح في Kotlin. (I918b5)
- تتحقّق أداة
NavHostFragment.findNavController(Fragment)الآن أيضًا من طريقة عرض الديكور الجذر لـ DialogFragment بالإضافة إلى عمليات التحقّق الحالية من التسلسل الهرمي لـ Fragment وهيكلية طرق العرض لـ Fragment. يتيح لك ذلك اختبار أجزاء مربّعات الحوار التي تستخدم مكوّن Navigation معFragmentScenarioوNavigation.setViewNavController(). (I69e0d)
الإصدار 2.3.1
الإصدار 2.3.1
14 أكتوبر 2020
تم طرح androidx.navigation:navigation-*:2.3.1. يتضمّن الإصدار 2.3.1 هذه التعديلات.
الميزات الجديدة
- تمت إضافة موارد Animator التلقائية إلى واجهة مستخدم التنقّل، ويُنصح باستخدامها بدلاً من موارد الحركة التلقائية. (b/167430145)
- تلغي NavOptions الآن طرق hashcode وequals (b/161586466)
- تتضمّن ميزة "التنقّل" الآن الوجهة الحالية في IllegalArgumentException "ما مِن وجهة برقم التعريف"، ما من شأنه تحسين تجربة تصحيح الأخطاء لدى المطوّرين. (b/168311416)
إصلاح الأخطاء
- لن يلتف Safe Args بعد الآن في سطر الإرجاع، حتى إذا كان اسم فئة الوسيطة الذي تم إنشاؤه أطول من 100 حرف. (b/168584987)
التغييرات في الاعتماديات
- يعتمد
navigation-uiالآن على DrawerLayout 1.1.1، لضمان قدرةNavigationUIعلى فتح الدرج حتى عند استخدامLOCK_MODE_LOCKED_CLOSEDأوLOCK_MODE_LOCKED_OPEN. (b/162253907) - يعتمد Safe Args الآن على الإصدار 1.6.0 من KotlinPoet (aosp/1435911).
- يعتمد Safe Args الآن على الإصدار 4.0.1 من "مكوّن Android الإضافي لبرنامج Gradle" (aosp/1442337).
الإصدار 2.3.0
الإصدار 2.3.0
24 يونيو 2020
تم طرح androidx.navigation:navigation-*:2.3.0. يتضمّن الإصدار 2.3.0 هذه التعديلات.
التغييرات الرئيسية منذ الإصدار 2.2.0
- دمج وحدة الميزات: تتيح لك عناصر
navigation-dynamic-features-runtimeوnavigation-dynamic-features-fragmentالانتقال إلى الوجهات المحدّدة في وحدات الميزات، مع معالجة تثبيت وحدات الميزات تلقائيًا حسب الحاجة. لمزيد من المعلومات، يُرجى الاطّلاع على التنقّل باستخدام وحدات الميزات. - اختبار التنقّل: يوفّر العنصر
navigation-testingواجهةTestNavHostControllerتتيح لك ضبط الوجهة الحالية والتحقّق من الأنشطة السابقة بعد عمليات التنقّل. لمزيد من المعلومات، يُرجى الاطّلاع على اختبار التنقّل. - عرض النتيجة: يتيح لك الآن
NavBackStackEntryالمرتبط بكل وجهة في الأنشطة السابقة للتنقّل الوصول إلىSavedStateHandleمناسب لتخزين كميات صغيرة من الحالة المحفوظة التي يجب ربطها بإدخال معيّن في الأنشطة السابقة. لمزيد من المعلومات، يُرجى الاطّلاع على إرجاع نتيجة إلى الوجهة السابقة. - إتاحة
NavigationUIلـOpenable: تم استبدال جميع استخداماتDrawerLayoutفيNavigationUIبواجهةOpenableالأكثر عمومية التي تمت إضافتها في CustomView1.1.0وتم تنفيذها بواسطةDrawerLayoutفي DrawerLayout1.1.0. - إتاحة الإجراءات وأنواع MIME في الروابط لصفحات معيّنة: تم توسيع نطاق الربط بصفحات معيّنة لإتاحة
app:actionوapp:mimeTypeبالإضافة إلىapp:uriالمتاحة سابقًا. يتيحNavControllerالآن التنقّل باستخدام أي مجموعة من هذه الحقول من خلال فئةNavDeepLinkRequestالجديدة. لمزيد من المعلومات، يُرجى الاطّلاع على التنقّل باستخدام NavDeepLinkRequest.
المشاكل المعروفة
- لا يتوفّر حتى الآن دعم لإجراءات الربط العميق وأنواع MIME في دمج البيان. إلى أن يكتمل هذا العمل، لن تتضمّن أي عناصر
<intent-filter>تم إنشاؤها من العنصر<nav-graph>في البيان نوع MIME في العنصر<data>أو<action>المخصّص. يجب إضافة<intent-filter>مناسب يدويًا إلى ملف البيان.
الإصدار 2.3.0-rc01
10 يونيو 2020
تم طرح androidx.navigation:navigation-*:2.3.0-rc01. يتضمّن الإصدار 2.3.0-rc01 هذه التعديلات.
إصلاح الأخطاء
- تم إصلاح
NullPointerExceptionعند استبدال مثيل لوجهة بدون وسيطات بمثيل آخر يتضمّن وسيطات باستخدامsingleTop. (b/158006669) - تحتوي الآن جميع استثناءات
destination is unknownالتي تم طرحها بواسطةNavControllerعلى معلومات إضافية لتصحيح الأخطاء للمساعدة في تحديد حالةNavController. (b/157764916)
الإصدار 2.3.0-beta01
20 أيار (مايو) 2020
تم طرح androidx.navigation:navigation-*:2.3.0-beta01. يتضمّن الإصدار 2.3.0-beta01 هذه التعديلات.
إصلاح الأخطاء
- تم إصلاح مشكلة عدم تحديث
LifecycleفيNavBackStackEntryبشكل صحيح بعد إيقاف العملية نهائيًا. (b/155218371) - يتم الآن إرسال الوجهة التي تمت استعادتها بشكل صحيح إلى مثيلات
OnDestinationChangedListenerالمسجَّلة قبل استدعاءsetGraph()بعد إيقاف العملية نهائيًا. (b/155218371) - عند استخدام
singleTop، يتم الآن تعديل وسيطاتNavBackStackEntryبشكل صحيح وإرسال الوسيطات المعدَّلة إلى جميع مثيلاتOnDestinationChangeListener. (b/156545508)
تحديثات الاعتماديات
- يعتمد العنصر
NavigationUIالآن على CustomView1.1.0-rc01وDrawerLayout1.1.0-rc01. (aosp/1309696)
الإصدار 2.3.0-alpha06
29 أبريل 2020
تم طرح androidx.navigation:navigation-*:2.3.0-alpha06. (يتضمّن الإصدار 2.3.0-alpha06 هذه التعديلات.)
الميزات الجديدة
- تم توسيع نطاق الربط العميق لإتاحة استخدام
app:actionوapp:mimeTypeبالإضافة إلىapp:uriالمتاحَين سابقًا. يتيح NavController الآن التنقّل باستخدام أي مجموعة من هذه الحقول من خلال فئةNavDeepLinkRequestالجديدة. (b/136573074، b/135334841)
التغييرات في واجهة برمجة التطبيقات
- تم توسيع نطاق دعم Kotlin DSL بشكل كبير لوجهات التنقّل الديناميكي. (b/148969800)
إصلاح الأخطاء
- تم إصلاح مشكلة تجاهُل أهداف الروابط العميقة عند استخدام وجهة بدء مدمجة. (b/154532067)
الإصدار 2.3.0-alpha05
نيسان (أبريل) 2020
تم طرح androidx.navigation:navigation-*:2.3.0-alpha05. يتضمّن الإصدار 2.3.0-alpha05 هذه التعديلات.
الميزات الجديدة
- بالنسبة إلى عمليات تضمين الرسم البياني الديناميكي باستخدام
<include-dynamic>، لن تحتاج بعد الآن إلى تحديدapp:graphPackageوسيتم استخدام قيمة تلقائية من خلال إضافة اللاحقةmoduleNameإلىapplicationIdبعد نقطة. إذا كنت بحاجة إلى تخصيصgraphPackage، يتوفّر الآن عنصر نائب${applicationId}. (b/152696768) - توفّر لغة Kotlin DSL لمخطّط التنقّل الآن
defaultArgumentsMapللإجراءات، ما يعكس إمكانية ضبط القيم التلقائية على عناصر<action>في ملفات XML الخاصة بالتنقّل. (b/150345605)
إصلاح الأخطاء
- من Navigation 2.2.2: تم إصلاح
IllegalStateExceptionعند الربط العميق بالوجهة الأولى للرسم البياني عندما يكون لديك مثيلاتNavHostFragmentمتعددة في نشاطك. (b/147378752)
تحديثات الاعتماديات
- يعتمد التنقّل الآن على Fragment
1.2.4. (aosp/1277325) - يعتمد Dynamic Navigation الآن على مكتبة Play الأساسية
1.7.2. (aosp/1282257)
الإصدار 2.3.0-alpha04
18 مارس 2020
تم طرح androidx.navigation:navigation-*:2.3.0-alpha04. يتضمّن الإصدار 2.3.0-alpha04 هذه التعديلات.
الميزات الجديدة
- تمت إضافة إمكانية استخدام وجهات الأنشطة والمقاطع في وحدات الميزات في Navigation Kotlin DSL. (b/148969800)
التغييرات في واجهة برمجة التطبيقات
- لم تعُد فئة
DynamicExtrasتستخدم نمط أداة الإنشاء، ويمكن الآن إنشاؤها مباشرةً. (aosp/1253671) - يستخدم
DynamicActivityNavigatorالآنContextفي الدالة الإنشائية بدلاً منActivity. (aosp/1250252)
إصلاح الأخطاء
- لم يعُد
NavigationUIيتجاهل التصنيفات الفارغة (أي وجهة تحتوي علىandroid:label=””)، ويضبط الآن العنوان بشكل صحيح على سلسلة فارغة. (b/148679860)
تحديثات الاعتماديات
- تعتمد الآن عناصر ميزات التنقّل الديناميكية على الإصدار
1.6.5من مكتبة Play الأساسية. (b/149556401)
الإصدار 2.3.0-alpha03
4 مارس 2020
تم طرح androidx.navigation:navigation-*:2.3.0-alpha03. يتضمّن الإصدار 2.3.0-alpha03 هذه التعديلات.
التغييرات في واجهة برمجة التطبيقات
- بدلاً من الاعتماد على فئة
DrawerLayoutالملموسة، يستخدمAppBarConfigurationالآن واجهةOpenableالتي تم تقديمها في CustomView1.1.0-alpha02(التي تنفّذهاDrawerLayoutاعتبارًا من DrawerLayout1.1.0-alpha04)، ما يسمح لك باستخدام عمليات تنفيذ مخصّصة لـOpenableمعNavigationUI. (b/129030452)
إصلاح الأخطاء
- تحتفظ قواعد ProGuard في
navigation-common-ktxالآن بشكل صحيح بفئاتNavArgsالمُستخدَمة فقط بدلاً من جميع نُسخNavArgs. (b/150213558)
التغييرات في التبعيات
- تمت إعادة اعتمادية Navigation على Core
1.2.0، وهي تعتمد الآن على Core1.1.0لتجنُّب إجبار المطوّرين على الانتقال إلى اعتمادية أحدث عندما لا تعتمد Navigation على أي واجهات برمجة تطبيقات جديدة في Core1.2.0.
الإصدار 2.3.0-alpha02
19 فبراير 2020
تم طرح androidx.navigation:navigation-*:2.3.0-alpha02. يتضمّن الإصدار 2.3.0-alpha02 هذه التعديلات.
الميزات الجديدة
- يتيح لك
NavBackStackEntryالآن الوصول إلىSavedStateHandleمناسب لتخزين كميات صغيرة من الحالة المحفوظة التي يجب ربطها بإدخال معيّن في الأنشطة السابقة. يمكنك الاطّلاع على عرض نتيجة للحصول على مثال على حالة استخدام. (b/79672220)
التغييرات في واجهة برمجة التطبيقات
- تمت إضافة طريقتَي
getCurrentBackStackEntry()وgetPreviousBackStackEntry()لتسهيل استردادNavBackStackEntryللوجهات الحالية والسابقة. (b/79672220)
إصلاح الأخطاء
- يُمرِّر
navigateUp()الآن وسيطات الوجهة الحالية وKEY_DEEP_LINK_INTENTإلى الوجهة السابقة عند تشغيل تطبيقك على حزمة المهام الخاصة بك. (b/147456890)
التغييرات في التبعيات
- يعتمد التنقّل الآن على Core
1.2.0.
الإصدار 2.3.0-alpha01
5 فبراير 2020
تم طرح androidx.navigation:navigation-*:2.3.0-alpha01. يتضمّن الإصدار 2.3.0-alpha01 هذه التعديلات.
الميزات الجديدة
- يوفّر العنصر الجديد
navigation-testingفئةTestNavHostController. توفّر هذه الفئة بديلاً لاستخدامNavControllerوهمي عند اختبار التنقّل، ما يتيح لك ضبط الوجهة الحالية والتحقّق من الأنشطة السابقة بعد عمليات التنقّل. (b/140884273) - تتيح لك واجهة برمجة التطبيقات
navigation-dynamic-features-fragmentالجديدة (واعتماديتها المتعديةnavigation-dynamic-features-runtime) تضمين الوجهات المستهدَفة أو رسومات بيانية كاملة للتنقّل (من خلال<include-dynamic>) من وحدات الميزات، ما يوفّر تثبيتًا سلسًا لوحدات الميزات عند الطلب أثناء التنقّل إلى تلك الوجهات. لمزيد من المعلومات، يُرجى الاطّلاع على التنقّل باستخدام وحدات الميزات. (b/132170186)
إصلاح الأخطاء
- من Navigation
2.2.1: الروابط العميقة التي لا تتضمّن مَعلمات طلب البحث تتجاهل الآن بشكل صحيح أي مَعلمات طلب بحث بدلاً من إلحاقها بعناصر{argument}اللاحقة أو عدم مطابقة الرابط العميق. (b/147447512) - من Navigation
2.2.1: تم تعديل قواعد ProGuard الخاصة بـnavigation-uiلـDrawerArrowDrawableلضمان عدم الحاجة إلىandroid.enableJetifier=true. (b/147610424) - من التنقّل
2.2.1: أصبحت وحدةnavigation-common-ktxالآن تتضمّن اسم حزمة بيان فريدًا بدلاً من مشاركة اسم حزمة البيان نفسه معnavigation-runtime-ktx. (aosp/1141947)
تحديثات الاعتماديات
- من Navigation
2.2.1: يعتمد Navigation2.2.1الآن على Lifecycle ViewModel SavedState2.2.0وFragment1.2.1.
الإصدار 2.2.2
الإصدار 2.2.2
نيسان (أبريل) 2020
تم طرح androidx.navigation:navigation-*:2.2.2. يتضمّن الإصدار 2.2.2 هذه التعديلات.
إصلاح الأخطاء
- تم إصلاح
IllegalStateExceptionعند الربط بصفحة في التطبيق تؤدي إلى وجهة بدء الرسم البياني عندما يكون لديك مثيلاتNavHostFragmentمتعددة في نشاطك. (b/147378752) - لم يعُد
NavigationUIيتجاهل التصنيفات الفارغة (أي وجهة تحتوي علىandroid:label=””)، ويضبط الآن العنوان بشكل صحيح على سلسلة فارغة. تم طرح هذه الميزة سابقًا في Navigation 2.3.0-alpha04. (b/148679860) - تحتفظ قواعد ProGuard في
navigation-common-ktxالآن بشكل صحيح بفئاتNavArgsالمُستخدَمة فقط بدلاً من جميع نُسخNavArgs. وقد تم طرح هذه الميزة سابقًا في Navigation 2.3.0-alpha03. (b/150213558
تحديثات الاعتماديات
- يعتمد التنقّل الآن على Fragment
1.2.4. (aosp/1277325)
الإصدار 2.2.1
الإصدار 2.2.1
5 فبراير 2020
تم طرح androidx.navigation:navigation-*:2.2.1. يتضمّن الإصدار 2.2.1 هذه التعديلات.
إصلاح الأخطاء
- أما الروابط العميقة التي لا تتضمّن معلمات طلب البحث، فتتجاهل الآن بشكل صحيح أي معلمات طلب بحث بدلاً من إلحاقها بعناصر
{argument}اللاحقة أو عدم مطابقة الرابط العميق. (b/147447512) - تم تعديل قواعد ProGuard الخاصة بـ "
navigation-ui" لـ "DrawerArrowDrawable" لضمان عدم طلب "android.enableJetifier=true". (b/147610424) - أصبحت وحدة
navigation-common-ktxالآن تتضمّن اسم حزمة بيان فريدًا بدلاً من مشاركة اسم حزمة البيان نفسه معnavigation-runtime-ktx. (aosp/1141947)
تحديثات الاعتماديات
- يعتمد Navigation
2.2.1الآن على Lifecycle ViewModel SavedState2.2.0وFragment1.2.1.
الإصدار 2.2.0
الإصدار 2.2.0
22 يناير 2020
تم طرح androidx.navigation:navigation-*:2.2.0. يتضمّن الإصدار 2.2.0 هذه التعديلات.
تغييرات مهمة منذ الإصدار 2.1.0
- NavBackStackEntry: يمكنك الآن استدعاء
NavController.getBackStackEntry()، مع تمرير معرّف وجهة أو رسم بياني للتنقّل في الأنشطة السابقة. يوفّر عنصرNavBackStackEntryالذي تم إرجاعهLifecycleOwnerوViewModelStoreOwnerمستندَين إلى التنقّل (وهما نفس العنصرَين اللذين تم إرجاعهما من خلالNavController.getViewModelStoreOwner()) وSavedStateRegistryOwner، بالإضافة إلى توفير الوسيطات المستخدَمة لبدء هذه الوجهة. - دمج Lifecycle ViewModel SavedState: أصبح
SavedStateViewModelFactoryالآن هو المصنع التلقائي المستخدَم عند استخدامby navGraphViewModels()أو دالة الإنشاءViewModelProviderمعViewModelStoreOwnerالذي يتم عرضه من خلالNavController.getBackStackEntry()أوNavController.getViewModelStoreOwner(). - إتاحة مَعلمات طلب البحث للروابط لصفحات في التطبيق: أصبحت الروابط لصفحات في التطبيق التي تتضمّن مَعلمات طلب البحث تتيح الآن إعادة ترتيب مَعلمات طلب البحث، وأصبحت الوسيطات التي لها قيمة تلقائية أو التي يمكن أن تكون فارغة اختيارية الآن عند مطابقة الروابط لصفحات في التطبيق.
- تحسين دعم الصور المتحركة: يستخدم
NavHostFragmentالآنFragmentContainerViewمن Fragment 1.2.0، ما يؤدي إلى إصلاح مشاكل ترتيب الصور المتحركة على المحور Z وإرسال العناصر المضمّنة في النافذة إلى الأجزاء.
الإصدار 2.2.0-rc04
18 ديسمبر 2019
تم طرح androidx.navigation:navigation-*:2.2.0-rc04. يتضمّن الإصدار 2.2.0-rc04 هذه التعديلات.
إصلاح الأخطاء
- تم تعديل تأثيرات التلاشي التلقائية المستخدَمة في
navigation-uiلتتطابق مع تأثيرات التلاشي المعدَّلة في Fragment1.2.0-rc04. (b/145769814)
الإصدار 2.2.0-rc03
4 ديسمبر 2024
تم طرح androidx.navigation:navigation-*:2.2.0-rc03. يتضمّن الإصدار 2.2.0-rc03 هذه التعديلات.
إصلاح الأخطاء
- تم إصلاح مشكلة في تحليل الروابط لصفحات في التطبيق عند استخدام معلمات طلب البحث ووسيطة كالجزء الأخير من المسار، ما منع تحليل أكثر من حرف واحد من وسيطة المسار النهائية. (b/144554689)
- تم إصلاح مشكلة في تحليل الروابط لصفحات معيّنة، حيث كانت المَعلمات الاختيارية تتلقّى
"@null"بدلاً منnull. (b/141613546) - يستعيد
NavHostFragmentالآن الرسم البياني بشكل صحيح بعد تغيير الإعدادات عند استخدامه معFragmentContainerView. (b/143752103)
التغييرات في التبعيات
- يعتمد التنقّل الآن على Lifecycle
2.2.0-rc03وLifecycle ViewModel SavedState1.0.0-rc03وActivity1.1.0-rc03وFragment1.2.0-rc03حيثما كان ذلك مناسبًا.
الإصدار 2.2.0-rc02
7 نوفمبر 2019
تم طرح androidx.navigation:navigation-*:2.2.0-rc02. يتضمّن الإصدار 2.2.0-rc02 هذه التعديلات.
التغييرات في التبعيات
- يعتمد التنقّل الآن على androidx.lifecycle
2.2.0-rc02.
الإصدار 2.2.0-rc01
23 أكتوبر 2019
تم إصدار androidx.navigation:navigation-*:2.2.0-rc01 بدون أي تغييرات منذ 2.2.0-beta01. يتضمّن الإصدار 2.2.0-rc01 هذه التعديلات.
الإصدار 2.2.0-beta01
9 أكتوبر 2019
تم طرح androidx.navigation:navigation-*:2.2.0-beta01. يتضمّن الإصدار 2.2.0-beta01 هذه التعديلات.
الميزات الجديدة
- تتجاوز الآن فئة
NavDestinationوفئاتها الفرعية فئةtoString()لتوفير معلومات أكثر فائدة عند تصحيح الأخطاء. (b/141264986)
التغييرات في السلوك
- يتم الآن تجاهل معلمات طلب البحث الإضافية عند مطابقة الروابط لصفحات في التطبيق بدلاً من التسبب في تعذُّر المطابقة. (b/141482822)
إصلاح الأخطاء
- تم إصلاح مشكلة تجاهُل الوسيطات في مسار الرابط لصفحة معيّنة في حال تحديد معلمات طلب البحث أيضًا. (b/141505755)
- تتضمّن إضافة Kotlin الخاصة بـ
navArgs()فيActivityالآن رسالة خطأ أفضل في حال عدم توفّر أي إضافات. (b/141408999) - أصبحت فئات Java التي تم إنشاؤها باستخدام Safe Args وعددها
Directionsتحتوي الآن على قيم تلقائية. (b/141099045) - أصبحت فئات Java التي تم إنشاؤها باستخدام Safe Args وعددها
Argsتحتوي الآن على قيم تلقائية. (b/140123727) - عند استخدام
Toolbar، لن يعرضNavigationUIبعد الآن تأثيرًا متحركًا لتغيير النص عند الانتقال بين وجهتَين في المستوى الأعلى. (b/140848160)
الإصدار 2.2.0-alpha03
18 سبتمبر 2019
تم طرح androidx.navigation:navigation-*:2.2.0-alpha03. يتضمّن الإصدار 2.2.0-alpha03 هذه التعديلات.
التغييرات في السلوك
- يؤدي استدعاء
setViewModelStore()بعد استدعاءsetGraphالآن إلى ظهورIllegalStateException. يجب أن يضبطNavHostهذا الإعداد دائمًا كجزء من عملية الإعداد الأوّلية لضمان توفّر مساحة تخزين متّسقة لجميع نُسخNavBackStackEntryفي نُسخViewModel. (aosp/1111821)
إصلاح الأخطاء
- تم إصلاح
ConcurrentModificationExceptionعند استخدام مثيلاتViewModelمرتبطة بمثيلاتViewModelStoreمتعددة ومختلفة ضمن نطاق الرسم البياني للتنقّل. (aosp/1112257)
الإصدار 2.2.0-alpha02
5 سبتمبر 2019
تم طرح androidx.navigation:navigation-*:2.2.0-alpha02. يمكنك الاطّلاع على التعديلات في هذا الإصدار هنا.
الميزات الجديدة
- أصبحت الروابط لصفحات في التطبيق التي تتضمّن معلَمات طلب البحث تتيح إعادة ترتيب معلَمات طلب البحث، وأصبحت الوسيطات التي لها قيمة تلقائية أو التي يمكن أن تكون فارغة اختيارية عند مطابقة الروابط لصفحات في التطبيق. (b/133273839)
- يمكنك الآن استدعاء
NavController.getBackStackEntry()، مع تمرير معرّف وجهة أو رسم بياني للتنقّل في الأنشطة السابقة. يوفّر عنصرNavBackStackEntryالذي تم إرجاعهLifecycleOwnerوViewModelStoreOwnerمستندَين إلى التنقّل (وهما نفس العنصرَين اللذين تم إرجاعهما من خلالNavController.getViewModelStoreOwner()) وSavedStateRegistryOwner، بالإضافة إلى توفير الوسيطات المستخدَمة لبدء هذه الوجهة. (aosp/1101691 وaosp/1101710)
إصلاح الأخطاء
- تم إصلاح مشكلة تعذُّر إضافة
NavHostFragmentإلىViewPager2بسببIllegalArgumentException. (b/133640271) - يتجنّب
NavInflaterالآن استدعاءgetResourceName()بدون داعٍ، ما يسرّع وقت التضخّم بنسبة تصل إلى %40. (b/139213740)
الإصدار 2.2.0-alpha01
7 أغسطس 2019
تم طرح androidx.navigation:navigation-*:2.2.0-alpha01. يمكنك الاطّلاع على التعديلات في هذا الإصدار هنا.
الميزات الجديدة
- أصبح
SavedStateViewModelFactoryالآن المصنع التلقائي المستخدَم عند استخدامby navGraphViewModels()أو مُنشئViewModelProviderمعViewModelStoreOwnerالذي يعرضهNavController.getViewModelStoreOwner(). (b/135716331)
تغييرات واجهة برمجة التطبيقات
- من Navigation
2.1.0-rc01: تمت إزالة واجهة برمجة التطبيقاتgetViewModelStore()المتوقفة نهائيًا علىNavControllerوالتي تم تقديمها في2.1.0-alpha02. (aosp/1091021)
إصلاح الأخطاء
- يستخدم
NavHostFragmentالآنFragmentContainerView، ما يؤدي إلى إصلاح مشاكل ترتيب z في الصور المتحركة وإرسال مجموعات النوافذ إلى الأجزاء. (b/137310379)
الإصدار 2.1.0
الإصدار 2.1.0
5 سبتمبر 2019
تم طرح androidx.navigation:navigation-*:2.1.0. يمكنك الاطّلاع على التعديلات في هذا الإصدار هنا.
تغييرات مهمة منذ الإصدار 2.0.0
- تحديد نطاق ViewModels في رسم بياني للتنقّل: يمكنك الآن إنشاء ViewModels التي يتم تحديد نطاقها على مستوى الرسم البياني للتنقّل باستخدام المفوَّض الخاص بالسمة
by navGraphViewModels()لمستخدمي Kotlin الذين يستخدمون مكتبات-ktxأو باستخدام واجهة برمجة التطبيقاتgetViewModelStoreOwner()التي تمت إضافتها إلىNavController. لمزيد من المعلومات، يُرجى الاطّلاع على مشاركة البيانات ذات الصلة بواجهة المستخدم بين الوجهات. - وجهات مربّعات الحوار: يمكنك الآن إنشاء وجهات
<dialog>ستعرضDialogFragmentعندnavigateإليها. يتيحNavHostFragmentاستخدام وجهات مربّعات الحوار تلقائيًا. لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء وجهة من DialogFragment. - التنقّل حسب معرّف الموارد المنتظم (URI): يمكنك الآن
navigateباستخدامUri، والذي يستخدم<deepLink>الذي أضفته إلى وجهة للانتقال إليها. لمزيد من المعلومات، يُرجى الاطّلاع على التنقّل باستخدام معرّف الموارد المنتظم (URI). - NavHostController: تم نقل واجهات برمجة التطبيقات المستخدَمة خصيصًا لإنشاء
NavHostمخصّص إلىNavHostController، ما يسمح لعمليات التنفيذ بربطNavControllerبـLifecycleOwnerوOnBackPressedDispatcherوViewModelStoreالمستضيفة.
الإصدار 2.1.0-rc01
7 أغسطس 2019
تم طرح androidx.navigation:navigation-*:2.1.0-rc01. يمكنك الاطّلاع على التعديلات في هذا الإصدار هنا.
تغييرات واجهة برمجة التطبيقات
- تمت إزالة واجهة برمجة التطبيقات
getViewModelStore()المتوقّفة نهائيًا علىNavControllerوالتي تم طرحها في2.1.0-alpha02. (aosp/1091021)
الإصدار 2.1.0-beta02
19 يوليو 2019
تم طرح androidx.navigation:*:2.1.0-beta02. يمكنك الاطّلاع على التعديلات في هذا الإصدار هنا.
إصلاح الأخطاء
- تمت إزالة تبعية jacoco غير المقصودة التي تم تقديمها في
2.1.0-beta01. (b/137782950)
الإصدار 2.1.0-beta01
17 يوليو 2019
تم طرح androidx.navigation:*:2.1.0-beta01. يمكنك الاطّلاع على التعديلات في هذا الإصدار هنا.
الميزات الجديدة
- يُظهر
NavigationUIالآن تأثيرًا متحركًا عند إزالة زر "الانتقال للأعلى" عند استخدامsetupWithNavController()معToolbarأوCollapsingToolbarLayout. (b/131403621)
إصلاح الأخطاء
- تم إصلاح مشكلة في التوقيت عند استخدام عدة NavHostFragments مع الحاوية نفسها مع
findNavController(). (b/136021571)
الإصدار 2.1.0-alpha06
2 يوليو 2019
تم طرح androidx.navigation:*:2.1.0-alpha06. يمكنك الاطّلاع على التعديلات في هذا الإصدار هنا.
الميزات الجديدة
- تم الآن نقل السمة
app:navGraphالتي تستخدمها NavHostFragment إلى العنصرnavigation-runtime. يجب أن تستخدم أدوات التنقّل المخصّصة التي يمكن إضافتها عبر XML هذه السمة للتكامل مع لوحة المضيف في "محرِّر التنقّل". (b/133880955)
تغييرات واجهة برمجة التطبيقات
- تم إيقاف واجهة برمجة التطبيقات
getViewModelStore()فيNavControllerنهائيًا واستبدالها بطريقةgetViewModelStoreOwner()الجديدة التي تعرضViewModelStoreOwner. (aosp/987010) - تم تعميم تنفيذ وجهات النوافذ العائمة، مثل وجهات
<dialog>، في واجهة علامة،FloatingWindow، والتي تنفّذها الآن جميع وجهات<dialog>. تتجاهل الآن طرق NavigationUI للتفاعل مع شريط التطبيقات العلوي وجهاتFloatingWindow. (b/133600763)
التغييرات في السلوك
- يحتفظ التنقّل الآن بحالته بشكل صحيح متزامنًا مع ما يظهر على الشاشة عند استخدام وجهة
<dialog>. نتيجةً لذلك، يزيل مكوّن Navigation الآن تلقائيًا وجهات<dialog>عند الانتقال إلى وجهة ليست مربّع حوار أو نشاطًا، مثل وجهة<fragment>. (b/134089818)
إصلاح الأخطاء
- يمنع مكوّن Navigation الآن ظهور الصورة المتحركة التي تظهر عند إعادة إنشاء النشاط عند التعامل مع رابط لصفحة في التطبيق، ما يؤدي إلى إصلاح وميض مرئي. (b/130362979)
- تم إصلاح خطأ يتعلّق بعدم مزامنة الأنشطة السابقة في التنقّل عند إزالة جزء أثناء إضافة الجزء الأولي. (b/133832218)
الإصدار 2.1.0-alpha05
5 يونيو 2019
تم طرح androidx.navigation:*:2.1.0-alpha05. يمكنك الاطّلاع على التعديلات في هذا الإصدار هنا.
تغييرات واجهة برمجة التطبيقات
- تمت إعادة تسمية واجهات برمجة التطبيقات ذات الصلة بالمضيف في
NavControllerونقلها إلى فئة فرعية جديدة منNavController، وهيNavHostController. (aosp/966091) - تم استبدال طريقة
NavControllersetHostOnBackPressedDispatcherOwner()بطريقةNavHostControllersetOnBackPressedDispatcher()، ويتطلب ذلك الآن استدعاءsetLifecycleOwner()قبل استدعائها. (aosp/965409) - يحتوي
NavHostControllerالآن على طريقةenableOnBackPressed(boolean)تحلّ محلّ فئةNavHostOnBackPressedManagerالتي تم عرضها سابقًا من خلالsetHostOnBackPressedDispatcherOwner(). (aosp/966091)
إصلاح الأخطاء
- تم إصلاح مشكلة عدم صحة الأنشطة السابقة بعد التنقّل باستخدام معرّف الموارد المنتظم (URI). (b/132509387)
- الروابط لصفحات في التطبيق التي يعالجها NavController تلقائيًا يتم تشغيلها الآن مرة واحدة فقط. (b/132754763)
الإصدار 2.1.0-alpha04
16 مايو 2019
تم طرح androidx.navigation:*:2.1.0-alpha04. يمكنك الاطّلاع على التعديلات في هذا الإصدار هنا.
إصلاح الأخطاء
- يستجيب
NavHostFragmentبشكل صحيح لـapp:defaultNavHostعند اعتراض أحداث زر الرجوع في النظام، ما يؤدي إلى إصلاح مشكلة في التنقّل في2.1.0-alpha03. b/132077777 - يعالج
DialogFragmentNavigatorالآن عملياتpopBackStack()وnavigateUp()بشكل صحيح. b/132576764 - تم إصلاح مشكلة في
IllegalStateException: unknown destination during restoreعند التنقّل بشكل متكرّر بين الرسوم البيانية المُدمَجة. b/131733658
الإصدار 2.1.0-alpha03
7 مايو 2019
تم طرح androidx.navigation:*:2.1.0-alpha03. يمكنك الاطّلاع على التعديلات في هذا الإصدار هنا.
المشاكل المعروفة
- يواصل NavHostFragment اعتراض زر الرجوع في النظام على الرغم من استخدام
app:defaultNavHost="false"b/132077777
الميزات الجديدة
- يمكنك الآن إنشاء وجهات
<dialog>ستعرضDialogFragmentعندnavigateإليها. يتيحNavHostFragmentوجهات مربّعات الحوار تلقائيًا. b/80267254 - بالإضافة إلى استدعاء
navigateباستخدام معرّف مورد أو مثيلNavDirections، يمكنك الآن التنقّل عبرUri، والذي يستخدم<deepLink>الذي أضفته إلى وجهة للانتقال إلى الوجهة الصحيحة. b/110412864
التغييرات في السلوك
- تمت زيادة سرعة الصور المتحركة التلقائية التي توفّرها NavigationUI من 400 ملي ثانية إلى 220 ملي ثانية لتتطابق مع سرعة الصور المتحركة التلقائية للأنشطة والأجزاء. b/130055522
تغييرات واجهة برمجة التطبيقات
- تم إيقاف طريقة
createFragmentNavigator()فيNavHostFragmentنهائيًا ونقل وظيفتها إلى طريقةonCreateNavController()الجديدة لتوضيح أنّها نقطة الدخول الصحيحة لإضافة عناصر Navigator مخصّصة عند إنشاء فئة فرعية منNavHostFragment. b/122802849 - تمت إضافة طريقة
hasDeepLink()إلىNavDestinationللسماح لك بالتحقّق مما إذا كان يمكن معالجةUriمعيّن من خلال تلك الوجهة أو، في حالةNavGraph، أي وجهة في الرسم البياني للتنقّل. b/117437718
إصلاح الأخطاء
- يتم الآن تمرير الوسيطات التلقائية بشكل صحيح إلى مثيلات
OnDestinationChangedListener. b/130630686 - يعترض
NavHostFragmentالآن أحداث "الرجوع" في النظام باستخدامOnBackPressedDispatcher، ما يؤدي إلى إصلاح مشكلة عند إجراء تنقّل شرطي في طرق مراحل نشاط "الجزء" عند العودة إلى "الجزء". b/111598096 - بالنسبة إلى Safe Args، يتم الآن استنتاج
android:defaultValue=”@null”بشكل صحيح كوسيطةstringمعapp:argTypeغير محدّد. b/129629192
الإصدار 2.1.0-alpha02
3 أبريل 2019
تم طرح androidx.navigation:*:2.1.0-alpha02. يمكنك الاطّلاع على التعديلات في هذا الإصدار هنا.
الميزات الجديدة
- يمكنك الآن إنشاء ViewModels على مستوى الرسم البياني للتنقّل من خلال مفوّض السمة
by navGraphViewModels()لمستخدمي Kotlin أو باستخدام واجهة برمجة التطبيقاتgetViewModelStore()التي تمت إضافتها إلىNavController. b/111614463
تغييرات واجهة برمجة التطبيقات
- يمكنك الآن إضافة
app:targetPackageإلى وجهة<activity>للحدّ من اسم الحزمة المطابق. يتيح هذا الإعداد استخدامapp:targetPackage="${applicationId}"لتقييد الحزمة على معرّف تطبيقك. b/110975456
إصلاح الأخطاء
- لم يعُد يتم تحليل
android:nameلوجهات<activity>إلى فئة في وقت التضخيم، ما يمنع حدوث ClassNotFoundExceptions عند استخدام الميزات الديناميكية. b/124538597
الإصدار 2.1.0-alpha01
19 مارس 2019
هذا هو الإصدار الأوّلي الأول من Navigation 2.1.0.
التغييرات في التبعيات
- يعتمد التنقّل الآن على
androidx.core:core:1.0.1وandroidx.fragment:fragment:1.1.0-alpha05. يزيل هذا الإصدار أيضًا الاعتماد علىandroidx.legacy:legacy-support-core-utils:1.0.0. b/128632612
التغييرات في واجهة برمجة التطبيقات
- تمت إضافة طريقة
Navigation.createNavigateOnClickListener(NavDirections)جديدة كبديل لإنشاء متتبِّع نقرات باستخدام معرّف مورد وحزمة. b/127631752 - تم إيقاف "
FragmentNavigator.instantiateFragment" نهائيًا. يستخدم التنفيذ التلقائي الآنFragmentFactoryلإنشاء مثيل من Fragments. b/119054429
إصلاح الأخطاء
- لم يعُد مكوّن Navigation يرسل قيمة فارغة لـ
Bundleعندما تكون هناك وسيطات مرتبطة بوجهة معيّنة، ما يؤدي إلى حلّ مشكلة عند استخدامandroid:defaultValue="@null". b/128531879 - يعتمد Safe Args الآن على الإصدار 1.1.0 من KotlinPoet، ما يحلّ مشكلة أسماء الحِزم الطويلة جدًا. b/123654948
الإصدار 2.0.0
الإصدار 2.0.0
14 مارس 2019
تم إصدار الإصدار 2.0.0 من حزمة تطوير البرامج (SDK) الخاصة بالتنقّل بدون أي تغييرات عن الإصدار 2.0.0-rc02.
الإصدار 2.0.0-rc02
6 مارس 2019
يوفّر الإصدار 2.0.0-rc02 من مكوّن Navigation عناصر جديدة باستخدام معرّف المجموعة androidx.navigation ويغيّر تبعياته إلى ما يعادلها في AndroidX.
يتطابق سلوك الإصدار 2.0.0-rc02 مع سلوك الإصدار 1.0.0-rc02 من مكوّن Navigation، ولن تحتاج إلى إجراء أي تغييرات على الرمز البرمجي لتحديث الإصدار 1.0.0-rc02 سوى تحديث التبعيات لتتطابق مع التبعيات الجديدة.
يجب أن يكون مشروعك قد انتقل إلى AndroidX لاستخدام الإصدارات 2.X من Navigation. سيكون الإصدار الثابت Navigation 1.0 هو آخر إصدار يستخدم تبعيات مكتبة الدعم، وستستند جميع عمليات التطوير المستقبلية بعد الإصدار 1.0 إلى AndroidX وستعتمد على الإصدار الثابت 2.0.
التبعيات السابقة لنظام AndroidX
بالنسبة إلى إصدارات Navigation السابقة لإصدار AndroidX، يجب تضمين التبعيات التالية:
dependencies {
def nav_version = "1.0.0"
implementation "android.arch.navigation:navigation-fragment:$nav_version" // For Kotlin use navigation-fragment-ktx
implementation "android.arch.navigation:navigation-ui:$nav_version" // For Kotlin use navigation-ui-ktx
}
بالنسبة إلى Safe args، أضِف
classpath التالي في ملف build.gradle المستوى الأعلى
buildscript {
repositories {
google()
}
dependencies {
classpath "android.arch.navigation:navigation-safe-args-gradle-plugin:1.0.0"
}
}
الإصدار 1.0.0
الإصدار 1.0.0
14 مارس 2019
تم إصدار الإصدار 1.0.0 من حزمة تطوير البرامج (SDK) الخاصة بالتنقّل بدون أي تغييرات عن الإصدار 1.0.0-rc02.
الإصدار 1.0.0-rc02
26 شباط (فبراير) 2019
هذا هو الإصدار المحتمل الثاني للإصدار الثابت 1.0.0 من Navigation. يتضمّن هذا الإصدار عددًا من إصلاحات الأخطاء.
إصلاح الأخطاء
- تم إصلاح مشكلة تجاهل
popBackStack()إذا لم يكن للرسم البياني الجذر رقم تعريف b/126251695 - يتعامل
navigateUp()الآن بشكل صحيح مع التنقّل مرة أخرى إلى مهمة تطبيقك عند استدعائه بعد التعامل مع رابط عميق بدونFLAG_ACTIVITY_NEW_TASKb/126082008 - تم إصلاح مشكلة عدم تطبيق
ActivityNavigator.applyPopAnimationsToPendingTransitionللحركة الصحيحة عند الخروج من النافذة المنبثقة b/126237567 - يستخدم رمز Kotlin الذي تم إنشاؤه بواسطة Safe Args الآن أحرف الإلغاء بشكل صحيح في كلمات Kotlin الرئيسية، مثل
inوfunفي اسم الحزمة المرتبط بالفئةR. b/126020455
الإصدار 1.0.0-rc01
21 فبراير 2019
هذا إصدار محتمل للإصدار الثابت 1.0.0 من Navigation. يتضمّن هذا الإصدار إصلاحًا لخطأ واحد.
إصلاح الأخطاء
- تم إصلاح مشكلة عند استخدام Fragments وعمليات التنقّل في
singleTopb/124294805
الإصدار 1.0.0-beta02
12 فبراير 2019
يتضمّن هذا الإصدار عددًا من التحسينات البسيطة والإصلاحات المهمة للأخطاء.
الميزات الجديدة
- يمكنك الآن استخدام
0كـandroid:defaultValueلوسيطاتreference. b/124248602
التغييرات في السلوك
- يتم الآن إعطاء الأولوية للمطابقات التامة للروابط العميقة على الروابط العميقة التي تتضمّن تطابقات
.*أو وسيطات. b/123969518
إصلاح الأخطاء
- تعرض الآن الدالتان
popBackStack()وnavigateUpالقيمةfalseبشكل صحيح عند إزالة آخر وجهة من الأنشطة السابقة، ما يؤدي إلى إصلاح مشكلة تراجُع الأداء التي حدثت في الإصدار1.0.0-beta01. b/123933201 - يضبط مكوّن Navigation الآن
ClassLoaderبشكل صحيح أثناء استعادة حالة المثيل المحفوظة، ما يجنّب حدوث مشاكل عند استخدام فئات مخصّصة في حالةNavigatorالمحفوظة أو في الوسيطات المُرسَلة إلىNavDestination. b/123893858 - لم تعُد فئات NavArgs التي تم إنشاؤها من خلال Safe Args تتعطّل عند استعادة وسيطة
Parcelable[]من حالة مثيل محفوظة. b/123963545 - تعمل مكوّنات Safe Args الآن على تنظيف فئات Kotlin التي تم إنشاؤها بشكل غير ضروري. b/124120883
الإصدار 1.0.0-beta01
4 شباط (فبراير) 2019
هذا هو الإصدار التجريبي الأول من Navigation، ومن المتوقع أن تظل واجهة برمجة التطبيقات Navigation API مستقرة حتى الإصدار التالي ما لم تكن هناك مشكلة خطيرة. يتضمّن هذا الإصدار بعض إصلاحات الأخطاء وتغييرات في السلوك.
التغييرات في السلوك
- يضمن مكوّن Navigation الآن التعامل مع القيم التلقائية للوسيطات بشكل متطابق
في وقت التشغيل ومن خلال Safe Args. نتيجةً لذلك، يمكن فقط للوسيطات التي تحتوي على
app:argType="reference"أن تشير قيمة تلقائية إلى مورد آخر (على سبيل المثال،@color/colorPrimary). ستؤدي محاولة استخدام قيمة تلقائية مرجعية معapp:argTypeمختلف إلى حدوث استثناء عند تحليل ملف XML للتنقّل. b/123551990 - يعتمد Safe Args الآن على الإصدار 3.3.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android aosp/888413
- يعتمد Safe Args الآن على الإصدار 1.3.20 من Kotlin aosp/888414
إصلاح الأخطاء
- يمكن الآن استخدام Safe Args في وحدات المكتبات والميزات في جميع إصدارات المكوّن الإضافي لنظام Gradle المتوافق مع Android. b/121304903
- تم إصلاح مشكلة تراجُع في الأداء كانت تؤدي إلى تنفيذ عملية
popBackStack()واحدة لإزالة جميع نُسخ الوجهة من أعلى الأنشطة السابقة، بدلاً من إزالة وجهة واحدة فقط في كل مرة. b/123552990 - تم إصلاح مشكلة كانت تؤدي إلى إلغاء مزامنة حالة
FragmentNavigatorمع حالةNavController، ما يتسبب في حدوثIllegalStateExceptionعند محاولة استعادة الأنشطة السابقة. b/123803044 - تم إصلاح مشكلة عدم ظهور سهم الرجوع الذي يعالجه
NavigationUIعند استخدام ProGuard مع التعتيم. b/123449431 - يعالج الرمز الذي تم إنشاؤه بواسطة Safe Args الآن بشكل صحيح استخدام
app:argTypeيشير إلى فئة داخلية ثابتة بالتنسيق.OuterClass$InnerClass. b/123736741 - يعالج رمز Java الذي تم إنشاؤه بواسطة Safe Args الآن الإجراءات العامة والوجهات المتداخلة بشكل صحيح. b/123347762
الإصدار 1.0.0-alpha11
23 يناير 2019
هذا إصدار عاجل من 1.0.0-alpha10 يعمل على حلّ مشكلة في Safe Args.
إصلاح الأخطاء
- تم إصلاح مشكلة تعذُّر استيراد Safe Args لفئة الاتجاهات المرتبطة بالإجراءات العامة. b/123307342
الإصدار 1.0.0-alpha10
23 يناير 2019
المشاكل المعروفة
- يتعذّر على Safe Args استيراد فئة Directions المرتبطة بالإجراءات العامة. b/123307342
يتضمّن هذا الإصدار تغييرات قد تؤدي إلى عطل في واجهة برمجة التطبيقات. يُرجى الاطّلاع على قسم التغييرات التي قد تؤدي إلى عطل أدناه.
الميزات الجديدة
- يمكن لمستخدمي Kotlin الآن استخدام المفوَّض الخاص بالسمة
by navArgs()للحصول على مرجع لفئةNavArgsتم إنشاؤها باستخدام Safe Args فيActivityأوFragment. b/122603367 - يتيح لك Safe Args الآن إنشاء رمز Kotlin من خلال تطبيق المكوّن الإضافي
androidx.navigation.safeargs.kotlin. تم إنشاء رمز Kotlin خصيصًا للوحدات التي تستخدم Kotlin فقط، وذلك باستخدام الوسيطات التلقائية والفئات غير القابلة للتغيير بدلاً من نمط أداة الإنشاء الذي لا يزال متاحًا من خلال المكوّن الإضافيandroidx.navigation.safeargsالسابق. b/110263087
التغييرات في السلوك
- يتم الآن تفضيل الروابط لصفحات معيّنة في التطبيق التي تتطابق مع الرابط لصفحة معيّنة في التطبيق الذي يحتوي على أكبر عدد من الوسيطات المتطابقة. b/118393029
- سيؤدي استدعاء
setGraph()علىNavControllerالآن إلى إعادة ضبط الأنشطة السابقة. b/111450672 - لم تعُد الروابط لصفحات معيّنة غير المعروفة تؤدي إلى ظهور
IllegalStateException، ولكن يتم تجاهلها، ما يؤدي إلى حلّ المشاكل المتعلّقة بـNavHostFragmentالمتداخلة أو المتعددة. b/121340440
التغييرات التي قد تؤدي إلى أعطال
- تم نقل طريقة
NavOptions.applyPopAnimationsToPendingTransition()لتطبيق الصور المتحركة المنبثقة على نشاط إلىActivityNavigator. b/122413117 - يتجنّب Safe Args الآن تكرار الفئات المتطابقة للإجراءات التي لا تتضمّن وسيطات. أصبح نوع القيمة التي تم إرجاعها لأساليب عدم استخدام الوسيطات في فئات NavDirections التي تم إنشاؤها هو
NavDirections. b/123233147 - لم تعُد فئات Directions التي تم إنشاؤها من خلال Safe Args تتضمّن دالة إنشاء علنية، بل يجب التفاعل فقط مع الطرق الثابتة التي تم إنشاؤها. b/123031660
- لم تعُد فئات
NavDirectionsالتي تم إنشاؤها من خلال Safe Args تحتوي على دالة إنشاء علنية، بل يجب إنشاؤها فقط من خلال الطرق الثابتة في فئات الاتجاهات التي تم إنشاؤها. b/122963206 - تم الآن وضع علامة على
Bundleالذي تم إرجاعه منgetArguments()في "NavDirections" على أنّه@NonNullبدلاً من@Nullable. b/123243957
إصلاح الأخطاء
- يعالج
NavDeepLinkBuilderالآن بشكل صحيح طلباتPendingIntentالمتعددة المتزامنة إلى الوجهة نفسها باستخدام الوسيطات التي يتم تمريرها لتحديد مدى التفرد. b/120042732 - يعالج
NavControllerالآن عملياتpopBackStack()بشكل صحيح عند استخدامNavHostFragmentمدمج أو أجزاء فرعية أخرى مع الأنشطة السابقة. b/122770335 - يضبط
NavigationUIالآن وصف محتوى الزر "أعلى" بشكل صحيح. b/120395362 - تعالج الآن فئات Directions التي تم إنشاؤها من خلال Safe Args الإجراءات العامة التي لها رقم التعريف نفسه كإجراء على وجهة معيّنة بشكل صحيح. b/122962504
- تحتوي الآن فئات
NavDirectionsالتي تم إنشاؤها باستخدام Safe Args على قيمhashCode()متساوية بشكل صحيح عندما تعرض دالةequals()القيمة "صحيح". b/123043662 - يعرض
FragmentNavigatorالآن رسالة خطأ أفضل إذا حاولت إجراءFragmentTransactionsمخصّص علىFragmentManagerفيNavHostFragment. يجب دائمًا استخدامgetChildFragmentManager(). b/112927148
الإصدار 1.0.0-alpha09
18 كانون الأول (ديسمبر) 2018
يتضمّن هذا الإصدار تغييرات قد تؤدي إلى عطل في واجهة برمجة التطبيقات. يُرجى الاطّلاع على قسم التغييرات التي قد تؤدي إلى عطل أدناه.
لقد اخترنا عدم مواصلة تطوير
المنتج النهائي android.arch.navigation:navigation-testing. على الرغم من أنّها أثبتت فائدتها في الاختبار الداخلي لـ NavController، ننصح بشدة باستخدام استراتيجيات اختبار بديلة، مثل محاكاة مثيل NavController للتحقّق من إجراء طلبات navigate() الصحيحة. تمت مناقشة هذا النهج بالتفصيل في جلسة "النشاط الفردي" في مؤتمر AndroidDevSummit لعام 2018، وسنعمل على توفير مستندات إضافية حول الاختبار باستخدام مكوّن "التنقّل".
الميزات الجديدة
- لن يؤدي استخدام
MenuItemمعmenuCategory="secondary"إلى إزالة الأنشطة السابقة عند استخدامها مع طرقNavigationUI. b/120104424 - تتيح لك السمة
AppBarConfigurationالآن ضبط مثيل احتياطيOnNavigateUpListenerسيتم استدعاؤه عندما تعرض السمةnavController.navigateUp()false. b/79993862 b/120690961
التغييرات التي قد تؤدي إلى أعطال
- عند استخدام
<argument>معargType="reference"، لن يحلّل مكوّن Navigation المرجع، بل سيقدّم معرّف المورد الأوّلي نفسه. b/111736515 onNavDestinationSelected()now pops back to the start destination of your navigation graph by default, making them consistent with thesetupmethods. أضِفmenuCategory="secondary"إلىMenuItemلتجنُّب إزالة الأنشطة السابقة. aosp/852869- تتطلّب الآن طرق
fromBundle()لفئاتArgsالتي تم إنشاؤها استخدامBundleغير فارغ بدلاً منBundleفارغ aosp/845616
إصلاح الأخطاء
- يتم الآن تحليل الوسيطات بشكل صحيح من الروابط العميقة على أنّها
argTypeالصحيحة بدلاً من تحليلها دائمًا كسلاسل b/110273284 - يتم الآن تصدير الموارد العامة بشكل صحيح في مكوّن Navigation b/121059552
- أصبح Safe Args متوافقًا الآن مع الإصدار 3.4 Canary 4 من المكوّن الإضافي لنظام Gradle المتوافق مع Android والإصدارات الأحدث b/119662045
الإصدار 1.0.0-alpha08
6 ديسمبر 2018
يتضمّن هذا الإصدار تغييرات قد تؤدي إلى عطل في واجهة برمجة التطبيقات. يُرجى الاطّلاع على قسم التغييرات التي قد تؤدي إلى عطل أدناه.
الميزات الجديدة
- عند استخدام تصنيفات الوجهة مع طرق
NavigationUI، سيتم الآن تلقائيًا استبدال مثيلات{argName}فيandroid:labelبالوسيطة الصحيحة b/80267266 - يعتمد مكوّن التنقّل الآن على Support Library 28.0.0 b/120293333
التغييرات التي قد تؤدي إلى أعطال
- تم تغيير اسم "
OnNavigatedListener" إلى "OnDestinationChangedListener" b/118670572 -
OnDestinationChangedListenerالآن يمرر أيضًاBundleمن الوسيطات aosp/837142 - تمت إزالة السمتَين
app:clearTaskوapp:launchDocumentوالطرق المرتبطة بهما. استخدِمapp:popUpToمع جذر الرسم البياني لإزالة جميع الوجهات من الأنشطة السابقة. b/119628354 - يستخدم
ActivityNavigator.Extrasالآن نمطBuilderويضيف إمكانية ضبط أي علاماتIntent.FLAG_ACTIVITY_aosp/828140 - تم تغيير اسم "
NavController.onHandleDeepLink" إلى "handleDeepLink" aosp/836063 - تم جعل العديد من الفئات والطرق غير المخصّصة للفئات الفرعية، مثل
NavOptionsوNavInflaterوNavDeepLinkBuilderوAppBarConfiguration،finalaosp/835681 - تمت إزالة طريقة
NavHostFragment.setGraph()المتوقفة نهائيًا aosp/835684 - تمت إزالة طريقة
NavigationUI.navigateUp(DrawerLayout, NavController)المتوقفة نهائيًا. aosp/835684 - تم نقل عملية إنشاء Fragment إلى
FragmentNavigator، ما يسهّل تفويض عملية إنشاء Fragment إلىFragmentFactory. b/119054429 - لم يعُد مُنشئ "
NavGraphNavigator" يتطلّب "Context" aosp/835340 - أصبحت NavigatorProvider الآن
فئة بدلاً من واجهة. لم تتغيّر وظيفة
NavigatorProviderالتي تعرضهاgetNavigatorProvider(). aosp/830660 - تمّت إزالة "
NavDestination.navigate()". يمكنك الاتصال بـ "navigate()" على "Navigator" بدلاً من ذلك. aosp/830663 - تمت إعادة هيكلة
Navigatorبشكل كبير، ما أدى إلى إزالة الحاجة إلىOnNavigatorNavigatedListenerوبدلاً من ذلك، يتم عرضNavDestinationالذي تم الانتقال إليه من خلالnavigate. - لم يعُد بإمكان مثيلات "
Navigator" إرسال أحداث POP إلى "NavController". ننصحك باستخدامOnBackPressedCallbackلاعتراض الضغطات على زر الرجوع واستدعاءnavController.popBackStack(). aosp/833716
إصلاح الأخطاء
popUpToتعمل الآن بشكل متّسق عندما تكون الوجهة عنصر<navigation>b/116831650- تم إصلاح عدد من الأخطاء التي تسبّبت في حدوث
IllegalArgumentExceptionعند استخدام الرسوم البيانية المُدمَجة b/118713731 b/113611083 b/113346925 b/113305559 - ستتم الآن تعبئة السمة
dataPatternلوجهات<activity>بالوسيطات من وسيطات غير سلاسل من خلال استدعاءtoString()b/120161365
Safe Args
- تتيح Safe Args استخدام عناصر Serializable، بما في ذلك قيم Enum. يمكن لأنواع التعداد
ضبط قيمة تلقائية باستخدام قيمة التعداد الحرفية بدون اسم الفئة
(مثلاً،
app:defaultValue="READ") b/111316353 - يتيح Safe Args استخدام مصفوفات من جميع الأنواع المتوافقة b/111487504
- يتجاهل Safe Args الآن المجلدات الفرعية لأدلة الموارد b/117893516
- يضيف Safe Args تعليقات توضيحية من النوع
@Overrideعند الاقتضاء b/117145301
الإصدار 1.0.0-alpha07
29 أكتوبر 2018
الميزات الجديدة
- تتيح لك فئة AppBarConfiguration الجديدة تخصيص الوجهات التي تُعتبر وجهات ذات مستوى أعلى. يمكنك الاطّلاع على المستندات المعدَّلة لمزيد من التفاصيل. b/117333663
- يمكنك الآن تمرير الوسيطات إلى الوجهة الأولى في الرسم البياني b/110300470
- أصبحت الروابط لصفحات معيّنة متوافقة الآن مع المخططات المخصّصة التي تحتوي على نقاط وواصلات وعلامات زائد. b/112806402
التغييرات التي قد تؤدي إلى أعطال
- تم دمج وحدة "
navigation-testing-ktx" في "navigation-testing artifact" ولن يتم نشرها بعد الآن. - يعتمد العنصر
navigation-testingالآن على مكتبة Kotlin العادية. تم تغيير واجهة برمجة التطبيقات لتكون أكثر اتساقًا مع اصطلاحات Kotlin، ولكن يمكنك مواصلة استخدامها للاختبارات المكتوبة بلغة Java. - لم تعُد الرسوم البيانية للتنقّل المسجَّلة في بيان البيانات الوصفية متاحة. b/118355937
- لم يعُد من الممكن إرفاق الإجراءات بوجهات <activity>. aosp/785539
إصلاح الأخطاء
- أصبحت الروابط العميقة تحلّل الآن معلمات طلب البحث بشكل صحيح. b/110057514
- تطبّق وجهات الأنشطة الآن جميع حركات الدخول والخروج بشكل صحيح. b/117145284
- تم إصلاح العطل الذي يحدث بعد تغيير الإعدادات عند استخدام أدوات التنقّل المخصّصة. b/110763345
Safe Args
- أصبح لدى Safe Args الآن تبعية ثابتة على الإصدار 3.2.1 من المكوّن الإضافي لنظام Gradle المتوافق مع Android. b/113167627
- يمكن الآن إنشاء الاتجاهات للفئات الداخلية. b/117407555
- تم إصلاح مشكلة في إنشاء اتجاهات إلى رسم بياني <include>. b/116542123
الإصدار 1.0.0-alpha06
20 سبتمبر 2018
الميزات الجديدة
- أصبحت انتقالات العناصر المشتركة لوجهات Fragment وActivity متاحة الآن b/79665225. لمزيد من المعلومات، يُرجى الاطّلاع على تنفيذ التنقّل باستخدام مكوّن بنية التنقّل
- سيؤدي اختيار عنصر في
NavigationViewالآن إلى إغلاق أي بطاقة سفلية تحتوي عليه b/112158843
التغييرات في واجهة برمجة التطبيقات
- تغيير قد يؤدي إلى عطل: تتطلّب طريقة Navigator
navigate()الآن مَعلمةNavigator.Extras. - أصبحت طريقة
getGraph()في NavController الآنNonNullb/112243286
إصلاح الأخطاء
- لم يعُد
NavigationUI.setupWithNavController()يسرّب المشاهدات إذا تم استخدامه مع مشاهدات من وجهات فردية b/111961977 - يتم الآن استدعاء Navigator
onSaveState()مرة واحدة فقط b/112627079
Safe Args
- أصبحت فئات الاتجاهات الخاصة بوجهة التنقّل الآن تمدّد فئة الاتجاهات الرئيسية في حال توفّرها b/79871405
- تتضمّن فئتا Directions وArgs الآن تنفيذًا مفيدًا لـ
toString()b/111843389
الإصدار 1.0.0-alpha05
10 أغسطس 2018
إصلاح الأخطاء
- تم إصلاح خطأ يتسبب في سلوك غير صحيح في حزمة الرجوع. b/111907708
- تم إصلاح خطأ في
equals()من فئات Generated Args. b/111450897 - تم إصلاح مشكلة تعذُّر إنشاء Safe Args. b/109409713
- تم إصلاح مشكلة في تحويل معرّفات الموارد إلى أسماء Java b/111602491
- تم إصلاح رسائل الخطأ المتعلّقة بقابلية قبول القيم الفارغة في المكوّن الإضافي Safe Args.
- أضِف التعليقات التوضيحية غير المتوفّرة حول إمكانية قبول القيمة الفارغة.
الإصدار 1.0.0-alpha04
19 يوليو 2018
يتضمّن الإصدار 1.0.0-alpha04 من مكوّن Navigation والمكوّن الإضافي Safe Args لنظام Gradle المرتبط به عددًا من التغييرات في واجهة برمجة التطبيقات وتغييرات في السلوك وإصلاحات للأخطاء.
تغييرات في واجهة برمجة التطبيقات أو السلوك
- سيضبط NavHostFragment دائمًا الجزء الحالي كجزء التنقّل الأساسي، ما يضمن إزالة مدراء الأجزاء الفرعية قبل إزالة NavController الخارجي b/111345778
Safe Args
- تغيير قد يؤدي إلى عطل: تم تغيير
app:typeإلىapp:argTypeلتجنُّب حدوث تعارضات مع المكتبات الأخرى، مثل ConstraintLayout 2.0.0-alpha1 b/111110548 - أصبحت رسائل الخطأ من Safe Args قابلة للنقر الآن b/111534438
- تؤكّد فئات Args الآن أنّ سمات
NonNullليست فارغة b/111451769 - تمت إضافة تعليقات توضيحية إضافية من النوع
NonNullإلى الفئات التي تم إنشاؤها من NavDirections وArgs b/111455455 b/111455456
إصلاح الأخطاء
- تم إصلاح مشكلة في زر الرجوع في النظام بعد الربط العميق بوجهة مجزّأة b/111515685
الإصدار 1.0.0-alpha03
12 يوليو 2018
يتضمّن الإصدار 1.0.0-alpha03 من مكوّن Navigation والمكوّن الإضافي Safe Args لنظام Gradle المرتبط به عددًا من التغييرات في واجهة برمجة التطبيقات وتغييرات في السلوك وإصلاحات للأخطاء.
تغييرات في واجهة برمجة التطبيقات أو السلوك
- تمت إضافة طريقة NavigationUI.setupWithNavController لشريط الأدوات b/109868820
- تمت إضافة طريقة NavigationUI.setupWithNavController لـ CollapsingToolbarLayout b/110887183
- تعرض الدالة popBackStack() الآن القيمة "خطأ" عندما تكون الأنشطة السابقة فارغة أو عندما لا يكون رقم تعريف الوجهة المحدّد ضِمن الأنشطة السابقة b/110893637
- يتجاهل FragmentNavigator الآن عمليات التنقّل بعد أن يحفظ FragmentManager الحالة، ما يؤدي إلى تجنُّب استثناءات "لا يمكن تنفيذ هذا الإجراء بعد onSaveInstanceState" b/110987825
Safe Args
- تغيير قد يؤدي إلى عطل: سيتم استبدال الأحرف غير الأبجدية الرقمية في أسماء الإجراءات والوسيطات بتنسيق Camel Case في أسماء طرق NavDirections ذات الصلة
- مثلاً، سيصبح
DemoController.indexsetDemoControllerIndexb/79995048 - مثال: سيصبح
action_show_settingsactionShowSettingsb/79642240
- مثلاً، سيصبح
- تغيير قد يؤدي إلى عطل: أصبحت الوسيطات تُعتبر غير فارغة تلقائيًا. للسماح بالقيم الفارغة في وسيطات السلسلة والوسيطات القابلة للتقسيم، أضِف
app:nullable="true"b/79642307 - يمكنك الآن استخدام
app:type="long"مع defaultValues في شكل "123L" b/79563966 - أصبحت وسيطات Parcelable متاحة الآن، باستخدام اسم فئة مؤهَّل بالكامل لـ
app:type. القيمة التلقائية الوحيدة المسموح بها هي"@null"b/79563966 - تنفّذ فئات Args الآن
equals()وhashCode()b/79642246 - يمكن الآن تطبيق المكوّن الإضافي Safe Args على مشاريع المكتبات b/80036553
- يمكن الآن تطبيق المكوّن الإضافي Safe Args على مشاريع الميزات b/110011752
إصلاح الأخطاء
- تم إصلاح المشاكل التي تحدث عند التنقّل أثناء استخدام طرق دورة حياة Fragment b/109916080
- تم إصلاح المشاكل التي تحدث عند التنقّل في الرسوم البيانية المتداخلة عدة مرات b/110178671
- تم إصلاح المشاكل التي تحدث عند استخدام
setPopUpToمع الوجهة الأولى في الرسم البياني b/109909461 - تم إصلاح مشكلة تمرير جميع قيم
app:defaultValueكسلاسل b/110710788 - تضيف أداة aapt2 المضمّنة في الإصدار التجريبي 01 من المكوّن الإضافي لنظام Gradle المتوافق مع Android 3.2 الآن قواعد الاحتفاظ لكل سمة
android:nameفي ملفات XML الخاصة بالتنقّل b/79874119 - تم إصلاح مشكلة تسرُّب الذاكرة عند استبدال FragmentNavigator التلقائي b/110900142
الإصدار 1.0.0-alpha02
7 يونيو 2018
التغييرات في السلوك
يستخدم "
FragmentNavigator" الآن "setReorderingAllowed(true)". b/109826220تفكّ ميزة "التنقّل" الآن ترميز عناوين URL للوسيطات التي تم تحليلها من عناوين URL للروابط لصفحات معيّنة في التطبيق. b/79982454
إصلاح الأخطاء
تم إصلاح
IllegalStateExceptionعند استدعاء التنقّل من إجراءات مراحل نشاط Fragment. b/79632233يعتمد مكوّن Navigation الآن على Support Library 27.1.1 لإصلاح مشكلة الوميض عند استخدام الصور المتحركة. b/80160903
تم إصلاح
IllegalArgumentExceptionعند استخدام defaultNavHost="true" كجزء فرعي. b/79656847تم إصلاح
StackOverflowErrorعند استخدام NavDeepLinkBuilder. b/109653065تم إصلاح
IllegalArgumentExceptionعند الرجوع إلى رسم بياني مدمج. b/80453447تم إصلاح مشكلة تداخل الأجزاء عند استخدام
launchSingleTop. b/79407969تُنشئ ميزة "التنقّل" الآن الأنشطة السابقة الاصطناعية الصحيحة للرسومات البيانية المُدمَجة. b/79734195
ستُبرز NavigationUI الآن العنصر الصحيح عند استخدام رسم بياني مدمج كـ
MenuItem. b/109675998
التغييرات في واجهة برمجة التطبيقات
تم إيقاف سمة
clearTaskللإجراءات وواجهة برمجة التطبيقات المرتبطة بها فيNavOptionsنهائيًا. b/80338878تم إيقاف سمة
launchDocumentللإجراءات وواجهة برمجة التطبيقات المرتبطة بها فيNavOptionsنهائيًا. b/109806636
الإصدار 1.0.0-alpha01
8 مايو 2018
يوفّر مكوّن التنقّل إطار عمل لإنشاء ميزة التنقّل داخل التطبيق. هذا الإصدار الأوّلي هو 1.0.0-alpha01.