ناوبری با Compose برای Wear OS


مؤلفه پیمایش در Android Jetpack از برنامه‌های Jetpack Compose پشتیبانی می‌کند. می‌توانید بین composableها پیمایش کنید و درعین‌حال از زیرساخت و ویژگی‌های مؤلفه Navigation بهره ببرید.

این صفحه تفاوت‌های Jetpack Navigation در Compose for Wear OS را شرح می‌دهد.

راه‌اندازی

از وابستگی زیر در فایل build.gradle واحد برنامه‌تان استفاده کنید:

کاتلین

dependencies {
    def wear_compose_version = "1.7.2"
    implementation "androidx.wear.compose:compose-navigation:$wear_compose_version"
}

این مورد به‌جای مصنوع androidx.navigation:navigation-compose استفاده می‌شود زیرا پیاده‌سازی‌های جایگزین مختص Wear OS را ارائه می‌دهد.

ایجاد کنترل‌کننده، میزبان، و گراف پیمایش

ناوبری با Compose برای Wear OS به همان سه مؤلفه موردنیاز در برنامه‌های غیر Wear OS نیاز دارد: کنترل‌کننده ناوبری، میزبان، و نمودار.

از rememberSwipeDismissableNavController() برای ایجاد نمونه‌ای از WearNavigator، پیاده‌سازی NavController مناسب برای برنامه‌های Wear OS استفاده کنید:

val navController = rememberSwipeDismissableNavController()

NavController میانای برنامه‌سازی کاربردی اصلی مورداستفاده برای پیمایش در برنامه‌های Compose است. این کنترلر پیمایش بین composableها را در میزبان پیمایش کنترل می‌کند که در Wear OS، SwipeDismissableNavHost است.

val navController = rememberSwipeDismissableNavController()
SwipeDismissableNavHost(
    navController = navController,
    startDestination = "message_list"
) {
    // TODO: build navigation graph
}

Like the NavHost composable, it takes a reference to the navigation controller, the route for the start destination, and the builder for the navigation graph which is shown here as a trailing lambda.

مقصد شروع باید در سازنده نمودار ناوبری، همراه با همه مقصدهای دیگری که باید با کنترل‌کننده ناوبری قابل‌ناوبری باشند، ارائه شود.

در برنامه 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)، کادر گفتگوی قابل‌ساخت را مستقیماً در مقصد قابل‌ساخت صفحه که آن را باز می‌کند اعلام کنید. برای انجام این کار، این مراحل را تکمیل کنید:

  1. رؤیت‌پذیری کادر گفتگو را بااستفاده از متغیر حالت بولی کنترل کنید و آن حالت را به پارامتر visible کادر گفتگو ارسال کنید. از rememberSaveable یا وضعیتی که به ViewModel ارتقا یافته است استفاده کنید.
  2. در فراخوانی برگشتی onDismissRequest و در هر فراخوانی برگشتی کنش تأیید یا رد کردن دیگری، متغیر وضعیت را روی false تنظیم کنید. به این ترتیب، وقتی کاربر برای رد کردن تند می‌کشد یا کنشی را انتخاب می‌کند، کادر گفت‌وگو با پویانمایی بسته می‌شود و به صفحه زیرین برمی‌گردد.

برای اطلاعات بیشتر، به اسناد مرجع میانای برنامه‌سازی کاربردی AlertDialog، ConfirmationDialog، و OpenOnPhoneDialog مراجعه کنید.

برای کسب اطلاعات بیشتر درباره Jetpack Navigation، به پیمایش با Compose مراجعه کنید یا کد آزمایشگاهی Jetpack Compose Navigation را ببینید.