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çinSwipeDismissableNavHost öğ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:
- Boole durum değişkeni kullanarak iletişim kutusunun görünürlüğünü kontrol edin ve bu durumu iletişim kutusunun
visibleparametresine iletin.rememberSaveableveyaViewModel'e yükseltilmiş bir durum kullanın. onDismissRequestgeri çağırmasında ve diğer tüm onay veya kapatma işlemi geri çağırmalarında durum değişkeninifalseolarak 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.
Sizin için önerilenler
- Not: JavaScript devre dışı olduğunda bağlantı metni gösterilir.
- Jetpack Navigation'dan Navigation Compose'a geçiş
- Compose ile gezinme
- Compose ile ekranlar arasında gezinme