Gezinme

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ı.

NavGraph

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.

NavController

Hedef

Gezinme grafiğindeki bir düğüm. Kullanıcı bu düğüme gittiğinde ana makine, içeriğini gösterir.

NavDestination

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:

Codelab uygulamaları

Videolar

Örnekler