navigation3

  
‫Navigation 3 היא ספריית ניווט חדשה שנועדה לעבוד עם Compose.
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
‫17 ביוני 2026 1.1.3 - - ‎1.2.0-alpha04

הצהרה על יחסי תלות

כדי להוסיף תלות ב-navigation3, צריך להוסיף את מאגר Google Maven לפרויקט. מידע נוסף זמין במאמר בנושא מאגר Maven של Google.

אתם יכולים להוסיף את יחסי התלות של הארטיפקטים שאתם צריכים בקובץ build.gradle של האפליקציה או המודול:

Groovy

dependencies {
    implementation "androidx.navigation3:navigation3-runtime:1.2.0-alpha04"
    implementation "androidx.navigation3:navigation3-ui:1.2.0-alpha04"
}

Kotlin

dependencies {
    implementation("androidx.navigation3:navigation3-runtime:1.2.0-alpha04")
    implementation("androidx.navigation3:navigation3-ui:1.2.0-alpha04")
}

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

משוב

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

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

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

אין הערות לגבי הגרסה של הארטיפקט הזה.

גרסה ‎1.2.0-alpha04

‫3 ביוני 2026

‫androidx.navigation3:navigation3-*:1.2.0-alpha04 מופץ. גרסה ‎1.2.0-alpha04 מכילה את השמירות האלה.

תיקוני באגים

  • תוקנה בעיה באנימציה של שכבת-על שבה שכבות-על מוטמעות כמו ModalBottomSheet מונפשות מחדש באופן בלתי צפוי כשהשכבות שמעליהן מוקפצות. (Ia2b9e, ‏ b/502624496)

גרסה ‎1.2.0-alpha03

‫19 במאי 2026

‫androidx.navigation3:navigation3-*:1.2.0-alpha03 מופץ. גרסה ‎1.2.0-alpha03 מכילה את השמירות האלה.

תכונות חדשות

בניווט 3 יש עכשיו תמיכה בקישורי עומק עם DeepLinkRequest ו-DeepLinkMatcher:

  • DeepLinkRequest קישור עמוק שכולל DeepLinkUri ו-mimeType או פעולה אופציונליים(ב-Android בלבד). בנוסף למחלקה החדשה, יש פונקציות נלוות ליצירת מופע עם uri, ‏ mimeType או action. בפלטפורמת Android יש גם כלי עזר ליצירת בקשה מ-Intent. (Iaaac9, b/470282247)

    val uriOnlyRequest = DeepLinkRequest.fromUriString("https://sampledeeplink.com/home")
val uriAndMimeRequest = DeepLinkRequest.fromUriString(
  "https://sampledeeplink.com/user/profile?id=123",
  "image/png"
)

  • ‫DeepLinkMatcher מייצג קישור עומק שאפשר להתאים ל-DeepLinkRequest. כל מופע של התאמה משויך למקש הניווט שתומך בקישור העומק הזה. אפשר לשייך מקש ניווט לכמה התאמות. התקשרות אל DeepLinkMatcher.match תחזיר MatchResult שמכיל את מקש הניווט המשויך אם ההתאמה תצליח. יש שתי הטמעות ברירת מחדל של DeepLinkMatcher: ‏ UriDeepLinkMatcher להתאמת קישורי עומק על סמך URI, ו-StaticKeyDeepLinkMatcher להתאמת קישורי עומק רק עם DeepLinkMatcher.Filter שתואמים לBoolean. ‫(I3798e, ‏ b/470282247)

  • ‫UriDeepLinkMatcher הטמעה מבוססת-הנחות של DeepLinkMatcher שמטפלת בקישור עומק על ידי התאמה של DeepLinkUri למפתח ניווט ניתן לסריאליזציה. הוא תומך בארגומנטים של קישורי עומק מסוגים פרימיטיביים או באוסף של פרימיטיבים כמו רשימות, מערכים וקבוצות. (I1520b, b/470282247)

    @Serializable
data class UserKey(val id: Int): NavKey

// declare a deep link supported by UserKey
val userMatcher = UriDeepLinkMatcher(
  uriPattern = "www.sampledeeplink.com/user?userId={id}",
  serializer = serializer<UserKey>()
)

// handle a requested deep link with fallback key
val key = userMatcher.match(deepLinkRequest)?.key ?: HomeKey

  • נוסף DeepLinkUri שהיא גרסת kotlin-multiplatform של android.net.Uri (Id4725, ‏ b/470282247)

שינויים ב-API

  • הועלה לגרסה compileSdk 37 כדי להתאים ל-compileSdk של Compose

