Jetpack Navigation 3 का स्टेबल वर्शन उपलब्ध है

Jetpack Navigation 3 का वर्शन 1.0, स्टेबल वर्शन है 🎉. इसलिए, आज ही से इसे अपने प्रोडक्शन ऐप्लिकेशन में इस्तेमाल करना शुरू करें. JetBrains, इसे अपने KotlinConf ऐप्लिकेशन में पहले से ही इस्तेमाल कर रहा है.

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

नई लाइब्रेरी क्यों?

Jetpack Navigation की ओरिजनल लाइब्रेरी (अब Nav2) को सात साल पहले डिज़ाइन किया गया था. यह अपने मूल लक्ष्यों को अच्छी तरह से पूरा करती है और इसमें समय-समय पर सुधार किए गए हैं. हालांकि, अब ऐप्लिकेशन बनाने का तरीका पूरी तरह से बदल गया है.

अब डिक्लेरेटिव यूज़र इंटरफ़ेस (यूआई) के साथ, रिएक्टिव प्रोग्रामिंग का इस्तेमाल किया जाता है. Nav3 में भी इसी तरीके का इस्तेमाल किया जाता है. उदाहरण के लिए, NavDisplay (Nav3 का यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट, जो आपकी स्क्रीन दिखाता है) Compose की स्थिति के हिसाब से, सिर्फ़ कुंजियों की सूची को देखता है. हर कुंजी, एक स्क्रीन को दिखाती है. साथ ही, सूची में बदलाव होने पर, यह अपने यूज़र इंटरफ़ेस (यूआई) को अपडेट करता है.

Nav2 में, नेविगेशन की स्थिति के लिए, जानकारी का एक सिंगल सोर्स रखना मुश्किल हो सकता है, क्योंकि इसकी अपनी इंटरनल स्थिति होती है. Nav3 में, आपको अपनी स्थिति देनी होती है. इससे आपको पूरा कंट्रोल मिलता है.

आखिर में, आपने ज़्यादा सुविधाओं और पसंद के मुताबिक बदलाव करने की मांग की थी. Nav3 में, एक ही एपीआई के बजाय, छोटे और अलग-अलग एपीआई (या "बिल्डिंग ब्लॉक") उपलब्ध कराए जाते हैं. इन्हें मिलाकर, जटिल फ़ंक्शन बनाए जा सकते हैं. Nav3 खुद भी इन बिल्डिंग ब्लॉक का इस्तेमाल करके, नेविगेशन के अच्छी तरह से तय किए गए इस्तेमाल के उदाहरणों के लिए, डिफ़ॉल्ट सेटिंग उपलब्ध कराता है. 

इस तरीके से, ये काम किए जा सकते हैं: 

• स्क्रीन के ऐनिमेशन को ग्लोबल और अलग-अलग लेवल पर पसंद के मुताबिक बनाना
• एक ही समय में कई पैन दिखाना और Scenes API का इस्तेमाल करके, फ़्लेक्सिबल लेआउट बनाना
• अगर आपको पसंद के मुताबिक व्यवहार चाहिए, तो Nav3 के कॉम्पोनेंट को अपनी पसंद के मुताबिक लागू किए गए कॉम्पोनेंट से आसानी से बदलना

इसके डिज़ाइन और सुविधाओं के बारे में ज़्यादा जानने के लिए, लॉन्च के बारे में लिखा गया ब्लॉग पढ़ें. 

Navigation 2 से माइग्रेट करना

अगर आपने पहले से ही Nav2, खास तौर पर Navigation Compose का इस्तेमाल शुरू कर दिया है, तो आपको Nav3 पर माइग्रेट करना चाहिए. इसमें आपकी मदद करने के लिए, एक माइग्रेशन गाइड उपलब्ध है. इसके मुख्य चरण ये हैं: 

