ניווט באמצעות 'כתיבה' ב-Wear OS


רכיב הניווט ב-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-הרכבה של תיבת הדו-שיח ישירות בתוך היעד של הרכיב הניתן להרכבה של המסך שפותח אותה. כדי לעשות את זה:

  1. שולטים בנראות של תיבת הדו-שיח באמצעות משתנה מצב בוליאני, ומעבירים את המצב הזה לפרמטר visible של תיבת הדו-שיח. משתמשים ב-rememberSaveable או במצב שמועבר ל-ViewModel.
  2. ב-callback של onDismissRequest, ובכל callback אחר של פעולת אישור או סגירה, מגדירים את משתנה המצב לערך false. כך, תיבת הדו-שיח נסגרת עם אנימציה וחוזרת למסך שמתחתיה כשהמשתמש מחליק כדי לסגור אותה או בוחר פעולה.

מידע נוסף זמין במאמרי העזרה של ה-API בנושא AlertDialog, ConfirmationDialog ו-OpenOnPhoneDialog.

מידע נוסף על Jetpack Navigation זמין במאמר ניווט באמצעות פיתוח נייטיב או ב-Codelab של Jetpack Compose Navigation.