एंड्रॉइड एप्लिकेशन में नेविगेशन को लागू करना नेविगेशन आर्किटेक्चर घटक का उपयोग करना

अनुवादक से

नमस्कार, हब्शने। यह एंड्रॉइड डेवलपर्स के लिए नई नेविगेशन तकनीक के लिए प्रलेखन लेख का अनुवाद है। प्रौद्योगिकी वर्तमान में विकास के अधीन है, लेकिन पहले से ही उपयोग के लिए उपलब्ध है और यहां तक ​​कि एंड्रॉइड स्टूडियो 3.2 और उससे अधिक के पूर्वावलोकन संस्करण में काम करता है। मैंने पहले ही कार्रवाई में कोशिश की और मैं कह सकता हूं कि उसने मुझे प्रभावित किया। अंत में, स्क्रीन बदलना कुछ जटिल हो गया है, खासकर अगर एक स्क्रीन से दूसरे स्क्रीन पर डेटा ट्रांसफर का उपयोग किया जाता है। दरअसल, मैं अनुवाद इसलिए कर रहा हूं ताकि अधिक रूसी-भाषी डेवलपर्स प्रौद्योगिकी पर ध्यान दें, और इसके अध्ययन को सरल बना सकें।
यदि आपको महत्वपूर्ण त्रुटियां या गलतियाँ नज़र आती हैं, तो कृपया टिप्पणियों में रिपोर्ट करें।

वास्तु घटक

नेविगेशन आर्किटेक्चर घटक आपके एप्लिकेशन में गंतव्य के बीच नेविगेशन को लागू करना आसान बनाता है। डिफ़ॉल्ट रूप से, नेविगेशन गंतव्य स्क्रीन के रूप में टुकड़े और गतिविधियों का समर्थन करता है, लेकिन आप नए प्रकार के गंतव्य स्क्रीन के लिए समर्थन भी जोड़ सकते हैं। गंतव्य स्क्रीन के सेट को एप्लिकेशन का नेविगेशन ग्राफ कहा जाता है।

नेविगेशन ग्राफ पर गंतव्य स्क्रीन के अलावा, उनके बीच क्रियाएं हैं जिन्हें क्रियाएं कहा जाता है । चित्र 1 पांच क्रियाओं से जुड़े छह गंतव्य स्क्रीन के एक साधारण अनुप्रयोग के लिए नेविगेशन ग्राफ का एक दृश्य प्रतिनिधित्व दिखाता है।

चित्र 1. नेविगेशन ग्राफ

नेविगेशन के आर्किटेक्चरल घटक को नेविगेशन के सिद्धांतों के आधार पर लागू किया जाता है।

यदि आप एंड्रॉइड स्टूडियो में नेविगेशन के वास्तुशिल्प घटक का उपयोग करना चाहते हैं, तो आपको संस्करण एंड्रॉइड स्टूडियो 3.2 कैनरी 14 या उच्चतर की आवश्यकता है।

नेविगेशन समर्थन के साथ एक परियोजना की स्थापना