תיקוני באגים

  • תוקנה הבעיה AnimatedBottomSheetSample's IllegalArgumentException כשמוצגות כמה שכבות-על. הדוגמה SceneStrategy תחשב עכשיו בצורה נכונה את ה-OverlayScene האחרון ותציג אותו מתחת לכל הסצנות של שכבות העל. (If2281, b/506733412)
  • הועלתה התלות ב-NavigationEvent לגרסה 1.1.1, שמסירה את NavigationEventHandler שאין לו פעולה (no-op) כשנמצאים במצב בדיקה, כדי להפעיל את התכונה 'חזרה עם אנימציה' בתצוגות המקדימות של Android Studio. (I487fd)

גרסה ‎1.2.0-alpha02

‫22 באפריל 2026

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

שינויים ב-API

  • משנים את השם של onBack ל-onBackCompleted ומוסיפים את onBackCancelled ל-NavigationBackHandler כדי לתמוך בטיפול במחוות חזרה שבוטלו. (I92741)
  • הוספת NavigationBackHandler כדי לפשט את הטיפול במחוות חזרה ובחיזוי חזרה כשמשתמשים ב-SceneState. כך המפתחים יכולים ליצור בקלות רבה יותר רכיבי ממשק משתמש מותאמים אישית שתומכים בניווט לאחור רגיל ובמחוות ניווט אחורה חזויות, בלי לחשב ידנית את הדלתאות של מקבץ הפעילויות הקודמות (back stack). (I6a055)
  • מוסיפים rememberNavigationEventState כדי לפשט את החיבור SceneState באמצעות טיפול חיזוי בחזרה. (Iae49c)

תכונות חדשות

  • הוספנו ResultEventBus API כדי לאפשר העברת תוצאות בין NavEntry באמצעות LocalResultEventBus שסופק על ידי ResultEventBusNavEntryDecorator החדש. אפשר להעריך את התוצאות שעברו כסטטוס עם ResultEventBus#conflateAsState או כרצף של תוצאות עם ResultEffect.

גרסה ‎1.2.0-alpha01

‫8 באפריל 2026

‫androidx.navigation3:navigation3-*:1.2.0-alpha01 מופץ. גרסה ‎1.2.0-alpha01 מכילה את השמירות האלה.

תיקוני באגים

  • הגישה אל LocalNavAnimatedContentScope מ-OverlayScene לא תגרום יותר ל-IllegalStateException כי OverlayScenes מקבלים עכשיו LocalAnimatedContentScope מסוג no-op. (I2f00c, b/486067688)

גרסה 1.1.3

‫17 ביוני 2026

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

תיקוני באגים

  • תוקנה בעיה באנימציה של שכבת-על שבה שכבות-על מוטמעות כמו ModalBottomSheet מונפשות מחדש באופן בלתי צפוי כשהשכבות שמעליהן מוקפצות. (Ia2b9e, ‏ b/502624496)

  • הועלתה התלות ב-NavigationEvent לגרסה 1.1.2, שבה הוסר ה-no-op‏ NavigationEventHandler כשנמצאים במצב בדיקה, כדי להפעיל את התכונה 'חזרה עם אנימציה' בגרסאות טרום-השקה של Android Studio.

גרסה 1.1.2

‫19 במאי 2026

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

תיקוני באגים

  • הועלתה התלות ב-NavigationEvent לגרסה 1.1.1, שבה הוסר ה-no-op‏ NavigationEventHandler כשנמצאים במצב בדיקה, כדי להפעיל את התכונה 'חזרה עם אנימציה' בתצוגות המקדימות של Android Studio.

גרסה 1.1.1

‫22 באפריל 2026

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

תיקוני באגים

  • הגישה אל LocalNavAnimatedContentScope מ-OverlayScene לא תגרום יותר ל-IllegalStateException כי OverlayScenes מקבלים עכשיו LocalAnimatedContentScope מסוג no-op. (I2f00c, b/486067688)

גרסה 1.1.0

‫8 באפריל 2026

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

גרסה 1.1.0 יציבה עכשיו!

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

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

‫SceneDecoratorStrategy - הוספנו את SceneDecoratorStrategy כדי לתמוך בתרחישי שימוש כמו הוספת רכיבי ממשק משתמש נפוצים לסצנות או שיתוף מצב בין סצנות.

‫NavMetadata DSL - בספרייה Navigation3 יש עכשיו DSL חדש של מטא-נתונים עם בטיחות סוגים. ה-DSL משתמש בממשק MetadataKey חדש שמאפשר להגדיר את סוגי המפתח והערך שרוצים לספק למפת המטא-נתונים. בנוסף, נוספו NavMetadataKeys חדשים למעברים של NavDisplay, כדי שאפשר יהיה להשתמש בהם עם ה-DSL החדש של המטא נתונים ולהוסיף מעברים ל-NavDisplay.

