सभी को नमस्कार! मैं नेविगेशन आर्किटेक्चर घटक के काम में सुविधाओं के बारे में बात करना चाहता हूं, जिसके कारण मुझे पुस्तकालय की अस्पष्ट छाप मिली।

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

मुझे तुरंत यह कहना चाहिए कि मैं निश्चित रूप से पुस्तकालय को उपयोगी मानता हूं और दुरुपयोग की संभावना को बाहर नहीं करता, लेकिन मैंने शायद इस लेख को लिखने से पहले सब कुछ आजमाया।

इसलिए, यहां ऐसे कार्यान्वयन के परिदृश्य हैं, जिनके कार्यान्वयन में वास्तविकता के साथ कार्यक्षमता की अपेक्षाएं पूरी नहीं हुईं:

नेविगेशन दराज में मेनू आइटम के बीच स्विच करना
अपने नेविगेशन ग्राफ के साथ एक नई गतिविधि की खोज
प्रारंभ करने के लिए पैरामीटर पारित करना

मेनू आइटम के बीच स्विच करें

यह उन विशेषताओं में से एक है, जिन्होंने नेविगेशन घटक का उपयोग करने के निर्णय को प्रभावित किया है।

आपको बस मेनू आइटम आईडी को समान बनाने की आवश्यकता है

activity_main_drawer.xml

<?xml version="1.0" encoding="utf-8"?> <menu xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools" tools:showIn="navigation_view"> <group android:checkableBehavior="single"> <item android:id="@+id/importFragment" android:icon="@drawable/ic_menu_camera" android:title="Import"/> <item android:id="@+id/galleryFragment" android:icon="@drawable/ic_menu_gallery" android:title="Gallery"/> <item android:id="@+id/slideshowFragment" android:icon="@drawable/ic_menu_slideshow" android:title="Slideshow"/> <!--    -->

और स्क्रीन आईडी (नेविगेशन ग्राफ में गंतव्य)

mobile_navigation.xml

 <?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/mobile_navigation" app:startDestination="@id/importFragment"> <fragment android:id="@+id/importFragment" android:name="com.xiii.navigationapplication.ImportFragment" android:label="fragment_import" tools:layout="@layout/fragment_import"/> <fragment android:id="@+id/galleryFragment" android:name="com.xiii.navigationapplication.GalleryFragment" android:label="fragment_gallery" tools:layout="@layout/fragment_gallery"/> <fragment android:id="@+id/slideshowFragment" android:name="com.xiii.navigationapplication.SlideshowFragment" android:label="fragment_slideshow" tools:layout="@layout/fragment_slideshow"/> </navigation>

तब आपको मेनू को नेविगेशन कंट्रोलर के साथ जोड़ना होगा:

MainActivity.kt

 class MainActivity : AppCompatActivity() { private val navController by lazy(LazyThreadSafetyMode.NONE) { Navigation.findNavController(this, R.id.nav_host_fragment) } override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) setSupportActionBar(toolbar) //   ""  toolbar NavigationUI.setupWithNavController(toolbar, navController, drawer_layout) //      nav_view.setupWithNavController(navController) } //     override fun onSupportNavigateUp() = navController.navigateUp() }

मेनू में नेविगेशन ने काम किया है - क्या यह चमत्कार नहीं है?

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

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

एक नई गतिविधि खोलना

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

 navController.navigate(R.id.editActivity)

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

नेविगेशन योजना

उदाहरण के रूप में, आइए नोट जोड़ने के लिए एक गतिविधि देखें। इसमें EditFragment input फ़ील्ड के साथ मुख्य टुकड़ा होगा; यह नेविगेशन ग्राफ़ में startDestination होगा। मान लेते हैं कि संपादन करते समय हमें एक फोटो संलग्न करने की आवश्यकता होती है, इसके लिए हम कैमरा से एक चित्र प्राप्त करने के लिए PhotoFragment पर जाएंगे। नेविगेशन ग्राफ इस तरह दिखेगा:

edit_navigation.xml

 <?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/edit_navigation" app:startDestination="@id/editFragment"> <fragment android:id="@+id/editFragment" android:name="com.xiii.navigationapplication.ui.edit.EditFragment" android:label="fragment_edit" tools:layout="@layout/fragment_edit"> <action android:id="@+id/action_editFragment_to_photoFragment" app:destination="@id/photoFragment"/> </fragment> <fragment android:id="@+id/photoFragment" android:name="com.xiii.navigationapplication.ui.edit.PhotoFragment" android:label="fragment_photo" tools:layout="@layout/fragment_photo"/> </navigation>