इससे पहले कि आप एक नेविगेशन ग्राफ़ बना सकें, आपको अपने प्रोजेक्ट के लिए नेविगेशन कॉन्फ़िगर करना होगा। ऐसा करने के लिए, इन चरणों का पालन करें।

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

   
   

   dependencies { def nav_version = "1.0.0-alpha05" // use -ktx for Kotlin implementation "android.arch.navigation:navigation-fragment:$nav_version" // use -ktx for Kotlin implementation "android.arch.navigation:navigation-ui:$nav_version" // optional - Test helpers // use -ktx for Kotlin androidTestImplementation "android.arch.navigation:navigation-testing:$nav_version" } 

   
   
2. प्रोजेक्ट विंडो में, Res फ़ोल्डर पर राइट-क्लिक करें और नया> Android संसाधन फ़ाइल चुनें ।
   नया संसाधन संवाद बॉक्स खुलता है।
3. एक फ़ाइल नाम दर्ज करें, उदाहरण के लिए " nav_graph "।
4. संसाधन प्रकार ड्रॉप-डाउन सूची से नेविगेशन का चयन करें।
5. ओके पर क्लिक करें। निम्नलिखित होगा:
   
   • नेविगेशन उपनिर्देशिका Res निर्देशिका में दिखाई देती है।
   • नेविगेशन निर्देशिका में nav_graph.xml फ़ाइल दिखाई देती है।
   • नेविगेशन संपादक में nav_graph.xml फ़ाइल खुलती है। इस फ़ाइल में आपका नेविगेशन ग्राफ़ है।
6. संपादन मोड पाठ का चयन करें। खाली नेविगेशन ग्राफ के लिए XML फ़ाइल इस तरह दिखाई देती है:
   

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

7. नेविगेशन एडिटर पर लौटने के लिए डिज़ाइन एडिट मोड का चयन करें।
   लगभग। अनुवादक: यदि नेविगेशन संपादक एक ग्राफ प्रदर्शित नहीं करता है, तो पीले रंग में हाइलाइट किए गए अगले पैराग्राफ की शुरुआत की जांच करें।

नेविगेशन संपादक का अवलोकन

नेविगेशन एडिटर डिफ़ॉल्ट रूप से केवल एंड्रॉइड स्टूडियो के कैनरी बिल्ड में उपलब्ध है। बीटा में नेविगेशन एडिटर का उपयोग करने के लिए, कैंडिडेट या स्टेबल बिल्ड रिलीज़ करें, फ़ाइल> सेटिंग्स (मैक के लिए एंड्रॉइड स्टूडियो> प्राथमिकताएं ) पर जाएं, प्रायोगिक श्रेणी का चयन करें, नेविगेशन एडिटर चेकबॉक्स को सक्षम करें , और एंड्रॉइड स्टूडियो को पुनरारंभ करें।
लगभग। अनुवादक: मैं यह जांचने के लिए विधानसभा की परवाह किए बिना कि क्या यह चेकबॉक्स इसके लायक है, की सिफारिश करता है।

नेविगेशन एडिटर में, आप XML लिखने के बजाय जल्दी से नेविगेशन ग्राफ़ बना सकते हैं। जैसा कि चित्र 2 में दिखाया गया है, नेविगेशन संपादक के तीन खंड हैं:

चित्रा 2. नेविगेशन संपादक

अनुभागों का विवरण:

1. गंतव्य स्क्रीन की सूची - ग्राफ़ में जोड़े गए सभी गंतव्य स्क्रीन प्रदर्शित करता है
2. ग्राफ संपादक - आपके ग्राफ का एक दृश्य प्रतिनिधित्व होता है
3. एट्रिब्यूट एडिटर - डेस्टिनेशन स्क्रीन की विशेषताओं और कार्यों को शामिल करता है।

गंतव्य स्क्रीन को परिभाषित करना

नेविगेशन ग्राफ बनाने में पहला कदम अपने आवेदन के लिए गंतव्य स्क्रीन को परिभाषित करना है। आप एक रिक्त असाइनमेंट स्क्रीन बना सकते हैं या वर्तमान प्रोजेक्ट से टुकड़े और गतिविधियों का उपयोग कर सकते हैं।

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

अपने आवेदन के लिए गंतव्य स्क्रीन निर्धारित करने के लिए, इन चरणों का पालन करें।

1. ग्राफ़ संपादक में, नया गंतव्य क्लिक करें । नया गंतव्य संवाद बॉक्स खुलता है।
2. रिक्त स्थान बनाएँ पर क्लिक करें या किसी मौजूदा टुकड़े या गतिविधि का चयन करें। Android घटक संवाद बॉक्स खुलता है।
3. Fragment Name फ़ील्ड में एक नाम दर्ज करें। यह इस टुकड़े के वर्ग नाम से मेल खाना चाहिए।
4. Fragment Layout नाम क्षेत्र में एक नाम दर्ज करें। यह नाम लेआउट टुकड़ा फ़ाइल को सौंपा जाएगा।
5. समाप्त पर क्लिक करें । नई गंतव्य स्क्रीन के नाम के साथ गंतव्य स्क्रीन की सूची में एक रेखा दिखाई देती है, और गंतव्य स्क्रीन स्वयं ग्राफ़ संपादक में दिखाई देती है। अधिक विस्तार से:
   
   • ग्राफ़ संपादक गंतव्य स्क्रीन का पूर्वावलोकन प्रदर्शित करता है। यदि आपने एक रिक्त गंतव्य स्क्रीन बनाई है, तो नए टुकड़े में शिलालेख "हैलो रिक्त टुकड़ा" होगा, और आपको ग्राफ़ संपादक में एक ही शिलालेख दिखाई देगा। यदि आप किसी मौजूदा टुकड़े या गतिविधि का चयन करते हैं, तो ग्राफ़ उसका लघु संस्करण प्रदर्शित करेगा।
   • यदि आपने रिक्त गंतव्य स्क्रीन बनाई है, तो इसके लिए एक वर्ग तैयार किया जाएगा। वर्ग नाम चरण 3 में निर्दिष्ट नाम से मेल खाएगा।
   • यदि आपने एक रिक्त गंतव्य स्क्रीन बनाई है, तो उसके लिए एक लेआउट फ़ाइल उत्पन्न की जाएगी। फ़ाइल नाम चरण 4 में निर्दिष्ट नाम से मेल खाएगा।
     चित्र 3 एक रिक्त और मौजूदा गंतव्य स्क्रीन दिखाता है।
     
     चित्रा 3. नई और मौजूदा गंतव्य स्क्रीन।
6. इसे चुनने के लिए नव निर्मित गंतव्य स्क्रीन पर क्लिक करें। विशेषता पैनल में निम्नलिखित विशेषताएं हैं:
   
   • टाइप फ़ील्ड को "फ़्रैगमेंट" या "गतिविधि" पर सेट किया जा सकता है ताकि यह पता चले कि गंतव्य स्क्रीन को स्रोत कोड में कैसे लागू किया गया है: एक खंड के रूप में या एक गतिविधि के रूप में।
   • लेबल फ़ील्ड में गंतव्य स्क्रीन फ़ाइल का XML नाम होता है।
   • आईडी फ़ील्ड में गंतव्य स्क्रीन की आईडी होती है (एक स्वतंत्र इकाई के रूप में - अनुवादक का नोट ), जिसका उपयोग इसे स्रोत कोड (R.id - अनुवादक के नोट के माध्यम से) में संदर्भित करने के लिए किया जाता है।
   • क्लास फ़ील्ड में गंतव्य स्क्रीन का वर्ग नाम होता है (सभी पैकेजों के संकेत के साथ - नोट अनुवादक )।
7. एक्सएमएल देखने के लिए स्विच करने के लिए टेक्स्ट एडिटिंग मोड पर जाएं। XML में अब विशेषताएँ आईडी, नाम (वर्ग नाम), लेबल और लेआउट शामिल हैं, जो मौजूदा कक्षाओं और लेआउट फ़ाइलों के नाम प्रदर्शित करते हैं:

 <?xml version="1.0" encoding="utf-8"?> <navigation xmlns:app="http://schemas.android.com/apk/res-auto" xmlns:tools="http://schemas.android.com/tools" xmlns:android="http://schemas.android.com/apk/res/android" app:startDestination="@id/blankFragment"> <fragment android:id="@+id/blankFragment" android:name="com.example.cashdog.cashdog.BlankFragment" android:label="Blank" tools:layout="@layout/fragment_blank" /> </navigation> 

XML में प्रारंभ गंतव्य विशेषता है जिसमें खाली गंतव्य स्क्रीन ( ऐप: startDestination = "@ + id / टुकड़ा" ) की आईडी है । गंतव्य प्रारंभ स्क्रीन के बारे में अधिक जानकारी के लिए, गंतव्य प्रारंभ स्क्रीन अनुभाग देखें।

गंतव्य स्क्रीन कनेक्ट करना

उन्हें जोड़ने के लिए आपके एप्लिकेशन में एक से अधिक गंतव्य स्क्रीन होनी चाहिए। निम्नलिखित दो खाली गंतव्य स्क्रीन के साथ नेविगेशन ग्राफ के लिए XML का वर्णन करता है:

 <?xml version="1.0" encoding="utf-8"?> <navigation xmlns:app="http://schemas.android.com/apk/res-auto" xmlns:tools="http://schemas.android.com/tools" xmlns:android="http://schemas.android.com/apk/res/android" app:startDestination="@id/blankFragment"> <fragment android:id="@+id/blankFragment" android:name="com.example.cashdog.cashdog.BlankFragment" android:label="fragment_blank" tools:layout="@layout/fragment_blank" /> <fragment android:id="@+id/blankFragment2" android:name="com.example.cashdog.cashdog.BlankFragment2" android:label="Blank2" tools:layout="@layout/fragment_blank_fragment2" /> </navigation> 

गंतव्य स्क्रीन कार्रवाई का उपयोग करके जुड़े हुए हैं। दो गंतव्य स्क्रीन कनेक्ट करने के लिए आपको चाहिए:

1. ग्राफ एडिटर में, गंतव्य स्क्रीन पर होवर करें जिससे आप संक्रमण करना चाहते हैं। इस पर एक सर्कल दिखाई देगा।
   
   चित्रा 4. एक्शन कनेक्शन सर्कल
2. सर्कल पर क्लिक करें और माउस बटन दबाए रखें। कर्सर को उस गंतव्य स्क्रीन पर ले जाएँ, जहाँ आप संक्रमण करना चाहते हैं। जाने दो। दो गंतव्य स्क्रीन के बीच एक तीर दिखाई देता है, जो उनके बीच संक्रमण का संकेत देता है।
   
   चित्रा 5. कनेक्टेड गंतव्य स्क्रीन
3. कार्रवाई को उजागर करने के लिए तीर पर क्लिक करें। निम्नलिखित विशेषता पैनल में दिखाई देता है:
   
   • टाइप फ़ील्ड में "एक्शन" होता है।
   • आईडी फ़ील्ड में स्वचालित रूप से उत्पन्न कार्रवाई आईडी होती है।
   • गंतव्य फ़ील्ड में गंतव्य स्क्रीन की ID होती है जिससे संक्रमण किया जाता है।
4. XML को देखने के लिए टेक्स्ट एडिटिंग मोड पर जाएँ। पैरेंट डेस्टिनेशन स्क्रीन पर एक एक्शन टैग जोड़ा गया है। कार्रवाई में एक उत्पन्न आईडी और एक विशेषता है जिसमें अगले गंतव्य स्क्रीन की आईडी शामिल है।

 <?xml version="1.0" encoding="utf-8"?> <navigation xmlns:app="http://schemas.android.com/apk/res-auto" xmlns:tools="http://schemas.android.com/tools" xmlns:android="http://schemas.android.com/apk/res/android" app:startDestination="@id/blankFragment"> <fragment android:id="@+id/blankFragment" android:name="com.example.cashdog.cashdog.BlankFragment" android:label="fragment_blank" tools:layout="@layout/fragment_blank" > <action android:id="@+id/action_blankFragment_to_blankFragment2" app:destination="@id/blankFragment2" /> </fragment> <fragment android:id="@+id/blankFragment2" android:name="com.example.cashdog.cashdog.BlankFragment2" android:label="fragment_blank_fragment2" tools:layout="@layout/fragment_blank_fragment2" /> </navigation> 

प्रारंभ स्क्रीन के रूप में गंतव्य स्क्रीन का पदनाम

ग्राफ संपादक घर के आइकन को प्रदर्शित करता है पहली मंजिल स्क्रीन के नाम के तुरंत बाद। यह आइकन इंगित करता है कि गंतव्य स्क्रीन नेविगेशन ग्राफ़ में प्रारंभ स्क्रीन है। आप इन चरणों का पालन करके एक अलग गंतव्य स्क्रीन को स्टार्ट स्क्रीन के रूप में चुन सकते हैं:

• ग्राफ़ संपादक में वांछित गंतव्य स्क्रीन हाइलाइट करें।
• विशेषता पट्टी पर सेट प्रारंभ गंतव्य पर क्लिक करें । अब यह डेस्टिनेशन स्क्रीन स्टार्ट स्क्रीन है। लगभग। अनुवादक: आप वांछित गंतव्य स्क्रीन पर आरएमबी पर क्लिक कर सकते हैं और खुलने वाले मेनू में एक समान आइटम का चयन कर सकते हैं।

नेविगेशन ग्राफ के लिए होस्ट में गतिविधि चालू करें

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

नेविगेशन में NavHost डिफ़ॉल्ट रूप से लागू होता है NavHostFragment ।

NavHost को जोड़ने के बाद, आपको ऐप का उपयोग करके इसे अपने नेविगेशन ग्राफ़ पर मैप करना होगा : navGraph विशेषता । यह कोड दर्शाता है कि लेआउट में NavHostFragment कैसे शामिल करें और इसे नेविगेशन ग्राफ़ से कनेक्ट करें:

 ?xml version="1.0" encoding="utf-8"?> <android.support.constraint.ConstraintLayout 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:layout_width="match_parent" android:layout_height="match_parent" tools:context=".MainActivity"> <fragment android:layout_width="match_parent" android:layout_height="match_parent" android:id="@+id/my_nav_host_fragment" android:name="androidx.navigation.fragment.NavHostFragment" app:navGraph="@navigation/nav_graph" app:defaultNavHost="true" /> </android.support.constraint.ConstraintLayout> 

इस उदाहरण में ऐप विशेषता है : defaultNavHost = "true" । वह सिस्टम बटन बैक को इंटरसेप्ट करने के लिए जिम्मेदार है ( नोट ट्रांसलेटर: सिस्टम बटन बैक और एप्लिकेशन के शीर्ष पैनल पर अप एरो उसी तरह काम करेगा )। आप AppCompatActivity.onSupportNavigateUp () को भी ओवरराइड कर सकते हैं और NavController.navigateUp () को कॉल कर सकते हैं: जैसा कि यहाँ दिखाया गया है:

 @Override public boolean onSupportNavigateUp() { return Navigation.findNavController(this, R.id.nav_host_fragment).navigateUp(); } 

 override fun onSupportNavigateUp() = findNavController(R.id.nav_host_fragment).navigateUp() 

विगेट्स को बांधने की क्रिया

NavController का उपयोग करके गंतव्य स्क्रीन पर जाएं । यह अतिभारित स्थैतिक findNavController () विधि का उपयोग करके प्राप्त किया जा सकता है:

• NavHostFragment.findNavController (टुकड़ा)
• नैविगेशन .findNavController (गतिविधि, @IdRes int viewId)
• नेवीगेशन.व्यूएनकंट्रोलर (देखें)

NavController प्राप्त करने के बाद, गंतव्य स्क्रीन पर जाने के लिए इसके नेविगेट () विधि का उपयोग करें । नेविगेट () विधि एक संसाधन आईडी को स्वीकार करती है। यह गंतव्य स्क्रीन की आईडी हो सकती है, जिस पर आप जाना चाहते हैं, या यह एक्शन आईडी हो सकती है। गंतव्य स्क्रीन आईडी के बजाय एक्शन आईडी का उपयोग करने से आप स्क्रीन के बीच संक्रमण एनीमेशन को अनुकूलित कर सकते हैं। अधिक जानकारी के लिए, गंतव्य स्क्रीन के बीच एनीमेशन बदलाव बनाना देखें।

यह कोड दर्शाता है कि बटन पर किसी क्रिया को कैसे बांधें:

 viewTransactionsButton.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View view) { Navigation.findNavController(view).navigate(R.id.viewTransactionsAction); } }); 

 viewTransactionsButton.setOnClickListener { view -> view.findNavController().navigate(R.id.viewTransactionsAction) } 