OverlayScene Animations - לממשק OverlayScene יש עכשיו קריאה חוזרת (callback) חדשה להשהיה onRemoved. הקריאה החוזרת הזו מופעלת אחרי שמפתח שמשויך לסצנה מוסר מהמחסנית האחורית, אבל לפני שהוא יוצא מהקומפוזיציה. כך אנימציות היציאה שנקראות בתוך onRemovedיושלמו לפני שהסצנה של שכבת העל תוסר מהקומפוזיציה.

שינויים אחרים - התגים NavDisplay ו-rememberSceneState מקבלים עכשיו List<SceneStrategy> במקום הפרמטר הקודם SceneStrategy שהיה משורשר באמצעות התו then. – עכשיו אפשר להוסיף מטא-נתונים באופן דינמי תוך התחשבות במפתח הרשומה באמצעות EntryProvider DSL.

גרסה ‎1.1.0-rc01

‫25 במרץ 2026

‫androidx.navigation3:navigation3-*:1.1.0-rc01 מופץ. גרסה ‎1.1.0-rc01 מכילה את השמירות האלה.

תיקוני באגים

  • NavDisplay מוודא עכשיו שהערכים שמוצגים מתחת לשכבות-על מוגבלים ל-STARTED.Lifecycle כך תוכלו לוודא ש-API כמו dropUnlessResumed ימשיך לפעול כשמשתמשים בתיבות דו-שיח. ‫(If209f, b/483966071)
  • תוקנה בעיה ב-NavDisplay שבה ניווט הלוך ושוב בין אותם מסכים והפרעה לאנימציות בין שני המסכים עלולים לגרום לסדר השכבות של המסכים להיות שגוי. ‫(I4d491, ‏ b/459419800)

גרסה ‎1.1.0-beta01

‫11 במרץ 2026

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

גרסה ‎1.1.0-alpha05

‫25 בפברואר 2026

‫androidx.navigation3:navigation3-*:1.1.0-alpha05 מופץ. גרסה ‎1.1.0-alpha05 מכילה את השמירות האלה.

שינויים ב-API

  • ב-NavDisplay וב-rememberSceneState יש עכשיו List<SceneStrategy> במקום הפרמטר הקודם SceneStrategy היחיד ששורשר באמצעות התחילית then. השינוי הזה תואם יותר ל-List<SceneDecoratorStrategy<T>> ששני ממשקי ה-API האלה כבר מקבלים. הוצאנו משימוש את ממשקי ה-API הקודמים. ‫(I78b2c, ‏ b/482108465)
  • נוסף אופרטור metadata #contains כדי לבדוק אם מפת המטא-נתונים מכילה את NavMetadataKey שצוין. (Ic30db, ‏ b/485311895)
  • נוספה האפשרות NavMetadataKey DialogKey ל-DialogSceneStrategy לשימוש עם Metadata DSL. ‫(Ic7a26, ‏ b/483388817)

גרסה ‎1.1.0-alpha04

‫11 בפברואר 2026

‫androidx.navigation3:navigation3-*:1.1.0-alpha04 מופץ. גרסה ‎1.1.0-alpha04 מכילה את השמירות האלה.

תכונות חדשות

  • ‫Navigation3 מספקת עכשיו DSL חדש של מטא-נתונים שמאובטח מפני שגיאות הקלדה. ה-DSL משתמש בממשק MetadataKey חדש שמאפשר להגדיר את סוגי המפתח והערך שרוצים לספק למפת המטא-נתונים. בנוסף, נוספו NavMetadataKey חדשים למעברים של NavDisplay, כדי שאפשר יהיה להשתמש בהם עם metadata DSL החדש כדי להוסיף מעברים ל-NavDisplay. (Ic10ef, Ic049c,b/476213928)

שינויים ב-API

  • בממשק של OverlayScene יש עכשיו onRemoved callback חדש להשעיה. הקריאה החוזרת הזו מופעלת אחרי שמפתח שמשויך לסצנה מוסר מהמחסנית האחורית, אבל לפני שהוא יוצא מהקומפוזיציה. כך אנימציות היציאה שנקראות בתוך onRemoved יושלמו לפני שהסצנה של שכבת העל תוסר מהקומפוזיציה. (I29a72, b/440558061)
  • ‫SceneStrategy פיצלה את פונקציית העיצוב לפונקציה חדשה SceneDecoratorStrategy. הממשק החדש הזה הוא הממשק שבו צריך להשתמש כדי לקשט סצנות. יש ממשקי API חדשים ל-NavDisplay ול-rememberSceneState שמאפשרים להוסיף SceneDecoratorStrategies. (If9385, b/477669607, b/477670333)

