एक से ज़्यादा मॉड्यूल वाले प्रोजेक्ट के लिए नेविगेशन

नेविगेशन ग्राफ़ में, इनमें से किसी भी एलिमेंट का कॉम्बिनेशन हो सकता है:

  • कोई एक डेस्टिनेशन, जैसे कि <fragment> डेस्टिनेशन.
  • एक नेस्टेड ग्राफ़, जिसमें मिलते-जुलते डेस्टिनेशन का सेट शामिल होता है.
  • <include> एलिमेंट, जिसकी मदद से किसी दूसरी नेविगेशन ग्राफ़ फ़ाइल को इस तरह एम्बेड किया जा सकता है जैसे कि वह नेस्ट की गई हो.

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

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

सैंपल मल्टी-मॉड्यूल ऐप्लिकेशन के लिए डिपेंडेंसी ग्राफ़
उदाहरण के तौर पर दिए गए ऐप्लिकेशन का शुरुआती डेस्टिनेशन
पहली इमेज. उदाहरण के तौर पर दिए गए ऐप्लिकेशन के लिए, ऐप्लिकेशन आर्किटेक्चर और स्टार्ट डेस्टिनेशन.

हर फ़ीचर मॉड्यूल, अपने-आप में एक पूरी यूनिट होता है. इसमें अपना नेविगेशन ग्राफ़ और डेस्टिनेशन होते हैं. app मॉड्यूल, हर मॉड्यूल पर निर्भर करता है. इन्हें अपनी build.gradle फ़ाइल में लागू करने की जानकारी के तौर पर जोड़ा जाता है, जैसा कि यहां दिखाया गया है:

Groovy

dependencies {
    ...
    implementation project(":feature:home")
    implementation project(":feature:favorites")
    implementation project(":feature:settings")

Kotlin

dependencies {
    ...
    implementation(project(":feature:home"))
    implementation(project(":feature:favorites"))
    implementation(project(":feature:settings"))

app मॉड्यूल की भूमिका

app मॉड्यूल, आपके ऐप्लिकेशन के लिए पूरा ग्राफ़ उपलब्ध कराने और आपके यूज़र इंटरफ़ेस (यूआई) में NavHost को जोड़ने के लिए ज़िम्मेदार है. app मॉड्यूल के नेविगेशन ग्राफ़ में, <include> का इस्तेमाल करके लाइब्रेरी ग्राफ़ को रेफ़र किया जा सकता है. <include> का इस्तेमाल करना, नेस्ट किए गए ग्राफ़ का इस्तेमाल करने जैसा ही है. हालांकि, <include> अन्य प्रोजेक्ट मॉड्यूल या लाइब्रेरी प्रोजेक्ट के ग्राफ़ के साथ काम करता है. इसे यहां दिए गए उदाहरण में दिखाया गया है:

<?xml version="1.0" encoding="utf-8"?>
<navigation xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/nav_graph"
    app:startDestination="@id/home_nav_graph">

    <include app:graph="@navigation/home_navigation" />
    <include app:graph="@navigation/favorites_navigation" />
    <include app:graph="@navigation/settings_navigation" />
</navigation>

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

<?xml version="1.0" encoding="utf-8"?>
<navigation xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/nav_graph"
    app:startDestination="@id/home_nav_graph">

    <include app:graph="@navigation/home_navigation" />
    <include app:graph="@navigation/favorites_navigation" />
    <include app:graph="@navigation/settings_navigation" />

    <fragment
        android:id="@+id/random_fragment"
        android:name="com.example.android.RandomFragment"
        android:label="@string/fragment_random" >
        <!-- Launch into Settings Navigation Graph -->
        <action
            android:id="@+id/action_random_fragment_to_settings_nav_graph"
            app:destination="@id/settings_nav_graph" />
    </fragment>
</navigation>

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

पिछले उदाहरण में, कार्रवाई से @id/settings_nav_graph के नेविगेशन डेस्टिनेशन के बारे में पता चलता है. यह आईडी, शामिल किए गए ग्राफ़ @navigation/settings_navigation. में तय किए गए डेस्टिनेशन के बारे में बताता है

ऐप्लिकेशन मॉड्यूल में टॉप-लेवल नेविगेशन

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

इमेज 2 में, उदाहरण के तौर पर दिए गए app मॉड्यूल में, इसकी मुख्य गतिविधि में BottomNavigationView को तय किया गया है. मेन्यू में मौजूद मेन्यू आइटम आईडी, लाइब्रेरी ग्राफ़ के नेविगेशन ग्राफ़ आईडी से मैच करते हैं:

<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto">

    <item
        android:id="@id/home_nav_graph"
        android:icon="@drawable/ic_home"
        android:title="Home"
        app:showAsAction="ifRoom"/>

    <item
        android:id="@id/favorites_nav_graph"
        android:icon="@drawable/ic_favorite"
        android:title="Favorites"
        app:showAsAction="ifRoom"/>

    <item
        android:id="@id/settings_nav_graph"
        android:icon="@drawable/ic_settings"
        android:title="Settings"
        app:showAsAction="ifRoom" />
</menu>

NavigationUI को पेज या स्क्रीन के नीचे मौजूद नेविगेशन बार को मैनेज करने की अनुमति देने के लिए, अपनी मुख्य गतिविधि क्लास में onCreate से setupWithNavController को कॉल करें. इसके बारे में यहां दिए गए उदाहरण में बताया गया है:

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)
    val navHostFragment =
        supportFragmentManager.findFragmentById(R.id.nav_host_fragment) as NavHostFragment
    val navController = navHostFragment.navController

    findViewById<BottomNavigationView>(R.id.bottom_nav)
            .setupWithNavController(navController)
}

