Wear OS için Compose ile gezinme


Android Jetpack'teki gezinme bileşeni, Jetpack Compose uygulamalarını destekler. Gezinme bileşeninin altyapısından ve özelliklerinden yararlanarak composable'lar arasında gezinebilirsiniz.

Bu sayfada, Wear OS için Compose'da Jetpack Gezinme ile ilgili farklılıklar açıklanmaktadır.

Kurulum

Uygulama modülünüzün build.gradle dosyasında aşağıdaki bağımlılığı kullanın:

Kotlin

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

Wear OS'e özel alternatif uygulamalar sağladığı için androidx.navigation:navigation-compose yapısı yerine bu kullanılır.

Gezinme denetleyicisi, ana makinesi ve grafiği oluşturma

Wear OS için Compose ile gezinme, Wear OS dışı uygulamalarda gereken üç bileşenin aynısını gerektirir: gezinme denetleyicisi, ana makine ve grafik.

Wear OS uygulamalarına uygun bir NavController uygulaması olan WearNavigator örneği oluşturmak için rememberSwipeDismissableNavController() kullanın:

val navController = rememberSwipeDismissableNavController()

NavController, Compose uygulamalarında gezinmek için kullanılan birincil API'dir. Wear OS'te SwipeDismissableNavHost olan gezinme ana makinesindeki composable'lar arasında gezinmeyi kontrol eder.

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

NavHost composable gibi, gezinme denetleyicisine referans, başlangıç hedefinin rotasını ve burada sondaki lambda olarak gösterilen gezinme grafiğinin oluşturucusunu alır.

Başlangıç hedefi, gezinme denetleyicisiyle gezinilebilecek diğer tüm hedeflerle birlikte gezinme grafiği oluşturucuya sağlanmalıdır.

Wear OS uygulamanızda, zaman, kaydırma veya konum göstergesi ve sayfa göstergesi gibi üst düzey bileşenleri desteklemek için SwipeDismissableNavHost öğesini AppScaffold öğesinin içeriği olarak tanımlayın. Varsayılan olarak ekrana bir TimeText nesnesi eklemek ve ekranlar arasında gezinirken doğru şekilde animasyon oluşturmasını sağlamak için ekran düzeyinde SwipeDismissableNavHost ve ScreenScaffold öğelerinin üzerinde bir AppScaffold nesnesi kullanın. Ayrıca ScreenScaffold, kaydırılabilir içerik için PositionIndicator ekler.
    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
        // ...

İletişim kutularını göster

Wear OS'te Compose için Materyal 3'ü kullanarak bir iletişim kutusu (ör. AlertDialog, ConfirmationDialog, OpenOnPhoneDialog veya Dialog) görüntülemek için iletişim kutusu composable'ını doğrudan onu açan ekran composable hedefinin içinde tanımlayın. Bunun için aşağıdaki adımları uygulayın:

  1. Boole durum değişkeni kullanarak iletişim kutusunun görünürlüğünü kontrol edin ve bu durumu iletişim kutusunun visible parametresine iletin. rememberSaveable veya ViewModel'e yükseltilmiş bir durum kullanın.
  2. onDismissRequest geri çağırmasında ve diğer tüm onay veya kapatma işlemi geri çağırmalarında durum değişkenini false olarak ayarlayın. Bu sayede, kullanıcı kaydırarak kapattığında veya bir işlem seçtiğinde iletişim kutusu animasyonla kapanır ve alttaki ekrana döner.

Daha fazla bilgi için AlertDialog, ConfirmationDialog ve OpenOnPhoneDialog API referans belgelerine bakın.

Jetpack Navigation hakkında daha fazla bilgi edinmek için Compose ile gezinme başlıklı makaleyi inceleyin veya Jetpack Compose Navigation codelab'ini tamamlayın.