רכיב הניווט ב-Android Jetpack תומך באפליקציות של Jetpack Compose. אתם יכולים לנווט בין רכיבים קומפוזביליים תוך ניצול התשתית והתכונות של רכיב הניווט.
בדף הזה מתוארים ההבדלים ב-Jetpack Navigation ב-Compose ל-Wear OS.
הגדרה
משתמשים ביחסי התלות הבאים בקובץ build.gradle של מודול האפליקציה:
Kotlin
dependencies { def wear_compose_version = "1.7.2" implementation "androidx.wear.compose:compose-navigation:$wear_compose_version" }
משתמשים בו במקום פריט המידע שנוצר בתהליך פיתוח התוכנה (Artifact) של androidx.navigation:navigation-compose, כי הוא מספק הטמעות חלופיות ספציפיות ל-Wear OS.
יצירת בקר ניווט, מארח ותרשים
כדי לנווט באמצעות Compose ל-Wear OS, צריך את אותם שלושה רכיבים שנדרשים באפליקציות שלא מיועדות ל-Wear OS: בקר הניווט, המארח והתרשים.
משתמשים ב-rememberSwipeDismissableNavController() כדי ליצור מכונה של WearNavigator, הטמעה של NavController שמתאימה לאפליקציות Wear OS:
val navController = rememberSwipeDismissableNavController()
NavController הוא ה-API הראשי שמשמש לניווט באפליקציות Compose. הוא שולט בניווט בין רכיבי ה-composable במארח הניווט, שב-Wear OS הוא SwipeDismissableNavHost.
val navController = rememberSwipeDismissableNavController() SwipeDismissableNavHost( navController = navController, startDestination = "message_list" ) { // TODO: build navigation graph }
בדומה לNavHost composable, הוא מקבל הפניה ל-navigation controller, למסלול של יעד ההתחלה ול-builder של תרשים הניווט, שמוצג כאן כ-trailing lambda.
צריך לציין את יעד ההתחלה ב-navigation graph builder, יחד עם כל היעדים האחרים שאפשר לנווט אליהם באמצעות ה-navigation controller.
באפליקציה ל-Wear OS, צריך להצהיר עלSwipeDismissableNavHost כתוכן של AppScaffold כדי לתמוך ברכיבים ברמה העליונה כמו זמן, גלילה או אינדיקטור מיקום ואינדיקטור דף.
משתמשים באובייקט AppScaffold מעל SwipeDismissableNavHost ו-ScreenScaffold ברמת המסך כדי להוסיף אובייקט TimeText למסך כברירת מחדל, ולוודא שהוא מונפש בצורה נכונה כשעוברים בין מסכים.
בנוסף, ScreenScaffold מוסיף PositionIndicator לתוכן שניתן לגלילה.
AppScaffold { val navController = rememberSwipeDismissableNavController() SwipeDismissableNavHost( navController = navController, startDestination = "message_list" ) { composable("message_list") { MessageList(onMessageClick = { id -> navController.navigate("message_detail/$id") }) } composable("message_detail/{id}") { MessageDetail(id = it.arguments?.getString("id")!!) } } } } // Implementation of one of the screens in the navigation @Composable fun MessageDetail(id: String) { // .. Screen level content goes here val scrollState = rememberTransformingLazyColumnState() val transformationSpec = rememberTransformationSpec() ScreenScaffold( scrollState = scrollState, ) { contentPadding -> // Screen content goes here // ...
הצגת תיבות דו-שיח
כדי להציג תיבת דו-שיח באמצעות Material 3 ל-Compose ב-Wear OS, כמו AlertDialog, ConfirmationDialog, OpenOnPhoneDialog או Dialog, צריך להצהיר על הרכיב הניתן לTex-הרכבה של תיבת הדו-שיח ישירות בתוך היעד של הרכיב הניתן להרכבה של המסך שפותח אותה. כדי לעשות את זה:
- שולטים בנראות של תיבת הדו-שיח באמצעות משתנה מצב בוליאני, ומעבירים את המצב הזה לפרמטר
visibleשל תיבת הדו-שיח. משתמשים ב-rememberSaveableאו במצב שמועבר ל-ViewModel. - ב-callback של
onDismissRequest, ובכל callback אחר של פעולת אישור או סגירה, מגדירים את משתנה המצב לערךfalse. כך, תיבת הדו-שיח נסגרת עם אנימציה וחוזרת למסך שמתחתיה כשהמשתמש מחליק כדי לסגור אותה או בוחר פעולה.
מידע נוסף זמין במאמרי העזרה של ה-API בנושא AlertDialog, ConfirmationDialog ו-OpenOnPhoneDialog.
מידע נוסף על Jetpack Navigation זמין במאמר ניווט באמצעות פיתוח נייטיב או ב-Codelab של Jetpack Compose Navigation.
מומלץ בשבילך
- הערה: טקסט הקישור מוצג כש-JavaScript מושבת
- העברת נתונים מ-Jetpack Navigation ל-Navigation Compose
- ניווט באמצעות "פיתוח נייטיב"
- איך עוברים בין מסכים באמצעות Compose