एंड्रॉइड एक बैक स्टैक का समर्थन करता है जो अंतिम ओपन डेस्टिनेशन स्क्रीन को स्टोर करता है। जब उपयोगकर्ता एप्लिकेशन लॉन्च करता है, तो पहले गंतव्य स्क्रीन को स्टैक पर धकेल दिया जाता है। नेविगेट करने के लिए प्रत्येक कॉल () विधि स्टैक पर एक नई गंतव्य स्क्रीन को धक्का देती है। बैक या अप बटन को दबाने पर गंतव्य स्क्रीन को स्टैक से निकालने के लिए NavController.navigateUp () और NavController.popBackStack () विधियों को कॉल करता है।

बटनों के लिए, आप सुविधाजनक Navigation.createNavigateOnClickListener () विधि का उपयोग कर सकते हैं:

 button.setOnClickListener(Navigation.createNavigateOnClickListener(R.id.next_fragment, null)); 

 button.setOnClickListener(Navigation.createNavigateOnClickListener(R.id.next_fragment, null)) 

नेविगेशन ड्रॉअर मेनू में बाइंडिंग क्रियाएँ

आप मेनू आइटम (आइटम) की आईडी के रूप में गंतव्य स्क्रीन की आईडी का उपयोग करके नेविगेशन ड्रॉअर के साथ नेविगेशन क्रियाओं को जोड़ सकते हैं। निम्न कोड एक गंतव्य स्क्रीन का एक उदाहरण दिखाता है जिसकी आईडी विवरण_पृष्ठ_फ्रैगमेंट पर सेट है:

 <fragment android:id="@+id/details_page_fragment" android:label="@string/details" android:name="com.example.android.myapp.DetailsFragment" /> 

