ניווט

‫Navigation הוא מסגרת לניווט בין "יעדים" באפליקציה ל-Android. הוא מספק ממשק API עקבי, בין אם היעדים מוטמעים כ-Fragments, כ-Activities או כרכיבים אחרים.
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
‫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 לפרויקט, מוסיפים את classpath הבא לקובץ build.gradle ברמה העליונה:

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 או למודולים משולבים של Java ו-Kotlin, מוסיפים את השורה הזו לקובץ 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")
}

צריך להוסיף את android.useAndroidX=true לקובץ gradle.properties בהתאם להוראות במאמר מעבר ל-AndroidX.

מידע על השימוש בתוספים של Kotlin זמין במסמכי התיעוד של ktx.

מידע נוסף זמין במאמר הוספת יחסי תלות ב-build.

משוב

המשוב שלכם עוזר לנו לשפר את Jetpack. נשמח לדעת אם גיליתם בעיות חדשות או אם יש לכם רעיונות איך לשפר את הספרייה הזו. כדאי לעיין בבעיות הידועות בספרייה הזו לפני שמדווחים על בעיה. כדי להוסיף הצבעה בדיווח על בעיה קיימת, לוחצים על כפתור הכוכב.

יצירת דיווח על בעיה חדשה

מידע נוסף זמין במאמרי העזרה בנושא Issue Tracker.

גרסה 2.10.2

‫23 בספטמבר 2026

‫androidx.navigation:navigation-*:2.10.2 מופץ. גרסה 2.10.2 מכילה את ה-commits האלה.

עדכוני תלויות

  • יחסי התלות של androidx.lifecycle עודכנו לגרסה 2.10.0. I4505a9f9a

גרסה 2.10.1

‫9 בספטמבר 2026

‫androidx.navigation:navigation-*:2.10.1 מופץ. גרסה 2.10.1 מכילה את ה-commits האלה.

תיקוני באגים

  • במקרים שבהם 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 נוסף כדי לחשוף תמונות מצב של מקבץ הפעילויות הקודמות (back stack) במהלך אירועי ניווט. כך אפשר להשתמש באנימציות עשירות יותר של חיזוי החזרה בהתאמה אישית.

תמיכה בפלטפורמות נוספות

  • המודולים 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 המינימלית לניווט הועברה ל-API 24, יחד עם שאר הספריות של AndroidX. ‫(I972da,‏ b/474169350)

גרסה ‎2.10.0-beta01

‫29 ביולי 2026

‫androidx.navigation:navigation-*:2.10.0-beta01 מופץ. גרסה ‎2.10.0-beta01 מכילה את השמירות האלה.

