التنقل

التنقّل هو إطار عمل للتنقّل بين "الوجهات" داخل تطبيق Android يوفّر واجهة برمجة تطبيقات متّسقة سواء تم تنفيذ الوجهات كأجزاء أو أنشطة أو مكوّنات أخرى.
آخر تحديث الإصدار المستقر إصدار محتمل الإصدار التجريبي الإصدار الأولي
‫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.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 و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: تم إصلاح NavDestination NullPointerException عند تعديل 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)
  • تم إصلاح NavDestination NullPointerException عند تعديل 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)

إصلاح الأخطاء

الإصدار 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 الذي يرجع إليه المستخدم إلى حالة Lifecycle RESUMED بعد إلغاء "إيماءة إظهار شاشة الرجوع". يضمن ذلك أيضًا عودة الوجهة السابقة إلى مكانها بشكل صحيح بدلاً من الانتقال إليه فجأة بعد التمرير السريع. (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

تستخدم هذه الوظيفة 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. ينطبق ذلك أيضًا على NavGraph startDestinations المدمجة. (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)

إصلاح الأخطاء

  • تم إصلاح مشكلة في ميزة "التنقّل" كانت تؤدي إلى DESTROYED NavGraph ViewModels في وقت مبكر جدًا لأنّ ViewModel الإدخال المرتبط لم يكن جزءًا من الحالة المحفوظة. (Ib6bb7، b/317581849)

تحديث الاعتماديات

الإصدار ‎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 هذه التعديلات.

إصلاح الأخطاء

  • تأخذ دالة NavGraph equals() الآن في الاعتبار عُقد الرسم البياني الآخر بشكل صحيح بدلاً من عُقد الرسم البياني الذي يتم استدعاؤه فقط. سيضمن ذلك عدم اعتبار الرسوم البيانية التي تحتوي على عُقد ذات معرّفات مختلفة متساوية (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.DESTROYED ViewModel عند استخدام 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 وRESUMED Activity. (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 فارغ باستخدام navDeepLink Kotlin DSL الآن إلى ظهور تحذير من أداة lint يشير إلى أنّ الرابط العميق يحتاج إلى معرّف موارد منتظم (URI) و/أو إجراء و/أو نوع MIME ليكون صالحًا.

تغييرات مهمة في ميزة "التنقّل باستخدام الأجزاء" منذ الإصدار 2.5.0

  • لم يعُد تطبيق "NavHostFragment" يعترض زر الرجوع في النظام نفسه. يتيح ذلك لـ "FragmentManager" الأساسي معالجة ميزة "الرجوع" في النظام. يسمح هذا الإجراء لـ Fragment 1.7.0-alpha01 والإصدارات الأحدث بتوفير حركة "إيماءة إظهار شاشة الرجوع" داخل التطبيق على أجهزة Android U.
  • عند استخدام ميزة "التنقّل" مع "الأجزاء"، ستؤدي محاولة إجراء FragmentTransaction يدويًا لإضافة جزء إلى الأنشطة السابقة في FragmentManager إلى ظهور IllegalArgumentException. يجب دائمًا إضافة الأجزاء من خلال واجهة برمجة التطبيقات navigate().
  • عند استخدام السلسلة النصية الدقيقة ${applicationId} كعنصر نائب في السمتَين app:data وapp:dataPattern في عنصر النشاط لملف XML للتنقّل، سيتم ملء العنصر النائب تلقائيًا باستخدام packageName السياق عند التضخيم.
  • يستخدم FragmentNavigator الآن واجهات برمجة التطبيقات الخاصة بالانتقال عند التنقّل وعرض NavBackStackEntries. يعني ذلك أنّ NavBackStackEntry Lifecycle سينتظر الآن اكتمال المؤثرات الخاصة للدخول والخروج من الجزء قبل نقل Lifecycle.State النهائي.
  • يستخدم DialogFragmentNavigator الآن واجهات برمجة التطبيقات الخاصة بالانتقال عند التنقّل وعرض NavBackStackEntries. هذا يعني أنّ NavBackStackEntry Lifecycle سينتظر الآن انتقال DialogFragment Lifecycle إلى 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 يزيله في الإطار نفسه، سيتم الآن نقل الإدخال العلوي الناتج في الأنشطة السابقة بشكل متّسق إلى RESUMED Lifecycle.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's FragmentManager بدون استخدام التنقّل إلى حدوث عطل بعد الآن. (b17204، b/274167493)

تحديثات الاعتماديات

الإصدار 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)

التغييرات في واجهة برمجة التطبيقات

  • تم الآن إضافة تعليقات توضيحية إلى جميع عمليات التحميل الزائد لـ NavController navigate باستخدام @MainThread لضمان استدعائها في سلسلة التعليمات الرئيسية. (I2c0b0، b/263427111)

إصلاح الأخطاء

  • تم إصلاح عطل يحدث عند محاولة التنقّل أثناء استخدام ميزة "التنقّل الديناميكي في الأجزاء". (I3ee29، b/268360479)
  • تم إصلاح الخطأ الذي كان يؤدي إلى عدم تحديث الشريط السفلي إلى العنصر المحدّد الصحيح عند الانتقال إلى جزء آخر من خلال زر الرجوع في النظام (If559f، b/269044426)

المشاكل المعروفة

  • عند استخدام ميزة "التنقّل" مع "الأجزاء"، يتعذّر على دورة حياة NavBackStackEntry الوصول إلى RESUMED عند استخدام واجهات برمجة التطبيقات Animation. (b/269646882)
  • عند استخدام مكوّن Navigation مع Fragments والتنقّل باستخدام BottomNavigation، إذا حاولت استعادة أنشطة سابقة تتضمّن إدخالات متعددة، لن يتم تعديل BottomMenuItem بشكل صحيح. (b/270447657)
  • عند استخدام ميزة "التنقّل" مع "الأجزاء"، بعد استعادة الحالة، لا يتم DESTROYED NavBackStackEntry Lifecycle عندما يكون الجزء الخاص به 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. يعني ذلك أنّ NavBackStackEntry Lifecycle سينتظر الآن اكتمال المؤثرات الخاصة للدخول والخروج من الجزء قبل نقل Lifecycle.State النهائي. (I3cb19، b/238686802)
  • يستخدم DialogFragmentNavigator الآن واجهات برمجة التطبيقات الخاصة بالانتقال عند التنقّل وعرض NavBackStackEntries. هذا يعني أنّ NavBackStackEntry Lifecycle سينتظر الآن انتقال DialogFragment Lifecycle إلى 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)

تحديثات الاعتماديات

الإصدار 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 فارغ باستخدام navDeepLink Kotlin 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)

