ניווט מתייחס לאינטראקציות שמאפשרות למשתמשים לנווט בין קטעי התוכן השונים באפליקציה, להיכנס אליהם ולצאת מהם.
רכיב הניווט של Android Jetpack כולל את ספריית הניווט, פלאגין Safe Args Gradle וכלים שיעזרו לכם להטמיע ניווט באפליקציה. רכיב הניווט מטפל בתרחישי שימוש שונים של ניווט, החל מקליקים פשוטים על כפתורים ועד לתבניות מורכבות יותר, כמו סרגלי אפליקציות וחלונית הזזה לניווט.
מושגים מרכזיים
בטבלה הבאה מפורטים מושגי המפתח בניווט והסוגים העיקריים שבהם משתמשים כדי להטמיע אותם.
קונספט |
מטרה |
סוג |
|---|---|---|
מארח |
רכיב בממשק המשתמש שמכיל את יעד הניווט הנוכחי. כלומר, כשמשתמש מנווט באפליקציה, האפליקציה למעשה מחליפה יעדים במארח הניווט. |
|
תרשים |
מבנה נתונים שמגדיר את כל יעדי הניווט באפליקציה ואת האופן שבו הם מתחברים זה לזה. |
|
שלט רחוק |
הרכז המרכזי לניהול הניווט בין היעדים. הבקר מציע שיטות לניווט בין יעדים, טיפול בקישורי עומק, ניהול מקבץ הפעילויות הקודמות (back stack) ועוד. |
|
יעד |
צומת בתרשים הניווט. כשהמשתמש מנווט לצומת הזה, המארח מציג את התוכן שלו. |
בדרך כלל נוצר כשבונים את תרשים הניווט. |
מסלול |
מזהה באופן ייחודי יעד וכל מידע שנדרש לו. אתם יכולים לנווט באמצעות מסלולים. מסלולים מובילים אתכם ליעדים. |
כל סוג נתונים שניתן לסריאליזציה. |
יתרונות ותכונות
לרכיב הניווט יש עוד כמה יתרונות ותכונות, כולל:
- אנימציות ומעברים: מספק משאבים סטנדרטיים לאנימציות ולמעברים.
- קישורי עומק: מטמיעים ומטפלים בקישורי עומק שמעבירים את המשתמש ישירות ליעד.
- תבניות עיצוב של ממשק משתמש: תמיכה בתבניות כמו חלוניות הזזה לניווט וסרגלי ניווט תחתונים, במינימום עבודה נוספת.
- מניעת שגיאות הקלדה: כוללת תמיכה בהעברת נתונים בין יעדים עם מניעת שגיאות הקלדה.
- תמיכה ב-ViewModel: מאפשרת להגדיר את ההיקף של
ViewModelבתרשים ניווט כדי לשתף נתונים שקשורים לממשק המשתמש בין היעדים בתרשים. - טרנזקציות מקטעים: תמיכה מלאה בטרנזקציות מקטעים וטיפול בהן.
- חזרה ועלייה ברמה: כברירת מחדל, הפעולות "חזרה" ו"עלייה ברמה" מטופלות בצורה נכונה.
אפשרויות של Framework
הרכיב Navigation תומך בשני Frameworks עיקריים להטמעה של תרשים הניווט, בהתאם לארכיטקטורת ממשק המשתמש של האפליקציה:
- Compose: אם האפליקציה שלכם פותחה לגמרי באמצעות Jetpack Compose, השתמשו ב-Navigation Compose. היעדים בתרשים הם פונקציות קומפוזביליות.
- מקטעים (fragments): אם האפליקציה משתמשת ב-Views או בשילוב של Views ופיתוח נייטיב, צריך להשתמש ברכיב הניווט מבוסס-מקטע (fragment). היעדים בתרשים הם מקטעים שיכולים לארח תצוגות רגילות, תוכן של פיתוח נייטיב או שילוב של שניהם.
באפליקציות שמועברות מ-Views לפיתוח נייטיב, האסטרטגיה המומלצת היא להמשיך להשתמש ברכיב הניווט מבוסס-מקטע (fragment) תוך כדי המרת מסכים נפרדים לפיתוח נייטיב. אחרי שכל המקטעים הוחלפו ברכיבי Composable, אפשר להעביר את תרשים הניווט אל Navigation Compose.
הגדרת הסביבה
כדי לכלול תמיכה בניווט בפרויקט, מוסיפים את יחסי התלות הבאים לקובץ 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") }
במאמר הוספת רכיבים לפרויקט מוסבר איך מוסיפים רכיבי ארכיטקטורה אחרים לפרויקט.
השלבים הבאים
במקורות המידע הבאים תוכלו למצוא עוד מסמכים ומשאבים שקשורים לרכיב הניווט.
מדריכים מפורטים
במדריכים הבאים מוסבר איך להטמיע מארח ניווט ו-NavController, ואיך הם פועלים עם Compose ומסגרות אחרות של ממשק משתמש:
- יצירת בקר ניווט: הסבר על יצירת
NavController. - יצירת תרשים ניווט: הסבר מפורט על יצירת מארח ניווט ותרשים ניווט.
- ניווט ליעד: איך משתמשים ב-
NavControllerכדי לעבור בין היעדים בתרשים.
Codelabs
- מידע על Jetpack Navigation
- מקטעים (fragments) ורכיב הניווט
- איך יוצרים אפליקציה מותאמת עם ניווט דינמי
סרטונים
- ניווט
- 10 שיטות מומלצות למעבר לפעילות אחת
- פעילות אחת: למה, מתי ואיך (מפגש של מפתחי Android, 2018)
- Android Jetpack: Manage UI navigation with navigation controller (Google I/O '18)