שינויים ב-API

  • הוספת NavBackStackEntryInfo כדי לחשוף תמונות מצב של מקבץ פעילויות קודמות (back stack) במהלך אירועי ניווט. כך אפשר להשתמש באנימציות עשירות יותר בהתאמה אישית של חיזוי החזרה. (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 שגרמה ל-Fragments לגיטימיים להקפיץ 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 ל-API 37. כלומר, כשמשתמשים ב-Compose, נדרשת גרסת AGP מינימלית של 9.2.0. (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 המינימלית

תרומה חיצונית

  • navigation:navigation-common, navigation:navigation-runtime ו-navigation:navigation-testing תומכים עכשיו במחשבים, ב-Linux, ב-macOS, ב-iOS, ב-JavaScript וב-WASM, בנוסף ל-Android. תודה לקונסטנטין צחוברוב (Konstantin Tskhovrebov)! (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)
  • תוקנה הבעיה שבה ה-constructor של SavedStateHandle לבדיקה ב-navigation-testing לא פענח את List<String>. (I26aac,b/454180135)

גרסה 2.9.6

‫5 בנובמבר 2025

‫androidx.navigation:navigation-*:2.9.6 מופץ. גרסה 2.9.6 מכילה את השמירות האלה.

תיקוני באגים

  • הפלאגין Navigation SafeArgs הועבר לממשקי ה-API המודרניים של פלאגין של Android Gradle, כדי להבטיח שהוא תואם לכל גרסאות AGP 8.4.2 ואילך. כתוצאה מהשינויים האלה, ספריית הפלט של הקבצים שנוצרו על ידי הפלאגין השתנתה למיקום ברירת המחדל שסופק על ידי AGP. (Ie09d6,‏ I7c431,‏ b/203559535,‏ b/293920476,‏ b/269532448,‏ b/443261197)
  • הפלאגין SafeArgs של Navigation לא ידרוש יותר להגדיר את המאפיין useAndroidX כשמשתמשים בו עם AGP 9.0.0-alpha04 ואילך. (I6c3a4,‏ b/444746731,‏ b/443106400)

גרסה 2.9.5

‫24 בספטמבר 2025

‫androidx.navigation:navigation-*:2.9.5 מופץ. גרסה 2.9.5 מכילה את השמירות האלה.

תיקוני באגים

  • עכשיו Navigation Safe Args יכול לטפל בתמיכה של AGP 9.0 ב-Kotlin מובנה. (I1d9d76)

עדכון של יחסי תלות

  • הפלאגין Navigation Safe Args תלוי עכשיו בפלאגין של Android Gradle בגרסה 8.4.2. (b/431847270,‏ I5932a)

גרסה 2.9.4

‫10 בספטמבר 2025

‫androidx.navigation:navigation-*:2.9.4 מופץ. גרסה 2.9.4 מכילה את ה-commits האלה.

תיקוני באגים

  • מניעת קריסה כשאירוע חיזוי החזרה מועבר באמצע פריים אחרי שהגורם המטפל הושבת במעבר 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 מכילה את ה-commits האלה.

תיקוני באגים

  • תוקנה בעיה שבה הרשומה לא המשיכה לפעול כשתיבת הדו-שיח שמעל הרשומה נסגרה (Idb20e,‏ b/418746335)
  • תוקנה שגיאת MissingFieldException בבדיקת SavedStateHandle עם נתיבים עם מניעת שגיאות הקלדה, תוך שימוש ב-NavTypes בהתאמה אישית. (I2f843, b/421002511)

גרסה 2.9.1

‫2 ביולי 2025

‫androidx.navigation:navigation-*:2.9.1 מופץ. גרסה 2.9.1 מכילה את ה-commits האלה.

תיקוני באגים

  • תוקנה בעיה שגרמה לכך ש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

  • עכשיו אפשר לסמן יעדים ב-Custom Navigators ככאלה שמטמיעים את הממשק SupportingPane, מה שמציין ל-NavController שהיעדים האלה יוצגו לצד יעדים אחרים. לדוגמה, באמצעות הממשק הזה אפשר RESUMED לכמה יעדים בו-זמנית.

Compose Kotlin Multiplatform

  • עכשיו יש ב-Navigation פונקציה נפוצה חדשה, NavController.handleDeepLink(), שמקבלת NavDeepLinkRequest במקום Intent. כך פלטפורמות שהן לא Android יכולות לטפל בקישורי עומק בצורה תקינה. תודה, Konstantin Tskhovrebov!
  • ב-Navigation יש עכשיו את NavUri, פונקציית ניתוח נפוצה חדשה שהיא API תואם ל-URI של Android בפלטפורמות אחרות. כך אפשר ליצור URI באופן שאינו תלוי בפלטפורמה. תודה, Konstantin Tskhovrebov!

פונקציות בטוחות לסוגי נתונים

  • ממשקי ה-API למניעת שגיאות הקלדה, שבעבר היו נגישים רק באמצעות שיטות 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 מכילה את השמירות האלה.

שינויים ב-API

  • ה-API הנפוץ של parseStringAsNavUri השתנה לפונקציית המפעל NavUri שמקבלת מחרוזת. (I4db6e, b/403616316)

עדכוני תלויות

  • הספרייה הזו מטרגטת עכשיו את רמת השפה של Kotlin 2.0 ודורשת KGP 2.0.0 ואילך. (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, שדרשה שקישור עומק יתאים בדיוק לכל השדות של בקשה או Intent של קישור עומק כדי להיחשב כהתאמה. כתוצאה מכך, קישורי עומק שהכילו התאמות חלקיות של שדות ולא הכילו שדות אחרים הפסיקו לפעול. (Ie5e36, b/399826566)

תרומה חיצונית

  • פונקציית ניתוח נפוצה חדשה ליצירת NavUri. תודה, Konstantin Tskhovrebov! (If0a6a)

גרסה ‎2.9.0-alpha07

‫26 בפברואר 2025

‫androidx.navigation:navigation-*:2.9.0-alpha07 מופץ. גרסה ‎2.9.0-alpha07 מכילה את השמירות האלה.

תיקוני באגים

  • תוקנה בעיה שבה ניסיון לבצע saveState עם pop לא כולל גרם ל-savedState ריק, שיכול היה לגרום לקריסה בזמן השחזור. (I9f3e8, b/395091644)
  • מגרסה Navigation 2.8.8: תוקנה ההתאמה של NavDeepLink, שבה קישור עומק ובקשה לקישור עומק צריכים להתאים בדיוק ל-URI, לפעולה ולסוג ה-MIME. אם רק שדה אחד או שניים תואמים, ההתאמה לא תתבצע. (I3b029, b/395712033)
  • מגרסה Navigation 2.8.8: תוקן באג שבו מסלולים עם נתיבים של תווי כלליים לא תואמים לקישור עומק שנוסף (I7ea92,‏ b/389970341)

תרומה חיצונית

  • חילוץ של ממשקי ה-API‏ navigation-common,‏ navigation-runtime ו-navigation-compose לפלטפורמה המשותפת. תודה, Konstantin Tskhovrebov! (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 מכילה את ה-commits האלה.

תיקוני באגים

  • תוקנה בעיה שגרמה לאנימציית קנה מידה לא צפויה כשמשתמשים ב-Navigation Compose. (I480f4, b/353294030)
  • מניווט 2.8.6: תוויות NavDestination שסופקו דרך XML ינותחו באמצעות NavType.get כדי לוודא שהלוגיקה של NavType בהתאמה אישית נשמרת. (I7ec2f, b/388100796)
  • מניווט 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 מכילה את השמירות האלה.

תכונות חדשות

בטבלה הבאה מפורטים ממשקי ה-API של reified ו-KClass.

reified 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)

שינויים ב-API

  • עומס היתר של NavGraph.setStartDestination הספציפי ל-Kotlin למניעת שגיאות הקלדה מוסתר ממקורות Java. (Ic640c, b/364634035)

תיקוני באגים

  • מ-Navigation 2.8.5: תוקנה בעיה שבה NavHost יכול להוביל לחריגה בתוך PredictiveBackHandler אם מקבץ הפעילויות הקודמות (back stack) מצטמצם לרשומה אחת ומופעלת חזרה למערכת באותו פריים. (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 מפעיל שינוי במקבץ הפעילויות הקודמות (back stack) כשהמארח LifecycleOwner, כמו הפעילות או ה-Fragment שמכילים אותו, משנה את מצב מחזור החיים שלו. (Ia9494)

גרסה ‎2.9.0-alpha02

‫30 באוקטובר 2024

‫androidx.navigation:navigation-*:2.9.0-alpha02 מופץ. גרסה ‎2.9.0-alpha02 מכילה את השמירות האלה.

תרומה חיצונית

  • שיטת NavController.handleDeepLink(request: NavDeepLinkRequest) נפוצה חדשה. תודה, Konstantin Tskhovrebov! (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: נוספו בדיקות Lint חדשות למודולים 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 class not found (לא נמצאה מחלקת Enum) כדי להציע להשתמש בהערה @Keep במקרה שמחלקת ה-Enum נמחקת בגרסאות מוקטנות. (I90e79, b/358137294)

בעיות מוכרות

  • יש בעיה בכללי ה-lint החדשים שנוספו ב-Navigation 2.8.*, שגורמת לשגיאת Obsolete custom lint check כשמנסים להריץ את ה-lint עם פלאגין של Android Gradle 8.4 ואילך. (b/368070326,‏ b/371463741)

גרסה 2.8

גרסה 2.8.9

‫12 במרץ 2025

‫androidx.navigation:navigation-*:2.8.9 מופץ. גרסה 2.8.9 מכילה את ה-commits האלה.

תיקוני באגים

  • תוקנה רגרסיה שנמצאה ב-Navigation 2.8.8, שדרשה שקישור עומק יתאים בדיוק לכל השדות של בקשת קישור עומק או Intent כדי להיחשב כהתאמה. כתוצאה מכך, קישורי עומק שהכילו התאמות חלקיות של שדות ולא הכילו שדות אחרים הפסיקו לפעול. (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 מכילה את ה-commits האלה.

תיקוני באגים

  • עכשיו Navigation Safe Args מספק תמיכה ביעדים קומפוזביליים. (I35320,‏ b/362791955)

גרסה 2.8.6

‫29 בינואר 2025

‫androidx.navigation:navigation-*:2.8.6 מופץ. גרסה 2.8.6 מכילה את ה-commits האלה.

תיקוני באגים

  • ‫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 מכילה את ה-commits האלה.

תיקוני באגים

  • תוקנה בעיה שבה NavHost עלול להקפיץ חריגה בתוך PredictiveBackHandler אם מקבץ הפעילויות הקודמות (back stack) מצטמצם לרשומה אחת ומופעלת חזרה למערכת באותו פריים. (I1a429, b/375343407)
  • תוקנה בעיה שקשורה ל-NavDestination NullPointerException כשמעדכנים את startDestination של תרשים. (I99421,‏ b/361560785)
  • תוקנה בעיה שגרמה לאנימציית קנה מידה לא צפויה כשמשתמשים ב-Navigation Compose וקוראים ל-navigate באותו פריים שבו האנימציה הנוכחית מסתיימת. (I26cb1, b/353294030)
  • תוקן ConcurrentModificationException שיכול להתרחש כש-LifecycleObserver שמצורף ל-NavBackStackEntry מפעיל שינוי במקבץ הפעילויות הקודמות (back stack) כשהמארח LifecycleOwner, כמו הפעילות או ה-Fragment שמכילים אותו, משנה את מצב מחזור החיים שלו. (Ia9494)

תרומה חיצונית

  • מניעת שגיאות הקלדה ב-Navigation תומכת עכשיו ב-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: מניעת שגיאות הקלדה בניווט תומכת עכשיו במחלקת ערכים כמסלול או כסוג הארגומנט של מסלול (I9344a,‏ b/374347483)

תיקוני באגים

גרסה 2.8.3

‫16 באוקטובר 2024

‫androidx.navigation:navigation-*:2.8.3 מופץ. גרסה 2.8.3 מכילה את השמירות האלה.

תכונות חדשות

  • הוספנו בדיקות lint חדשות למודולים navigation-common,‏ navigation-runtime ו-navigation-compose כדי לזהות מסלולים עם מניעת שגיאות הקלדה שלא נוספו להם הערות בצורה נכונה באמצעות @Serializable. הבדיקה הזו חלה על כל פונקציות התוספים של NavGraphBuilder ו-NavDeepLinkBuilder. (I4a259,‏ I95402,‏ Ie601a,‏ Id8c6e,‏ I28bda,‏ b/362725816)
  • הוספנו בדיקות איתור שגיאות בקוד (lint) חדשות למודולים 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 עם פלאגין של Android Gradle בגרסה 8.4 ואילך. (I1be3d,‏ b/368070326,‏ b/371463741)

בעיות מוכרות

  • ‫Navigation lint יציג את השגיאה Obsolete custom lint check כשמנסים להריץ את lint עם Lint 16 ‏(AGP 8.7) ואילך. (b/371926651)

גרסה 2.8.2

‫2 באוקטובר 2024

‫androidx.navigation:navigation-*:2.8.2 מופץ. גרסה 2.8.2 מכילה את ה-commits האלה.

תכונות חדשות

  • מניעת שגיאות הקלדה ב-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 מכילה את ה-commits האלה.

תכונות חדשות

  • הוספנו כלל חדש לניתוח קוד סטטי כדי להבטיח שימוש בפונקציה popBackStack שמקבלת סוג מחלקה מוגדר כשמנסים לבצע popBackStack באמצעות ממשקי API למניעת שגיאות הקלדה. (Ief161, b/358095343)

תיקוני באגים

  • עכשיו, כדי לנווט, המסלול שמועבר אל startDestination של NavGraph צריך להכיל את הערכים של כל הארגומנטים הנדרשים, כולל ארגומנטים שלא יכולים להיות ריקים ואין להם ערך ברירת מחדל. (I18e74, b/362594265)
  • הוספנו ל-Navigation Safe Args תמיכה במחרוזות שלא יכולות להיות ריקות, כך שערכי null ינותחו ויישמרו בחבילה כמו שהם. זה שונה מההתנהגות הקיימת, שבה ערכי null מנותחים לאובייקט null. השינוי הזה רלוונטי רק לסוגי מחרוזות שלא יכולים להיות ריקים. מחרוזות שניתנות לאיפוס לא משתנות. (I08b4a,‏ b/348936238)
  • אי אפשר יותר להוסיף קישור עומק ל-NavDestination, אלא אם קישור העומק נוסף באופן מפורש ליעד. זה גם אומר שאפשר לנווט למסלול של יעד רק באמצעות עומס היתר של פונקציית הניווט שמקבלת מסלול מחרוזת. העדכון הזה מתקן נקודת חולשה שאפשרה ליצור קישור עומק ליעד שמוגן לכאורה. (Ie30e6)

עדכון של יחסי תלות

  • ‫Navigation Safe Args תלוי עכשיו ב-Kotlin 1.9.24, ולא ב-Kotlin 2.X, כדי שהמפתחים לא יצטרכו לעדכן. (a4129a)
  • הניווט ב-Compose תלוי עכשיו ב-Compose 1.7.2.

גרסה 2.8.0

‫4 בספטמבר 2024

‫androidx.navigation:navigation-*:2.8.0 מופץ. גרסה 2.8.0 מכילה את ה-commits האלה.

שינויים חשובים מאז גרסה 2.7.0

מניעת שגיאות הקלדה ב-Navigation Kotlin DSL

  • עכשיו הרכיב Navigation מספק מניעת שגיאות הקלדה ל-Kotlin DSL (שמשמש את 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 meet Type Safety.

חיזוי החזרה ב-Navigation Compose

  • עכשיו אפשר להשתמש ב-Navigation Compose כדי להוסיף תמיכה בחיזוי תנועת החזרה בתוך האפליקציה, באמצעות ממשקי ה-API החדשים של SeekableTransitionState מ-compose-animation. כך אפשר להשתמש בתנועת החזרה כדי לראות את היעד הקודם עם המעבר המותאם אישית, לפני שמחליטים אם לבצע את המעבר באמצעות השלמת התנועה או לבטל אותו.

Navigation Fragment Composable

  • הוספנו פריט מידע חדש שנוצר בתהליך פיתוח התוכנה (artifact) של navigation-fragment-compose שכולל חלופה של ComposableNavHostFragment ל-NavHostFragment, שמאפשרת להוסיף יעדים קומפוזביליים לקובצי ה-XML של הניווט. כל יעד של composable צריך להיות מוגדר כ-method ברמה העליונה ללא ארגומנטים של @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" />

שינויים אחרים

  • הניווט ב-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 מכילה את ה-commits האלה.

תיקוני באגים

  • תיקון קריסה של הניווט כשמעבירים מחלקות Enum ברמה העליונה כארגומנטים למניעת שגיאות הקלדה. (I0ba76, b/358137294)
  • ‫Navigation 2.8 פועל עכשיו בצורה תקינה עם SDK 34, ולא יעבור ל-SDK 35 עד לגרסה 2.9, יחד עם שאר הספריות של AndroidX. (b/358798728)

גרסה ‎2.8.0-beta07

‫7 באוגוסט 2024

‫androidx.navigation:navigation-*:2.8.0-beta07 מופץ. גרסה ‎2.8.0-beta07 מכילה את ה-commits האלה.

בעיות מוכרות

  • בגלל b/358137294, רק טיפוסי Enum שמוטמעים בכיתה אחרת נתמכים באופן מיידי. בגרסה הבאה תהיה תמיכה ב-Enums ברמה העליונה.

תיקוני באגים

  • כשמנווטים ליעדים כפולים או משותפים, הניווט יתעדף את היעד התואם הקרוב ביותר מהמיקום הנוכחי בתרשים. ‫(Ic89a4, ‏b/352006850)
  • נוסף NavType.EnumType חדש לניווט ב-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 מכילה את ה-commits האלה.

תיקוני באגים

  • תוקנה בעיה שבה בדיקות ה-lint של WrongStartDestinationType לא בדקו אובייקטים נלווים בסוג המחלקה שהועבר, וכתוצאה מכך ה-lint לא זיהה את השגיאה. (I92b09)

גרסה ‎2.8.0-beta05

‫10 ביולי 2024

‫androidx.navigation:navigation-*:2.8.0-beta05 מופץ. גרסה ‎2.8.0-beta05 מכילה את ה-commits האלה.

תיקוני באגים

  • תיקון קריסה של ניווט ב-singleTop כש-NavGraphs בתצוגת עץ משתפים את אותו מסלול startDestination. (I17b94,‏ b/294408596)

גרסה ‎2.8.0-beta04

‫26 ביוני 2024

‫androidx.navigation:navigation-*:2.8.0-beta04 מופץ. גרסה ‎2.8.0-beta04 מכילה את השמירות האלה.

תיקוני באגים

  • עכשיו אפשר לנווט עם מחרוזות ריקות בארגומנטים של נתיבים. (Ic5dbd, b/339481310)
  • שיפור הודעת השגיאה לגבי סריאליזטורים בהתאמה אישית שמוצהרים ישירות בשדות של מחלקות באמצעות @Serializable(with =...), כדי להבהיר שהתכונה הזו לא נתמכת כרגע. (I052b0, b/341319151)
  • ‫SavedStateHandleFactory עכשיו אפשר להשתמש ב-API לבדיקות בבדיקות שהן לא של Android, אבל צריך להשתמש ב-Robolectric כדי לתמוך בניתוח ארגומנטים באמצעות חבילות. (I76cdc, b/340966212)
  • תוקנה קריסה שנגרמה משחזור המצב בזמן המשך הפעילות של האפליקציה אחרי השבתת תהליך, כשמשתמשים בניווט מסוג Type-Safe ב-Compose. (Ia8f38, b/341801005)
  • תוקנה בעיה ב-Navigation Compose שבה אחרי ביטול של חיזוי תנועת החזרה, ה-NavBackStackEntry שהמשתמש חוזר אליו אף פעם לא חוזר למצב מחזור החיים 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 מכילה את השמירות האלה.

שינויים ב-API

  • ל-CollectionNavType יש שיטה מופשטת חדשה, emptyCollection(). אפשר לשנות את זה כדי לטפל באוסף ריק שמועבר כארגומנט. (Ie4d84, b/341723133)

תיקוני באגים

  • הוספנו מסמכי תיעוד לגבי NavType.serializeAsValue ו-serializeAsValues כדי להדגיש שהפלטים הסופיים צריכים להיות מקודדים ב-URI. thought (Ida6bd, b/344943214)
  • תוקנה קריסה שהתרחשה כשבוצעה קריאה ל-toRoute<T> עם ארגומנט CollectionNavType מסוג null. כשמנווטים עם CollectionNavType מסוג null, הארגומנט של הפלט יהיה ערך ברירת המחדל שהוגדר במחלקה Serializable, או הערך המוחזר של emptyCollection() אם אין ערך ברירת מחדל. (I84158,‏ Id630f,‏ b/342672856)

גרסה ‎2.8.0-beta02

‫29 במאי 2024

‫androidx.navigation:navigation-*:2.8.0-beta02 מופץ. גרסה ‎2.8.0-beta02 מכילה את ה-commits האלה.

תיקוני באגים

  • תוקנה קריסה של ClassCastException כשמשתמשים ב-NavBackStackEntry.toRoute עם NavType מותאם אישית שניתן להגדיר כ-null. (I1c29b,‏ b/342239473)
  • תוקנו בעיות בשחזור המצב של מקבץ הפעילויות הקודמות (back stack) של הניווט, שנגרמו כשניסו לשחזר רשומה של מקבץ פעילויות קודמות שלא ניתן להגיע אליה באמצעות מזהה מהיעד הנוכחי. מכיוון שהמסלולים מבוססים על מזהים, גם היעדים שנוצרו באמצעות מסלולים הושפעו. העדכון הזה גם מתקן קריסה שנגרמה כתוצאה מהפעלת clearBackStack(), שהייתה לה אותה בעיה בסיסית. (I423c3, ‏b/339908057)

גרסה ‎2.8.0-beta01

‫14 במאי 2024

‫androidx.navigation:navigation-*:2.8.0-beta01 מופץ. גרסה ‎2.8.0-beta01 מכילה את ה-commits האלה.

שינויים ב-API

  • הפונקציה SavedStateHandle.toRoute() מקבלת עכשיו פרמטר typeMap לסוגי ארגומנטים בהתאמה אישית. (Ie39fb,‏ b/339026523)
  • נוסף API לבדיקה אל 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 בניווט Compose

הפונקציונליות הזו משתמשת בסריאליזציה של Kotlin כדי לאפשר לכם להגדיר יעדים בתרשים הניווט באמצעות אובייקטים ומחלקות נתונים למניעת שגיאות הקלדה:

  // 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 meet Type Safety.

תכונות חדשות

  • הארטיפקט navigation-fragment-compose מספק עכשיו LocalFragment מקומי לקומפוזיציה ל-methods הניתנות להגדרה בתוך 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 מכילה את השמירות האלה.

תכונות חדשות

  • מוסיף פריט מידע חדש שנוצר בתהליך הפיתוח (artifact) של navigation-fragment-compose שכולל חלופה של ComposableNavHostFragment ל-NavHostFragment, שמאפשרת להוסיף יעדי composable לקובצי ה-XML של הניווט. כל יעד של composable צריך להיות מוגדר כ-method ברמה העליונה ללא ארגומנטים של @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" />
    

שינויים ב-API

  • המשך התמיכה ב-Safe Args ב-Navigation Compose באמצעות גישה שמבוססת על Kotlin Serialization. ממשקי ה-API האלה לא גמורים ומסומנים בהערה ExperimentalSafeArgsApi. ההערה הזו תוסר כשכל ממשק ה-API יושלם בגרסה עתידית. (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 מכילה את השמירות האלה.

שינויים ב-API

תיקוני באגים

  • ‫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)

שינויים ב-API

  • נוספה מחלקה מופשטת חדשה CollectionNavType<T>, מחלקת משנה של NavType<T> לארגומנטים שמבוססים על אוספים כמו רשימות, מערכים ומפות. (Ic6d63, b/188693139)
  • כל המערכים של ברירת המחדל של NavType (IntArrayType,‏ LongArrayType,‏ FloatArrayType,‏ BoolArrayType ו-StringArrayType) הם עכשיו מסוג CollectionNavType (Idcf79,‏ b/188693139)
  • ב-NavType יש עכשיו API פתוח חדש של valueEquals שקובע אם שני ערכים מאותו סוג שווים זה לזה. (I6cb97, b/327229511)

תיקוני באגים

  • פרמטרים של שאילתות בקישורי עומק מאפשרים עכשיו ערכים בצורת סוגריים מסולסלים סביב שם הארגומנט (כלומר {argName}) כערכים חוקיים של NavTypes מבוסס-מחרוזת. התיקון הזה פותר בעיה שבה ערך כזה נחשב לא חוקי (או שאין ערך) בכל הסוגים. thought (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 לא הציג כראוי את המעבר כשמשתמשים ב-System Back בלי תנועה. (Iceeae, b/325998468)

גרסה ‎2.8.0-alpha03

‫21 בפברואר 2024

‫androidx.navigation:navigation-*:2.8.0-alpha03 מופץ. גרסה ‎2.8.0-alpha03 מכילה את השינויים האלה.

שינויים ב-API

  • השיטה NavBackStackEntry.savedStateHandle מסומנת עכשיו בתור @MainThread כי היא משתמשת בקוד שצריך להיות בשרשור הראשי בכל מקרה. (Ibb988, b/299523245)

תיקוני באגים

  • תוקנה בעיה ב-Navigation שגרמה ל-NavGraph ViewModels להיות DESTROYED מוקדם מדי כי ה-ViewModel של הרשומה המשויכת לא היה חלק מהמצב השמור. (Ib6bb7, b/317581849)

עדכון של יחסי תלות

גרסה ‎2.8.0-alpha02

‫7 בפברואר 2024

‫androidx.navigation:navigation-*:2.8.0-alpha02 מופץ. גרסה 2.8.0-alpha02 מכילה את השינויים האלה.

תכונות חדשות

  • עכשיו אפשר להשתמש ב-Navigation Compose כדי להוסיף תמיכה בחיזוי תנועת החזרה בתוך האפליקציה, באמצעות ממשקי ה-API החדשים של 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 כוללת את השינויים האלה.

תיקוני באגים

  • היסב בגרסאות מוקדמות יותר (backporting) מ-Navigation 2.8.0-alpha01: תוקנה דליפה של BackStackState שבה כמה קריאות ל-saveState() ב-NavBackStackEntry יחיד גרמו לשמירה של כמה מצבים, אבל רק המצב הראשון שנשמר שוחזר. (I598b0, b/309559751)
  • היסב בגרסאות מוקדמות יותר (backporting) מ-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, שמשוות באופן פנימי בין התרשים החדש לתרשים הקיים, מהירות הרבה יותר וגורמות לפחות דילוגים על פריימים. תודה ל-Michał Z על הניתוח המעמיק שהוביל לשיפור הזה. (I6ad62)
  • עכשיו NavHost יעבד את יעד ההתחלה בסבב הקומפוזיציה הראשון, במקום להמתין לסבב השני כדי לקרוא את המצב המעודכן. (I439a7, b/304852206)

תיקוני באגים

  • תוקנה בעיה שבה מקבץ הפעילויות הקודמות (back stack) היה נשלף אם קראתם ל-setGraph יותר מפעם אחת עם אותו תרשים בדיוק, רק אם היה יעד בתרשים שהכיל קישור לפעולה שמקשרת בין שני יעדים. (Ieaed7)
  • תיבות דו-שיח שהמשתמשים עברו אליהן וסגרו אותן במהירות לא יופיעו יותר ברשימה של NavController.visibleEntries. (I67586,‏ b/287969970)
  • כשערך נשלף ואחריו מתבצע שינוי בהגדרות, הערך ViewModel של הרשומה יימחק עכשיו כמו שצריך אם הערך של saveState הוא False. (Idf242, b/298164648)
  • תוקנה בעיה שבה NavController יכול היה לטפל באותו קישור עומק יותר מפעם אחת אם מקבץ הפעילויות הקודמות (back stack) היה ריק לגמרי לפני שינוי בהגדרות או קריאה ל-setGraph, רק כשה-Intent הנכנס כלל את הדגל FLAG_ACTIVITY_NEW_TASK. (I73c7f)

עדכוני תלויות

  • הניווט עם מקטעים (fragments) תלוי עכשיו במקטע 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)

תיקוני באגים

  • תוקנה בעיה שבה הפרעה לניווט באמצעות ניווט אחר עם popUpTo גרמה לקריסה של FragmentNavigator. (I3c848,‏ b/301887045)
  • תוקנה בעיה שבה לחיצה על כפתור החזרה של המערכת גרמה לכך שה-currentDestination לא עודכן כראוי בהתאם ל-Fragment המוצג. (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 מכילה את השינויים האלה.

תיקוני באגים

  • הניווט תלוי עכשיו ב-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 תלויה עכשיו ב-Compose 1.5.1.

גרסה 2.7.1

גרסה 2.7.1

‫23 באוגוסט 2023

‫androidx.navigation:navigation-*:2.7.1 מופץ. גרסה 2.7.1 מכילה את השינויים האלה.

תיקוני באגים

  • תוקנה בעיה ב-Navigation with Compose שבה כשמשתמשים ב-Scaffold, יכולה להופיע שגיאה בניסיון לגשת אל Lifecycle.State.DESTROYED ViewModel. (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 עצמו, אבל זה יהיה ההפך מהמדריך להעברת נתונים (מיגרציה), ולא יידרשו שינויים אחרים ב-API אם אתם כבר משתמשים בגרסת האלפא האחרונה של Accompanist‏ (0.31.2-alpha). (b/197140101)

תיקוני באגים

  • עכשיו NavHost ב-Navigation Compose מיירטת בצורה נכונה קריאות חזרה של המערכת, גם אחרי שהפעילות הופסקה וחודשה. (Icb6de, b/279118447)

עדכוני תלויות

  • הניווט תלוי עכשיו ב-Compose 1.5.0, במקום ב-1.1.0.

גרסה ‎2.7.0-rc01

26 ביולי 2023

‫androidx.navigation:navigation-*:2.7.0-rc01 מופץ. גרסה 2.7.0-rc01 מכילה את השינויים האלה.

תיקוני באגים

  • תוקנה בעיה שבה פונקציות הלמבדה 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 מיירט עכשיו בצורה נכונה קריאות חזרה של המערכת, גם אחרי ש-Activity עבר STOPPED ו-RESUMED. (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 עצמו, אבל זה יהיה ההפך מהמדריך להעברת נתונים (מיגרציה), ולא יידרשו שינויים אחרים ב-API אם אתם כבר משתמשים בגרסת האלפא האחרונה של Accompanist‏ (0.31.2-alpha). (b/197140101)

תיקוני באגים

  • מ-Navigation 2.6.0-rc02: תוקנה בעיה ב-Navigation in Fragments שבה ניווט באמצעות popUpTo והסרת מקטע ממקבץ הפעילויות הקודמות (back stack) בלי ליצור מחדש את התצוגה שלו גרמו לכך שהחזרה למערכת הפסיקה לפעול. (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 מכילה את השינויים האלה.

שינויים חשובים ב-Navigation מאז גרסה 2.5.0

  • הארגומנטים arguments של NavBackStackEntry והארגומנטים arguments שמועברים אל OnDestinationChangedListener הם עכשיו רק עותק של הארגומנטים שלא ניתנים לשינוי שנוצרו כשניווטתם אל היעד. כלומר, שינויים שבוצעו בחבילות האלה לא יבואו לידי ביטוי בגישות הבאות ל-arguments או למכונות OnDestinationChangedListener אחרות.
  • עכשיו NavDeepLink תומך בערכי ברירת מחדל למערכים, מה שמאפשר תמיכה בפרמטרים חוזרים של שאילתות שימופו לסוג המערך של הארגומנט. בנוסף, NavType כולל עכשיו שיטת ברירת מחדל שאפשר לשנות כדי לשלב שני ערכים מנותחים.
  • מעכשיו, מחלקות משנה מותאמות אישית של NavType יכולות לשנות את serializeAsValue כדי להפוך ערך לסדרה במחרוזת, וכך לאפשר גם הפיכה לסדרה וגם ביטול הפיכה לסדרה (באמצעות parseValue) להיות מוקפסות לחלוטין במחלקה NavType. ‫StringType מבטל עכשיו את ה-method הזו כדי להפעיל את Uri.encode ב-String הנתון.

שינויים חשובים ב-Navigation Compose מאז גרסה 2.5.0

  • כשמציגים תצוגה מקדימה של רכיב Composable עם 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.
  • כשמשתמשים ב-Navigation עם Fragments, ניסיון לבצע באופן ידני FragmentTransaction שמוסיף מקטע ל-back stack של FragmentManager יגרום עכשיו להשלכת IllegalArgumentException. תמיד צריך להוסיף מקטעים דרך ה-API של navigate().
  • כשמשתמשים במחרוזת המדויקת ${applicationId} בתור ה-placeholder במאפיינים app:data ו-app:dataPattern ברכיב הפעילות של קובץ XML לניווט, ה-placeholder יתמלא באופן אוטומטי ב-packageName של ההקשר בזמן הניפוח.
  • ‫FragmentNavigator משתמש עכשיו בממשקי ה-API של המעברים בזמן ניווט ופתיחת NavBackStackEntries. זה אומר שה-NavBackStackEntry Lifecycle ימתין עכשיו עד שהאפקטים המיוחדים של הכניסה והיציאה של הפרגמנט יסתיימו לפני שיעביר את ה-Lifecycle.State הסופי שלהם.
  • ‫DialogFragmentNavigator משתמש עכשיו בממשקי ה-API של המעברים בזמן ניווט ופתיחת NavBackStackEntries. כלומר, NavBackStackEntry Lifecycle ימתין עכשיו עד ש-DialogFragment Lifecycle יעבור ל-DESTROYED לפני שהוא יעבור בעצמו ל-DESTROYED.
  • עכשיו אפשר לאחזר את NavController ב-NavHostFragment ברגע ש-NavHostFragment מצורף אל FragmentManager, ולא רק אחרי onCreate().
  • התמיכה של Navigation במודולים של תכונות דינמיות תלויה עכשיו בספריית הפצת הפיצ'רים ב-Play.
  • ‫Navigation Safe Args תלוי עכשיו בפלאגין של Android Gradle בגרסה 7.3.0. המשמעות היא שהיא תואמת עכשיו רק לגרסאות 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 מכילה את השינויים האלה.

תיקוני באגים

  • תוקנה בעיה בניווט ב-Fragments שבה ניווט באמצעות popUpTo והסרת Fragment ממקבץ הפעילויות הקודמות (back stack) בלי ליצור מחדש את התצוגה שלו גרמו לכך שהחזרה של המערכת הפסיקה לפעול. (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)

תיקוני באגים

  • כשמשתמשים ב-Navigation עם Fragments, ניסיון לבצע באופן ידני FragmentTransaction שמוסיף מקטע ל-back stack של FragmentManager יגרום עכשיו להשלכת IllegalArgumentException. תמיד צריך להוסיף מקטעים דרך ה-API של navigate(). (I6d38e)
  • כשיש navigate שמוסיף רשומה ו-popBackStack שמסיר אותה באותו פריים, הרשומה העליונה שמתקבלת במקבץ הפעילויות הקודמות (back stack) תחזור עכשיו באופן עקבי אל 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 שלא יכול להיות null, הנתיב של היעד הזה חייב להכיל פלייסהולדרים לארגומנטים עם אותו שם כמו ה-NavArgument שלא יכול להיות null. (Ic62bf, b/274697949)
  • ניווטים בקישורי עומק שמבוססים על Action/MimeType ייכשלו מעכשיו אם בפעולת הניווט חסר NavArgument שנדרש על ידי NavDestination ש-Action/MimeType תואם לו, ואי אפשר להגדיר אותו כ-null. (Ibfa17,‏ b/271777424)
  • כש-NavController מגדיר תרשים עם אותו מסלול ואותם יעדים כמו בתרשים הקודם, הוא מחליף עכשיו בצורה תקינה את צומתי התרשים הנוכחיים ואת היעדים במקבץ הפעילויות הקודמות (back stack) במופעים חדשים. הבעיה הזו תוקנה: קריסה בזמן שימוש ב-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 מכילה את השינויים האלה.

תכונות חדשות

  • עכשיו אפשר לאחזר את NavController ב-NavHostFragment ברגע ש-NavHostFragment מצורף אל FragmentManager, ולא רק אחרי onCreate(). (Ic6382, b/220186282)

תיקוני באגים

  • תוקנה בעיה שגרמה ל-NullPointerException כשמוציאים תרשים בתצוגת עץ שכולל ארגומנט שלא יכול להיות null. (6b3581, b/249988437)
  • כשמשתמשים בפעולת החזרה של המערכת אחרי ניווט באמצעות popUpTo, המצב של NavController יקפוץ לרשומה הנכונה. (I3a8ec, b/270447657)
  • עכשיו FragmentNavigator יקפיץ רשומות בצורה תקינה כשמקבץ הפעילויות הקודמות (back stack) מוקפץ באמצעות לחצן החזרה של המערכת או popBackStack(), וגם אם הטרנזקציה משתמשת באפקטים של הפרגמנט. (I81bdf)
  • הוספת מקטעים ל-FragmentManager של FragmentNavigator בלי להשתמש בניווט לא תגרום יותר לקריסה. (b17204, b/274167493)

עדכוני תלויות

גרסה ‎2.6.0-alpha07

‫8 במרץ 2023

‫androidx.navigation:navigation-*:2.6.0-alpha07 מופץ. גרסה 2.6.0-alpha07 מכילה את השינויים האלה.

תיקוני באגים

  • גרסאות ה-API של getBackStackEntry,‏ popBackStack ו-clearBackStack שמקבלות מסלולים מקבלות עכשיו תבניות של מסלולים עם ארגומנטים ופרמטרים של שאילתות שיכולים להיות ריקים (I22294,‏ b/269302500)
  • תוקנה בעיה שבה קריאה ל-clearBackStack() מ-NavController לא ניקתה את המצב השמור במנהל הפרגמנטים שמשויך למקבץ הפעילויות הקודמות (back stack) שנוקה. (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 מכילה את השינויים האלה.

תכונות חדשות

  • כשמציגים תצוגה מקדימה של רכיב Composable עם NavHost, עכשיו מוצג כברירת מחדל ה-startDestination של NavGraph. (I2b89f)

שינויים ב-API

  • כל עומסי היתר של NavController navigate מסומנים עכשיו באמצעות @MainThread כדי לוודא שהם נקראים בשרשור הראשי. (I2c0b0, b/263427111)

תיקוני באגים

  • תוקנה קריסה שהתרחשה כשניסו לנווט בזמן שימוש ב-Dynamic Fragment Navigation. ‫(I3ee29,‏ b/268360479)
  • תוקן באג שבו מעבר למקטע אחר באמצעות הכפתור "הקודם" של המערכת לא מעדכן את הסרגל התחתון לפריט הנכון שנבחר (If559f,‏ b/269044426)

בעיות מוכרות

  • כשמשתמשים ב-Navigation עם Fragments, מחזור החיים של NavBackStackEntry לא מגיע ל-RESUMED כשמשתמשים בממשקי API של Animation. (b/269646882)
  • כשמשתמשים ב-Navigation עם Fragments ומנווטים באמצעות BottomNavigation, אם מנסים לשחזר מקבץ פעילויות קודמות (back stack) עם כמה רשומות, ה-BottomMenuItem לא מתעדכן בצורה נכונה. (b/270447657)
  • כשמשתמשים ב-Navigation עם Fragments, אחרי שחזור המצב, ה-NavBackStackEntry Lifecycle לא מקבל DESTROYED כשה-fragment שלו הוא 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 משתמש עכשיו בממשקי ה-API של המעברים בזמן ניווט ופתיחת NavBackStackEntries. זה אומר שה-NavBackStackEntry Lifecycle ימתין עכשיו עד שהאפקטים המיוחדים של הכניסה והיציאה של הפרגמנט יסתיימו לפני שיעביר את ה-Lifecycle.State הסופי שלהם. (I3cb19, b/238686802)
  • ‫DialogFragmentNavigator משתמש עכשיו בממשקי ה-API של המעברים בזמן ניווט ופתיחת NavBackStackEntries. כלומר, NavBackStackEntry Lifecycle ימתין עכשיו עד ש-DialogFragment Lifecycle יעבור ל-DESTROYED לפני שהוא יעבור בעצמו ל-DESTROYED. (I53ee5, b/261213893)

שינויים ב-API

  • עכשיו NavigatorState מספק את ה-API של prepareForTransition כדי לאפשר ל-Navigator להעביר את NavBackStackEntries ל-Lifecycle.State ביניים. (I42c21, b/238686802)
  • עכשיו אפשר לגשת למקבץ הפעילויות הקודמות שמשויך ל-NavGraphNavigator או ל-ComposeNavigator דרך מאפיין backstack. ‫ComposeNavigator חושף עכשיו גם את הקריאה החוזרת (callback) של onTransitionComplete() כדי לסמן NavBackStackEntry שהפעיל פעולת ניווט או פעולת popBackStack כפעולה שהושלמה. (I02062, I718db, b/257519195)

תיקוני באגים

  • מצב הניווט לא יבצע פעולה כשמשתמשים בממשקי ה-API של push/popWithTransition והרשומה כבר מטופלת. (Iadbfa, b/261213893)
  • כשמשתמשים ב-launchSingleTop עם NavGraph בתצוגת עץ, כל היעדים שמתחילים מהיעד המקורי ועד ל-startDestination שלו יתווספו בצורה תקינה רק לחלק העליון של המחסנית האחורית. (Id4bea, b/253256629)
  • הניווט יחליף עכשיו בצורה תקינה את המופע של DialogFragment כשמנווטים לאותו יעד כשהדגל launchSingleTop מוגדר כ-true. (I45b5a,‏ b/149572817)
  • השימוש ב-Navigation SafeArgs לא יגרום יותר לשגיאת קומפילציה כשמשתמשים בארגומנטים באורך של 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 מבטל עכשיו את ה-method הזו כדי להפעיל את Uri.encode ב-String הנתון. (Ie5213, b/247637434)
  • עכשיו NavigationUI מספק יומנים כשהוא לא מצליח לנווט דרך MenuItem שנבחר. (I2af5a, b/247730357)

תיקוני באגים

  • קישורי עומק לניווט מנותחים עכשיו באופן עצל במקום באתחול התרשים, מה שיכול לשפר את ביצועי האפליקציה בזמן ההפעלה. (Iab0ab)
  • תוקנה קריסה שנגרמה כתוצאה מניווט למעלה אחרי קישור עומק ליעד עם ארגומנטים של ברירת מחדל מסוג null. (I51c24, b/243183636)

עדכון של יחסי תלות

  • התמיכה של Navigation במודולים של תכונות דינמיות תלויה עכשיו בספריית הפצת הפיצ'רים ב-Play. (Ib4ddc)
  • ‫Navigation Safe Args תלוי עכשיו בפלאגין של Android Gradle בגרסה 7.3.0. המשמעות היא שהיא תואמת עכשיו רק לגרסאות 7.3.0 ואילך. (I47e49)

גרסה ‎2.6.0-alpha03

‫24 באוקטובר 2022

‫androidx.navigation:navigation-*:2.6.0-alpha03 מופץ. גרסה ‎2.6.0-alpha03 מכילה את השינויים האלה.

תיקוני באגים

  • מ-Navigation 2.5.3: NavHost לא יגרום יותר ל-NoSuchElementException כשאין יעד זמין ל-Crossfade ליצירה. עכשיו הוא פשוט ידלג על הקומפוזיציה. (Ieb46e,‏ b/253299416)
  • מ-Navigation 2.5.3: תוקנה בעיה שבה מצב Compose שנשמר (למשל, שימושים ב-rememberSaveable) לא נשכח והוסר כשיעד הוסר ממקבץ הפעילויות הקודמות (back stack). (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} בתור ה-placeholder במאפיינים app:data ו-app:dataPattern ברכיב הפעילות של קובץ XML לניווט, ה-placeholder יתמלא באופן אוטומטי ב-packageName של ההקשר בזמן הניפוח. (Iaabde, b/234223561)
  • ניסיון ליצור NavDeepLink ריק באמצעות navDeepLink Kotlin DSL יגרום עכשיו להצגת אזהרת Lint שמציינת שקישור עומק צריך URI, פעולה ו/או סוג MIME כדי להיות תקין. (I08d2f, b/154038883)

שינויים ב-API

  • נוספה פונקציית תוסף חדשה NavDestination לניתוח תוויות דינמיות עם ארגומנטים בצורת android:label="{arg}" ל-String. תומך בארגומנטים מסוג ReferenceType על ידי ניתוח ערכים מסוג R.string לערכי המחרוזת שלהם. (I07d89,‏ b/236269380)

שינויים בהתנהגות

  • הארגומנטים arguments של NavBackStackEntry ו-arguments שמועברים אל OnDestinationChangedListener הם עכשיו רק עותק של הארגומנטים שלא ניתנים לשינוי שנוצרו כשניווטתם אל היעד. כלומר, שינויים שבוצעו בחבילות האלה לא יבואו לידי ביטוי בגישות הבאות ל-arguments או למכונות OnDestinationChangedListener אחרות. (I676f5)

תיקוני באגים

  • מ-Navigation 2.5.2: עכשיו, לפני שמתבצע ניווט ליעדי פעילות ממודולים אחרים, הניווט הדינמי מנסה להתקין אותם כמו שצריך. (Ia2c16, b/240292838)
  • מ-Navigation 2.5.2: עכשיו Navigation יחליף כמו שצריך את המופע של Fragment כשמנווטים לאותו יעד ומגדירים את הדגל launchSingleTop כ-true. (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) לא נשכח ולא הוסר כשיעד הוסר ממקבץ הפעילויות הקודמות (back stack). (I64949)

גרסה 2.5.2

‫7 בספטמבר 2022

‫androidx.navigation:navigation-*:2.5.2 מופץ. גרסה 2.5.2 מכילה את השינויים האלה.

תיקוני באגים

  • עכשיו, כשמשתמשים בניווט דינמי, המערכת מנסה להתקין יעדי פעילות ממודולים אחרים לפני שהיא מנווטת אליהם. (Ia2c16, b/240292838)
  • עכשיו, כשמנווטים לאותו יעד ומגדירים את הדגל launchSingleTop כ-true, המערכת מחליפה את המופע של המקטע (Fragment) בצורה תקינה. (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 ללא שמירת מצב (stateless) באמצעות CreationExtras של Lifecycle 2.5.0.

Navigation SafeArgs

  • ב-Navigation Safe Args שדרגו את התלות של Android Gradle Plugin כך שתסתמך על 7.0.4, והפסיקו את התאימות לגרסאות AGP שקדמו ל-7.0.
  • נוספה תמיכה במאפיין build.gradle של מרחב השמות, שבו אפשר להשתמש במקום ב-applicationId.

שינויים אחרים

  • ה-API של 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 מכילה את השינויים האלה.

תכונות חדשות

  • הוספנו כלל חדש לניתוח קוד סטטי (lint) כדי להזהיר מפני הצבת רכיבי <deeplink> בתוך רכיבי <activity> בקובץ navigation.xml. (Ic15a5,‏ b/178403185)

תיקוני באגים

  • היקפים קומפוזביליים ב-NavHost וב-DialogHost נמחקים עכשיו בסדר הצפוי, כלומר רכיבים קומפוזביליים פנימיים נמחקים לפני רכיבים קומפוזביליים חיצוניים. (I157e6)
  • עכשיו Navigation SafeArgs משתמש ב-PathSensitivity.RELATIVE ב-ArgumentsGenerationTask כדי לאפשר העברה של המטמון. המשמעות היא שעכשיו אפשר להשתמש שוב ברשומת המטמון מ-build של CI ל-build מקומי. (I5f67c, b/173420454)
  • כלל ה-lint של 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 אחר בכרטיסיית סרגל ניווט תחתון לא ראשי, כשמשתמשים בכמה מקבצי פעילויות קודמות (back stack).

גרסה ‎2.5.0-alpha04

‫6 באפריל 2022

‫androidx.navigation:navigation-*:2.5.0-alpha04 מופץ. גרסה 2.5.0-alpha04 מכילה את השינויים האלה.

שינויים ב-API

תיקוני באגים

  • עכשיו NavHost תלוי ב-visibleEntries מ-NavController כדי לקבוע אילו רשומות ליצור. זה אומר שכאשר משתמשים ב-NavHost מקונן, ה-NavHost הפנימי אמור עכשיו להציג אנימציה בצורה תקינה. (I4ba2b, b/225394514)
  • הערך של visibleEntries StateFlow שסופק על ידי NavController מבוסס עכשיו על המצב המקסימלי של מחזור החיים של הרשומה, במקום על המצב הנוכחי של מחזור החיים. המשמעות היא שגם אם מחזור החיים של המארח של navController יורד מתחת ל-STARTED, רשימת הרשומות הגלויות תישאר ללא שינוי. (I9e2a8, b/225394514)
  • עכשיו אפשר להשתמש ב-CreationExtras ב-SavedStateViewFactory גם אם הוא אותחל באמצעות 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 מכילה את השינויים האלה.

שינויים ב-API

  • עכשיו אפשר להעביר את 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 מכילה את השינויים האלה.

תיקוני באגים

  • מ-Navigation 2.4.1: ה-NavHostFragment יגדיר עכשיו בצורה תקינה את ה-OnBackPressedDispatcher כשמשתמשים ב-viewbinding עם תרשימים בתצוגת עץ. (Ifbb51, b/214577959)
  • מ-Navigation 2.4.1: כשמבצעים קישור עומק דרך כמה רכיבי NavGraph מקוננים, מקבץ הפעילויות הקודמות (back stack) יכלול עכשיו בצורה תקינה יעדי התחלה ביניים. (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 תלוי עכשיו בפלאגין של Android Gradle בגרסה 7.0.4. כלומר, Navigation Safe Args לא תואם יותר לגרסאות של Android Studio שקודמות ל-7.0, אבל הוא תואם עכשיו לפלאגין של Android Gradle מגרסה 7.1.0 ואילך. (I41c88,‏ b/213086135,‏ b/207670704)

גרסה 2.4.2

גרסה 2.4.2

‫6 באפריל 2022

‫androidx.navigation:navigation-*:2.4.2 מופץ. גרסה 2.4.2 מכילה את השינויים האלה.

תיקוני באגים

  • היסב בגרסאות מוקדמות יותר (backporting) מ-Navigation 2.5.0-alpha03: NavDeepLinks עכשיו תומך כראוי בתווי שורה חדשה מקודדים שמוטמעים בנתיבים או במזהי URI של קישורי עומק. (I513d1,‏ b/217815060)
  • היסב בגרסאות מוקדמות יותר (backporting) מ-Navigation 2.5.0-alpha03: עכשיו אפשר להשתמש ב-Navigation SafeArgs במרחב השמות שמוגדר ב-build.gradle במקום בחבילה ב-AndroidManifest. (I659ef, b/217414933)
  • היסב בגרסאות מוקדמות יותר (backporting) מ-Navigation 2.5.0-alpha04: Navigation Safe Args לא יקרוס יותר כשמשתמשים במרחבי שמות ואין AndroidManifest.xml. (I17ccf,‏ b/227229815)
  • היסב בגרסאות מוקדמות יותר (backporting) מ-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 כשמשתמשים ב-viewbinding עם תרשימים בתצוגת עץ. (Ifbb51, b/214577959)
  • כשמבצעים קישור עומק דרך כמה רכיבי NavGraph מקוננים, מקבץ הפעילויות הקודמות (back stack) יכלול עכשיו כמו שצריך יעדי התחלה ביניים. (I504c0, b/214383060)
  • היסב בגרסאות מוקדמות יותר (backporting) מ-Navigation 2.5.0-alpha01: תוקנה בעיה שבה הגישה ל-ViewModel שנוצר באמצעות by navGraphViewModels() מ-onCreate() של Fragment נכשלה עם IllegalStateException. (I8a14d)
  • היסב בגרסאות מוקדמות יותר (backporting) מ-Navigation 2.5.0-alpha01: NavDeepLinks כבר לא מפענח ארגומנטים פעמיים שלא לצורך, כלומר הארגומנטים שפוענחו כראוי מועברים עכשיו ליעד הסופי. (I31b0a, b/210711399)
  • היסב בגרסאות מוקדמות יותר (backporting) מ-Navigation 2.5.0-alpha01: עכשיו Safe Args תלוי בפלאגין של Android Gradle בגרסה 7.0.4. זה אומר ש-Navigation Safe Args לא תואם יותר לגרסאות של Android Studio שקודמות ל-7.0, אבל הוא תואם עכשיו לפלאגין של Android Gradle בגרסה 7.1.0 ואילך. (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. השינוי הזה משפר את יכולת ה-nullability של מחלקות שמשתמשות בגנריות (כמו מחלקות משנה של NavType). כל פונקציות ההרחבה של Kotlin שהיו חלק מהפריטים של -ktx הועברו לפריטים הראשיים שלהן. פריטי המידע שנוצרו על ידי -ktx ימשיכו להתפרסם, אבל הם יהיו ריקים לגמרי.
  • פריט המידע שנוצר בתהליך הפיתוח (Artifact) של navigation-fragment מכיל עכשיו הטמעה מובנית של פריסה עם שני חלונות באמצעות ה-AbstractListDetailFragment החדש. הקטע הזה משתמש ב-SlidingPaneLayout כדי לנהל חלונית רשימה (שמסופקת על ידי מחלקת המשנה) וחלונית פרטים, שמשתמשת ב-NavHostFragment כהטמעה שלה, כפי שמוצג בהטמעה לדוגמה.
  • ה-method‏ currentBackStackEntryAsFlow() ב-NavController מספק Flow שמופעל בכל פעם שה-NavBackStackEntry הנוכחי משתנה. התהליך הזה יכול לשמש כחלופה לניהול ידני של OnDestinationChangedListener.
  • עכשיו אפשר לאחזר באמצעות NavController רשימה של כל המופעים הגלויים של NavBackStackEntry בתור StateFlow, דרך המאפיין הניסיוני visibleEntries.
  • עכשיו אפשר להרחיב את המחלקה NavType כדי ליצור סוגי NavType בהתאמה אישית. סוגים מותאמים אישית נתמכים רק כשיוצרים את תרשים הניווט באופן פרוגרמטי, למשל באמצעות Navigation Graph Kotlin DSL.
  • הניווט כולל עכשיו ממשקי API של findStartDestination() ו-getHierarchy() שאפשר להשתמש בהם כדי להטמיע NavigationUI בהתאמה אישית. ‫findStartDestination() היא פונקציית הרחבה של NavGraph שתאתר את יעד ההתחלה בפועל שיוצג כשמנווטים לתרשים, גם אם startDestination הוא בעצמו NavGraph בתצוגת עץ. ‫getHierarchy() היא פונקציה ב-NavDestination שמאפשרת לבדוק אם יעד מסוים נמצא בהיררכיה של יעד אחר.

    val matchingRoute: Boolean = destination.hierarchy.any { it.route == routeToFind }
    
  • ה-methods של 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)
    }
    

מסלולי ניווט ו-Kotlin DSL

בגרסאות קודמות של Navigation, לכל יעד היה מזהה מספר שלם קבוע שזיהה אותו באופן ייחודי מהיעדים האחים שלו, ואפשר לכם navigate() ליעד הזה ישירות או באמצעות פעולה. השיטה הזו עדיין תקפה ושימושית, במיוחד במקרים שבהם אתם מגדירים את תרשים הניווט ב-XML ויכולים להשתמש בקבועים של R.id שנוצרו באופן אוטומטי או ב-Safe Args (שמשתמש בקבועים האלה כדי ליצור קוד בזמן ה-build). עם זאת, מערכת המספרים השלמים הייחודיים הזו לא תיעדה את המשמעות הסמנטית ואת יכולת הביטוי שנדרשות כדי לתמוך בתרשימים דינמיים לחלוטין שנוצרו באופן פרוגרמטי בזמן הריצה באמצעות Navigation Kotlin DSL.

בגרסה הזו נוספה אפשרות חדשה לזיהוי ייחודי של יעד בתרשים ניווט לפי המסלול שלו. מסלול הוא String שמגדיר את הנתיב הייחודי ליעד. כל השיטות של Kotlin DSL שקיבלו מזהה יעד הוצאו משימוש והוחלפו ב-API מקביל שמקבל מסלול.

צריך להתייחס לכל מסלול כחלק ה"נתיב" של Uri שמגדיר את היעד הזה, למשל home,‏ profile/{userId},‏ profile/{userId}/friends וכו'. כשהזהות של היעד משויכת לתוכן ספציפי, הארגומנטים הדינמיים האלה צריכים להיות חלק מהמסלול, בהתאם לאותם כללים של קישורי עומק מרומזים.

לכל ממשקי ה-API של NavController שבעבר קיבלו רק מזהה, יש עכשיו עומס יתר שמקבל מסלול String. זה כולל את navigate(), popBackStack(), popUpTo() ו-getBackStackEntry().

לשינוי הזה יש כמה השלכות על ה-API:

  • המאפיין popUpTo של Kotlin ב-Kotlin DSL הוצא משימוש, ובמקומו משתמשים ב-popUpToId.
  • הוצאנו משימוש את getStartDestination() API והחלפנו אותו ב-getStartDestinationId().

בניגוד לניווט לפי מזהה, הניווט לפי מסלול פועל לפי אותם כללים כמו קישורי עומק מרומזים, בכך שאפשר לנווט ישירות לכל יעד בכל תרשים בתצוגת עץ, וכך להבטיח שאפשר להשתמש במסלולים האלה בפרויקטים עם כמה מודולים בלי להוסיף באופן מפורש קישור עומק שגלוי באופן חיצוני לכל יעד.

Navigation Compose

רכיב ה-artifact‏ navigation-compose מספק שילוב בין רכיב ה-Navigation לבין Jetpack Compose. היא משתמשת בפונקציות של @Composable כיעדים באפליקציה.

הגרסה הזו כוללת:

  • רכיב NavHost שמאפשר ליצור את תרשים הניווט באמצעות Kotlin DSL, באמצעות יעדי composable ו-dialog, וגם תמיכה ברכיבי Navigator אופציונליים כמו אלה מ-Accompanist Navigation Material.
  • תמיכה חובה במעבר הדרגתי בין יעדים. אפשר להשתמש ב-Accompanist Navigation Animation כדי לשלוט במעברי הכניסה והיציאה באמצעות ממשקי API ניסיוניים של Compose.
  • היקף של Lifecycle לכל יעד קומפוזבילי. כל יעד מגיע למצב RESUMED רק כשכל המעברים הנכנסים מסתיימים, ומיד יורד למצב STARTED כשכל המעברים היוצאים מתחילים. כך אפשר להימנע מכל הבעיות שקשורות ל-IllegalStateException ולמגע בכמה נקודות בו-זמנית, על ידי הפעלת קריאה ל-navigate רק כשה-Lifecycle נמצא במצב RESUMED.
  • היקף ההרשאות של ViewModel (באמצעות ה-API של viewModel() ב-Lifecycle ViewModel Compose 2.4.0 או hiltViewModel() ב-Hilt Navigation Compose 1.0.0 ברמת היעד, מספק היקף הרשאות ששורד שינויים בהגדרות ונמצא במקבץ הפעילויות הקודמות (back stack) (כאשר תוכן ה-Composable נמחק) ואות ב-onCleared() של ViewModel שמציין את המחיקה הקבועה והניקוי של המצב שמשויך לאותו NavBackStackEntry.
  • היקף המצב של rememberSaveable ברמת היעד, כדי להבטיח שכל המצב של ה-composable יישמר וישוחזר באופן אוטומטי כשתחזרו ליעד.
  • תמיכה מלאה בשמירה ובשחזור של המצב של NavController ושל המצב של היעד שלו אחרי השבתת התהליך ויצירה מחדש.
  • שילוב אוטומטי עם הכפתור "הקודם" של המערכת.
  • תמיכה בהעברת ארגומנטים, צירוף קישורי עומק ליעדים והחזרת תוצאה ליעדים קודמים.

  • פונקציות עזר ספציפיות של Compose ב-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 Navigation.

מקבצים מרובים של פעילויות קודמות (back stack)

‫NavController אחראי לניהול מקבץ הפעילויות הקודמות (back stack) של היעדים, להוספת יעדים למקבץ הפעילויות הקודמות כשמבצעים navigate() אליהם ולהסרה שלהם כשמפעילים את popBackStack() או מפעילים את לחצן החזרה של המערכת. הרחבנו את המחלקה הקיימת NavOptions ואת השילוב ברכיבי <action> בקובץ ה-XML של תרשים הניווט, כדי לתמוך בשמירה ובשחזור של מקבץ הפעילויות הקודמות (back stack).

כחלק מהשינוי הזה, השיטות NavigationUI של onNavDestinationSelected(),‏ BottomNavigationView.setupWithNavController() ו-NavigationView.setupWithNavController() שומרות ומשחזרות עכשיו באופן אוטומטי את המצב של יעדים שהוסרו, וכך מאפשרות תמיכה בכמה מקבצי פעילויות קודמות בלי שינויים בקוד. כשמשתמשים בניווט עם Fragments, זו הדרך המומלצת לשלב עם כמה מקבצי פעילויות קודמות (back stack).

ממשקי ה-API הבסיסיים לשמירה ולשחזור של המצב נחשפים דרך כמה פלטפורמות:

  • ב-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 builder:

    // 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 נוסף.

  • אפשר להשתמש ב-method‏ clearBackStack() כדי למחוק כל מצב שנשמר באמצעות popBackStack() או popUpToSaveState.

בכל המקרים, ה-NavController ישמור וישחזר את המצב של כל NavBackStackEntry, כולל כל המופעים של ViewModel שמוגדרים ליעד הניווט. ממשקי ה-API של Navigator עודכנו כדי לאפשר לכל Navigator לתמוך בשמירה ובשחזור של המצב שלו.

שינויים בהתנהגות

  • ‫NavDeepLinkBuilder מוסיף עכשיו את PendingIntent.FLAG_IMMUTABLE אל PendingIntent שמוחזר על ידי createPendingIntent(), כדי לוודא שה-API הזה פועל כמו שצריך כשמטרגטים את Android 12.
  • עכשיו הניווט תלוי ב-Lifecycle 2.3.1, והשיטות setGraph(),‏ popBackStack(),‏ navigateUp() ו-navigate() שמעדכנות את NavBackStackEntry Lifecycle מסומנות עכשיו כ-@MainThread. כך הניווט תואם לאכיפת ה-Main Thread שהושקה ב-Lifecycle 2.3.0.
  • קישורי עומק מאמתים עכשיו שכל הארגומנטים הנדרשים (אלה שאין להם ערכי ברירת מחדל) קיימים ב-Uri.
  • NavDeepLink ארגומנטים מנותחים מתייחסים עכשיו לסימני סולמית באותו אופן כמו לסימני שאלה, כמפריד בין קטעי נתיב, ומונעים מארגומנט להתפרס על פני סימן הסולמית.
  • כשיוצרים פעולות, קוד Kotlin שנוצר מ-Safe Args ממקם עכשיו ארגומנטים בלי ערכי ברירת מחדל לפני אלה עם ערכי ברירת מחדל כפרמטרים.
  • כשיוצרים ארגומנטים, Safe Args ממקם עכשיו פרמטרים בלי ערכי ברירת מחדל לפני אלה עם ערכי ברירת מחדל.
  • ‫Safe-Args תלוי עכשיו בפלאגין של Android Gradle בגרסה 4.2.0. זה אומר שלא אמורה להופיע יותר האזהרה "שימוש ב-applicationIdTextResource".

בעיות מוכרות

  • תוקן ב-Navigation 2.5.0-alpha01: גישה אל ViewModel שנוצר באמצעות by navGraphViewModels() מ-onCreate() של Fragment תיכשל עם IllegalStateException. (b/213504272)
  • תוקן ב-Navigation 2.5.0-alpha01: ‏Safe Args 2.4.0 לא תואם ל-פלאגין של Android Gradle 7.1.0 ואילך. (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)

תיקוני באגים

  • קישורי עומק לא יתעלמו יותר מארגומנטים עם ערכים זהים לשם של ה-placeholder. (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 מכילה את השינויים האלה.

שינויים ב-API

  • הטיפול בקישורי עומק מפורשים ומרומזים מוסיף עכשיו באופן אוטומטי את הדגל saveState כשמנווטים לתרשים אחר, כדי להבטיח שקוד כמו NavigationUI.setupWithNavController וקוד שמשתמש בכמה מקבצי פעילויות קודמות (back stack) יפעלו כצפוי. (Ic8807)

שינויים בהתנהגות

  • תבניות של קישורי עומק עוברות עכשיו הידור עצל ב-NavDeepLink במקום במהלך הניפוח. הפעולה הזו אמורה לשפר את זמן הניפוח של תרשימי ניווט שכוללים קישורי עומק. (b8d257, b/184149935)

תיקוני באגים

  • תוקנה בעיה שבה ערכי NavBackStackEntries נדחפו למטה אל Lifecycle.State.CREATED אחרי המעבר אל Lifecycle.State.STARTED כש-NavHost נוסף ישירות אל setContent() של הפעילות. (Ia5ac1, b/203536683)
  • תוקן מרוץ תהליכים שבו הסרת יעד DialogFragment ממקבץ הפעילויות הקודמות (back stack) לפני שתיבת הדו-שיח הוצגה בפועל לא סגרה את תיבת הדו-שיח, וכתוצאה מכך התרחשה קריסה כשתיבת הדו-שיח השגויה נסגרה באופן ידני על ידי המשתמש. (I687e5)
  • תוקנה בעיה שבה ה-API של 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. thought (I901e3, b/201446416)

שינויים ב-API

  • ה-API של visibleEntries הוא עכשיו ניסיוני. (I93f6f)

תיקוני באגים

  • מודלים של ViewModels לא יושמדו יותר כשמעברים נקטעים על ידי ניווט קדימה ואחורה בין אותם מסכים (Id52d8, b/200817333)
  • כשמוסיפים קישורי עומק ל-NavDestination, לא צריך יותר להגדיר ערך ברירת מחדל לארגומנטים מסוג NavDeepLink שיכולים להיות ריקים. (I5aad4, b/201320030)
  • אובייקטים מסוג NavBackStackEntries עם מחזורי חיים שונים לא נחשבים יותר זהים. זה אומר ש-NavHost ירכיב מחדש את כל היעדים בצורה תקינה כשמנווטים עם singleTop וכשבוחרים מחדש פריטים בתפריט התחתון. (I1b351, b/196997433)
  • תוקנה בעיה ב-AbstractListDetailFragment שגרמה לכך שהמאפיינים layout_width ו-layout_weight בחלונית הרשימה שהוחזרה על ידי onCreateListPaneView() טופלו באופן שגוי או שהמערכת התעלמה מהם. (f5fbf3)
  • המצב החזותי של יעדי תיבת הדו-שיח נשאר עכשיו מסונכרן בצורה נכונה עם המצב של DialogFragmentNavigator. המשמעות היא שקריאה ידנית ל-API האסינכרוני 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 דרך StateFlow‏ visibleEntries (Ia964e)
  • עכשיו הפונקציה rememberNavController() מקבלת קבוצה אופציונלית של מופעי Navigator שיתווספו ל-NavController שיוחזר, כדי לתמוך טוב יותר ברכיבי Navigator אופציונליים כמו אלה מ-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)
  • עכשיו אפשר להעביר רשימה של ארגומנטים ו/או קישורי עומק ל-builder של תרשים הניווט בתצוגת עץ, והם יתווספו באופן אוטומטי לתרשים שיתקבל. (I8a470, b/182545357)

שינויים ב-API

  • הפונקציה 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 מכילה את השינויים האלה.

תכונות חדשות

  • עכשיו אפשר להרחיב את המחלקה NavType כדי ליצור סוגי NavType בהתאמה אישית. סוגים מותאמים אישית נתמכים רק כשיוצרים את תרשים הניווט באופן פרוגרמטי, למשל באמצעות Navigation Graph Kotlin DSL. (I78440,‏ b/196871885)

שינויים בהתנהגות

  • כשיוצרים פעולות, קוד Kotlin שנוצר מ-Safe Args ממקם עכשיו ארגומנטים בלי ערכי ברירת מחדל לפני אלה עם ערכי ברירת מחדל כפרמטרים. (Idb697,‏ b/188855904)
  • קישורי עומק מאמתים עכשיו שכל הארגומנטים הנדרשים (אלה שאין להם ערכי ברירת מחדל) קיימים ב-Uri. (#204, b/185527157)

תיקוני באגים

  • שימוש ב-getBackStackEntry וב-previousBackStackEntry בתוך composable()‎, בשילוב עם remember(), לא יגרום יותר לחריגה כי אין יעד במקבץ הפעילויות הקודמות (back stack). (I75138, b/194313238)
  • עכשיו, כשמשתמשים ב-launchSingleTop=true ומשנים את הארגומנטים של מקבץ הפעילויות הקודמות (back stack), מתבצעת קומפוזיציה מחדש של Navigation Compose כמו שצריך. (Iebd69, b/186392337)
  • לא תהיה יותר ArrayIndexOutOfBoundsException כשמתקשרים אל setGraph עם תרשים עם 13 או 29 יעדים. (I1a9f1, b/195171984)
  • מחולל ה-Java של SafeArgs לא אמור יותר לגרום לאזהרות 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 שומר את המצב כמו שצריך אחרי שינויים בהגדרות וכשמשנים תרשימים בזמן השימוש בתכונה של כמה מקבצי פעילויות קודמות (back stack). (If5a3d,‏ b/195141957)
  • אם תבחרו מחדש באותה כרטיסייה כשאתם משתמשים ב-Navigation Compose עם כמה מקבצי פעילויות קודמות (back stack), לא יוצג יותר מסך ריק. (I860dc, b/194925622)
  • עכשיו NavHost בודק אם יש שינויים ב-Lifecycle.State של NavBackStackEntry, כלומר שימוש ב-NavHost במקטע יגרום עכשיו ליצירה מחדש של הרכיב כשהמצב של מחזור החיים משתנה, במקום להציג מסך ריק. (I4eb85,‏ b/195864489)
  • תוקנה בעיה שבה סגירת DialogFragment לא עדכנה כראוי את המצב של NavController אחרי יצירה מחדש של הפעילות (כלומר, אחרי שינוי בהגדרות). (Icd72b)
  • תוקנה בעיה שבה הצגת יעד של תיבת דו-שיח לא עדכנה את הטיפול של NavController בכפתור "הקודם" של המערכת, מה שעלול לגרום ל-NavController ליירט את כפתור "הקודם" למרות שאין לו מקבץ פעילויות קודמות (back stack) להצגה. (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 מכילה את השינויים האלה.

שינויים ב-API

  • ה-methods‏ 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 ליירט את כפתור "הקודם" למרות שאין לו מקבץ פעילויות קודמות (back stack) להצגה. (aosp/1782668)

גרסה ‎2.4.0-alpha05

‫21 ביולי 2021

‫androidx.navigation:navigation-*:2.4.0-alpha05 מופץ. גרסה 2.4.0-alpha05 מכילה את השינויים האלה.

שינויים בהתנהגות

  • הפונקציה NavHost של Navigation Compose משתמשת עכשיו תמיד ב-Crossfades כשמנווטים בין יעדים. (I07049, b/172112072)
  • עכשיו אפשר לבצע שינויים בתרשים של NavHost. תרשימים עם אותו startDestination ויעדים בתרשים ייחשבו כשווים ולא ינקו את מקבץ הפעילויות הקודמות (back stack) של 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 מכילה את השינויים האלה.

תכונות חדשות

  • פריט המידע שנוצר בתהליך הפיתוח (Artifact) של navigation-fragment מכיל עכשיו הטמעה מובנית של פריסה עם שני חלונות באמצעות ה-AbstractListDetailFragment החדש. הקטע הזה משתמש ב-SlidingPaneLayout כדי לנהל חלונית רשימה (שמסופקת על ידי מחלקת המשנה) וחלונית פרטים, שמשתמשת ב-NavHostFragment כהטמעה שלה, כפי שמוצג בהטמעה לדוגמה. (Iac4be, b/191276636)
  • ה-NavHost של פריט המידע שנוצר באופן מלאכותי (artifact) navigation-compose תומך עכשיו ביעדי dialog בנוסף ליעדי composable. כל אחד מהיעדים של תיבות הדו-שיח האלה יוצג בתוך 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()
            }
        }
    }

שינויים ב-API

  • השם של הפונקציה add ב-NavigatorState השתנה ל-push. צריך לשנות את כל הקריאות הנוכחיות ל-add() ל-()push. ‏(Ie89fc,‏ b/172112072)
  • עכשיו אפשר להשתמש בממשקי ה-API‏ pushWithTransaction ו-popWithTransition ב-NavigatorState במכונות Navigator בהתאמה אישית כדי להוסיף או להסיר יעד באופן אסינכרוני. חשוב לציין שממשקי ה-API האלה עדיין לא נמצאים בשימוש באף אחד מהדפדפנים הכלולים. (Ic4d7c, b/172112072)

שינויים בהתנהגות

  • ‫NavDeepLinkBuilder מוסיף עכשיו את PendingIntent.FLAG_IMMUTABLE אל PendingIntent שמוחזר על ידי createPendingIntent(), כדי לוודא שה-API הזה פועל כמו שצריך כשמטרגטים את 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 או בכל פריט מידע שנוצר בתהליך הפיתוח (artifact) שתלוי בו. (I68800, b/190082521)
  • OnDestinationChangedListener שקורא ל-navigate() בפעם הראשונה שהוא מקבל קריאה חוזרת (callback), מקבל עכשיו קריאה חוזרת שנייה עם היעד שאליו הוא ניווט. (Ie5f9e, b/190228815)
  • ‫Safe Args לא קורס יותר כשמשתמשים בו עם מודולים של תכונות דינמיות ו-AGP 7.0 ואילך. (I69518, b/189966576)

בעיה ידועה

  • ‫Safe Args ייכשל עם שגיאת Unable to find method ‘’java.lang.String kotlin.text.CarsKt.titleCase(char, java.util.Locale)’’ כשמשתמשים ב-Gradle 6.7.0 בגלל תלות בגרסה ישנה יותר של Kotlin. כדי לעקוף את הבעיה, אפשר לעדכן ל-Gradle 7.0. (b/190739257)

גרסה ‎2.4.0-alpha02

‫2 ביוני 2021

‫androidx.navigation:navigation-*:2.4.0-alpha02 מופץ. גרסה 2.4.0-alpha02 מכילה את השינויים האלה.

תכונות חדשות

  • עכשיו יש תמיכה במסלולים ליעדים מסוג Activity, ‏ Fragment ו-Dialog, וגם ב-DynamicNavigation Kotlin DSL. (Ib5544,‏ Ia617b,‏ I22f96,‏ b/188914648,‏ b/188901565)
  • ‫NavigationUI הוסיפה באופן זמני ממשקי API ניסיוניים שמאפשרים לבטל את ההסכמה לשמירת המצב. למרות ששמירת המצב היא תמיד ההתנהגות הנכונה, עדיין יש שימושים בספריות שהוצאו משימוש (כלומר, מקטעים שנשמרו) שלא ניתן לתמוך בהם כששומרים את המצב. לכן, זה מאפשר לאפליקציות להמיר בהדרגה ממשקי API לא נתמכים. (Idf93c)
  • הניווט כולל עכשיו ממשקי API של findDestination() ו-getHierarchy() שאפשר להשתמש בהם כדי להטמיע NavigationUI בהתאמה אישית. ‫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)

שינויים ב-API

  • הוצאנו משימוש את ה-builders של Kotlin DSL שמשתמשים במזהה, וצריך להחליף אותם ב-builders שמשתמשים בנתיבים (I85b42,‏ b/188816479) (I9f58f,‏ b/188816479)

תיקוני באגים

  • ‫DialogFragmentNavigator משתמש עכשיו ב-API של NavigatorState.pop() כדי להודיע ל-NavController כשתיבת דו-שיח נסגרת בלחיצה על כפתור החזרה של המערכת או בלחיצה מחוץ לתיבה, כדי לוודא שהמצב של NavController תמיד מסונכרן עם המצב של Navigator. (I2ead9)
  • הניווט כבר לא גורם ל-ConcurrentModificationException כשמשתמשים ברשימה של OnDestinationChangedListeners מתוך קריאה חוזרת (callback) של onDestinationChanged. (Ib1707,‏ b/188860458)

  • ‫Safe Args לא קורס יותר כשמנסים ליצור מאפייני כיוון ב-Kotlin. (Id2416, b/188564435)

  • השיטה setId ב-NavDestination כוללת עכשיו הערה מתאימה עם @IdRes, כך שהיא מקבלת רק מזהי משאבים. (I69b80)

  • הפרמטר int של findNode הוא עכשיו resId במקום resid. (I7711d)

עדכון של יחסי תלות

  • ‫Safe-Args תלוי עכשיו בפלאגין של Android Gradle בגרסה 4.2.0. זה אומר שלא אמורה להופיע יותר האזהרה "שימוש ב-applicationIdTextResource". (I6d67b, b/172824579)

גרסה ‎2.4.0-alpha01

‫18 במאי 2021

‫androidx.navigation:navigation-*:2.4.0-alpha01 מופץ. גרסה 2.4.0-alpha01 מכילה את השינויים האלה.

תכונות חדשות

  • ה-method‏ currentBackStackEntryAsFlow() ב-NavController מספק Flow שמופעל בכל פעם שה-NavBackStackEntry הנוכחי משתנה. התהליך הזה יכול לשמש כחלופה לניהול ידני של OnDestinationChangedListener. (I19c4a, #89, b/163947280)

מקבצים מרובים של פעילויות קודמות (back stack)

‫NavController אחראי לניהול מקבץ הפעילויות הקודמות (back stack) של היעדים, להוספת יעדים למקבץ הפעילויות הקודמות כשמבצעים navigate() אליהם ולהסרה שלהם כשמפעילים את popBackStack() או מפעילים את לחצן החזרה של המערכת. הרחבנו את המחלקה הקיימת NavOptions ואת השילוב ברשומות <action> בקובץ ה-XML של תרשים הניווט, כדי לתמוך בשמירה ובשחזור של מקבץ הפעילויות הקודמות (back stack). (b/80029773)

כחלק מהשינוי הזה, השיטות NavigationUI של onNavDestinationSelected(),‏ BottomNavigationView.setupWithNavController() ו-NavigationView.setupWithNavController() שומרות ומשחזרות עכשיו באופן אוטומטי את המצב של יעדים שהוסרו, וכך מאפשרות תמיכה בכמה מקבצי פעילויות קודמות בלי שינויים בקוד. כשמשתמשים בניווט עם Fragments, זו הדרך המומלצת לשלב עם כמה מקבצי פעילויות קודמות (back stack). (Ie07ca)

ממשקי ה-API הבסיסיים לשמירה ולשחזור של המצב נחשפים דרך כמה פלטפורמות:

  • ב-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 builder:

    // 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 שמוגדרים ליעד הניווט. ממשקי ה-API של Navigator עודכנו כדי לאפשר לכל Navigator לתמוך בשמירה ובשחזור של המצב שלו.

ה-ComposeNavigator שמשמש ליעדי composable ב-Navigation Compose וה-FragmentNavigator וה-DynamicFragmentNavigator שמשמשים ליעדי <fragment> ב-Navigation עם מקטעים (fragments) עודכנו כך שישתמשו בממשקי ה-Navigator API החדשים ויתמכו בשמירה ובשחזור של המצב.

מסלולי ניווט

נתיב הוא String שמזהה יעד באופן ייחודי. בעבר השתמשו במושג הזה רק ב-Navigation Compose, אבל עכשיו הוא חלק מממשקי ה-API העיקריים של Navigation. זוהי חלופה לשימוש במזהי מספרים שלמים כשיוצרים את התרשים באמצעות Navigation Kotlin DSL. (b/172823546)

לכל ממשקי ה-API שבעבר קיבלו רק מזהה, יש עכשיו עומס יתר שמקבל מסלול String. זה כולל את navigate(), popBackStack(), popUpTo() ו-getBackStackEntry().

לשינוי הזה יש כמה השלכות על ה-API:

  • המאפיין popUpTo של Kotlin ב-Kotlin DSL הוצא משימוש, ובמקומו משתמשים ב-popUpToId. (I59c73, b/172823546)
  • הוצאנו משימוש את getStartDestination() API והחלפנו אותו ב-getStartDestinationId(). (I0887f,‏ b/172823546)

למפתחים שמשדרגים מגרסאות קודמות של Navigation Compose ל-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.

שינויים ב-API

  • כל הארטיפקטים של Navigation נכתבו מחדש ב-Kotlin. השינוי הזה משפר את יכולת ה-nullability של מחלקות שמשתמשות בגנריות (כמו מחלקות משנה של NavType). כל פונקציות ההרחבה של Kotlin שהיו חלק מהפריטים של -ktx הועברו לפריטים הראשיים שלהן. פריטי המידע שנוצרו על ידי -ktx ימשיכו להתפרסם, אבל הם יהיו ריקים לגמרי. (b/184292145)
  • עכשיו אפשר להוסיף ב-NavDeepLinkBuilder כמה יעדים נפרדים למקבץ הפעילויות הקודמות (back stack) שנוצר. (I3ee0d,‏ b/147913689)
  • הוספת פונקציות של מפעלים ל-DynamicNavHostFragment (Icd515,‏ b/175222619)
  • המזהה הייחודי של NavBackStackEntry חשוף עכשיו כחלק מה-API הציבורי שלו. (Ie033a)
  • השדות name ו-argument ופונקציות הפירוק של NamedNavArgument הם עכשיו ציבוריים. ‫(#174, b/181320559)
  • הוספנו תוסף NavBackStackEntry#provideToCompositionLocals חדש שמספק את NavBackStackEntry ל-CompositionLocals הרלוונטיים. (#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. כך הניווט תואם לאכיפת ה-Main Thread שהושקה ב-Lifecycle 2.3.0. (b/171125856)
  • ניתוח של ארגומנטים מסוג Enum מקישורי עומק לא תלוי-רישיות עכשיו, כך שקישור עומק כמו http://www.example.com/red יכול להתאים לקישור עומק מסוג www.example.com/{color} גם אם הערך של ה-enum הוא RED. (#152, b/135857840)

תאימות של Compose

  • ‫androidx.navigation:navigation-compose:2.4.0-alpha01 תואם רק לגרסה 1.0.0-beta07 ומעלה של "פיתוח נייטיב".

תיקוני באגים

  • תוקנה בעיה שבה פלייסהולדרים של ארגומנטים נגררים קיבלו עדיפות על פני קישורי עומק עם סיומת תואמת מדויקת. (#153, b/184072811)
  • עכשיו NavHostFragment תומך ב-Navigators בהתאמה אישית שמשתמשים באותו @Navigator.Name("dialog") כמו ברירת המחדל של DialogFragmentNavigator. (Ib1c2c, b/175979140)
  • שיפרנו את ההתנהגות של NavigatorProvider#addNavigator כדי לוודא שקריאה חוזרת לאותו מופע לא תגרום לבעיות. (#176, b/187443146)

תרומות חיצוניות

  • תודה ל-simonschiller על פיתוח התמיכה ב-Safe Args שיוצרת שיטת fromSavedStateHandle() לכל מחלקת NavArgs. (#122, b/136967621)
  • תודה ל-Bradleycorn על הפיכת ניתוח ארגומנטים של Enum מקישורי עומק ללא תלוי-רישיות. (#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 ל-CompositionLocals הרלוונטיים. (#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 מכילה את השינויים האלה.

שינויים ב-API

  • עכשיו NavHost מקבל Modifier, שמועבר למאגר ה-composable שעוטף את ה-composables של היעד. (I85aca,‏ b/175125483)

תיקוני באגים

  • ‫NavHost פועל עכשיו גם כשלא נמצא OnBackPressedDispatcherOwner, כמו במקרה של תצוגה מקדימה של NavHost. (I7d8b4)
  • הניווט ב-Compose תלוי עכשיו בניווט 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 מכילה את השינויים האלה.

שינויים ב-API

  • הפונקציה LocalViewModelStoreOwner.current מחזירה עכשיו ערך ViewModelStoreOwner שניתן לאפס, כדי לקבוע בצורה טובה יותר אם יש ViewModelStoreOwner זמין בקומפוזיציה הנוכחית. ממשקי API שנדרש בהם 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 מכילה את השמירות האלה.

שינויים ב-API

  • נוספה שיטת הרחבה 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 מכילה את השמירות האלה.

  • הגרסה עודכנה כדי שתהיה תואמת ל-Compose 1.0.0-alpha09.

גרסה 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 מכילה את השמירות האלה.

שינויים ב-API

  • עכשיו Navigation Compose תומך ב-NavOptions לשימוש בפעולות popUpTo ו-launchSingleTop‏ (If96c3,‏ b/171468994)
  • הוספנו פונקציית ניווט שמקבלת מסלול במקום מזהה, שמאפשרת ליצור תרשימים בתצוגת עץ ב-Navigation Compose DSL. (I1661d)
  • הפרמטר startDestination מופיע עכשיו לפני המסלול ברשימת הפרמטרים של NavHost‏ (Ie620e)
  • עכשיו אפשר ליצור תרשים באמצעות המסלול כיעד התחלתי מחוץ ל-composable של NavHost. (Iceb75)

גרסה 1.0.0-alpha01

‫28 באוקטובר 2020

‫android.navigation:navigation-compose:1.0.0-alpha01 מופץ. גרסה 1.0.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

רכיב ה-artifact‏ navigation-compose מספק שילוב בין רכיב ה-Navigation לבין Jetpack Compose. היא משתמשת בפונקציות של @Composable כיעדים באפליקציה.

הגרסה הראשונית הזו כוללת:

  • רכיב קומפוזבילי של NavHost שמאפשר ליצור את תרשים הניווט באמצעות Kotlin DSL.
  • היקף מחזור החיים, ViewModel והמצב שנשמר ברמת היעד.
  • שילוב אוטומטי עם הכפתור "הקודם" של המערכת.
  • תמיכה בהעברת ארגומנטים, צירוף קישורי עומק ליעדים והחזרת תוצאה ליעדים קודמים.
  • פונקציות עזר ספציפיות של Compose ב-rememberNavController() וב-currentBackStackEntryAsState() כדי לאפשר העלאת מצב וחיבור של NavController לפונקציות קומפוזביליות מחוץ ל-NavHost (כמו סרגל ניווט תחתון).

מידע נוסף זמין במדריך בנושא Compose Navigation.

גרסה 2.3.5

גרסה 2.3.5

‫7 באפריל 2021

‫androidx.navigation:navigation-*:2.3.5 מופץ. גרסה 2.3.5 מכילה את השינויים האלה.

תכונות חדשות

  • כשמנווטים באמצעות NavDeepLinkRequest או Uri, אפשר עכשיו לגשת אל Uri, הפעולה וסוג ה-MIME ביעד שמתקבל על ידי קבלת ה-Intent מארגומנטים דרך 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)

עדכוני תלויות

  • הפלאגין Navigation Safe Args Gradle תלוי עכשיו בפלאגין Kotlin Gradle בגרסה 1.4.31. (aosp/1661058, b/181156413)

תרומה חיצונית

  • תודה ל-bentrengrove על בקשת המשיכה (pull request) שהופכת את ניתוח הדומיין של קישורי העומק ללא תלוי-רישיות. ‫(#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)

תיקוני באגים

  • תיקון של התקדמות התקנה שנתקעה כשמשתמשים בתמיכה של Navigation בתכונות דינמיות. (Ib27a7, b/169636207)
  • קריאה ל-setViewModelStore או ל-setLifecycleOwner עם אותו אובייקט שכבר הוגדר תהיה עכשיו ללא פעולה (Idf491,‏ b/177825470)
  • עכשיו Safe-Args מוסיף הערות לביטול בשיטות המתאימות כשמשתמשים ב-Java. (I8fbc5, b/179463137)

תרומות חיצוניות

  • תודה ל-JvmName על בקשת משיכה (pull request) שמאפשרת לנתח כראוי ארגומנטים של ReferenceType כשהם נשלחים כחלק מ-URI של קישור עומק. ‫(#127,‏ b/179166693)
  • תודה ל-tatocaster על בקשת המשיכה (pull request) שמאפשרת ל-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)
  • תוקנה בעיה שבה ניווט לתרשים ניווט בתצוגת עץ לא יצר מופע חדש של תרשים במקבץ הפעילויות הקודמות (back stack). (Ifc831)
  • תוקנה בעיה שבה שימוש ב-navigate() עם popUpTo שהסיר את היעד האחרון בתרשים ניווט לא הרס והסיר מיד את תרשים הניווט עצמו ממקבץ הפעילויות הקודמות (back stack). (I910a3)
  • עכשיו Navigation SafeArgs משתמש ב-KotlinPoet בגרסה 1.7.2, שמוסיפה תמיכה במצב API מפורש של Kotlin. (I918b5)
  • עכשיו NavHostFragment.findNavController(Fragment) בודק גם את תצוגת העיצוב ברמה הבסיסית (root) של DialogFragment, בנוסף לבדיקות הקיימות של היררכיית ה-Fragment והיררכיית התצוגות של ה-Fragment. כך אפשר לבדוק קטעי תיבות דו-שיח שמשתמשים בניווט עם 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 תלוי עכשיו ב-KotlinPoet 1.6.0‏ (aosp/1435911)
  • ‫Safe Args תלוי עכשיו ב-AGP 4.0.1‏ (aosp/1442337)

גרסה 2.3.0

גרסה 2.3.0

‫24 ביוני 2020

‫androidx.navigation:navigation-*:2.3.0 מופץ. גרסה 2.3.0 מכילה את השינויים האלה.

שינויים משמעותיים מאז גרסה 2.2.0

  • שילוב של מודול תכונות: פריטי המידע שנוצרו בתהליך הפיתוח (Artifacts) של navigation-dynamic-features-runtime ו-navigation-dynamic-features-fragment מאפשרים לכם לנווט ליעדים שמוגדרים במודולים של תכונות, ומטפלים באופן אוטומטי בהתקנה של המודולים של התכונות לפי הצורך. מידע נוסף זמין במאמר ניווט באמצעות מודולים של תכונות.
  • בדיקת ניווט: פריט המידע שנוצר בתהליך הפיתוח (artifact) של navigation-testing מספק TestNavHostController שמאפשר להגדיר את היעד הנוכחי ולאמת את מקבץ הפעילויות הקודמות (back stack) אחרי פעולות ניווט. מידע נוסף זמין במאמר בדיקת הניווט.
  • החזרת תוצאה: ה-NavBackStackEntry שמשויך לכל יעד במקבץ הפעילויות הקודמות (back stack) של הניווט מאפשר עכשיו לגשת ל-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 עדיין לא זמינה ב-Manifest Merger. עד שהעבודה הזו תושלם, כל רכיבי <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)

שינויים ב-API

  • הרחבנו משמעותית את התמיכה ב-Kotlin DSL ליעדי ניווט דינמיים. (b/148969800)

תיקוני באגים

  • תוקנה בעיה שבה המערכת התעלמה מ-Intent של קישורי עומק כשנעשה שימוש ביעד התחלה בתצוגת עץ. (b/154532067)

גרסה ‎2.3.0-alpha05

15 באפריל 2020

‫androidx.navigation:navigation-*:2.3.0-alpha05 מופץ. גרסה 2.3.0-alpha05 מכילה את השינויים האלה.

תכונות חדשות

  • בהכללות של תרשימים דינמיים באמצעות <include-dynamic>, כבר לא צריך לציין את app:graphPackage. המערכת תשתמש בברירת מחדל על ידי הוספת הסיומת moduleName ל-applicationId אחרי נקודה. אם אתם צריכים להתאים אישית את graphPackage, עכשיו יש תמיכה בפלייסהולדר ${applicationId}. (b/152696768)
  • ‫Navigation Graph Kotlin DSL חושף עכשיו defaultArguments Map לפעולות, ומשקף את היכולת להגדיר ערכי ברירת מחדל ברכיבי <action> בקובצי Navigation 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)

שינויים ב-API

  • ה-class‏ DynamicExtras כבר לא משתמשת בתבנית של builder, ועכשיו אפשר ליצור אותה ישירות. (aosp/1253671)
  • עכשיו DynamicActivityNavigator מקבל Context ב-constructor שלו במקום Activity. (aosp/1250252)

תיקוני באגים

  • ‫NavigationUI לא מתעלם יותר מתוויות ריקות (כלומר, יעד עם android:label=””) ועכשיו מגדיר בצורה נכונה את הכותרת למחרוזת ריקה. (b/148679860)

עדכוני תלויות

  • רכיבי ה-Navigation Dynamic Features תלויים עכשיו ב-Play Core 1.6.5. (b/149556401)

גרסה ‎2.3.0-alpha03

‫4 במרץ 2020

‫androidx.navigation:navigation-*:2.3.0-alpha03 מופץ. גרסה 2.3.0-alpha03 מכילה את השינויים האלה.

שינויים ב-API

  • במקום להסתמך על המחלקה הקונקרטית 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 לא תלויה בממשקי API חדשים ב-Core 1.2.0.

גרסה ‎2.3.0-alpha02

‫19 בפברואר 2020

‫androidx.navigation:navigation-*:2.3.0-alpha02 מופץ. גרסה 2.3.0-alpha02 מכילה את השינויים האלה.

תכונות חדשות

  • ה-NavBackStackEntry מאפשר עכשיו לגשת ל-SavedStateHandle שמתאים לאחסון כמויות קטנות של מצב שמור שצריך לשייך לרשומה מסוימת במקבץ פעילויות קודמות (back stack). דוגמה לתרחיש לדוגמה מופיעה בקטע החזרת תוצאה. (b/79672220)

שינויים ב-API

  • הוספנו שיטות נוחות של getCurrentBackStackEntry() ו-getPreviousBackStackEntry() כדי שיהיה קל יותר לאחזר NavBackStackEntry ליעדים הנוכחיים והקודמים. (b/79672220)

תיקוני באגים

  • עכשיו navigateUp() מעביר את הארגומנטים של היעד הנוכחי ואת KEY_DEEP_LINK_INTENT ליעד הקודם כשמפעילים את האפליקציה במחסנית המשימות שלכם. (b/147456890)

שינויים בתלויות

גרסה ‎2.3.0-alpha01

‫5 בפברואר 2020

‫androidx.navigation:navigation-*:2.3.0-alpha01 מופץ. גרסה 2.3.0-alpha01 מכילה את השינויים האלה.

תכונות חדשות

  • פריט המידע החדש שנוצר, navigation-testing, מספק את המחלקה TestNavHostController. המחלקה הזו מספקת חלופה לשימוש ב-NavController מדומה כשבודקים את הניווט, ומאפשרת להגדיר את היעד הנוכחי ולאמת את מקבץ הפעילויות הקודמות (back stack) אחרי פעולות הניווט. (b/140884273)
  • הספרייה החדשה navigation-dynamic-features-fragment (והתלות הטרנזיטיבית שלה, navigation-dynamic-features-runtime) מאפשרת לכלול יעדים או תרשימי ניווט שלמים (באמצעות <include-dynamic>) ממודולים של תכונות, וכך להתקין בצורה חלקה מודולים של תכונות על פי דרישה כשמנווטים ליעדים האלה. מידע נוסף זמין במאמר ניווט באמצעות מודולים של תכונות. (b/132170186)

תיקוני באגים

  • מ-Navigation 2.2.1: קישורי עומק ללא פרמטרים של שאילתה מתעלמים עכשיו בצורה נכונה מכל פרמטר של שאילתה, במקום לצרף אותם לרכיבי {argument} נגררים או לא להתאים לקישור העומק. (b/147447512)
  • מניווט 2.2.1: כללי ProGuard של navigation-ui עבור DrawerArrowDrawable עודכנו כדי לוודא ש-android.enableJetifier=true לא נדרש. (b/147610424)
  • מ-Navigation 2.2.1: למודול navigation-common-ktx יש עכשיו שם חבילת מניפסט ייחודי, במקום שם חבילת מניפסט זהה ל-navigation-runtime-ktx. (aosp/1141947)

עדכונים של יחסי תלות

גרסה 2.2.2

גרסה 2.2.2

15 באפריל 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(), ולהעביר את המזהה של יעד או תרשים ניווט במקבץ הפעילויות הקודמות (back stack). ה-NavBackStackEntry שמוחזר מספק LifecycleOwner, ViewModelStoreOwner (אותו אחד שמוחזר על ידי NavController.getViewModelStoreOwner()) ו-SavedStateRegistryOwner שמבוססים על ניווט, בנוסף לארגומנטים שמשמשים להפעלת היעד הזה.
  • שילוב של Lifecycle ViewModel SavedState: SavedStateViewModelFactory הוא עכשיו ברירת המחדל של ה-factory שמשמשת כשמשתמשים ב-by navGraphViewModels() או ב-constructor של ViewModelProvider עם ViewModelStoreOwner שמוחזר על ידי NavController.getBackStackEntry() או NavController.getViewModelStoreOwner().
  • תמיכה בפרמטרים של שאילתות בקישורי עומק: קישורי עומק עם פרמטרים של שאילתות תומכים עכשיו בפרמטרים של שאילתות בסדר שונה. ארגומנטים עם ערך ברירת מחדל או ערך שיכול להיות null הם עכשיו אופציונליים בהתאמה של קישורי עומק.
  • תמיכה משופרת באנימציה: NavHostFragment משתמש עכשיו ב-FragmentContainerView מ-Fragment 1.2.0, ומתקן בעיות ב-z-ordering של אנימציה וחלונות פנימיים שנשלחים ל-Fragments.

גרסה ‎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 בדצמבר 2019

‫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 שנוצרו על ידי Directions Safe Args מכילות עכשיו ערכי ברירת מחדל. (b/141099045)
  • מחלקות Java שנוצרו על ידי Args Safe 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 הוא עכשיו ה-factory שמוגדר כברירת מחדל כשמשתמשים ב-by navGraphViewModels() או ב-constructor של ViewModelProvider עם ViewModelStoreOwner שמוחזר על ידי NavController.getViewModelStoreOwner(). (b/135716331)

שינויים ב-API

תיקוני באגים

  • ‫NavHostFragment משתמש עכשיו ב-FragmentContainerView, ומתקן בעיות בסדר ה-Z של האנימציה ובהוספת חלונות ל-Fragments. (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 או באמצעות ה-API של getViewModelStoreOwner() שנוסף ל-NavController. מידע נוסף זמין במאמר שיתוף נתונים שקשורים לממשק המשתמש בין יעדים.
  • יעדים של תיבות דו-שיח: עכשיו אפשר ליצור יעדים של <dialog> שיציגו DialogFragment כשnavigate אליהם. כברירת מחדל, NavHostFragment תומך ביעדי תיבות דו-שיח. מידע נוסף זמין במאמר יצירת יעד מ-DialogFragment.
  • ניווט לפי URI: עכשיו אפשר navigate באמצעות Uri, שמשתמש ב-<deepLink> שהוספתם ליעד כדי לנווט אליו. מידע נוסף זמין במאמר ניווט באמצעות URI.
  • ‫NavHostController: ממשקי API שמשמשים ספציפית ליצירת NavHost בהתאמה אישית הועברו אל NavHostController, כדי לאפשר להטמעות לחבר את NavController שלהן אל LifecycleOwner, OnBackPressedDispatcher ו-ViewModelStore המארחים.

גרסה ‎2.1.0-rc01

‫7 באוגוסט 2019

‫androidx.navigation:navigation-*:2.1.0-rc01 מופץ. כאן אפשר למצוא את השמירות שנכללות בגרסה הזו.

שינויים ב-API

  • ה-API מסוג 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, אתם צריכים להשתמש במאפיין הזה כדי לשלב אותם עם החלונית Host של Navigation Editor. (b/133880955)

שינויים ב-API

  • ה-API של getViewModelStore() ב-NavController הוצא משימוש והוחלף בשיטה החדשה getViewModelStoreOwner() שמחזירה ViewModelStoreOwner. (aosp/987010)
  • ההטמעה של יעדי חלונות צפים, כמו יעדי <dialog>, הכללה בממשק סמן, FloatingWindow, שכל יעדי <dialog> מטמיעים עכשיו. השיטות של NavigationUI לאינטראקציה עם סרגל האפליקציה העליון מתעלמות עכשיו מיעדי FloatingWindow. (b/133600763)

שינויים בהתנהגות

  • הניווט שומר עכשיו בצורה נכונה על סנכרון המצב שלו עם מה שמוצג במסך כשמשתמשים ביעד <dialog>. כתוצאה מכך, רכיב הניווט מקפיץ עכשיו באופן אוטומטי יעדים מסוג <dialog> כשמנווטים ליעד שהוא לא תיבת דו-שיח ולא פעילות, כמו יעד מסוג <fragment>. (b/134089818)

תיקוני באגים

  • עכשיו, כשמטפלים בקישור עומק, הניווט מבטל את האנימציה שמתרחשת כשיוצרים מחדש את הפעילות, ומתקן הבזק חזותי. (b/130362979)
  • תוקן באג שגרם לכך שמקבץ הפעילויות הקודמות (back stack) של הניווט לא היה מסונכרן כשמוציאים Fragment בזמן שמוסיפים את ה-Fragment הראשוני. (b/133832218)

גרסה ‎2.1.0-alpha05

‫5 ביוני 2019

‫androidx.navigation:*:2.1.0-alpha05 מופץ. כאן אפשר למצוא את השמירות שנכללות בגרסה הזו.

שינויים ב-API

  • ממשקי API שקשורים למארח ב-NavController קיבלו שם חדש והועברו למחלקה משנית חדשה של NavController, NavHostController. (aosp/966091)
  • ה-method‏ setHostOnBackPressedDispatcherOwner() של NavController הוחלפה ב-method‏ setOnBackPressedDispatcher() של NavHostController, ועכשיו צריך להפעיל את setLifecycleOwner() לפני שמפעילים אותה. (aosp/965409)
  • NavHostController מכיל עכשיו שיטה enableOnBackPressed(boolean) שמחליפה את המחלקה NavHostOnBackPressedManager שהוחזרה בעבר על ידי setHostOnBackPressedDispatcherOwner(). (aosp/966091)

תיקוני באגים

  • תוקנה בעיה שבה מקבץ הפעילויות הקודמות (back stack) לא היה נכון אחרי ניווט לפי URI. (b/132509387)
  • קישורי עומק שמטופלים באופן אוטומטי על ידי NavController מופעלים עכשיו רק פעם אחת. (b/132754763)

גרסה ‎2.1.0-alpha04

‫16 במאי 2019

‫androidx.navigation:*:2.1.0-alpha04 מופץ. כאן אפשר למצוא את השמירות שנכללות בגרסה הזו.

תיקוני באגים

  • ‫NavHostFragment מכבדת כראוי את app:defaultNavHost כשהיא מיירטת את האירועים של הכפתור "הקודם" במערכת, ומתקנת רגרסיה ב-Navigation 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

שינויים ב-API

  • השיטה createFragmentNavigator() של NavHostFragment הוצאה משימוש והפונקציונליות שלה הועברה לשיטה החדשה onCreateNavController() כדי להבהיר שזו נקודת הכניסה הנכונה להוספת רכיבי Navigator בהתאמה אישית כשיוצרים מחלקת משנה של NavHostFragment. b/122802849
  • נוסף ה-method‏ hasDeepLink() ל-NavDestination כדי לאפשר לכם לבדוק אם אפשר לטפל ב-Uri נתון ביעד הזה, או במקרה של NavGraph, בכל יעד בתרשים הניווט. b/117437718

תיקוני באגים

  • ארגומנטים שמוגדרים כברירת מחדל מועברים עכשיו בצורה תקינה למכונות OnDestinationChangedListener. b/130630686
  • NavHostFragment עכשיו מיירט אירועי חזרה של המערכת באמצעות OnBackPressedDispatcher, ומתקן בעיה שמתרחשת כשמבצעים ניווט מותנה בשיטות של מחזור החיים של המקטע כשחוזרים למקטע. b/111598096
  • ב-Safe Args, עכשיו android:defaultValue=”@null” עם app:argType לא מוגדר מוסק כראוי כארגומנט string. b/129629192

גרסה ‎2.1.0-alpha02

‫3 באפריל 2019

‫androidx.navigation:*:2.1.0-alpha02 מופץ. כאן אפשר למצוא את השמירות שנכללות בגרסה הזו.

תכונות חדשות

  • עכשיו אפשר ליצור מודלים של תצוגה (ViewModels) ברמת תרשים הניווט באמצעות נציג המאפיין by navGraphViewModels() למשתמשי Kotlin, או באמצעות ה-API של getViewModelStore() שנוסף ל-NavController. b/111614463

שינויים ב-API

  • עכשיו אפשר להוסיף app:targetPackage ליעד <activity> כדי להגביל את שם החבילה התואם. הוא תומך ב-app:targetPackage="${applicationId}" כדי להגביל את החבילה למזהה האפליקציה שלכם. b/110975456

תיקוני באגים

  • הערך של android:name ביעדי <activity> כבר לא מנותח ל-Class בזמן הניפוח, וכך נמנעות שגיאות ClassNotFoundException כשמשתמשים בתכונות דינמיות. 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

שינויים ב-API

  • הוספנו שיטה חדשה, Navigation.createNavigateOnClickListener(NavDirections), כחלופה ליצירת רכיב click listener עם מזהה משאב ו-Bundle. b/127631752
  • השדה FragmentNavigator.instantiateFragment הוצא משימוש. ההטמעה שמוגדרת כברירת מחדל משתמשת עכשיו ב-FragmentFactory כדי ליצור מופעים של Fragments. b/119054429

תיקוני באגים

  • הניווט לא שולח יותר ערך null של Bundle כשיש ארגומנטים שמצורפים ליעד, מה שמתקן בעיה שמתרחשת כשמשתמשים ב-android:defaultValue="@null". b/128531879
  • ‫Safe Args תלוי עכשיו ב-KotlinPoet 1.1.0, וזה פותר בעיה שקשורה לשמות ארוכים מאוד של חבילות. b/123654948

גרסה 2.0.0

גרסה 2.0.0

‫14 במרץ 2019

גרסה 2.0.0 של Navigation הושקה ללא שינויים מגרסה 2.0.0-rc02.

גרסה ‎2.0.0-rc02

‫6 במרץ 2019

בגרסה Navigation 2.0.0-rc02 יש פריטי מידע חדשים שנוצרו עם מזהה הקבוצה androidx.navigation, והתלויות שלהם השתנו למקבילות ב-AndroidX.

ההתנהגות של 2.0.0-rc02 זהה להתנהגות של Navigation 1.0.0-rc02, ולא צריך לבצע שינויים בקוד כדי לעדכן מ-1.0.0-rc02, מלבד עדכון יחסי התלות כך שיתאימו ליחסי התלות החדשים.

כדי להשתמש בגרסאות 2.X של Navigation, צריך להעביר את הפרויקט ל-AndroidX. גרסה 1.0 היציבה של Navigation תהיה הגרסה האחרונה שמשתמשת ביחסי התלות של Support Library. כל הפיתוחים העתידיים אחרי גרסה 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 של Navigation הושקה ללא שינויים מגרסה 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 כולל עכשיו תווי בריחה (escape) תקינים למילות מפתח ב-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 כשמוציאים את היעד האחרון ממקבץ הפעילויות הקודמות (back stack). כך תוקנה רגרסיה שהופיעה בגרסה 1.0.0-beta01. b/123933201
  • עכשיו, כשמשחזרים את המצב של מופע שמור, רכיב הניווט מגדיר בצורה נכונה את 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 תלוי בפלאגין של Android Gradle בגרסה 3.3.0 aosp/888413
  • ‫Safe Args תלוי עכשיו ב-Kotlin 1.3.20 aosp/888414

תיקוני באגים

  • עכשיו אפשר להשתמש ב-Safe Args במודולים של ספריות ותכונות בכל הגרסאות של הפלאגין של Android Gradle. b/121304903
  • תוקנה רגרסיה שגרמה לפעולת popBackStack() אחת להסיר את כל העותקים של יעד מהחלק העליון של מקבץ הפעילויות הקודמות (back stack), במקום רק יעד אחד בכל פעם. b/123552990
  • תוקנה בעיה שבה המצב של FragmentNavigator לא היה מסונכרן עם המצב של NavController, מה שגרם ל-IllegalStateException כשניסו לשחזר את מקבץ הפעילויות הקודמות (back stack). 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

זו גרסה של תיקון מהיר (hotfix) של 1.0.0-alpha10 שמתקנת בעיה ב-Safe Args.

תיקוני באגים

  • תיקון בעיה שבה Safe Args לא הצליח לייבא את המחלקה Directions שמשויכת לפעולות גלובליות. b/123307342

גרסה 1.0.0-alpha10

‫23 בינואר 2019

בעיות מוכרות

  • ‫Safe Args לא מצליח לייבא את המחלקה Directions שמשויכת לפעולות גלובליות. b/123307342

הגרסה הזו כוללת שינויי API שעלולים לגרום לכשל. מידע נוסף זמין בקטע שינויי תוכנה שעלולים לגרום לכשל שבהמשך.

תכונות חדשות

  • משתמשי Kotlin יכולים עכשיו להשתמש בנציג המאפיין by navArgs() כדי לקבל הפניה למחלקה NavArgs שנוצרה על ידי Safe Args ב-Activity או ב-Fragment. b/122603367
  • עכשיו אפשר להשתמש ב-Safe Args כדי ליצור קוד Kotlin באמצעות הפלאגין androidx.navigation.safeargs.kotlin. קוד Kotlin נוצר במיוחד למודולים של Kotlin בלבד, באמצעות ארגומנטים שמוגדרים כברירת מחדל ומחלקות שלא ניתנות לשינוי, על פני תבנית ה-builder שעדיין זמינה דרך הפלאגין הקודם של androidx.navigation.safeargs. b/110263087

שינויים בהתנהגות

  • קישורי עומק תואמים נוטים עכשיו לקישור העומק שיש לו הכי הרבה ארגומנטים תואמים. b/118393029
  • מעכשיו, קריאה ל-setGraph() ב-NavController תאפס את מקבץ הפעילויות הקודמות (back stack). 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 אין יותר פונקציית constructor ציבורית – צריך ליצור אותן רק באמצעות השיטות הסטטיות במחלקות Directions שנוצרו. b/122963206
  • הערך Bundle שמוחזר מהפונקציה getArguments() של NavDirections מסומן עכשיו כ-@NonNull במקום כ-@Nullable. b/123243957

תיקוני באגים

  • ‫NavDeepLinkBuilder מטפל עכשיו בצורה נכונה בכמה פעולות PendingIntent בו-זמניות לאותו יעד, באמצעות הארגומנטים שאתם מעבירים כדי לקבוע את הייחודיות. b/120042732
  • עכשיו NavController מטפל בצורה נכונה בפעולות popBackStack() כשמשתמשים ב-NavHostFragment בתצוגת עץ או ב-Fragments צאצאים אחרים עם מקבץ פעילויות קודמות (back stack). b/122770335
  • ‫NavigationUI מגדיר עכשיו בצורה נכונה את תיאור התוכן של הלחצן "למעלה". b/120395362
  • מחלקות Directions שנוצרו על ידי Safe Args מטפלות עכשיו בצורה נכונה בפעולות גלובליות שיש להן אותו מזהה כמו לפעולה ביעד. b/122962504
  • למחלקות NavDirections שנוצרו על ידי Safe Args יש עכשיו ערכי hashCode() שווים באופן תקין כש-equals() מחזיר את הערך True. b/123043662
  • עכשיו מוצגת הודעת שגיאה ברורה יותר ב-FragmentNavigator אם מנסים לבצע FragmentTransactions בהתאמה אישית ב-FragmentManager של NavHostFragment. תמיד צריך להשתמש ב-getChildFragmentManager(). b/112927148

גרסה 1.0.0-alpha09

‫18 בדצמבר 2018

הגרסה הזו כוללת שינויי API שעלולים לגרום לכשל. מידע נוסף זמין בקטע שינויי תוכנה שעלולים לגרום לכשל שבהמשך.

החלטנו לא להמשיך לפתח את פריט המידע שנוצר באופן מלאכותי android.arch.navigation:navigation-testing. הוא הוכח כמועיל לבדיקות פנימיות של NavController, אבל אנחנו ממליצים מאוד על אסטרטגיות בדיקה חלופיות, כמו הדמיה של המכונה של NavController כדי לוודא שהקריאות הנכונות ל-navigate() מתבצעות. הגישה הזו נדונה בפירוט בשיחה על פעילות יחידה ב-AndroidDevSummit 2018, ואנחנו נעבוד על תיעוד נוסף במיוחד בנושא בדיקות באמצעות Navigation.

תכונות חדשות

  • MenuItem עם menuCategory="secondary" לא יקפיצו יותר את מקבץ הפעילויות הקודמות (back stack) כשהם בשימוש עם שיטות NavigationUI. b/120104424
  • עכשיו אפשר להגדיר ב-AppBarConfiguration מופע חלופי של OnNavigateUpListener, שייקרא כש-navController.navigateUp() יחזיר את הערך false. b/79993862 b/120690961

שינויי תוכנה שעלולים לגרום לכשלים

  • כשמשתמשים ב-<argument> עם argType="reference", הרכיב Navigation כבר לא מנתח את ההפניה, אלא מספק את מזהה המשאב הגולמי עצמו. b/111736515
  • onNavDestinationSelected() חוזר עכשיו כברירת מחדל ליעד ההתחלה של תרשים הניווט, כך שהוא תואם לשיטות של setup. מוסיפים את menuCategory="secondary" ל-MenuItem כדי למנוע את הקפיצה של מקבץ הפעילויות הקודמות (back stack). aosp/852869
  • ה-methods של fromBundle() במחלקות Args שנוצרו מקבלות עכשיו Bundle שאינו null במקום Bundle שיכול להיות null aosp/845616

תיקוני באגים

  • עכשיו הארגומנטים מנותחים בצורה תקינה מקישורי עומק בתור argType הנכון, במקום תמיד כמחרוזות b/110273284
  • עכשיו רכיב הניווט מייצא בצורה נכונה את המשאבים הציבוריים שלו b/121059552
  • ‫Safe Args תואם עכשיו ל-פלאגין של Android Gradle 3.4 Canary 4 ואילך b/119662045

גרסה 1.0.0-alpha08

‫6 בדצמבר 2018

הגרסה הזו כוללת שינויי API שעלולים לגרום לכשל. מידע נוסף זמין בקטע שינויי תוכנה שעלולים לגרום לכשל שבהמשך.

תכונות חדשות

  • תוויות יעד, כשמשתמשים בהן עם שיטות 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 וה-methods שמשויכות אליהם הוסרו. משתמשים ב-app:popUpTo עם הרמה הבסיסית (root) של התרשים כדי להסיר את כל היעדים ממקבץ הפעילויות הקודמות (back stack). 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
  • ה-constructor של NavGraphNavigator לא מקבל יותר Context aosp/835340
  • NavigatorProvider הוא עכשיו מחלקה, ולא ממשק. הפונקציונליות של NavigatorProvider שמוחזר על ידי getNavigatorProvider() לא השתנתה. aosp/830660
  • NavDestination.navigate() הוסר. במקום זאת, קוראים ל-navigate() ב-Navigator. aosp/830663
  • שינוי משמעותי של מבנה הקוד של Navigator, שמסיר את הצורך ב-OnNavigatorNavigatedListener ובמקום זאת גורם ל-navigate להחזיר את ה-NavDestination שאליו בוצע הניווט.
  • מופעים של 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. אפשר להגדיר ערך ברירת מחדל לסוגי טיפוסים בני מנייה (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 ולא יפורסם יותר.
  • עכשיו פריט המידע שנוצר בתהליך הפיתוח (Artifact) של navigation-testing תלוי בספרייה הרגילה של Kotlin. ה-API שונה כדי שיהיה עקבי יותר עם המוסכמות של Kotlin, אבל אתם יכולים להמשיך להשתמש בו לבדיקות שכתובות ב-Java.
  • אין יותר תמיכה בתרשימי ניווט שרשומים במניפסט של המטא-נתונים. b/118355937
  • אי אפשר יותר לצרף פעולות ליעדי <activity>. aosp/785539

תיקוני באגים

  • קישורי עומק מנתחים עכשיו בצורה נכונה את הפרמטרים של השאילתה. b/110057514
  • עכשיו כל אנימציות הכניסה והיציאה מוחלות בצורה נכונה על יעדי פעילות. b/117145284
  • תוקנה קריסה שמתרחשת אחרי שינויים בהגדרות כשמשתמשים ב-Navigators בהתאמה אישית. b/110763345

Safe Args

  • ל-Safe Args יש עכשיו תלות קבועה בפלאגין של Android Gradle גרסה 3.2.1. b/113167627
  • עכשיו אפשר ליצור מסלולים למחלקות פנימיות. b/117407555
  • תוקנה בעיה ביצירת מסלולים לתרשים <include>. b/116542123

גרסה 1.0.0-alpha06

‫20 בספטמבר 2018

תכונות חדשות

שינויים ב-API

  • שינוי תוכנה שעלול לגרום לכשל: ה-method‏ navigate() של Navigator מקבלת עכשיו פרמטר Navigator.Extras.
  • השיטה getGraph() של NavController היא עכשיו NonNull b/112243286

תיקוני באגים

  • הפונקציה NavigationUI.setupWithNavController() לא גורמת יותר לדליפת תצוגות כשמשתמשים בה עם תצוגות מיעדים נפרדים b/111961977
  • ‫Navigator onSaveState() נקרא עכשיו רק פעם אחת b/112627079

Safe Args

  • מחלקות Directions של יעדי ניווט מרחיבות עכשיו את מחלקת Directions של ההורה שלהן, אם היא קיימת b/79871405
  • למחלקות Directions ו-Args יש עכשיו הטמעה שימושית של toString() ‏b/111843389

גרסה ‎1.0.0-alpha05

‫10 באוגוסט 2018

תיקוני באגים

  • תוקן באג שגרם להתנהגות שגויה של מחסנית הניווט. b/111907708
  • תיקון באג ב-equals() של מחלקות Generated Args. ‏b/111450897
  • תיקון של כשל ב-build ב-Safe Args. b/109409713
  • תיקון המרה ממזהי משאבים לשמות Java‏ b/111602491
  • תיקון הודעות שגיאה לגבי ערכים שניתנים לאיפוס בפלאגין Safe Args.
  • הוספת אנוטציות חסרות לגבי מאפיין המציין אם ערך יכול להיות ריק (nullability).

גרסה 1.0.0-alpha04

‫19 ביולי 2018

‫Navigation 1.0.0-alpha04 והפלאגין Safe Args gradle המשויך כוללים כמה שינויים ב-API, שינויים בהתנהגות ותיקוני באגים.

שינויים ב-API או בהתנהגות

  • ‫NavHostFragment תמיד יגדיר את ה-Fragment הנוכחי כ-Fragment הניווט הראשי, כדי להבטיח שמנהלי ה-Fragment המשניים יוקפצו לפני ש-NavController החיצוני יוקפץ b/111345778

Safe Args

  • שינוי תוכנה שעלול לגרום לכשל: app:type השתנה ל-app:argType כדי למנוע התנגשויות עם ספריות אחרות כמו ConstraintLayout 2.0.0-alpha1 b/111110548
  • עכשיו אפשר ללחוץ על הודעות שגיאה מ-Safe Args‏ b/111534438
  • מחלקות Args מאשרות עכשיו שמאפייני NonNull הם לא null‏ b/111451769
  • הוספנו הערות NonNull נוספות למחלקות שנוצרו על ידי NavDirections ו-Args‏ b/111455455 b/111455456

תיקוני באגים

  • תוקנה בעיה בכפתור "הקודם" של המערכת אחרי קישור עומק ליעד של מקטע b/111515685

גרסה 1.0.0-alpha03

‫12 ביולי 2018

‫Navigation 1.0.0-alpha03 והפלאגין Safe Args gradle המשויך כוללים כמה שינויים ב-API, שינויים בהתנהגות ותיקוני באגים.

שינויים ב-API או בהתנהגות

  • נוספה שיטת NavigationUI.setupWithNavController לסרגל הכלים b/109868820
  • נוספה שיטת NavigationUI.setupWithNavController ל-CollapsingToolbarLayout‏ b/110887183
  • עכשיו הפונקציה popBackStack()‎ מחזירה את הערך false כשמקבץ הפעילויות הקודמות ריק או כשמזהה היעד שצוין לא נמצא במקבץ הפעילויות הקודמות b/110893637
  • FragmentNavigator מתעלם עכשיו מפעולות ניווט אחרי ש-FragmentManager שמר את המצב, כדי למנוע חריגות מסוג "לא ניתן לבצע את הפעולה הזו אחרי onSaveInstanceState"‏ b/110987825

Safe Args

  • שינוי תוכנה שעלול לגרום לכשל: תווים אלפאנומריים בשמות של פעולות וארגומנטים יוחלפו בקאמל קייס בשמות של השיטות המתאימות של NavDirections
    • לדוגמה, DemoController.index יהפוך ל-setDemoControllerIndex b/79995048
    • לדוגמה, action_show_settings יהפוך ל-actionShowSettings b/79642240
  • שינוי תוכנה שעלול לגרום לכשל: ארגומנטים נחשבים עכשיו כ-non-null כברירת מחדל. כדי לאפשר ערכי null בארגומנטים של מחרוזות ושל Parcelable, צריך להוסיף את 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 שמצורף לפלאגין של Android Gradle 3.2 Beta 01 מוסיף עכשיו כללי שמירה לכל מאפיין android:name בקובצי XML של Navigation‏ b/79874119
  • תוקנה דליפת זיכרון בהחלפה של FragmentNavigator שמוגדר כברירת מחדל b/110900142

גרסה 1.0.0-alpha02

‫7 ביוני 2018

שינויים בהתנהגות

  • הבית FragmentNavigator משתמש עכשיו במינוי setReorderingAllowed(true). b/109826220

  • עכשיו מתבצעת פעולת URLDecode על ארגומנטים שנותחו מכתובות URL של קישורי עומק. b/79982454

תיקוני באגים

  • תוקן IllegalStateException כשמתקשרים לניווט משיטות מחזור החיים של המקטע. b/79632233

  • הניווט תלוי עכשיו ב-Support Library 27.1.1 כדי לתקן את הריצוד כשמשתמשים באנימציות. b/80160903

  • תוקנה בעיה מסוג IllegalArgumentException כשמשתמשים ב-defaultNavHost="true"‎ כקטע צאצא. b/79656847

  • תוקנה בעיה של StackOverflowError בשימוש ב-NavDeepLinkBuilder. b/109653065

  • תוקן IllegalArgumentException כשמנווטים חזרה לתרשים בתצוגת עץ. b/80453447

  • תוקנה בעיה של חפיפה בין קטעים כשמשתמשים ב-launchSingleTop. b/79407969

  • עכשיו הניווט יוצר את מקבץ הפעילויות הקודמות (back stack) הסינתטי הנכון לתרשימים בתצוגת עץ. b/79734195

  • עכשיו NavigationUI ידגיש את הפריט הנכון כשמשתמשים בתרשים בתצוגת עץ בתור MenuItem. b/109675998

שינויים ב-API

  • המאפיין clearTask לפעולות ול-API המשויך ב-NavOptions הוצא משימוש. b/80338878

  • המאפיין launchDocument לפעולות וה-API המשויך ב-NavOptions הוצאו משימוש. b/109806636

גרסה 1.0.0-alpha01

‫8 במאי 2018

ניווט מספק מסגרת ליצירת ניווט בתוך האפליקציה. הגרסה הראשונית הזו היא 1.0.0-alpha01.