التنقّل باستخدام ميزة الإنشاء في نظام التشغيل Wear OS

إصدار Compose لـ Wear OS Material ‫2.5 ‫3

---

يتيح مكوِّن التنقّل في Android Jetpack إمكانية استخدام تطبيقات Jetpack Compose. يمكنك التنقّل بين العناصر القابلة للإنشاء مع الاستفادة من البنية الأساسية والميزات التي يوفّرها مكوّن Navigation.

توضّح هذه الصفحة الاختلافات بين Jetpack Navigation وCompose for Wear OS.

ملاحظة: إذا لم تكن على دراية بمكوّن Navigation، راجِع الموارد الخاصة بـ التنقّل باستخدام Compose قبل المتابعة.

ضبط إعدادات الميزة

استخدِم الاعتمادية التالية في ملف build.gradle الخاص بوحدة التطبيق:

Kotlin

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

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

إنشاء أداة تحكّم في التنقّل ومضيف ورسم بياني

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

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

val navController = rememberSwipeDismissableNavController()
Navigation.kt

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

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

كما هو الحال مع NavHostComposable، يأخذ هذا الرمز مرجعًا إلى أداة التحكّم في التنقّل، ومسار وجهة البدء، وأداة إنشاء الرسم البياني للتنقّل، والتي تظهر هنا كدالة لامدا لاحقة.

يجب توفير وجهة البدء في أداة إنشاء الرسم البياني للتنقّل، بالإضافة إلى جميع الوجهات الأخرى التي يجب أن يكون من الممكن التنقّل إليها باستخدام أداة التحكّم في التنقّل.

في تطبيق 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 padding = rememberResponsiveColumnPadding(
        first = ColumnItemType.BodyText
    )

    ScreenScaffold(
        scrollState = scrollState,
        contentPadding = padding
    ) { scaffoldPaddingValues ->
        // Screen content goes here
        // ...
Navigation.kt

لمزيد من المعلومات حول Jetpack Navigation، يمكنك الاطّلاع على التنقّل باستخدام Compose أو المشاركة في تجربة Jetpack Compose Navigation العملية.