תיקוני באגים

  • תוקנה שגיאה שבה העברה של SharedTransitionLayout אל NavDisplay או אל rememberSceneState ושימוש ב-OverlayScene כלשהו גרמו לקריסה, כי השימוש ב-SharedTransitionLayout פועל רק עם NavEntries שמוצגים כחלק מ-AnimatedContent, ו-OverlayScene מוצגים בחלונות נפרדים משלהם. ‫(I1bb76, ‏ b/478664101)

עדכון תלות

  • מגרסה Navigation3 1.0.1: Navigation3 תלויה עכשיו בגרסה NavigationEvent 1.0.2. העדכון הזה פותר בעיה IllegalStateException שנגרמה כתוצאה משימוש ב- NavDisplay במהלך תצוגות מקדימות של AndroidStudio. (Id7212, b/477149762)

גרסה ‎1.1.0-alpha03

‫28 בינואר 2026

‫androidx.navigation3:navigation3-*:1.1.0-alpha03 מופץ. גרסה ‎1.1.0-alpha03 מכילה את השמירות האלה.

תכונות חדשות

  • עכשיו אפשר להוסיף מטא-נתונים באופן דינמי באמצעות EntryProvider DSL, תוך התחשבות במפתח הרשומה. ‫(I942fb, ‏ b/474416976)

גרסה ‎1.1.0-alpha02

‫14 בינואר 2026

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

תכונות חדשות

  • ‫SceneStrategy תומך עכשיו בהטמעה של סצנות באמצעות הפונקציה החדשה calculatedScene(Scene). כלומר, אפשר להתאים אישית את SceneStrategy כדי לספק פונקציונליות נוספת לסצנות אחרות. (I5df7c,b/440333896)

גרסה ‎1.1.0-alpha01

‫3 בדצמבר 2025

‫androidx.navigation3:navigation3-*:1.1.0-alpha01 מופץ. גרסה ‎1.1.0-alpha01 מכילה את השמירות האלה.

שינויים ב-API

  • ב-Navigation3 יש עכשיו תמיכה בהתייחסות לסצנות כאובייקט של רכיב משותף. המשמעות היא שכאשר הסצנות משתנות, אפשר לוודא שהמעבר ביניהן יהיה חלק. כדי להפעיל את ההגדרה הזו, מעבירים SharedTransitionScope ל-NavDisplay או ל-rememberSceneState. (I15868)

גירסה 1.0

גרסה 1.0.1

‫11 בפברואר 2026

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

עדכון תלות

  • ‫Navigation3 תלוי עכשיו ב-NavigationEvent 1.0.2. העדכון הזה פותר בעיה IllegalStateException שנגרמה כתוצאה משימוש ב- NavDisplay במהלך תצוגות מקדימות של AndroidStudio. (Id7212, b/477149762)

גרסה 1.0.0

‫19 בנובמבר 2025

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

חדש: Navigation3!

גרסה ‎1.0.0-rc01

‫5 בנובמבר 2025

‫androidx.navigation3:navigation3-*:1.0.0-rc01 מופץ. גרסה ‎1.0.0-rc01 מכילה את השמירות האלה.

תיקוני באגים

  • ‫NavDisplay מגדיר עכשיו LocalLifecycleOwner ברמה Scene שמאפשרת לכותבי סצנות לקבוע אם כל המעברים הסתיימו על ידי בדיקה שהערך של Lifecycle.State הוא RESUMED. ההתנהגות של LocalLifecycleOwner ברמה NavEntry לא משתנה: היא גם נשארת מוגבלת ל-STARTED אם מתבצע מעבר, ומוגבלת בנוסף ל-CREATED אם NavEntry הוצא מהמחסנית האחורית והוא בתהליך של אנימציה. (I03113, b/454045829)

גרסה ‎1.0.0-beta01

‫22 באוקטובר 2025

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

שינויים ב-API

  • ‫SceneStrategyScope כולל עכשיו רק בנאי ציבורי ללא ארגומנטים, שמתאים לבדיקה של SceneStrategy ושל Scene שמוחזר בבידוד. לתרחישי שימוש מורכבים יותר, מומלץ להשתמש ב-rememberSceneState(). (I8440c, ‏ b/451679047)