गंतव्य स्क्रीन और मेनू आइटम के लिए एक ही आईडी का उपयोग करते हुए, मेनू आइटम और गंतव्य स्क्रीन स्वचालित रूप से जुड़े हुए हैं। यह कोड दर्शाता है कि गंतव्य स्क्रीन को मेनू आइटम से कैसे जोड़ा जाए (उदाहरण के लिए, यह menu_nav_drawer.xml फ़ाइल है):

 <item android:id="@id/details_page_fragment" android:icon="@drawable/ic_details" android:title="@string/details" /> 

या यहाँ श्रेणियों के साथ मेनू के लिए एक उदाहरण है (उदा। Menu_overflow.xml ):

 <item android:id="@id/details_page_fragment" android:icon="@drawable/ic_details" android:title="@string/details" android:menuCategory:"secondary" /> 

इसके अलावा, नेविगेशन आर्किटेक्चर घटक में नेविगेशनयूआई वर्ग शामिल है। इस वर्ग में कई स्थिर विधियां हैं जिनका उपयोग आप मेनू स्क्रीन के साथ मेनू आइटम को जोड़ने के लिए कर सकते हैं। उदाहरण के लिए, यह कोड दिखाता है कि किसी नेविगेशन आइटम के मेनू आइटम को कनेक्ट करने के लिए setupWithNavController () विधि का उपयोग कैसे करें:

 NavigationView navigationView = (NavigationView) findViewById(R.id.nav_view); NavigationUI.setupWithNavController(navigationView, navController); 

 val navigationView = findViewById<NavigationView>(R.id.nav_view) navigationView.setupWithNavController(navController) 

