Wear OS-এর জন্য Compose-এর মাধ্যমে নেভিগেশন


Android Jetpack-এ নেভিগেশন কম্পোনেন্ট Jetpack Compose অ্যাপ্লিকেশনের জন্য সহায়তা প্রদান করে। আপনি নেভিগেশন কম্পোনেন্টের ইনফ্রাস্ট্রাকচার ও ফিচারের সুবিধা নেওয়ার সময় কম্পোজেবলের মধ্যে নেভিগেট করতে পারবেন।

এই পৃষ্ঠায় Compose for Wear OS-এ Jetpack Navigation-এর সাথে পার্থক্য বর্ণনা করা হয়েছে।

সেটআপ

আপনার অ্যাপ মডিউলের 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 for Wear OS-এর মাধ্যমে নেভিগেট করতে, Wear OS নয় এমন অ্যাপের মতো একই তিনটি কম্পোনেন্ট প্রয়োজন: নেভিগেশন কন্ট্রোলার, হোস্ট ও গ্রাফ।

WearNavigator-এর ইনস্ট্যান্স তৈরি করতে rememberSwipeDismissableNavController() ব্যবহার করুন, NavController-এর প্রয়োগ Wear OS অ্যাপ্লিকেশনের জন্য উপযুক্ত:

val navController = rememberSwipeDismissableNavController()

NavController হল Compose অ্যাপ্লিকেশনে নেভিগেট করার জন্য ব্যবহৃত প্রাথমিক API। এটি নেভিগেশন হোস্টে কম্পোজেবলের মধ্যে নেভিগেট করা নিয়ন্ত্রণ করে, যা Wear OS-এ SwipeDismissableNavHost।

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

NavHost কম্পোজেবল-এর মতো, এটি নেভিগেশন কন্ট্রোলারের রেফারেন্স, শুরু করার গন্তব্যের রুট এবং নেভিগেশন গ্রাফের জন্য বিল্ডার নেয় যা এখানে ট্রেলিং ল্যাম্বডা হিসেবে দেখানো হয়েছে।

নেভিগেশন গ্রাফ বিল্ডারে শুরুর গন্তব্য উল্লেখ করতে হবে, এর সাথে অন্যান্য সব গন্তব্যও উল্লেখ করতে হবে যেগুলি নেভিগেশন কন্ট্রোলারের মাধ্যমে নেভিগেট করা যাবে।

আপনার Wear OS অ্যাপে, সময়, স্ক্রল বা পজিশন ইন্ডিকেটর এবং পৃষ্ঠা ইন্ডিকেটরের মতো টপ-লেভেল কম্পোনেন্টকে সাপোর্ট করার জন্য AppScaffold-এর কন্টেন্ট হিসেবে SwipeDismissableNavHost ডিক্লেয়ার করুন। স্ক্রিন লেভেলে SwipeDismissableNavHost এবং ScreenScaffold-এর উপরে AppScaffold অবজেক্ট ব্যবহার করুন যাতে ডিফল্ট হিসেবে স্ক্রিনে 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
        // ...

ডায়ালগ দেখান

Wear OS-এ কম্পোজের জন্য মেটেরিয়াল ৩ ব্যবহার করে ডায়ালগ দেখাতে—যেমন AlertDialog, ConfirmationDialog, OpenOnPhoneDialog, অথবা Dialog—স্ক্রিন কম্পোজেবল ডেস্টিনেশনের মধ্যে সরাসরি ডায়ালগ কম্পোজেবল ঘোষণা করুন যা এটি খোলে। এটি করতে, এইসব ধাপ সম্পূর্ণ করুন:

  1. বুলিয়ান স্টেট ভেরিয়েবল ব্যবহার করে ডায়ালগের দৃশ্যমানতা নিয়ন্ত্রণ করুন এবং সেই স্টেট ডায়ালগের visible প্যারামিটারে পাস করুন। rememberSaveable অথবা ViewModel-এ উত্তোলন করা হয়েছে এমন পতাকা ব্যবহার করুন।
  2. onDismissRequest কলব্যাকে এবং অন্য যেকোনও কনফার্মেশন বা বাতিল করার অ্যাকশন কলব্যাকে, স্টেট ভেরিয়েবল false-এ সেট করুন। এর ফলে, ব্যবহারকারী সোয়াইপ করে ডায়ালগ বক্স বন্ধ করলে বা কোনও অ্যাকশন বেছে নিলে, ডায়ালগ বক্সটি অ্যানিমেট হয়ে বন্ধ হয়ে যায় এবং আগের স্ক্রিনে ফিরে আসে।

আরও তথ্যের জন্য, AlertDialog, ConfirmationDialog, এবং OpenOnPhoneDialog API রেফারেন্স ডকুমেন্টেশন দেখুন।

Jetpack Navigation সম্পর্কে আরও জানতে, Compose-এর মাধ্যমে নেভিগেট করা দেখুন অথবা Jetpack Compose Navigation কোড ল্যাব দেখুন।