תיקוני באגים

  • תוקנה לולאה אינסופית כשמשלבים SceneStrategy עם then. (Iba3f0, b/450323470)
  • תוקן מצב של הבהוב המסך כשמחליפים את backStack שעבר אל NavDisplay ומשתמשים באנימציות. (Ief7b5, b/450967248)

גרסה ‎1.0.0-alpha11

‫8 באוקטובר 2025

‫androidx.navigation3:navigation3-*:1.0.0-alpha11 מופץ. גרסה ‎1.0.0-alpha11 מכילה את השמירות האלה.

שינויים ב-API

  • השיטה calculateScene ב-SceneStrategy כבר לא @Composable. במקום זאת, כדאי להעביר את העבודה הזו לבנייה של שיטת SceneStrategy (כלומר, בשיטת rememberMySceneStrategy()) שמאפשרת לכם להגדיר באופן מלא את משך החיים של ערכי rememberSaveable או של הצהרות מפתח remember על סמך הערכים הנכונים. (If1733, b/448709506)
  • הפרמטר onBack של SceneStrategy.calculateScene הועבר להיקף החדש של מקבל הנתונים SceneStrategyScope כדי להבהיר שמדובר בפרמטר אופציונלי, וכדי לספק נקודת הרחבה לתכונות עתידיות של Navigation3. (I3aea3, ‏ b/448460407)
  • פונקציית ה-lambda‏ onBack שמועברת אל NavDisplay ואל SceneStrategy לא מספקת יותר פרמטר count: Int כדי לציין מתי צריך להסיר כמה רשומות. במקום זאת, קריאה ל-lambda‏ () -> Unit תתבצע כמה פעמים ברצף במקרה הנדיר שבו בקשות ה-Scene שלכם יציגו כמה רשומות. (Idedb5, ‏ b/446989346)
  • תסיר את המחלקה NavEntryWrapper ותחליף את הפונקציונליות שלה במחלקה סופית NavEntry עם בנאי משני חדש שמקבל NavEntry עם תוכן חדש. כך תהיה תמיכה בהוספת תוכן חדש לערך. (I7da2a, b/444447130)
  • הפונקציה navEntryDecorator שיוצרת ומחזירה NavEntryDecorator הוסרה והוחלפה במחלקה NavEntryDecorator, שעכשיו היא ציבורית ופתוחה ליצירת מחלקות משנה. ‫(If81f8, ‏ b/444447434, ‏ b/447381176)
  • השם של SavedStateNavEntryDecorator שונה ל-SaveableStateHolderNavEntryDecorator כי הוא מוסיף SaveableStateHolder לרשומות. בנוסף, בוצע רפקטורינג של ה-decorator מפונקציה למחלקה, כי מבחינה פונקציונלית הוא מפעל של NavEntryDecorator. (Ie6013, b/447381176)
  • כבר לא צריך להשתמש ב-LocalEntriesToRenderInCurrentScene composition local כדי להציג תצוגות מותאמות אישית באמצעות SceneState כחלופה לשימוש ב-NavDisplay. התכונה הזו היא עכשיו פנימית. (Ic40ef, b/414668196)
  • הסרנו את SceneSetupNavEntryDecorator ואת rememberSceneSetupNavEntryDecorator() מ-API שגלוי לכולם. הפונקציונליות הזו כלולה עכשיו כברירת מחדל, ולא צריך להוסיף אותה באופן ידני. (Ieae42, ‏ b/444479133)
  • הפונקציות NavEntry,‏ DialogScene,‏ SinglePaneScene וגם SceneState כוללות עכשיו את הפונקציה equals. (I96121)
  • בממשק של הסצנה יש שדה חדש של מטא-נתונים לצירוף מטא-נתונים ספציפיים לסצנה עבור NavDisplay. כך אפשר להגדיר שסצנה מסוימת תבטל את המטא-נתונים של NavDisplay, למשל באמצעות מעברים. (I1fd96, b/443955625)
  • כדי לפשט את החתימה של rememberNavBackStack, צריך להסיר את פרמטר הסוג הכללי המיותר. הפונקציה מקבלת עכשיו את הערך vararg elements: NavKey. (I03e45)
  • אנימציות ברירת המחדל של NavDisplay הן עכשיו חלק מה-API המשותף, כך שאפשר לקרוא להן מכל הפלטפורמות. (I71af9, b/447147159)
  • משנים את השם של EntryProviderBuilder ל-EntryProviderScope כדי לשקף בצורה מדויקת שהכיתה היא Kotlin DSL שמספקת היקף לבניית NavEntries. (Ia7465)