आपको नेविगेशनयूआई विधियों का उपयोग करके मेनू के नेविगेशन घटकों को कॉन्फ़िगर करने की आवश्यकता है ताकि उनकी स्थिति नवकंट्रोलर में परिवर्तन के साथ सिंक्रनाइज़ रहे।

गंतव्य स्क्रीन के बीच डेटा स्थानांतरित करना

आप डेस्टिनेशन स्क्रीन के बीच डेटा को दो तरह से ट्रांसफर कर सकते हैं: बंडल ऑब्जेक्ट्स या सेफगार्ड ग्रैडल प्लगइन का उपयोग करके सुरक्षित तरीके। बंडल ऑब्जेक्ट्स का उपयोग करके डेटा ट्रांसफर करने के लिए इन चरणों का पालन करें। यदि आप ग्रैडल का उपयोग कर रहे हैं, तो एक प्रकार-सुरक्षित तरीके से गंतव्य स्क्रीन के बीच डेटा स्थानांतरित करना अनुभाग देखें।

1. ग्राफ़ संपादक में, गंतव्य स्क्रीन का चयन करें जिसे डेटा प्राप्त करना चाहिए।
2. विशेषता पैनल के तर्क खंड में जोड़ें ( + ) पर क्लिक करें। रिक्त फ़ील्ड नाम (नाम), प्रकार (प्रकार) और डिफ़ॉल्ट मान (डिफ़ॉल्ट मान) के साथ एक तर्क दिखाई देगा।
3. एक तर्क नाम दर्ज करें।
4. एक डिफ़ॉल्ट मान दर्ज करें।
5. गंतव्य स्क्रीन की ओर इशारा करते हुए क्रिया (तीर) को हाइलाइट करें। तर्क डिफ़ॉल्ट मान अनुभाग में अभी बनाया तर्क होना चाहिए।
6. XML को देखने के लिए टेक्स्ट एडिटिंग मोड पर जाएँ। गंतव्य स्क्रीन में एक तर्क टैग जोड़ा गया है, जिसमें नाम और डिफ़ॉल्ट गुण हैं।
7. स्रोत कोड में, एक बंडल बनाएं और उसे नेविगेट करें () विधि का उपयोग करके गंतव्य स्क्रीन पर पास करें :

 Bundle bundle = new Bundle(); bundle.putString("amount", amount); Navigation.findNavController(view).navigate(R.id.confirmationAction, bundle); 

 var bundle = bundleOf("amount" to amount) view.findNavController().navigate(R.id.confirmationAction, bundle) 