Java

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    NavHostFragment navHostFragment =
            (NavHostFragment) supportFragmentManager.findFragmentById(R.id.nav_host_fragment);
    NavController navController = navHostFragment.getNavController();
    BottomNavigationView bottomNav = findViewById(R.id.bottom_nav);

    NavigationUI.setupWithNavController(bottomNav, navController);
}

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

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

फ़ीचर मॉड्यूल के बीच नेविगेट करना

कंपाइल के समय, अलग-अलग फ़ीचर मॉड्यूल एक-दूसरे को नहीं देख सकते. इसलिए, अन्य मॉड्यूल में मौजूद डेस्टिनेशन पर जाने के लिए, आईडी का इस्तेमाल नहीं किया जा सकता. इसके बजाय, डीप लिंक का इस्तेमाल करें, ताकि सीधे उस डेस्टिनेशन पर पहुंचा जा सके जो इंप्लिसिट डीप लिंक से जुड़ा है.

पिछले उदाहरण को जारी रखते हुए, मान लें कि आपको :feature:home मॉड्यूल में मौजूद किसी बटन से, :feature:settings मॉड्यूल में नेस्ट किए गए डेस्टिनेशन पर जाना है. इसके लिए, सेटिंग नेविगेशन ग्राफ़ में डेस्टिनेशन का डीप लिंक जोड़ें. यहां इसका तरीका बताया गया है:

<?xml version="1.0" encoding="utf-8"?>
<navigation xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/settings_nav_graph"
    app:startDestination="@id/settings_fragment_one">

    ...

    <fragment
        android:id="@+id/settings_fragment_two"
        android:name="com.example.google.login.SettingsFragmentTwo"
        android:label="@string/settings_fragment_two" >

        <deepLink
            app:uri="android-app://example.google.app/settings_fragment_two" />
    </fragment>
</navigation>

इसके बाद, होम फ़्रैगमेंट में बटन के onClickListener में यह कोड जोड़ें:

Kotlin

button.setOnClickListener {
    val request = NavDeepLinkRequest.Builder
        .fromUri("android-app://example.google.app/settings_fragment_two".toUri())
        .build()
    findNavController().navigate(request)
}

Java

button.setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View view) {
        NavDeepLinkRequest request = NavDeepLinkRequest.Builder
            .fromUri(Uri.parse("android-app://example.google.app/settings_fragment_two"))
            .build();
        NavHostFragment.findNavController(this).navigate(request);
    }
});

ऐक्शन या डेस्टिनेशन आईडी का इस्तेमाल करके नेविगेट करने के बजाय, किसी भी ग्राफ़ में किसी भी यूआरआई पर नेविगेट किया जा सकता है. यहां तक कि मॉड्यूल में भी नेविगेट किया जा सकता है.

यूआरआई का इस्तेमाल करके नेविगेट करने पर, पिछली गतिविधियां रीसेट नहीं होती हैं. यह व्यवहार, एक्सप्लिसिट डीप लिंक नेविगेशन से अलग है. इसमें नेविगेट करते समय, पिछली गतिविधियों को बदल दिया जाता है.