תיקוני באגים

  • rememberNavBackStack() אוכף עכשיו סריאליזציה פולימורפית עבור NavKey ודורש SavedStateConfiguration מותאם אישית שמוגדר כדי להבטיח שחזור נכון של המצב. עדכנו את KDoc כדי לשקף את הדרישה שכל סוגי המשנה של NavKey צריכים להיות רשומים ב-SerializersModule שסופק. (I6de37,I782f2, b/446664383)

גרסה ‎1.0.0-alpha10

‫24 בספטמבר 2025

‫androidx.navigation3:navigation3-*:1.0.0-alpha10 מופץ. גרסה ‎1.0.0-alpha10 מכילה את השמירות האלה.

שינויים ב-API

  • הוספת עומס יתר חדש של NavDisplay שמקבל רשימה של NavEntry<T> שעברה קישוט על ידי rememberDecoratedNavEntries. ‫(I4025b, ‏ b/441940314)
  • העברנו את DialogScene לחבילה חדשה. (Ia5840)
  • הסרת ה-API הציבורי DecorateNavEntry. במקום זאת, משתמשים ב-rememberDecoratedNavEntries כדי להקיף את NavEntry ברשימה של רכיבי Decorator. (Id8c09)
  • בממשק המשתמש של Navigation3 יש עכשיו מאפייני ברירת מחדל חדשים של transitionSpec. (Ibcabd)
  • הוספנו אובייקט SceneState חדש שיעזור לכם לנהל סצנות. הפעולה הזו מספקת גם עומס יתר חדש של NavDisplay שמקבל את SceneState ואת NavigationEventState. (Idfb46, ‏ b/444479133)
  • NavDisplay מאפשרת עכשיו להתאים אישית את המעברים על סמך המיקום Scene שממנו יוצאים והמיקום שאליו נכנסים, על ידי עיון בTransitioncurrentState ובtargetState. (I906cc, ‏ b/443872322)
  • התפקיד של NavigationEventInfo הוא עכשיו abstract class במקום interface. מעדכנים את כל ההטמעות בהתאמה אישית כך שיורשות מהמחלקה (לדוגמה, data class MyInfo : NavigationEventInfo()). (I1e59c, b/444734264)
  • ממשקי ה-API של navigationevent-compose handler עודכנו. הפונקציות NavigationEventHandler ו-NavigationBackHandler (והווריאציות שלהן) תומכות עכשיו בעומס יתר חדש שמקבל NavigationEventStates שהועברו למעלה. העומסים הפשוטים (שמקבלים currentInfo) נשמרים ועכשיו משתמשים במודל המצב החדש הזה באופן פנימי. (Ic3251, b/444734264)
  • כל ממשקי ה-API של Scene הועברו מ-navigation3-ui אל navigation3-runtime. כלומר, הם זמינים עכשיו בכל הפלטפורמות שנתמכות על ידי navigation3-runtime. ‫(I431d0, ‏ b/444449993)
  • נוספה rememberDecoratedNavEntries חדשה של overload שמקבלת רשימה של NavEntry לעיצוב. אפשר להוסיף לערכי הקלט קישוטי ערכים אחרים. (I5a034, ‏ b/444230270)
  • הסרת פרמטרים של סוג wildcard של navigation3 ‏ (I02540)
  • שיפרנו את הטיפול בגנריות ב-entryProvider DSL. אם בעבר ייבאתם את androidx.navigation3.runtime.entry, אין יותר צורך בכך. (I299fc)
  • הגבלת העומס העודף של NavBackStackSerializer שמבוסס על השתקפות ל-Android. ההגדרה הזו מונעת כשלים מרומזים בסריאליזציה בזמן ריצה בפלטפורמות שאינן Android, על ידי אכיפת השימוש בעומס היתר המפורש SavedStateConfiguration בקוד מרובה פלטפורמות. ‫(I73313, ‏ b/420443609)
  • תכין את NavigationEvent's swipeEdge בתור @IntDef (Icee54, ‏ b/443950342)
  • הגבלת סריאליזציה NavBackStack ל-Android. כך נמנעים כשלים בזמן ריצה בפלטפורמות שאינן Android. כדי לשמור את המצב בכמה פלטפורמות, משתמשים ב-rememberNavBackStack overload עם SavedStateConfiguration מפורש. (I1e418, b/420443609)

תיקוני באגים

  • תוקנה קריסה במהלך ניווט חזוי אחורה כש-NavDisplay מקונן מכיל רשומה אחת של צאצא. (I2cdc0, ‏ b/441933162)

גרסה ‎1.0.0-alpha09

‫10 בספטמבר 2025

‫androidx.navigation3:navigation3-*:1.0.0-alpha09 מופץ. גרסה ‎1.0.0-alpha09 מכילה את השמירות האלה.