EditActivity MainActivity से बहुत अलग नहीं है। मुख्य अंतर यह है कि EditActivity पर कोई मेनू नहीं है:

EditActivity.kt

 class EditActivity : AppCompatActivity() { private val navController by lazy(LazyThreadSafetyMode.NONE) { Navigation.findNavController(this, R.id.nav_host_fragment) } override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_edit) setSupportActionBar(toolbar) //    ""  toolbar NavigationUI.setupWithNavController(toolbar, navController) } override fun onSupportNavigateUp() = navController.navigateUp() fun takePhoto(view: View) { navController.navigate(R.id.action_editFragment_to_photoFragment) } }

गतिविधि खुलती है, इसके अंदर नेविगेशन काम करता है:

फिर से, टूलबार में नेविगेशन बटन पर ध्यान दें - शुरुआती EditFragment पर "बैक टू पैरेंट एक्टिविटी" बटन नहीं है (लेकिन मैं चाहूंगा)। प्रलेखन के दृष्टिकोण से, यहां सब कुछ कानूनी है: एक नया नेविगेशन ग्राफ, एक नया प्रारंभ मूल्य, "बैक" बटन को प्रारंभ , अंत में नहीं दिखाया गया है।

जो लोग अभिभावकों की गतिविधि के साथ अपने सामान्य व्यवहार पर लौटना चाहते हैं, वे टुकड़ों के बीच स्विच करने के लिए कार्यक्षमता बनाए रखते हुए, मैं इस ~~बैसाखी की~~ पेशकश कर सकता हूं:

1. प्रकट में मूल गतिविधि निर्दिष्ट करें

 <activity android:name=".EditActivity" android:parentActivityName=".MainActivity" android:theme="@style/AppTheme.NoActionBar"> <!-- Parent activity meta-data to support 4.0 and lower --> <meta-data android:name="android.support.PARENT_ACTIVITY" android:value=".MainActivity" /> </activity>

2. एक सदस्यता जोड़ें जिसमें हम आईडी शुरुआत को बदल देंगे

 class EditActivity : AppCompatActivity() { private val navController by lazy(LazyThreadSafetyMode.NONE) { Navigation.findNavController(this, R.id.nav_host_fragment) } private var isStartDestination = true override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_edit) setSupportActionBar(toolbar) val startDestinationId = navController.graph.startDestination //    id,  NavigationUI.ActionBarOnNavigatedListener     //      destination    startDestination navController.addOnNavigatedListener { controller, destination -> isStartDestination = destination.id == startDestinationId // R.id.fake_start_destination  id        controller.graph.startDestination = if (isStartDestination) R.id.fake_start_destination else startDestinationId } //    ""  toolbar NavigationUI.setupActionBarWithNavController(this, navController) } override fun onSupportNavigateUp(): Boolean { //  startDestination      Navigation Component return if (isStartDestination) super.onSupportNavigateUp() else navController.navigateUp() } fun takePhoto(view: View) { navController.navigate(R.id.action_editFragment_to_photoFragment) } }

एक सदस्यता आवश्यक है ताकि नैविगेशन के लिए। ActionBarOnNavigatedListener सभी गंतव्य प्रारंभ न हों । इस प्रकार, NavigationUI.ActionBarOnNavigatedListener नेविगेशन बटन (विवरण के लिए स्रोत का संदर्भ) को छिपाएगा नहीं। प्रारंभ में इस नियमित रूप से onSupportNavigateUp () प्रसंस्करण में जोड़ें और जो हम चाहते थे वह प्राप्त करें।

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

प्रारंभ करने के लिए पैरामीटर पास करना

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

अब हम मामले का विश्लेषण करेंगे, जिसके कारण मैं इस कार्य के लिए ठोस पांच नहीं रख सका।

जब एक गतिविधि का उपयोग वस्तुओं को बनाने और संपादित करने के लिए किया जाता है, तो हम EditActivity पर वापस आते हैं। जब आप गतिविधि में संपादन के लिए एक ऑब्जेक्ट खोलते हैं, तो आपको स्थानांतरण की आवश्यकता होती है, उदाहरण के लिए, ऑब्जेक्ट की आईडी - चलो इसे एक नियमित तरीके से करते हैं:

1. EditActivity के लिए ग्राफ़ में एक पैरामीटर जोड़ें

