नेविगेशन

नेविगेशन का मतलब है, ऐसी इंटरैक्शन जो उपयोगकर्ताओं को आपके ऐप्लिकेशन में मौजूद अलग-अलग कॉन्टेंट पर जाने, उसे ऐक्सेस करने, और उससे बाहर निकलने की सुविधा देती हैं.

Android Jetpack के नेविगेशन कॉम्पोनेंट में नेविगेशन लाइब्रेरी, Safe Args Gradle प्लग-इन, और ऐप्लिकेशन नेविगेशन को लागू करने में मदद करने वाले टूल शामिल हैं. नेविगेशन कॉम्पोनेंट, नेविगेशन के अलग-अलग इस्तेमाल के उदाहरणों को मैनेज करता है. इनमें बटन पर क्लिक करने जैसे आसान मामलों से लेकर, ऐप्लिकेशन बार और नेविगेशन पैनल जैसे ज़्यादा जटिल पैटर्न शामिल हैं.

मुख्य सिद्धांत

यहां दी गई टेबल में, नेविगेशन के मुख्य कॉन्सेप्ट और उन्हें लागू करने के लिए इस्तेमाल किए जाने वाले मुख्य टाइप की खास जानकारी दी गई है.

कॉन्सेप्ट

मकसद

प्रकार

होस्ट

एक यूज़र इंटरफ़ेस (यूआई) एलिमेंट, जिसमें मौजूदा नेविगेशन डेस्टिनेशन शामिल होता है. इसका मतलब है कि जब कोई उपयोगकर्ता किसी ऐप्लिकेशन पर नेविगेट करता है, तो ऐप्लिकेशन, नेविगेशन होस्ट में डेस्टिनेशन को स्वैप करता है.

ग्राफ़

एक ऐसा डेटा स्ट्रक्चर जो ऐप्लिकेशन में मौजूद सभी नेविगेशन डेस्टिनेशन के बारे में बताता है. साथ ही, यह भी बताता है कि वे एक-दूसरे से कैसे कनेक्ट होते हैं.

NavGraph

कंट्रोलर

यह एक डेस्टिनेशन से दूसरे डेस्टिनेशन पर जाने के लिए, नेविगेशन को मैनेज करने वाला मुख्य कोऑर्डिनेटर है. कंट्रोलर में, डेस्टिनेशन के बीच नेविगेट करने, डीप लिंक मैनेज करने, पिछली गतिविधियां मैनेज करने वगैरह के तरीके उपलब्ध होते हैं.

NavController

मंज़िल

नेविगेशन ग्राफ़ में मौजूद एक नोड. जब उपयोगकर्ता इस नोड पर जाता है, तो होस्ट इसका कॉन्टेंट दिखाता है.

NavDestination

आम तौर पर, नेविगेशन ग्राफ़ बनाते समय बनाया जाता है.

देश के हिसाब से डेटा

यह किसी डेस्टिनेशन और उसके लिए ज़रूरी डेटा की यूनीक तरीके से पहचान करता है.

रास्तों का इस्तेमाल करके नेविगेट किया जा सकता है. रास्तों की मदद से, आपको अपनी मंज़िल तक पहुंचने में मदद मिलती है.

सीरियलाइज़ किया जा सकने वाला कोई भी डेटा टाइप.

फ़ायदे और सुविधाएं

नेविगेशन कॉम्पोनेंट से कई अन्य फ़ायदे और सुविधाएं मिलती हैं. इनमें ये शामिल हैं:

  • ऐनिमेशन और ट्रांज़िशन: ऐनिमेशन और ट्रांज़िशन के लिए स्टैंडर्ड रिसॉर्स उपलब्ध कराता है.
  • डीप लिंकिंग: यह डीप लिंक लागू करता है और उन्हें मैनेज करता है. ये लिंक, उपयोगकर्ता को सीधे डेस्टिनेशन पर ले जाते हैं.
  • यूज़र इंटरफ़ेस (यूआई) पैटर्न: इसमें नेविगेशन पैनल और पेज या स्क्रीन के नीचे मौजूद नेविगेशन बार जैसे पैटर्न इस्तेमाल किए जा सकते हैं. इसके लिए, ज़्यादा मेहनत करने की ज़रूरत नहीं पड़ती.
  • टाइप सेफ़्टी: इसमें टाइप सेफ़्टी के साथ, डेस्टिनेशन के बीच डेटा पास करने की सुविधा शामिल है.
  • ViewModel के साथ काम करता है: इससे ViewModel को नेविगेशन ग्राफ़ तक सीमित किया जा सकता है, ताकि ग्राफ़ के डेस्टिनेशन के बीच यूज़र इंटरफ़ेस (यूआई) से जुड़ा डेटा शेयर किया जा सके.
  • फ़्रैगमेंट ट्रांज़ैक्शन: फ़्रैगमेंट ट्रांज़ैक्शन को पूरी तरह से सपोर्ट और मैनेज करता है.
  • बैक और अप: डिफ़ॉल्ट रूप से, बैक और अप ऐक्शन को सही तरीके से हैंडल करता है.

फ़्रेमवर्क के विकल्प

नेविगेशन कॉम्पोनेंट, नेविगेशन ग्राफ़ को लागू करने के लिए दो मुख्य फ़्रेमवर्क के साथ काम करता है. यह आपके ऐप्लिकेशन के यूज़र इंटरफ़ेस (यूआई) आर्किटेक्चर पर निर्भर करता है:

  • Compose: अगर आपका ऐप्लिकेशन पूरी तरह से Jetpack Compose की मदद से बनाया गया है, तो Navigation Compose का इस्तेमाल करें. आपके ग्राफ़ में मौजूद डेस्टिनेशन, कंपोज़ेबल होते हैं.
  • फ़्रैगमेंट: अगर आपका ऐप्लिकेशन, व्यू या व्यू और Compose के कॉम्बिनेशन का इस्तेमाल करता है, तो फ़्रैगमेंट पर आधारित नेविगेशन कॉम्पोनेंट का इस्तेमाल करें. आपके ग्राफ़ में मौजूद डेस्टिनेशन, ऐसे फ़्रैगमेंट होते हैं जो स्टैंडर्ड व्यू, Compose कॉन्टेंट या दोनों को होस्ट कर सकते हैं.

Views से Compose पर माइग्रेट करने वाले ऐप्लिकेशन के लिए, हमारा सुझाव है कि फ़्रैगमेंट पर आधारित नेविगेशन कॉम्पोनेंट का इस्तेमाल जारी रखें. साथ ही, अलग-अलग स्क्रीन को Compose में बदलें. सभी फ़्रैगमेंट को कंपोज़ेबल से बदलने के बाद, नेविगेशन ग्राफ़ को Navigation Compose पर माइग्रेट किया जा सकता है.

अपना एनवायरमेंट सेट अप करना

अपने प्रोजेक्ट में नेविगेशन की सुविधा शामिल करने के लिए, अपने ऐप्लिकेशन की 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 और अन्य यूज़र इंटरफ़ेस (यूआई) फ़्रेमवर्क के साथ कैसे इंटरैक्ट करते हैं:

कोडलैब

वीडियो

सैंपल