تحديث الاعتماديات

الإصدار 2.5.1

‫27 يوليو 2022

تم طرح androidx.navigation:navigation-*:2.5.1. يتضمّن الإصدار 2.5.1 هذه التعديلات.

إصلاح الأخطاء

  • لن يتسبب Navigation Safe Args بعد الآن في ظهور تحذيرات بشأن الإيقاف النهائي في الفئات التي يتم إنشاؤها عند استخدام أنواع وسيطات مخصّصة يتم حفظها في Bundle. (Id86ed، b/237725966)

تحديثات الاعتماديات

الإصدار 2.5.0

‫29 يونيو 2022

تم طرح androidx.navigation:navigation-*:2.5.0. يتضمّن الإصدار 2.5.0 هذه التعديلات.

تغييرات مهمة منذ الإصدار 2.4.0

  • دمج CreationExtras: أصبح بإمكان Navigation الآن توفير ViewModelProvider.Factory بدون حالة من خلال CreationExtras في Lifecycle 2.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 هذه التعديلات.

التغييرات في واجهة برمجة التطبيقات

إصلاح الأخطاء

  • يعتمد NavHost الآن على visibleEntries من NavController لتحديد الإدخالات التي سيتم إنشاؤها. ويعني ذلك أنّه عند استخدام NavHost مدمج، من المفترض أن يتم الآن عرض NavHost الداخلي بشكل صحيح. (I4ba2b، b/225394514)
  • يستند الآن visibleEntries StateFlow المقدَّم من 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 هذه التعديلات.

الميزات الجديدة

إصلاح الأخطاء

  • تم إصلاح مشكلة تعذُّر الوصول إلى 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 لتستخدم بدلاً من ذلك فئتها العليا التي تم تقديمها في Material 1.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 Compose 2.4.0 أو hiltViewModel() في Hilt Navigation Compose 1.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” />
    
  • في navOptions Kotlin 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()، وهي الطرق التي تعدّل NavBackStackEntry Lifecycle، على أنّها @MainThread، ما يؤدي إلى مواءمة التنقّل مع فرض سلسلة التعليمات الرئيسية التي تم تقديمها في Lifecycle 2.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 المرئية من خلال visibleEntries StateFlow (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)

التغييرات في واجهة برمجة التطبيقات

  • أصبحت دالة navArgument Kotlin DSL الآن جزءًا من navigation-common بدلاً من navigation-compose. سيتطلب ذلك تحديث عمليات الاستيراد لمواصلة استخدام هذه الدالة. (I1d095)

التغييرات في السلوك

  • عند إنشاء الوسيطات، يضع Safe Args الآن المَعلمات التي لا تتضمّن قيمًا تلقائية قبل تلك التي تتضمّن قيمًا تلقائية. (I89709، b/198493585)

إصلاح الأخطاء

  • عند استخدام Navigation Compose، لن يتم DESTROYED NavGraphs إلا بعد DESTROYED جميع العناصر الفرعية. (I86552، b/198741720)
  • لم تعد وسيطات NavDeepLink التي تقبل القيمة الفارغة تتطلّب قيمة تلقائية. (Ia14ef، b/198689811)
  • عند استدعاء setGraph() باستخدام رسم بياني جديد، سيتم الآن أيضًا محو أي أنشطة سابقة محفوظة، بالإضافة إلى السلوك السابق المتمثّل في إزالة الأنشطة السابقة. (I97f96)
  • تم إصلاح مشكلة عدم إرسال إشعارات إلى مثيلات OnDestinationChangedListener وcurrentBackStackEntryFlow عند استخدام launchSingleTop. (Iaaebc)