मैंने ग्राफ़ (नेविगेशन) के मूल तत्व में सीधे पैरामीटर जोड़ा, लेकिन लक्ष्य टुकड़े में जोड़ा जा सकता है। इससे, केवल पैरामीटर प्राप्त करने की विधि बदल जाएगी।

 <?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/edit_navigation" app:startDestination="@id/editFragment"> <argument android:name="id" app:argType="integer"/> <fragment android:id="@+id/editFragment" android:name="com.xiii.navigationapplication.ui.edit.EditFragment" android:label="fragment_edit" tools:layout="@layout/fragment_edit"> <action android:id="@+id/action_editFragment_to_photoFragment" app:destination="@id/photoFragment"/> </fragment> <fragment android:id="@+id/photoFragment" android:name="com.xiii.navigationapplication.ui.edit.PhotoFragment" android:label="fragment_photo" tools:layout="@layout/fragment_photo"/> </navigation>

2. एक्शन को मुख्य ग्राफ में जोड़ें

मैंने खंडों में से एक में क्रियाओं को जोड़ा और संपादित किया है, इसलिए वे केवल इससे उपलब्ध होंगे।

 <?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/mobile_navigation" app:startDestination="@id/importFragment"> <fragment android:id="@+id/importFragment" android:name="com.xiii.navigationapplication.ImportFragment" android:label="fragment_import" tools:layout="@layout/fragment_import"> <action android:id="@+id/add" app:destination="@id/editActivity"> <argument android:name="id" app:argType="integer" android:defaultValue="0"/> </action> <action android:id="@+id/edit" app:destination="@id/editActivity"> <argument android:name="id" app:argType="integer"/> </action> </fragment> <fragment android:id="@+id/galleryFragment" android:name="com.xiii.navigationapplication.GalleryFragment" android:label="fragment_gallery" tools:layout="@layout/fragment_gallery"/> <fragment android:id="@+id/slideshowFragment" android:name="com.xiii.navigationapplication.SlideshowFragment" android:label="fragment_slideshow" tools:layout="@layout/fragment_slideshow"/> <activity android:id="@+id/editActivity" android:name="com.xiii.navigationapplication.EditActivity" android:label="activity_edit" tools:layout="@layout/activity_edit"/> </navigation>

3. पैरामीटर तैयार करें और संक्रमण का अनुरोध करें

इस उदाहरण में, ImportFragmentDirections स्वचालित रूप से उत्पन्न सुरक्षित-args वर्ग है।

 val direction = ImportFragmentDirections.edit(123 /* id  */) navController.navigate(direction)

3. टुकड़े टुकड़े में आईडी प्राप्त करें

 class EditFragment : Fragment() { override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?): View { //    ,  fragment     startDestination // val id = EditFragmentArgs.fromBundle(arguments) val id = EditFragmentArgs.fromBundle(requireActivity().intent.extras) return inflater.inflate(R.layout.fragment_edit, container, false) } }

आप, EditFragment में मापदंडों को प्राप्त करने की सुविधाओं पर निश्चित रूप से ध्यान देते हैं । यह काम करता है क्योंकि संपादित क्रिया (बिंदु 1 से), EditActivity के लिए तर्क पारित करती है , और इसके किसी कारण से, यह ~~लालची है~~ कि यह इसे ग्राफ़ को नहीं पारित करता है (उदाहरण के लिए, navController.graph.setDefaultArguments () ) को कॉल करके। नेविगेशन कंट्रोलर को मैन्युअल रूप से तैयार करके इस सुविधा को दरकिनार किया जा सकता है। StackOwerflow पर एक तरीका वर्णित है।

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

संक्षेप में, मैं यह नोट करना चाहता हूं कि मैंने खुद को पुस्तकालय का उपयोग करना बंद नहीं किया है और, सुविधा की सूचीबद्ध ~~कमियों के~~ बावजूद, मुझे उपयोग के लिए सिफारिश करने के लिए यह पर्याप्त उपयोगी लगता है। मुझे वास्तव में उम्मीद है कि अगले रिलीज में स्थिति बदल जाएगी, कम से कम शुरू करने के लिए मापदंडों के हस्तांतरण के साथ।

आपका ध्यान के लिए धन्यवाद। आपका काम कोड!

लेख के लिए सूत्र GitHub पर पोस्ट किए गए हैं।

Android नेविगेशन घटक। सरल चीजें जो आपको खुद करनी हैं

मेनू आइटम के बीच स्विच करें

एक नई गतिविधि खोलना

प्रारंभ करने के लिए पैरामीटर पास करना

More articles: