Gezinme, kullanıcıların uygulamanızdaki farklı içerik parçaları arasında, içinde ve dışında gezinmesine olanak tanıyan etkileşimleri ifade eder.
Android Jetpack'in Gezinme bileşeni, uygulama gezinme özelliğini uygulamanıza yardımcı olacak Gezinme kitaplığı, Safe Args Gradle eklentisi ve araçları içerir. Gezinme bileşeni, basit düğme tıklamalarından uygulama çubukları ve gezinme çekmecesi gibi daha karmaşık kalıplara kadar çeşitli gezinme kullanım alanlarını yönetir.
Temel kavramlar
Aşağıdaki tabloda, gezinmeyle ilgili temel kavramlar ve bunları uygulamak için kullandığınız ana türler hakkında genel bilgiler verilmiştir.
Konsept |
Amaç |
Tür |
|---|---|---|
Ana makine |
Mevcut navigasyon hedefini içeren bir kullanıcı arayüzü öğesi. Yani kullanıcı bir uygulamada gezinirken uygulama, gezinme ana makinesindeki hedefleri değiştirir. |
|
Grafik |
Uygulamadaki tüm gezinme hedeflerini ve bunların birbirine nasıl bağlandığını tanımlayan bir veri yapısı. |
|
Alan Kontrolcüsü |
Hedefler arasında gezinmeyi yönetmek için merkezi koordinatör. Denetleyici; hedefler arasında gezinme, derin bağlantıları işleme, eski yığını yönetme ve daha fazlası için yöntemler sunar. |
|
Hedef |
Gezinme grafiğindeki bir düğüm. Kullanıcı bu düğüme gittiğinde ana makine, içeriğini gösterir. |
Genellikle gezinme grafiği oluşturulurken oluşturulur. |
Rota |
Bir hedefi ve bu hedefin gerektirdiği tüm verileri benzersiz şekilde tanımlar. Rotaları kullanarak gezinebilirsiniz. Rotalar sizi varış noktalarına götürür. |
Serileştirilebilir herhangi bir veri türü. |
Avantajlar ve özellikler
Gezinme bileşeni, aşağıdakiler de dahil olmak üzere başka avantajlar ve özellikler de sunar:
- Animasyonlar ve geçişler: Animasyonlar ve geçişler için standartlaştırılmış kaynaklar sağlar.
- Derin bağlantı: Kullanıcıyı doğrudan bir hedefe yönlendiren derin bağlantıları uygular ve yönetir.
- Kullanıcı arayüzü kalıpları: Gezinme çekmeceleri ve alt gezinme gibi kalıpları minimum ek çalışmayla destekler.
- Tip güvenliği: Hedefler arasında tip güvenliği ile veri aktarma desteği içerir.
- ViewModel desteği: Grafiğin hedefleri arasında kullanıcı arayüzüyle ilgili verileri paylaşmak için bir
ViewModelöğesini gezinme grafiği kapsamına almanızı sağlar. - Fragment işlemleri: Fragment işlemlerini tam olarak destekler ve işler.
- Geri ve yukarı: Geri ve yukarı işlemlerini varsayılan olarak doğru şekilde gerçekleştirir.
Çerçeve seçenekleri
Gezinme bileşeni, uygulamanızın kullanıcı arayüzü mimarisine bağlı olarak gezinme grafiğinizi uygulamak için iki temel çerçeveyi destekler:
- Compose: Uygulamanız tamamen Jetpack Compose ile oluşturulduysa Navigation Compose'u kullanın. Grafiğinizdeki hedefler, composable'lardır.
- Parçalar: Uygulamanızda görünümler veya görünümler ile Compose'un bir karışımı kullanılıyorsa parça tabanlı gezinme bileşenini kullanın. Grafiğinizdeki hedefler, standart görünümleri, oluşturma içeriğini veya her ikisinin birleşimini barındırabilen parçalardır.
Görünümler'den Compose'a geçiş yapan uygulamalar için önerilen strateji, tek tek ekranları Compose'a dönüştürürken parçaya dayalı gezinme bileşenini kullanmaya devam etmektir. Tüm parçalar composable'larla değiştirildikten sonra gezinme grafiğini Gezinme Oluşturma'ya taşıyabilirsiniz.
Ortamınızı ayarlama
Projenize navigasyon desteği eklemek için uygulamanızın build.gradle dosyasına aşağıdaki bağımlılıkları ekleyin:
Groovy
plugins { // Kotlin serialization plugin for type safe routes and navigation arguments id 'org.jetbrains.kotlin.plugin.serialization' version '2.0.21' } dependencies { def nav_version = "2.10.2" // Jetpack Compose Integration implementation "androidx.navigation:navigation-compose:$nav_version" // Views/Fragments Integration implementation "androidx.navigation:navigation-fragment:$nav_version" implementation "androidx.navigation:navigation-ui:$nav_version" // Feature module support for Fragments implementation "androidx.navigation:navigation-dynamic-features-fragment:$nav_version" // Testing Navigation androidTestImplementation "androidx.navigation:navigation-testing:$nav_version" // JSON serialization library, works with the Kotlin serialization plugin. implementation "org.jetbrains.kotlinx:kotlinx-serialization-json:1.7.3" }
Kotlin
plugins { // Kotlin serialization plugin for type safe routes and navigation arguments kotlin("plugin.serialization") version "2.0.21" } dependencies { val nav_version = "2.10.2" // Jetpack Compose integration implementation("androidx.navigation:navigation-compose:$nav_version") // Views/Fragments integration implementation("androidx.navigation:navigation-fragment:$nav_version") implementation("androidx.navigation:navigation-ui:$nav_version") // Feature module support for Fragments implementation("androidx.navigation:navigation-dynamic-features-fragment:$nav_version") // Testing Navigation androidTestImplementation("androidx.navigation:navigation-testing:$nav_version") // JSON serialization library, works with the Kotlin serialization plugin implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.7.3") }
Projenize başka mimari bileşenler ekleme hakkında bilgi için Projenize bileşen ekleme başlıklı makaleyi inceleyin.
Sonraki adımlar
Gezinme bileşeniyle ilgili daha fazla belge ve kaynak için aşağıdaki kaynaklara göz atın.
Ayrıntılı kılavuzlar
Gezinme ana makinesi ve NavController uygulamanın yanı sıra bunların Compose ve diğer kullanıcı arayüzü çerçeveleriyle nasıl etkileşimde bulunduğu hakkında daha fazla bilgi için aşağıdaki kılavuzları inceleyin:
- Gezinme denetleyicisi oluşturma:
NavControlleroluşturma adımlarını açıklar. - Gezinme grafiğinizi oluşturma: Gezinme ana makinesi ve gezinme grafiğinin nasıl oluşturulacağı açıklanır.
- Hedefe gitme: Grafiğinizdeki hedefler arasında gezinmek için
NavControlleröğesinin nasıl kullanılacağını gösterir.
Codelab uygulamaları
- Jetpack Navigation'ı Öğrenme
- Parçalar ve Gezinme Bileşeni
- Dinamik Gezinme Özelliğine Sahip Uyarlanabilir Bir Uygulama Oluşturma
Videolar
- Navigasyonda gezinme
- Tek etkinliğe geçişle ilgili en iyi 10 uygulama
- Tek etkinlik: Neden, ne zaman ve nasıl (Android Dev Summit '18)
- Android Jetpack: Manage UI navigation with navigation controller (Google I/O '18)