שינויים ב-API

  • הפונקציה DecoratedNavEntryProvider הוחלפה בפונקציה rememberDecoratedNavEntries שיוצרת ומחזירה NavEntry עם קישוטים של רשימת הקישוטים שסופקו (I0fe1c, b/441328236)
  • הפונקציה NavBackStack היא עכשיו גנרית לגבי הסוג NavKey. כך אפליקציות וספריות יכולות להגדיר סוגים מותאמים אישית של מקשים עבור ערימות החזרה שלהן, במקום להיות מוגבלות ל-NavKey. (I4d190,Iad2f4, b/420443609)
  • ‫NavBackStack הוא עכשיו @kotlinx.serialization.Serializable, ולכן אפשר לשמור ולשחזר את מצב הניווט אחרי סיום התהליך ושינויים בהגדרות בלי להשתמש בקוד boilerplate נוסף. (I2c3cf, ‏ b/420443609)
  • העברנו את RememberNavBackStack אל commonMain כדי לוודא שהוא מסופק בכל פלטפורמות היעד. (Id69e7, b/420443609)

תיקוני באגים

  • ‫NavDisplay עכשיו כל NavEntry מועבר בצורה נכונה לLifecycle.State הנכון. (I30aac, b/440145700)
  • תוקנה בעיה שבה NavDisplay התעלם מכל NavigationEventDispatcherOwner שמוגדר באמצעות LocalNavigationEventDispatcherOwner של ספריית NavigationEvent. (I6224a)

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

גרסה ‎1.0.0-alpha08

‫27 באוגוסט 2025

‫androidx.navigation3:navigation3-*:1.0.0-alpha08 מופץ. גרסה ‎1.0.0-alpha08 מכילה את השמירות האלה.

תכונות חדשות

  • נוספו יעדים חדשים של Kotlin MultiPlatform‏ (KMP) לארטיפקטים של Navigation3 Runtime. ‫Navigation3 Runtime תומך עכשיו בפלטפורמות הבאות: JVM (Android ומחשב), Native (Linux,‏ iOS,‏ watchOS,‏ macOS,‏ MinGW) ו-Web (JavaScript,‏ WasmJS). (I55078, b/424410398, b/419294028, b/419046226). הערה: הפקודה הזו לא מספקת יעדי KMP עבור ארטיפקט Navigation3 UI. בפלטפורמות אחרות, תצטרכו להטמיע NavDisplay משלכם בהתאמה אישית. אם אתם רוצים שהתמיכה תתווסף, אתם יכולים להצביע על הבעיה ב-Jetbrains כאן ולעקוב אחרי ההתקדמות כדי לקבל תמיכה נוספת.
  • האובייקט NavDisplayInfo עכשיו ציבורי ואפשר להשתמש בו כדי לאחזר את רשימת הרשומות שגלויות מתוך NavDisplay. (Ibc91f)

שינויים ב-API

  • נוסף NavBackStackSerializer חדש לשימוש בשילוב עם rememberNavBackStack כדי לבצע שחזור של מצב. התג rememberNavBackStack() מקבל עכשיו גם את הערך SavedStateConfiguration שאפשר להשתמש בו כדי לספק הגדרה משלכם. (I2f4d2, ‏ I4cd58, ‏ b/420443609)

תיקוני באגים

  • תוקנה בעיה שבה ניווט גרם להפעלת אירועים שגויים של מחזור החיים. (I8bf6d, ‏ b/425901162, ‏ b/434109022)

בעיות מוכרות

  • באג שנוצר על ידי I8bf6d גרם לכך שמחזורי החיים התבססו על סצנות במקום על רשומות נפרדות. כתוצאה מכך, מחזור החיים לא פעל בכל המקרים שבהם הערך key שסופק ל-NavEntry לא היה String, או ש-NavEntry לא ביטל את contentKey והגדיר אותו כשוויון ל-key (שימו לב שפעולה כזו מחייבת שהמפתח יישמר ב-Bundle). הבאג הזה תוקן בגרסה הבאה. (b/440145700)

גרסה ‎1.0.0-alpha07

‫13 באוגוסט 2025

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

עדכון MinSdk

שינויים ב-API

  • ‫SavedStateNavEntryDecorator משתמש עכשיו ב-SaveableStateRegistry שמוטמע ב-SaveableStateProvider כדי לשמור ולשחזר מצבים. (If8d9a)
  • הפרמטר predictivePopTransitionSpec מועבר עכשיו כפרמטר של החלקה מהקצה, וכך אפשר להתאים אישית את המעבר בהתאם לקצה שממנו המשתמש התחיל את תנועת החיזוי של החזרה. (I753a8)

