ניווט
androidx.navigation
androidx.navigation.compose
androidx.navigation.dynamicfeatures
androidx.navigation.dynamicfeatures.fragment
androidx.navigation.dynamicfeatures.fragment.ui
androidx.navigation.fragment
androidx.navigation.fragment.compose
androidx.navigation.testing
androidx.navigation.ui
| העדכון האחרון | גרסה יציבה | גרסה מועמדת להפצה | גרסת בטא | גרסת אלפא |
|---|---|---|---|---|
| 23 בספטמבר 2026 | 2.10.2 | - | - | - |
הצהרה על יחסי תלות
כדי להוסיף תלות ב-Navigation, צריך להוסיף לפרויקט את מאגר Google Maven. מידע נוסף זמין במאמר מאגר ה-Maven של Google.
אתם יכולים להוסיף את יחסי התלות של הארטיפקטים שאתם צריכים בקובץ build.gradle של האפליקציה או המודול:
Groovy
plugins { // Kotlin serialization plugin for type safe routes and navigation arguments id 'org.jetbrains.kotlin.plugin.serialization' version '2.0.21' } dependencies { def nav_version = "2.10.2" // Jetpack Compose Integration implementation "androidx.navigation:navigation-compose:$nav_version" // Views/Fragments Integration implementation "androidx.navigation:navigation-fragment:$nav_version" implementation "androidx.navigation:navigation-ui:$nav_version" // Feature module support for Fragments implementation "androidx.navigation:navigation-dynamic-features-fragment:$nav_version" // Testing Navigation androidTestImplementation "androidx.navigation:navigation-testing:$nav_version" // JSON serialization library, works with the Kotlin serialization plugin. implementation "org.jetbrains.kotlinx:kotlinx-serialization-json:1.7.3" }
Kotlin
plugins { // Kotlin serialization plugin for type safe routes and navigation arguments kotlin("plugin.serialization") version "2.0.21" } dependencies { val nav_version = "2.10.2" // Jetpack Compose integration implementation("androidx.navigation:navigation-compose:$nav_version") // Views/Fragments integration implementation("androidx.navigation:navigation-fragment:$nav_version") implementation("androidx.navigation:navigation-ui:$nav_version") // Feature module support for Fragments implementation("androidx.navigation:navigation-dynamic-features-fragment:$nav_version") // Testing Navigation androidTestImplementation("androidx.navigation:navigation-testing:$nav_version") // JSON serialization library, works with the Kotlin serialization plugin implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.7.3") }
Safe Args
כדי להוסיף את Safe Args לפרויקט, מוסיפים את 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 של Navigation
גרסה 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 המינימלית
- minSdk שמוגדר כברירת מחדל שונה מ-API 21 ל-API 23, יחד עם שאר הספריות של AndroidX. (Ibdfca, b/380448311, b/435705964, b/435705223)
תרומה חיצונית
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, כלומר: composable<YourScreen>כוללים עכשיו גרסאות לא מוגדרות שמקבלות ישירות מופע שלKClass. (Ia7eed, Id2879, Ibf244, I17d79, Id09d2, I54696, Ia47be, I93281, Ic1bf0, Iba4ee, If56a5, Icf969, I67644, I6f788, b/382094941, b/366291612, b/381938808)
בטבלה הבאה מפורטים ממשקי ה-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: תוקנה בעיה מסוגNavDestinationNullPointerExceptionכשמעדכנים אתstartDestinationשל תרשים. (I99421, b/361560785)
תרומה חיצונית
- מ-Navigation
2.8.5: מניעת שגיאות הקלדה ב-Navigation תומכת עכשיו ב-List<Enum>כסוג ארגומנט של מסלול בלי לדרושNavTypeבהתאמה אישית. תודה ל-Csaba Kozák! (GH-725, b/375559962)
גרסה 2.9.0-alpha03
13 בנובמבר 2024
androidx.navigation:navigation-*:2.9.0-alpha03 מופץ. גרסה 2.9.0-alpha03 מכילה את השמירות האלה.
תכונות חדשות
- מניעת שגיאות הקלדה בניווט תומכת עכשיו במחלקות ערכים כנתיב או כסוג הארגומנט של נתיב. (I9344a, b/374347483)
תיקוני באגים
- תוקן
ConcurrentModificationExceptionשיכול להתרחש כש-LifecycleObserverשמצורף ל-NavBackStackEntryמפעיל שינוי במקבץ הפעילויות הקודמות (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) - תוקנה בעיה שקשורה ל-
NavDestinationNullPointerExceptionכשמעדכנים את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)
תיקוני באגים
- מ-Navigation
2.9.0-alpha01: ניסיון להשתמש ב-NavControllerשכבר עברDESTROYEDיגרום עכשיו ל-IllegalStateException. (I520da, b/369616172)
גרסה 2.8.3
16 באוקטובר 2024
androidx.navigation:navigation-*:2.8.3 מופץ. גרסה 2.8.3 מכילה את השמירות האלה.
תכונות חדשות
- הוספנו בדיקות 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
- העבודה על תמיכה במניעת שגיאות הקלדה בזמן הקימפול ב-Navigation Compose וב-Navigation Kotlin DSL על סמך Kotlin Serialization הסתיימה, וממשקי ה-API שהיו ניסיוניים בעבר הפכו ליציבים. (Iea94d, I0eb0d, I873b7, I3a64b, I6c3a2, I11f0b, Ic3032, I8d394, I95710, Ice060, Id0e55, I45f8b, Idcdaf, If5380, I08b23, Ia5c59, b/188693139)
הפונקציונליות הזו משתמשת בסריאליזציה של 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
- התחלנו לתמוך ב-Safe Args ב-Navigation Compose באמצעות גישה שמבוססת על Kotlin Serialization. ממשקי ה-API האלה לא גמורים ומסומנים בהערה
ExperimentalSafeArgsApi. ההערה הזו תוסר כשכל ממשק ה-API יושלם בגרסה עתידית. (I644e7, I98896, I2a1c5, I43a51, I836a1, Ic5eec, I39407, I24e41, If9e14, Ibb13e, If44d3, Icb70f, I8972f, I1d432, Icf32b, I20a14, I262aa, I7de99, I35990, I1033d, b/188693139)
תיקוני באגים
-
NavHostמשתמש עכשיו ב-Alignment.TopStartכארגומנט ברירת המחדל של contentAlignment. השינוי הזה מתאים לברירת המחדל שלAnimatedContentומתקן כמה מקרים של שינוי קנה מידה לא צפוי מהמעבר המרכזי. (I09e72, b/330111602) - כשמבצעים את חיזוי תנועת החזרה תוך כדי שימוש ב-Navigation Compose, ה-
NavHostישלים עכשיו את המעבר בהתאמה אישית בצורה נכונה במקום לסיים מיד. (I99017, b/327292110)
גרסה 2.8.0-alpha05
20 במרץ 2024
androidx.navigation:navigation-*:2.8.0-alpha05 מופץ. גרסה 2.8.0-alpha05 מכילה את השמירות האלה.
תכונות חדשות
- עכשיו אפשר להעביר ארגומנטים ל-
startDestinationשלNavGraphישירות בנתיב שלstartDestinationבלי להסתמך עלdefaultValue. ההגדרה הזו חלה גם עלNavGraphstartDestinationsבתצוגת עץ. (I0e0b5, b/109505019, b/188693139)
שינויים ב-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 שגרמה ל-
NavGraphViewModels להיותDESTROYEDמוקדם מדי כי ה-ViewModelשל הרשומה המשויכת לא היה חלק מהמצב השמור. (Ib6bb7, b/317581849)
עדכון של יחסי תלות
- הניווט ב-Compose תלוי עכשיו ב-Compose 1.7.0-alpha03.
גרסה 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 כוללת את השינויים האלה.
תיקוני באגים
- הפונקציה
NavGraphequals()מתייחסת עכשיו בצורה נכונה לצמתים של התרשים השני, ולא רק לתרשים שקורא לה. כך אפשר לוודא שתרשימים עם צמתים עם מזהים שונים לא ייחשבו יותר כשווים (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.DESTROYEDViewModel. (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ריק באמצעותnavDeepLinkKotlin DSL יגרום עכשיו להצגת אזהרת Lint שמציינת שקישור עומק צריך URI, פעולה ו/או סוג MIME כדי להיות תקין.
שינויים חשובים בניווט עם מקטעים מאז גרסה 2.5.0
- האפליקציה
NavHostFragmentלא מפריעה יותר לפעולה של הכפתור "הקודם" במערכת. כךFragmentManagerהבסיסי יכול לטפל בחזרה למערכת. כך, גרסה Fragment1.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. זה אומר שה-NavBackStackEntryLifecycleימתין עכשיו עד שהאפקטים המיוחדים של הכניסה והיציאה של הפרגמנט יסתיימו לפני שיעביר את ה-Lifecycle.Stateהסופי שלהם. -
DialogFragmentNavigatorמשתמש עכשיו בממשקי ה-API של המעברים בזמן ניווט ופתיחתNavBackStackEntries. כלומר,NavBackStackEntryLifecycleימתין עכשיו עד ש-DialogFragmentLifecycleיעבור ל-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) תחזור עכשיו באופן עקבי אלRESUMEDLifecycle.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)
עדכוני תלויות
- הניווט תלוי עכשיו ב-Lifecycle
2.6.1. (586fe7) - הניווט תלוי עכשיו ב-SavedState
1.2.1. (078e4e) - הניווט תלוי עכשיו ב-ProfileInstaller
1.3.0. (512f0c)
גרסה 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
- כל עומסי היתר של
NavControllernavigateמסומנים עכשיו באמצעות@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, אחרי שחזור המצב, ה-
NavBackStackEntryLifecycleלא מקבל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. זה אומר שה-NavBackStackEntryLifecycleימתין עכשיו עד שהאפקטים המיוחדים של הכניסה והיציאה של הפרגמנט יסתיימו לפני שיעביר את ה-Lifecycle.Stateהסופי שלהם. (I3cb19, b/238686802) -
DialogFragmentNavigatorמשתמש עכשיו בממשקי ה-API של המעברים בזמן ניווט ופתיחתNavBackStackEntries. כלומר,NavBackStackEntryLifecycleימתין עכשיו עד ש-DialogFragmentLifecycleיעבור ל-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)
עדכוני תלויות
- עכשיו הניווט תלוי ב-Fragment
1.5.4. (Icd424)
גרסה 2.6.0-alpha02
5 באוקטובר 2022
androidx.navigation:navigation-*:2.6.0-alpha02 מופץ. גרסה 2.6.0-alpha02 מכילה את השינויים האלה.
שינויים בהתנהגות
- כשמעבירים את המזהה של תרשים ניווט אל
AppBarConfiguration(למשל דרךMenu),NavigationUIמתייחס עכשיו רק ליעד ההתחלה של תרשים הניווט הזה כיעד ברמה העליונה, במקום לסמן באופן שגוי כל יעד בתרשים כיעד ברמה העליונה. ההתנהגות של העברת המזהה של יעד ספציפי לא השתנתה. הפונקציונליות הזו זמינה לקוד שלכם דרך הפונקציה החדשהisTopLevelDestinationב-AppBarConfiguration. (Ie936e, b/238496771)
תיקוני באגים
- הרכיב
navigation:navigation-fragmentתלוי עכשיו בגרסה1.5.2של Fragment. (I00ba4) - הפריט שנבחר בתפריט לא יתעדכן יותר כשעוברים ליעד ב-
FloatingWindow, כמו תיבת דו-שיח. (I4cde8, b/240308330)
גרסה 2.6.0-alpha01
7 בספטמבר 2022
androidx.navigation:navigation-*:2.6.0-alpha01 מופץ. גרסה 2.6.0-alpha01 מכילה את השינויים האלה.
תכונות חדשות
- השילובים של
setupWithNavControllerב-NavigationUIלעבודה עם סרגל האפליקציה העליון ינתחו עכשיו ערכיR.stringשל ארגומנטים מסוגReferenceTypeשנמצאים ב-android:labelלערכי המחרוזת שלהם, במקום להפיק את המספר השלם של המשאב שנוצר אוטומטית. (I5f803, b/167959935) - עכשיו
NavDeepLinkתומך בערכי ברירת מחדל למערכים, מה שמאפשר תמיכה בפרמטרים חוזרים של שאילתות שימופו לסוג המערך של הארגומנט. בנוסף,NavTypeכולל עכשיו שיטת ברירת מחדל שאפשר לשנות כדי לשלב שני ערכים מנותחים. (Id68c3, b/209977108) - כשמשתמשים במחרוזת המדויקת
${applicationId}בתור ה-placeholder במאפייניםapp:dataו-app:dataPatternברכיב הפעילות של קובץ XML לניווט, ה-placeholder יתמלא באופן אוטומטי ב-packageNameשל ההקשר בזמן הניפוח. (Iaabde, b/234223561) - ניסיון ליצור
NavDeepLinkריק באמצעותnavDeepLinkKotlin 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)
עדכון של יחסי תלות
- Navigation
2.5.2תלוי עכשיו ב-Fragment1.5.2. (aosp/2178734)
גרסה 2.5.1
27 ביולי 2022
androidx.navigation:navigation-*:2.5.1 מופץ. גרסה 2.5.1 כוללת את השינויים האלה.
תיקוני באגים
Navigation Safe Argsלא יגרום יותר לאזהרות על הוצאה משימוש במחלקות שנוצרו כשמשתמשים בסוגי ארגומנטים מותאמים אישית שנשמרים ב-Bundle. (Id86ed, b/237725966)
עדכוני תלויות
- ספריית הניווט תלויה עכשיו ב-Lifecycle
2.5.1. (Ib4451) - ספריית הניווט תלויה עכשיו ב-Activity
1.5.1. (I3efe8) - ספריית הניווט תלויה עכשיו ב-Fragment
1.5.1. (I56177)
גרסה 2.5.0
29 ביוני 2022
androidx.navigation:navigation-*:2.5.0 מופץ. גרסה 2.5.0 מכילה את השינויים האלה.
שינויים חשובים מאז גרסה 2.4.0
- שילוב של CreationExtras – עכשיו ל-
Navigationיש יכולת לספקViewModelProvider.Factoryללא שמירת מצב (stateless) באמצעותCreationExtrasשל Lifecycle2.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
-
visibleEntriesכבר לא ניסיוני. (I4829f, b/225394514)
תיקוני באגים
- עכשיו NavHost תלוי ב-
visibleEntriesמ-NavControllerכדי לקבוע אילו רשומות ליצור. זה אומר שכאשר משתמשים ב-NavHost מקונן, ה-NavHostהפנימי אמור עכשיו להציג אנימציה בצורה תקינה. (I4ba2b, b/225394514) - הערך של
visibleEntriesStateFlowשסופק על ידי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 מכילה את השינויים האלה.
תכונות חדשות
-
NavBackStackEntryמשתלב עכשיו עם ViewModel CreationExtras, שהוצג כחלק מ-Lifecycle2.5.0-alpha01. (Ib9fe2, b/207012490)
תיקוני באגים
- תוקנה בעיה שבה הגישה ל-
ViewModelשנוצר באמצעותby navGraphViewModels()מ-onCreate()של Fragment נכשלה עםIllegalStateException. (I8a14d) -
NavDeepLinks לא יפענח יותר ארגומנטים פעמיים שלא לצורך, כלומר הארגומנטים המתאימים מועברים עכשיו ליעד הסופי. (I31b0a, b/210711399)
Safe Args
- Safe Args תלוי עכשיו בפלאגין של 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עודכנו כך שיקבלו את המחלקה הראשית שהוצגה ב-Material1.4.0,NavigationBarView. כך אפשר להשתמש בשיטות האלה עםNavigationRailView.כשמנפחים רכיב
<action>באמצעות XML, מאפייני אנימציה יכולים להשתמש במאפיינים שנשלפים מהעיצוב באמצעות התחבירapp:enterAnim="?attr/transitionEnter".עכשיו Safe Args יוצר שיטת
fromSavedStateHandle()לכל כיתתNavArgs. (#122, b/136967621)class HomeViewModel(savedStateHandle: SavedStateHandle) : ViewModel() { // Create a HomeDestinationArgs class with type safe accessors for each argument // defined on your destination private val args = HomeDestinationArgs.fromSavedStateHandle(savedStateHandle) }
מסלולי ניווט ו-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 Compose2.4.0אוhiltViewModel()ב-Hilt Navigation Compose1.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” />ב-
navOptionsKotlin DSL, אפשר להוסיף את המאפיין הבוליאניrestoreStateואת המאפיין הבוליאניsaveStateב-popUpTobuilder:// 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()שמעדכנות אתNavBackStackEntryLifecycleמסומנות עכשיו כ-@MainThread. כך הניווט תואם לאכיפת ה-Main Thread שהושקה ב-Lifecycle2.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דרך StateFlowvisibleEntries(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
- הפונקציה
navArgumentKotlin 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)
עדכוני תלויות
- התכונה Navigation Compose תלויה עכשיו ב-Activity Compose 1.3.1. (I05829)
- עכשיו Navigation Compose תלוי ב-Lifecycle ViewModel Compose
2.4.0-beta01. (Ib86a3)
גרסה 2.4.0-alpha08
1 בספטמבר 2021
androidx.navigation:navigation-*:2.4.0-alpha08 מופץ. גרסה 2.4.0-alpha08 מכילה את השינויים האלה.
תכונות חדשות
- עכשיו אפשר להרחיב את המחלקה
NavTypeכדי ליצור סוגי 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. כל אחד מהיעדים של תיבות הדו-שיח האלה יוצג בתוך ComposableDialog, ויצוף מעל היעד הנוכחי של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)’’כשמשתמשים ב-Gradle6.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עודכנו כך שיקבלו את המחלקה הראשית שהוצגה ב-Material1.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” />ב-
navOptionsKotlin DSL, אפשר להוסיף את המאפיין הבוליאניrestoreStateואת המאפיין הבוליאניsaveStateב-popUpTobuilder:// 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()שמעדכנות אתNavBackStackEntryLifecycleמסומנות עכשיו כ-@MainThread. כך הניווט תואם לאכיפת ה-Main Thread שהושקה ב-Lifecycle2.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 של Navigation Compose
גרסה 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מאכלס עכשיו אתLocalSavedStateRegistryOwnerCompositionLocal ב-NavBackStackEntryשל היעד הזה, כדי להבטיח שכל מצב שנשמר ישירות ב-SavedStateRegistryיישמר וישוחזר לצד היעד. (I435d7, b/179469431)
גרסה 1.0.0-alpha07
10 בפברואר 2021
androidx.navigation:navigation-compose:1.0.0-alpha07 מופץ. גרסה 1.0.0-alpha07 מכילה את השמירות האלה.
עדכוני תלויות
- עכשיו Navigation Compose תלוי ב-Lifecycle ViewModel Compose 1.0.0-alpha01 כדי לספק תמיכה ב-
viewModel()ליעדיcomposable. (I7a374) NavHostמשתמש עכשיו ב-LocalOnBackPressedDispatcherOwnerהחדש מ-Activity-Compose 1.3.0-alpha01 כדי לקבל את ה-OnBackPressedDispatcherשמוגדר ב-NavController. (I65b12)
גרסה 1.0.0-alpha06
28 בינואר 2021
androidx.navigation:navigation-compose:1.0.0-alpha06 מופץ. גרסה 1.0.0-alpha06 מכילה את השמירות האלה.
שינויים ב-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שנוסף ב-CustomView1.1.0והוטמע על ידיDrawerLayoutב-DrawerLayout1.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)
עדכוני תלויות
- רכיב ה-artifact
NavigationUIתלוי עכשיו ב-CustomView1.1.0-rc01וב-DrawerLayout1.1.0-rc01. (aosp/1309696)
גרסה 2.3.0-alpha06
29 באפריל 2020
androidx.navigation:navigation-*:2.3.0-alpha06 מופץ. (גרסה 2.3.0-alpha06 מכילה את השינויים האלה.)
תכונות חדשות
- קישורי העומק הורחבו כדי לתמוך ב-
app:actionוב-app:mimeType, בנוסף ל-app:uriשהיה זמין בעבר. NavController תומך עכשיו בניווט לפי כל שילוב של השדות האלה באמצעות המחלקה החדשהNavDeepLinkRequest. (b/136573074, b/135334841)
שינויים ב-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 חושף עכשיו
defaultArgumentsMapלפעולות, ומשקף את היכולת להגדיר ערכי ברירת מחדל ברכיבי<action>בקובצי Navigation XML. (b/150345605)
תיקוני באגים
- מגרסה Navigation 2.2.2: תוקנה שגיאת
IllegalStateExceptionשמתרחשת כשמבצעים קישור עומק ליעד ההתחלה של התרשים, כשיש כמה מופעים שלNavHostFragmentבפעילות. (b/147378752)
עדכונים של יחסי תלות
- עכשיו הניווט תלוי ב-Fragment
1.2.4. (aosp/1277325) - הניווט הדינמי תלוי עכשיו ב-Play Core
1.7.2. (aosp/1282257)
גרסה 2.3.0-alpha04
18 במרץ 2020
androidx.navigation:navigation-*:2.3.0-alpha04 מופץ. גרסה 2.3.0-alpha04 מכילה את השינויים האלה.
תכונות חדשות
- הוספנו תמיכה בפעילות של מודול תכונות וביעד של קטע ב-Navigation Kotlin DSL. (b/148969800)
שינויים ב-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שהוצג ב-CustomView1.1.0-alpha02(ש-DrawerLayoutמטמיע החל מ-DrawerLayout1.1.0-alpha04), ומאפשר לכם להשתמש בהטמעות בהתאמה אישית שלOpenableעםNavigationUI. (b/129030452)
תיקוני באגים
- כללי ProGuard של
navigation-common-ktxשומרים עכשיו בצורה נכונה רק את המחלקות שלNavArgsשנמצאות בשימוש, ולא את כל המופעים שלNavArgs. (b/150213558)
שינויים בתלויות
- התלות של Navigation ב-Core
1.2.0הוחזרה, ועכשיו היא תלויה ב-Core1.1.0כדי לא לאלץ את המפתחים לעבור לתלות חדשה יותר כש-Navigation לא תלויה בממשקי API חדשים ב-Core1.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)
שינויים בתלויות
- הניווט תלוי עכשיו ב-Core
1.2.0.
גרסה 2.3.0-alpha01
5 בפברואר 2020
androidx.navigation:navigation-*:2.3.0-alpha01 מופץ. גרסה 2.3.0-alpha01 מכילה את השינויים האלה.
תכונות חדשות
- פריט המידע החדש שנוצר,
navigation-testing, מספק את המחלקהTestNavHostController. המחלקה הזו מספקת חלופה לשימוש ב-NavControllerמדומה כשבודקים את הניווט, ומאפשרת להגדיר את היעד הנוכחי ולאמת את מקבץ הפעילויות הקודמות (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)
עדכונים של יחסי תלות
- מ-Navigation
2.2.1: Navigation2.2.1תלוי עכשיו ב-Lifecycle ViewModel SavedState2.2.0וב-Fragment1.2.1.
גרסה 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
עדכונים של יחסי תלות
- עכשיו הניווט תלוי ב-Fragment
1.2.4. (aosp/1277325)
גרסה 2.2.1
גרסה 2.2.1
5 בפברואר 2020
androidx.navigation:navigation-*:2.2.1 מופץ. גרסה 2.2.1 מכילה את השמירות האלה.
תיקוני באגים
- קישורי עומק בלי פרמטרים של שאילתה מתעלמים עכשיו בצורה נכונה מכל פרמטר של שאילתה, במקום לצרף אותם לרכיבי
{argument}בסוף או לא להתאים לקישור העומק. (b/147447512) - כללי ProGuard של
navigation-uiעבורDrawerArrowDrawableעודכנו כדי לוודא ש-android.enableJetifier=trueלא נדרש. (b/147610424) - למודול
navigation-common-ktxיש עכשיו שם חבילת מניפסט ייחודי, במקום שם חבילת מניפסט זהה לזה שלnavigation-runtime-ktx. (aosp/1141947)
עדכונים של יחסי תלות
- Navigation
2.2.1תלוי עכשיו ב-Lifecycle ViewModel SavedState2.2.0וב-Fragment1.2.1.
גרסה 2.2.0
גרסה 2.2.0
22 בינואר 2020
androidx.navigation:navigation-*:2.2.0 מופץ. גרסה 2.2.0 מכילה את השמירות האלה.
שינויים חשובים מאז גרסה 2.1.0
- NavBackStackEntry: עכשיו אפשר להפעיל את
NavController.getBackStackEntry(), ולהעביר את המזהה של יעד או תרשים ניווט במקבץ הפעילויות הקודמות (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כך שיתאימו לאנימציות ההתפוגגות שהותאמו ב-Fragment1.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 SavedState1.0.0-rc03, ב-Activity1.1.0-rc03וב-Fragment1.2.0-rc03, לפי הצורך.
גרסה 2.2.0-rc02
7 בנובמבר 2019
androidx.navigation:navigation-*:2.2.0-rc02 מופץ. גרסה 2.2.0-rc02 מכילה את השינויים האלה.
שינויים בתלויות
- הניווט תלוי עכשיו ב-androidx.lifecycle
2.2.0-rc02.
גרסה 2.2.0-rc01
23 באוקטובר 2019
גרסה androidx.navigation:navigation-*:2.2.0-rc01 הושקה ללא שינויים מאז גרסה 2.2.0-beta01. גרסה 2.2.0-rc01 מכילה את השינויים האלה.
גרסה 2.2.0-beta01
9 באוקטובר 2019
androidx.navigation:navigation-*:2.2.0-beta01 מופץ. גרסה 2.2.0-beta01 כוללת את השינויים האלה.
תכונות חדשות
NavDestinationומחלקות המשנה שלו מבטלות עכשיו אתtoString()כדי לספק מידע מועיל יותר במהלך ניפוי באגים. (b/141264986)
שינויים בהתנהגות
- עכשיו המערכת מתעלמת מפרמטרים נוספים של שאילתות כשהיא מתאימה קישורי עומק, במקום שההתאמה תיכשל. (b/141482822)
תיקוני באגים
- תוקנה בעיה שבה המערכת התעלמה מארגומנטים בנתיב של קישור עומק אם צוינו גם פרמטרים של שאילתה. (b/141505755)
- הודעת השגיאה של תוסף Kotlin של
navArgs()ב-Activityשופרה, והיא מוצגת כשאין תוספות. (b/141408999) - מחלקות Java שנוצרו על ידי
DirectionsSafe Args מכילות עכשיו ערכי ברירת מחדל. (b/141099045) - מחלקות Java שנוצרו על ידי
ArgsSafe 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
- מ-Navigation
2.1.0-rc01: ה-APIgetViewModelStore()שהוצא משימוש ב-NavControllerוהושק ב-2.1.0-alpha02הוסר. (aosp/1091021)
תיקוני באגים
-
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הוחלפה ב-methodsetOnBackPressedDispatcher()של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כשהיא מיירטת את האירועים של הכפתור "הקודם" במערכת, ומתקנת רגרסיה ב-Navigation2.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_TASKb/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) ובפעולות ניווט ב-
singleTopb/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השתנה לשםOnDestinationChangedListenerb/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השתנה לשםhandleDeepLinkaosp/836063 - הרבה מחלקות ושיטות שלא נועדו ליצירת מחלקות משנה, כמו
NavOptions,NavInflater,NavDeepLinkBuilderו-AppBarConfiguration, הפכו ל-finalaosp/835681 - השיטה
NavHostFragment.setGraph()שהוצאה משימוש הוסרה aosp/835684 - השיטה
NavigationUI.navigateUp(DrawerLayout, NavController)שהוצאה משימוש הוסרה. aosp/835684 - יצירת Fragment הועברה אל
FragmentNavigator, כך שקל יותר להקצות יצירת Fragment ל-FragmentFactory. b/119054429 - ה-constructor של
NavGraphNavigatorלא מקבל יותרContextaosp/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
תכונות חדשות
- יש עכשיו תמיכה במעברים של רכיבים משותפים ליעדים של Fragment ו-Activity b/79665225. מידע נוסף זמין במאמר הטמעת ניווט באמצעות רכיב ארכיטקטורת הניווט.
- בחירת פריט ב-
NavigationViewתסגור עכשיו כל גיליון תחתון שמכיל אותו b/112158843
שינויים ב-API
- שינוי תוכנה שעלול לגרום לכשל: ה-method
navigate()של Navigator מקבלת עכשיו פרמטרNavigator.Extras. - השיטה
getGraph()של NavController היא עכשיוNonNullb/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יהפוך ל-setDemoControllerIndexb/79995048 - לדוגמה,
action_show_settingsיהפוך ל-actionShowSettingsb/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.