गंतव्य स्क्रीन जिसमें डेटा स्थानांतरित किया जाता है, बंडल प्राप्त करने के लिए getArguments () विधि का उपयोग करें और इसकी सामग्री का उपयोग करें:

 TextView tv = view.findViewById(R.id.textViewAmount); tv.setText(getArguments().getString("amount")); 

 val tv = view.findViewById(R.id.textViewAmount) tv.text = arguments.getString("amount") 

एक सुरक्षित तरीके से गंतव्य स्क्रीन के बीच डेटा स्थानांतरित करना

नेविगेशन आर्किटेक्चरल घटक में एक ग्रेडल प्लगइन है जिसे सेफगर्स कहा जाता है। यह डेस्टिनेशन और एक्शन स्क्रीन के तर्कों के लिए टाइप-सेफ एक्सेस के लिए सबसे सरल कक्षाएं बनाता है। सेफगर्ग का दृष्टिकोण बंडल के उपयोग पर आधारित है, लेकिन अधिक नमूना सुरक्षा के लिए थोड़ा अतिरिक्त कोड की आवश्यकता होती है। इस प्लगइन को जोड़ने के लिए, build.gradle (मॉड्यूल में: एप्लिकेशन - अनुवादक टिप्पणी) में androidx.navigation.safeargs लाइन डालें । उदाहरण के लिए, इस तरह:

 apply plugin: 'com.android.application' apply plugin: 'androidx.navigation.safeargs' android { //... } 

लगभग। अनुवादक: इसके अलावा, निर्भरता classpath "android.arch.navigation: नेविगेशन-सुरक्षित-आर्ग-ग्रेड-प्लगइन: 1.0.0-Alpha02" को build.gradle (प्रोजेक्ट: प्रोजेक्टनेम) में जोड़ें:

 buildscript { repositories { google() } dependencies { classpath "android.arch.navigation:navigation-safe-args-gradle-plugin:1.0.0-alpha02" } } 

प्लगइन स्थापित करने के बाद, टाइप-सेफ डेटा ट्रांसफर का उपयोग करने के लिए इन चरणों का पालन करें:

1. ग्राफ एडिटर में, गंतव्य स्क्रीन को हाइलाइट करें जिसमें आप डेटा ट्रांसफर करना चाहते हैं।
2. विशेषता पैनल के तर्क अनुभाग में + पर क्लिक करें। खाली फ़ील्ड के साथ एक विशेषता दिखाई देती है।
3. एक तर्क नाम दर्ज करें।
4. एक तर्क प्रकार चुनें।
5. एक डिफ़ॉल्ट मान दर्ज करें।
6. गंतव्य स्क्रीन से पहले की क्रिया को हाइलाइट करें। तर्क डिफ़ॉल्ट मान अनुभाग में अभी बनाया तर्क होना चाहिए।
7. XML संपादन मोड में प्रवेश करने के लिए पाठ पर क्लिक करें।

 <fragment android:id="@+id/confirmationFragment" android:name="com.example.buybuddy.buybuddy.ConfirmationFragment" android:label="fragment_confirmation" tools:layout="@layout/fragment_confirmation"> <argument android:name="amount" android:defaultValue="1" app:type="integer"/> </fragment> 

सेफगार्स प्लग-इन उत्पन्न होने के बाद कोड ( जो कि टाइप - ट्रांसलेटर नोट के साथ एक तर्क बनाने के बाद ), स्क्रीन भेजने और स्क्रीन प्राप्त करने के लिए कक्षाएं भी उत्पन्न हुईं।
लगभग। अनुवादक: एक तर्क बनाने के बाद, मुझे ग्रैडल फाइल बटन के साथ सिंक प्रोजेक्ट पर क्लिक करना होगा ताकि कक्षाएं उत्पन्न हो सकें।

• प्रेषक स्क्रीन वर्ग का मूल नाम वही है, जिसके साथ शब्द अंत में जोड़े गए हैं।
  यही है, यदि आपके पास FirstFragment गंतव्य स्क्रीन है, तो उत्पन्न वर्ग FirstFragmentDirections कहलाता है। इस वर्ग में एक विधि है (!) जिसका नाम तर्क से गुजरने वाली कार्रवाई की आईडी से मेल खाता है। यही है, यदि आपका FirstFragment स्क्रीन SecondFragment स्क्रीन पर एक तर्क देती है, और यदि उन्हें जोड़ने वाली क्रिया को कार्रवाई_first_to_second कहा जाता है, तो यह वांछित FirstFragmentDirections.action_f_s_second () विधि है।

  
  

• प्रेषक वर्ग में एक उपवर्ग भी शामिल है, जो ऊपर चर्चा की गई विधि का रिटर्न प्रकार है। यही है, हमारे मामले में, एक्शन_फर्स्ट_टो_सोकोंड () पद्धति का रिटर्न प्रकार एक्शन_फर्स्ट_टो_सेंडक होगा।

  
  

• प्राप्तकर्ता वर्ग का मूल नाम वही है, जिसके अंत में शब्द Args जोड़ा गया है। हमारे उदाहरण के लिए, SecondFragment मेजबान है, इसलिए SecondFragmentArgs वर्ग इसके लिए उत्पन्न होता है। इस वर्ग में तर्क प्राप्त करने के लिए एक FromBundle () विधि है।

  
  

लगभग। अनुवादक: अब सब कुछ स्पष्ट हो जाएगा। मैंने मूल कोड की तुलना में इस कोड को थोड़ा संशोधित किया। परिवर्तन केवल उन नामों की चिंता करते हैं, जो प्रत्येक के लिए अलग-अलग हो सकते हैं। यह समझने में आसानी के लिए है। यहाँ, myArgument नाम का उपयोग तर्क नाम के रूप में किया जाता है, और इसका प्रकार स्ट्रिंग है।

यह कोड दर्शाता है कि नेविगेट के माध्यम से तर्कों को पारित करने के लिए सेफग्रास का उपयोग कैसे किया जाता है:

 @Override public void onClick(View view) { FirstFragmentDirections.Action_first_to_second action = FirstFragmentDirections.action_first_to_second(); action.setMyArgument("My argument value"); Navigation.findNavController(view).navigate(action); } 

 override fun onClick(v: View?) { val action = FirstFragmentDirections.action_first_to_second action.myArgument = "My argument value" v.findNavController().navigate(action) } 

यह कोड दर्शाता है कि सेफगर्ल्स का उपयोग करके तर्क कैसे निकाले जाएं:

 @Override public void onViewCreated(View view, @Nullable Bundle savedInstanceState) { String myArgument = SecondFragmentArgs.fromBundle(getArguments()).getMyArgument(); } 

 override fun onViewCreated(view: View, savedInstanceState: Bundle?) { val myArgument = SecondFragmentArgs.fromBundle(arguments).myArgument } 

लगभग। अनुवादक: मुझे व्यक्तिगत रूप से तर्कों को पारित करने का यह तरीका पसंद आया। कोई और अधिक निजी स्थिर अंतिम स्ट्रिंग MY_ARGUMENT_KEY = "MY_ARGUMENT" नहीं। यह बहुत सुविधाजनक है कि अब तर्क को सेट और पुनः प्राप्त करने के लिए, इसके व्यक्ति (!) का उपयोग करें।

गंतव्य स्क्रीन को नेस्टेड ग्राफ़ में समूहित करना

गंतव्य स्क्रीन के दृश्यों को एक सबग्राफ में समूहीकृत किया जा सकता है। सबग्राफ को "नेस्टेड ग्राफ" (नेस्टेड ग्राफ) कहा जाता है, और मूल ग्राफ "रूट ग्राफ" (रूट ग्राफ) है । नेस्टेड ग्राफ़ आपके एप्लिकेशन के उपयोगकर्ता इंटरफ़ेस के कुछ हिस्सों के पुन: उपयोग को व्यवस्थित करने के लिए उपयोगी होते हैं, जैसे कि प्राधिकरण की एक शाखा (स्क्रीन का अनुक्रम)।

साथ ही रूट, नेस्टेड ग्राफ़ में एक स्टार्ट स्क्रीन होनी चाहिए। एक नेस्टेड ग्राफ़ अपने गंतव्य स्क्रीन को एनकैप्सुलेट करता है। नेस्टेड ग्राफ़ के बाहर स्क्रीन, जैसे रूट ग्राफ़ की स्क्रीन, नेस्टेड ग्राफ़ की केवल शुरुआत स्क्रीन तक पहुँच है। चित्र 6 एक सरल मनी ट्रांसफर एप्लिकेशन के नेविगेशन ग्राफ को दर्शाता है। ग्राफ़ की दो शाखाएँ हैं: पैसे ट्रांसफर करने के लिए, और शेष राशि देखने के लिए।

चित्र 6. मनी ट्रांसफर एप्लिकेशन का नेविगेशन ग्राफ

गंतव्य स्क्रीन को नेस्टेड ग्राफ़ में समूहित करना:

1. ग्राफ़ एडिटर में, प्रेस और होल्ड शिफ्ट , और उन स्क्रीन पर क्लिक करें जिन्हें आप नेस्टेड ग्राफ़ में शामिल करना चाहते हैं। प्रत्येक स्क्रीन को हाइलाइट किया जाना चाहिए।
2. उनमें से किसी एक पर राइट-क्लिक करें, और संदर्भ मेनू से नेस्टेड ग्राफ़> न्यू ग्राफ़ पर ले जाएँ का चयन करें। चयनित स्क्रीन नेस्टेड ग्राफ़ में बदल जाती हैं। चित्र 7 ग्राफ़ संपादक में नेस्टेड ग्राफ़ दिखाता है।
   
   चित्र 7. ग्राफ संपादक में नेस्टेड ग्राफ
3. इसे चुनने के लिए नेस्टेड ग्राफ़ पर क्लिक करें। निम्नलिखित विशेषताएं विशेषता पैनल में दिखाई देनी चाहिए:
   
   • प्रकार फ़ील्ड में "नेस्टेड ग्राफ़" होता है।
   • ID फ़ील्ड में नेस्टेड ग्राफ़ के लिए जनरेट की गई ID होती है।
4. नेस्टेड ग्राफ़ पर डबल-क्लिक करें। नेस्टेड ग्राफ़ की स्क्रीन दिखाई देगी।
5. स्क्रीन (बाएं) की सूची में, रूट ग्राफ़ पर लौटने के लिए रूट पर क्लिक करें।
6. Text XML. . navigation . ID sendMoneyGraph startDestination chooseRecipient :
   

    <?xml version="1.0" encoding="utf-8"?> <navigation xmlns:app="http://schemas.android.com/apk/res-auto" xmlns:tools="http://schemas.android.com/tools" xmlns:android="http://schemas.android.com/apk/res/android" app:startDestination="@id/mainFragment"> <fragment android:id="@+id/mainFragment" android:name="com.example.cashdog.cashdog.MainFragment" android:label="fragment_main" tools:layout="@layout/fragment_main" > <action android:id="@+id/action_mainFragment_to_ sendMoneyGraph" app:destination="@id/sendMoneyGraph" /> <action android:id="@+id/action_mainFragment_to_viewBalanceFragment" app:destination="@id/viewBalanceFragment" /> </fragment> <fragment android:id="@+id/viewBalanceFragment" android:name="com.example.cashdog.cashdog.ViewBalanceFragment" android:label="fragment_view_balance" tools:layout="@layout/fragment_view_balance" /> <navigation android:id="@+id/sendMoneyGraph" app:startDestination="@id/chooseRecipient"> <fragment android:id="@+id/chooseRecipient" android:name="com.example.cashdog.cashdog.ChooseRecipient" android:label="fragment_choose_recipient" tools:layout="@layout/fragment_choose_recipient"> <action android:id="@+id/action_chooseRecipient_to_chooseAmountFragment" app:destination="@id/chooseAmountFragment" /> </fragment> <fragment android:id="@+id/chooseAmountFragment" android:name="com.example.cashdog.cashdog.ChooseAmountFragment" android:label="fragment_choose_amount" tools:layout="@layout/fragment_choose_amount" /> </navigation> </navigation> 

7. ID , , navigate() :

 Navigation.findNavController(view).navigate(R.id.action_mainFragment_to_sendMoneyGraph); 

 view.findNavController(view).navigate(R.id.action_mainFragment_to_sendMoneyGraph) 

Android, ( deep link ) URI (, – . ), - . URI - , .

1. .
2. + Depp Links . Add Deep Link .
3. URI URI. "www.cashdog.com/sendmoney" ( www.cashdog.com , ).
   URI:
   
   • URI , http https. www.cashdog.com http://www.cashdog.com https://www.cashdog.com .
   • (placeholders) {placeholder_name} . http://www.example.com/users/{id } http://www.example.com/users/4 .
   • . 0 .
4. Auto Verify Google , URI . Android App Links .
5. Add . .
6. Text . :
   

    <deepLink app:uri="https://cashdog.com/sendmoney"/> 

Back, , . , , .

manifest.xml :

• Android Studio 3.0 3.1, intent-filter. , .
• Android Studio 3.2+, nav-graph :
  

   <activity name=".MainActivity"> <nav-graph android:value="@navigation/main_nav" /> </activity> 

, .

Navigation , " " " ".
:

1. . Navigation Property Animation View Animation . Animation Resources .
2. , .
3. Transitions , Enter. .
4. , .
5. Transitions , Exit. .
6. , .
7. Text . XML action. , . specifyAmountFragment , , :
   

    <fragment android:id="@+id/specifyAmountFragment" android:name="com.example.buybuddy.buybuddy.SpecifyAmountFragment" android:label="fragment_specify_amount" tools:layout="@layout/fragment_specify_amount"> <action android:id="@+id/confirmationAction" app:destination="@id/confirmationFragment" app:enterAnim="@anim/slide_in_right" app:exitAnim="@anim/slide_out_left" app:popEnterAnim="@anim/slide_in_left" app:popExitAnim="@anim/slide_out_right" /> </fragment> 

, ( enterAnim exitAnim ) ( popEnterAnim popExitAnim ).

- Navigation Editor, . , Report a bug .

Navigation . :

• Migrate to the Navigation Architecture Component
• Add support for new destination types
• Implement conditional navigation
• Identify a common destination for several UI elements

, , , . - . , . ! , - ( Android) – .

UPD: : https://github.com/PrincessYork/android_navigation