1. नेविगेशन 3 की डिपेंडेंसी जोड़ना.
2. NavKey को लागू करने के लिए, अपने नेविगेशन रूट अपडेट करना. Nav3 का इस्तेमाल करने के लिए, आपके रूट में इस इंटरफ़ेस को लागू करना ज़रूरी नहीं है. हालांकि, अगर ऐसा किया जाता है, तो लगातार पिछली गतिविधियां बनाने के लिए, Nav3 के rememberNavBackStack फ़ंक्शन का फ़ायदा लिया जा सकता है.
3. नेविगेशन की स्थिति को सेव करने और उसमें बदलाव करने के लिए क्लास बनाना. आपके बैक स्टैक यहीं सेव किए जाते हैं.
4. NavController को इन क्लास से बदलना.
5. NavHost के NavGraph से, अपनी मंज़िलों को entryProvider में ले जाना.
6. NavHost को NavDisplay से बदलना.

एआई एजेंट के माइग्रेशन के साथ एक्सपेरिमेंट करना

आपके पास एआई एजेंट का इस्तेमाल करके, माइग्रेशन गाइड पढ़ने और अपने प्रोजेक्ट पर चरण पूरे करने का विकल्प होता है. Android Studio के एजेंट मोड में Gemini के साथ यह आज़माने के लिए:

• गाइड के इस मार्कडाउन वर्शन को अपने प्रोजेक्ट में सेव करें.
• एजेंट को यह प्रॉम्प्ट चिपकाएं, लेकिन एंटर न दबाएं: "इस प्रोजेक्ट को " का इस्तेमाल करके, Navigation 3 पर माइग्रेट करें.
• @migration-guide.md टाइप करें. इससे एजेंट को गाइड, कॉन्टेक्स्ट के तौर पर मिलेगी.

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

हमें यह जानकर खुशी होगी कि आपने या आपके एजेंट ने कैसा काम किया. कृपया अपनी राय यहां भेजें.

आम तौर पर इस्तेमाल होने वाले उदाहरणों के लिए, नेविगेशन की काम की रेसिपी

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

फ़िलहाल, 19 रेसिपी उपलब्ध हैं. इनमें ये शामिल हैं: 

• एक से ज़्यादा बैक स्टैक
• मॉड्यूलर बनाना और डिपेंडेंसी इंजेक्शन
• ViewModels को नेविगेशन के आर्ग्युमेंट पास करना. इसमें Koin का इस्तेमाल करना भी शामिल है
• इवेंट और शेयर की गई स्थिति के हिसाब से, स्क्रीन से नतीजे वापस पाना

फ़िलहाल, हम डीपलिंक की रेसिपी और Koin इंटिग्रेशन पर काम कर रहे हैं. साथ ही, हमारे पास कई अन्य रेसिपी की योजनाएं हैं. JetBrains के एक इंजीनियर ने रेसिपी का Compose Multiplatform वर्शन भी पब्लिश किया है.

अगर आपके पास आम तौर पर इस्तेमाल होने वाला कोई ऐसा उदाहरण है जिसके लिए आपको रेसिपी चाहिए, तो कृपया रेसिपी का अनुरोध सबमिट करें. 

खास जानकारी

Nav3 का इस्तेमाल शुरू करने के लिए, दस्तावेज़ और रेसिपी देखें. इसके अलावा, तकनीकी कॉन्टेंट के पूरे हफ़्ते पर नज़र रखें. इसमें ये शामिल हैं: 

• एपीआई के बारे में जानकारी देने वाला वीडियो. इसमें मॉड्यूलर बनाने, ऐनिमेशन, और अडैप्टिव लेआउट के बारे में बताया गया है.
• Nav3 को बनाने वाले इंजीनियरों के साथ, 'मुझसे कुछ भी पूछें' (एएमए) वाला लाइव सेशन.

Nav3 Spotlight Week, 1 दिसंबर, 2025 से शुरू होगा. 

हमेशा की तरह, अगर आपको कोई समस्या आती है, तो कृपया उन्हें यहां दर्ज करें.