תיקוני באגים

  • תוקנה בעיה שגרמה לחישוב אינסופי של סצנות בהתאמה אישית, כי המערכת לא זכרה את הסצנה האחרונה. (I7ba84, b/418153031)

עדכון תלות

גרסה ‎1.0.0-alpha06

‫30 ביולי 2025

‫androidx.navigation3:navigation3-*:1.0.0-alpha06 מופץ. גרסה ‎1.0.0-alpha06 מכילה את השמירות האלה.

עדכון תלות

גרסה ‎1.0.0-alpha05

‫2 ביולי 2025

‫androidx.navigation3:navigation3-*:1.0.0-alpha05 מופץ. גרסה ‎1.0.0-alpha05 מכילה את השמירות האלה.

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

  • הסטטוס של NavEntry מבוסס עכשיו באופן בלעדי על הרשימה הנוכחית של פונקציות העיטור שמועברות אל NavDisplay. המשמעות היא שאם יש כמה מחסניות של היסטוריית ניווט, צריך להחליף את ה-decorators לאורך מחסניות היסטוריית הניווט כדי לשמור על המצב של NavEntry במחסנית היסטוריית הניווט. אחרת, המצבים ינוקו כאילו הרשומות הוצאו מהמחסנית (במקום החלפה). (I7a759, b/428033667)

גרסה ‎1.0.0-alpha04

‫18 ביוני 2025

‫androidx.navigation3:navigation3-*:1.0.0-alpha04 מופץ. גרסה ‎1.0.0-alpha04 מכילה את השמירות האלה.

שינויים ב-API

  • הסרטון NavEntry.content מוגדר עכשיו כפרטי. כדי להפעיל תוכן NavEntry, צריך לקרוא ל-API החדש NavEntry.Content(), שכבר לא דורש פרמטר key להפעלה. (Icd0fd, ‏ b/420991203)
  • השדה NavEntry.key הוא עכשיו שדה פרטי. השדה החדש contentKey, שנוצר מ-lambda חדשה contentKeyFactory, צריך לזהות את NavEntry ואת המצבים הרלוונטיים שלו. ערך ברירת המחדל של השדה הוא גיבוב שניתן לשמירה שנוצר מ-NavEntry.key (I81a6c,‏ b/422001357,‏ b/420991203 I2d7d4,‏ b/420991203,‏ b/422841812)

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

  • ‫Navigation3 תלוי עכשיו בארטיפקט androidx.navigationevent.compose החדש.

גרסה ‎1.0.0-alpha03

‫4 ביוני 2025

‫androidx.navigation3:navigation3-*:1.0.0-alpha03 מופץ. גרסה ‎1.0.0-alpha03 מכילה את השמירות האלה.

תיקוני באגים

  • ‫Navigation3 כבר לא ינקה את מצבי ה-decorator של backStacks שהוחלפו והוחלפו במופע אחר של backStack. ‫(I28a42, ‏ b/415076044)

גרסה ‎1.0.0-alpha02

‫23 במאי 2025

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

תיקוני באגים

  • נפתרה בעיה ב-SavedStateNavEntryDecorator שגרמה להתנגשויות בין סוגים שונים של נתונים עם אותם ערכי מאפיינים. (b/418070648, ‏ Iff4775)
  • תוקנה בעיה של מחלקה חסרה שגרמה לקריסות כשמריצים בלי להצהיר על תלות מפורשת. (b/419049149, ‏ I4b4ed)

גרסה ‎1.0.0-alpha01

‫20 במאי 2025

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

תכונות חדשות

‫Navigation3 היא ספריית ניווט חדשה שנוצרה במיוחד כדי לטפל בניווט בתוך האפליקציה ב-Jetpack Compose. ארטיפקט androidx.navigation3.runtime מספק את אבני הבניין, וארטיפקט androidx.navigation3.ui מספק את שכבת ממשק המשתמש באמצעות NavDisplay API. מפתחים יכולים לספק את המצב שלהם ישירות לפונקציה הניתנת להרכבה NavDisplay, שמשנה את התוכן בהתאם לשינויים במצב המפתח.

@Serialiable object Home : NavKey
@Serialiable object Chat : NavKey

val backStack = rememberNavBackStack(Home)

NavDisplay(backStack, entryProvider = entryProvider {
  entry<Home> {
    Column {
      Text(“Home”)
      Button(onClick = { backStack.add(Chat) } ) {
        Text(“Go to Chat”)
      } 
    }
  }
  entry<Chat> { /* My Composable Content */ }
})

מידע נוסף זמין במדריך Navigation3.