التنقّل باستخدام ميزة الإنشاء في نظام التشغيل 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"
}

يتم استخدام هذه السمة بدلاً من العنصر androidx.navigation:navigation-compose لأنّها توفّر عمليات تنفيذ بديلة خاصة بنظام التشغيل Wear OS.

إنشاء وحدة تحكّم في التنقّل ومضيف ومخطّط

يتطلّب التنقّل باستخدام Compose لنظام التشغيل Wear OS المكوّنات الثلاثة نفسها المطلوبة في التطبيقات التي لا تعمل بنظام التشغيل Wear OS، وهي: وحدة التحكّم في التنقّل والمضيف والرسم البياني.

استخدِم rememberSwipeDismissableNavController() لإنشاء مثيل من WearNavigator، وهو تنفيذ لـ NavController مناسب لتطبيقات Wear OS:

val navController = rememberSwipeDismissableNavController()

تُعدّ NavController واجهة برمجة التطبيقات الأساسية المستخدَمة للتنقّل في تطبيقات Compose. تتحكّم هذه الفئة في التنقّل بين الدوال المركّبة في مضيف التنقّل، وهو SwipeDismissableNavHost على Wear OS.

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

مثل الدالة المركّبة NavHost، تتلقّى هذه الدالة مرجعًا إلى وحدة التحكّم في التنقّل، والمسار المؤدي إلى الوجهة الأولى، وأداة إنشاء الرسم البياني للتنقّل الذي يظهر هنا كدالة 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.