การนำทาง

การนำทางหมายถึงการโต้ตอบที่ช่วยให้ผู้ใช้ไปยังส่วนต่างๆ เข้าไป และออกจากเนื้อหาต่างๆ ภายในแอป

คอมโพเนนต์การนำทางของ Android Jetpack ประกอบด้วยไลบรารีการนำทาง, ปลั๊กอิน Safe Args Gradle และเครื่องมือที่จะช่วยคุณใช้การนำทางในแอป คอมโพเนนต์การนำทางจะจัดการกรณีการใช้งานการนำทางที่หลากหลาย ตั้งแต่การคลิกปุ่มที่ตรงไปตรงมาไปจนถึงรูปแบบที่ซับซ้อนมากขึ้น เช่น แถบแอปและลิ้นชักการนำทาง

แนวคิดสำคัญ

ตารางต่อไปนี้แสดงภาพรวมของแนวคิดหลักในการนำทางและประเภทหลักๆ ที่คุณใช้เพื่อนำไปใช้

แนวคิด

วัตถุประสงค์

ประเภท

เป็นเจ้าภาพ

องค์ประกอบ UI ที่มีปลายทางการนำทางปัจจุบัน กล่าวคือ เมื่อผู้ใช้ไปยังส่วนต่างๆ ของแอป แอปจะสลับปลายทางเข้าและออกจากโฮสต์การนำทาง

กราฟ

โครงสร้างข้อมูลที่กำหนดปลายทางการนำทางทั้งหมดภายในแอปและวิธีเชื่อมต่อเข้าด้วยกัน

NavGraph

ตัวควบคุม

ผู้ประสานงานส่วนกลางสำหรับการจัดการการนำทางระหว่างจุดหมาย ตัวควบคุมมีเมธอดสำหรับการไปยังส่วนต่างๆ ระหว่างปลายทาง การจัดการ Deep Link การจัดการ Back Stack และอื่นๆ

NavController

ปลายทาง

โหนดในกราฟการนำทาง เมื่อผู้ใช้ไปยังโหนดนี้ โฮสต์จะแสดงเนื้อหาของโหนด

NavDestination

โดยปกติแล้วจะสร้างขึ้นเมื่อสร้างกราฟการนำทาง

เส้นทาง

ระบุปลายทางและข้อมูลที่จำเป็นสำหรับปลายทางนั้นๆ แบบไม่ซ้ำกัน

คุณนำทางโดยใช้เส้นทางได้ เส้นทางจะนำคุณไปยังจุดหมาย

ประเภทข้อมูลที่ทำให้เป็นอนุกรมได้

สิทธิประโยชน์และฟีเจอร์

คอมโพเนนต์การนำทางมีประโยชน์และฟีเจอร์อื่นๆ อีกมากมาย ซึ่งรวมถึงสิ่งต่อไปนี้

  • ภาพเคลื่อนไหวและการเปลี่ยนภาพ: มีทรัพยากรมาตรฐานสำหรับภาพเคลื่อนไหวและการเปลี่ยนภาพ
  • การทำ Deep Link: ใช้และจัดการ Deep Link ที่นำผู้ใช้ไปยังปลายทางโดยตรง
  • รูปแบบ UI: รองรับรูปแบบต่างๆ เช่น ลิ้นชักการนำทางและแถบการไปยังส่วนต่างๆ ด้านล่าง โดยใช้การทำงานเพิ่มเติมเพียงเล็กน้อย
  • ความปลอดภัยในการกำหนดประเภท: มีการรองรับการส่งข้อมูลระหว่างปลายทางด้วยความปลอดภัยในการกำหนดประเภท
  • การรองรับ ViewModel: ช่วยให้สามารถกำหนดขอบเขต ViewModel ไปยังกราฟการนำทางเพื่อแชร์ข้อมูลที่เกี่ยวข้องกับ UI ระหว่างปลายทางของกราฟ
  • ธุรกรรม Fragment: รองรับและจัดการธุรกรรม Fragment ได้อย่างเต็มรูปแบบ
  • ย้อนกลับและขึ้น: จัดการการดำเนินการย้อนกลับและขึ้นอย่างถูกต้องโดยค่าเริ่มต้น

ตัวเลือกเฟรมเวิร์ก

คอมโพเนนต์การนําทางรองรับเฟรมเวิร์กหลัก 2 รายการสําหรับการติดตั้งใช้งานกราฟการนําทาง โดยขึ้นอยู่กับสถาปัตยกรรม UI ของแอป ดังนี้

  • Compose: หากแอปสร้างขึ้นด้วย Jetpack Compose ทั้งหมด ให้ใช้ Navigation Compose ปลายทางในกราฟเป็นแบบ Composable
  • Fragment: หากแอปใช้ View หรือทั้ง View และ Compose ให้ใช้คอมโพเนนต์การนำทางที่อิงตาม Fragment ปลายทางในกราฟคือส่วนย่อยที่สามารถโฮสต์มุมมองมาตรฐาน, เนื้อหา Compose หรือทั้ง 2 อย่างรวมกัน

สำหรับแอปพลิเคชันที่ย้ายข้อมูลจาก Views ไปยัง Compose กลยุทธ์ที่แนะนำคือการใช้คอมโพเนนต์การนำทางที่อิงตาม Fragment ต่อไปขณะแปลงหน้าจอแต่ละหน้าเป็น Compose เมื่อแทนที่ Fragment ทั้งหมดด้วย Composable แล้ว คุณจะย้ายข้อมูลกราฟการนําทางไปยัง Navigation Compose ได้

ตั้งค่าสภาพแวดล้อม

หากต้องการรวมการรองรับการนำทางในโปรเจ็กต์ ให้เพิ่มทรัพยากร Dependency ต่อไปนี้ลงในไฟล์ build.gradle ของแอป

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")
}

ดูข้อมูลเกี่ยวกับการเพิ่มคอมโพเนนต์สถาปัตยกรรมอื่นๆ ลงในโปรเจ็กต์ได้ที่เพิ่มคอมโพเนนต์ลงในโปรเจ็กต์

ขั้นตอนถัดไป

ดูเอกสารประกอบและแหล่งข้อมูลเพิ่มเติมที่เกี่ยวข้องกับคอมโพเนนต์การนําทางได้ที่แหล่งข้อมูลต่อไปนี้

คู่มือโดยละเอียด

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีใช้โฮสต์การนำทางและ NavController รวมถึงรายละเอียดเกี่ยวกับวิธีที่โฮสต์การนำทางและ โต้ตอบกับ Compose และเฟรมเวิร์ก UI อื่นๆ ได้ที่ คำแนะนำต่อไปนี้

Codelab

วิดีโอ

ตัวอย่าง