تحديثات الاعتماديات

الإصدار 2.4.0-alpha08

‫1 سبتمبر 2021

تم طرح androidx.navigation:navigation-*:2.4.0-alpha08. يتضمّن الإصدار 2.4.0-alpha08 هذه التعديلات.

الميزات الجديدة

التغييرات في السلوك

  • عند إنشاء الإجراءات، يضع رمز 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 لتستخدم بدلاً من ذلك فئتها الفائقة التي تم تقديمها في Material 1.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” />
    
  • في navOptions Kotlin 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().

وقد أدى ذلك إلى بعض التغييرات في واجهة برمجة التطبيقات:

  • تم إيقاف سمة popUpTo kotlin نهائيًا في 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()، وهي الطرق التي تعدّل NavBackStackEntry Lifecycle، على أنّها @MainThread، ما يؤدي إلى مواءمة التنقّل مع فرض سلسلة التعليمات الرئيسية التي تم تقديمها في Lifecycle 2.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-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 الآن LocalSavedStateRegistryOwner CompositionLocal باستخدام NavBackStackEntry لتلك الوجهة، ما يضمن حفظ أي حالة يتم حفظها مباشرةً في SavedStateRegistry واستعادتها مع الوجهة. (I435d7، b/179469431)

الإصدار ‎1.0.0-alpha07

‫10 فبراير 2021

تم طرح androidx.navigation:navigation-compose:1.0.0-alpha07. يتضمّن الإصدار 1.0.0-alpha07 هذه التعديلات.

تحديثات الاعتماديات

الإصدار ‎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 الأكثر عمومية التي تمت إضافتها في CustomView 1.1.0 وتم تنفيذها بواسطة DrawerLayout في DrawerLayout 1.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)

تحديثات الاعتماديات

الإصدار ‎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 لمخطّط التنقّل الآن defaultArguments Map للإجراءات، ما يعكس إمكانية ضبط القيم التلقائية على عناصر <action> في ملفات XML الخاصة بالتنقّل. (b/150345605)

إصلاح الأخطاء

  • من Navigation 2.2.2: تم إصلاح IllegalStateException عند الربط العميق بالوجهة الأولى للرسم البياني عندما يكون لديك مثيلات NavHostFragment متعددة في نشاطك. (b/147378752)

تحديثات الاعتماديات

الإصدار 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 التي تم تقديمها في CustomView 1.1.0-alpha02 (التي تنفّذها DrawerLayout اعتبارًا من DrawerLayout 1.1.0-alpha04)، ما يسمح لك باستخدام عمليات تنفيذ مخصّصة لـ Openable مع NavigationUI. (b/129030452)

إصلاح الأخطاء

  • تحتفظ قواعد ProGuard في navigation-common-ktx الآن بشكل صحيح بفئات NavArgs المُستخدَمة فقط بدلاً من جميع نُسخ NavArgs. (b/150213558)

التغييرات في التبعيات

  • تمت إعادة اعتمادية Navigation على Core 1.2.0، وهي تعتمد الآن على Core 1.1.0 لتجنُّب إجبار المطوّرين على الانتقال إلى اعتمادية أحدث عندما لا تعتمد Navigation على أي واجهات برمجة تطبيقات جديدة في Core 1.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)

تحديثات الاعتماديات

الإصدار 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

تحديثات الاعتماديات

الإصدار 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)

تحديثات الاعتماديات

الإصدار 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 لتتطابق مع تأثيرات التلاشي المعدَّلة في Fragment 1.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 SavedState 1.0.0-rc03 وActivity 1.1.0-rc03 وFragment 1.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)
  • تم استبدال طريقة NavController setHostOnBackPressedDispatcherOwner() بطريقة NavHostController setOnBackPressedDispatcher()، ويتطلب ذلك الآن استدعاء 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_TASK b/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 وعمليات التنقّل في singleTop b/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() الصحيحة. تمت مناقشة هذا النهج بالتفصيل في جلسة &quot;النشاط الفردي&quot; في مؤتمر AndroidDevSummit لعام 2018، وسنعمل على توفير مستندات إضافية حول الاختبار باستخدام مكوّن &quot;التنقّل&quot;.

الميزات الجديدة

  • لن يؤدي استخدام 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 the setup methods. أضِف 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، final aosp/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

الميزات الجديدة

التغييرات في واجهة برمجة التطبيقات

  • تغيير قد يؤدي إلى عطل: تتطلّب طريقة Navigator navigate() الآن مَعلمة Navigator.Extras.
  • أصبحت طريقة getGraph() في NavController الآن NonNull b/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.index setDemoControllerIndex b/79995048
    • مثال: سيصبح action_show_settings actionShowSettings b/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.