मल्टी-मॉड्यूल परियोजनाओं में नेविगेशन

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

शुरू करने से पहले, मैं एक कहानी बताता हूँ। चलो इसे इस तरह कहते हैं "हमने प्रोजेक्ट मॉड्यूलर कैसे बनाया और मुझे हमारे नेविगेशन से नफरत क्यों हुई।"

हमारे पास एक एकल मॉड्यूल परियोजना थी और निर्माण समय को छोड़कर सब कुछ ठीक था, ऐसा इसलिए है क्योंकि हमने डैगर का उपयोग किया था और एक एकल घटक को उत्पन्न करने में बहुत लंबा समय लगा। इसलिए हमने प्रोजेक्ट को मॉड्यूल द्वारा अलग करने का निर्णय लिया, उदाहरण के लिए, एक लॉगिन सुविधा, एक सहायता सुविधा और आदि।

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

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

इसलिए, मैं यह सोच रहा हूं कि इसे बेहतर कैसे बनाया जाए, फ्रैगमेंट के बीच इन कनेक्शनों को कैसे तोड़ें, कैसे ज्ञान से छुटकारा पाएं कि कुछ राउटर हैं। इस लेख में, मैं दिखाऊंगा कि मैंने क्या बनाया है।

हम क्या करेंगे

आवेदन सुपर सरल होगा लेकिन यह मॉड्यूलर होगा। एक अनुप्रयोग मॉड्यूल और तीन फ़ीचर मॉड्यूल होंगे:

• ऐप मॉड्यूल - यह मॉड्यूल ऐप के बारे में सब कुछ जानता है और वहां हम अपने नेविगेशन को लागू करेंगे। हम JetPack से नेविगेशन घटक का उपयोग करेंगे।
• प्रश्न मॉड्यूल - यह मॉड्यूल प्रश्न सुविधा के लिए जिम्मेदार है। मॉड्यूल ऐप मॉड्यूल या किसी अन्य मॉड्यूल के बारे में कुछ नहीं जानता है। एक QuestionsFragment और एक QuestionsNavigation इंटरफ़ेस होगा।
• प्रश्न मॉड्यूल - एक प्रश्न सुविधा होगी। पिछले मॉड्यूल के रूप में, यह अन्य मॉड्यूल के बारे में नहीं जानता है। उस मॉड्यूल में एक QuestionFragment और एक QuestionNavigation इंटरफ़ेस होगा।
• परिणाम मॉड्यूल - यह एक परिणाम विशेषता है। इसके अलावा, यह पूरी तरह से स्वतंत्र मॉड्यूल है। एक RightAnswerFragment RightAnswerNavigation इंटरफेस के साथ होगा और एक WrongAnswerFragment एक WrongAnswerNavigation इंटरफेस के साथ होगा।

एप्लिकेशन के लिए स्रोत कोड यहां पाया जा सकता है: GitHub ।

कार्यान्वयन

इस लेख में, मैं फीचर के नेविगेशन को प्राप्त करने के लिए ComponentsManager लाइब्रेरी का उपयोग करूंगा। एक वास्तविक परियोजना में, मैं डैगर द्वारा फीचर का नेविगेशन प्रदान करूंगा लेकिन इस छोटे से प्रोजेक्ट के लिए यह आवश्यक नहीं है। साथ ही, ComponentManager लाइब्रेरी आपको मल्टी-मॉड्यूल प्रोजेक्ट्स में डैगर का उपयोग करने में मदद करती है।

क्या आप तैयार हैं? चलो चलते हैं!

प्रश्न मॉड्यूल

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

 //build.gradle (for the questions module) apply plugin: 'com.android.library' apply plugin: 'kotlin-android' apply plugin: 'kotlin-android-extensions' android { ... } dependencies { ... implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version" implementation 'androidx.appcompat:appcompat:1.1.0-alpha01' implementation 'androidx.constraintlayout:constraintlayout:1.1.3' implementation "com.github.valeryponomarenko.componentsmanager:androidx:2.0.1" ... } 

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

 interface QuestionsNavigation { fun openQuestion(questionId: Long) } 

एक प्रश्न के साथ एक स्क्रीन खोलने के लिए, हम सिर्फ openQuestion(questionId: Long) विधि कहते हैं और यह है। हमें परवाह नहीं है कि स्क्रीन कैसे खोली जाएगी, हमें इस बात की भी परवाह नहीं है कि यह Fragment या Activity या कुछ और।

यहाँ QuestionsFragment और इसका लेआउट है ।

 class QuestionsFragment : Fragment() { private val navigation: QuestionsNavigation by lazy { XInjectionManager.findComponent<QuestionsNavigation>() } override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?): View? = inflater.inflate(R.layout.fragment_questions, container, false) override fun onViewCreated(view: View, savedInstanceState: Bundle?) { super.onViewCreated(view, savedInstanceState) button_first_question.setOnClickListener { navigation.openQuestion(1) } button_second_question.setOnClickListener { navigation.openQuestion(2) } button_third_question.setOnClickListener { navigation.openQuestion(3) } } } 

प्रश्न मॉड्यूल

सबसे पहले, एक एंड्रॉइड लाइब्रेरी मॉड्यूल बनाएं और इसे प्रश्न कहें। मॉड्यूल की build.gradle में प्रश्न मॉड्यूल के build.gradle फ़ाइल के समान निर्भरताएं होनी चाहिए।

 //build.gradle (for the question module) apply plugin: 'com.android.library' apply plugin: 'kotlin-android' apply plugin: 'kotlin-android-extensions' android { ... } dependencies { ... implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version" implementation 'androidx.appcompat:appcompat:1.1.0-alpha01' implementation 'androidx.constraintlayout:constraintlayout:1.1.3' implementation "com.github.valeryponomarenko.componentsmanager:androidx:2.0.1" ... } 

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

QuestionFragment उपयोगकर्ता एक गलत उत्तर स्क्रीन या एक सही उत्तर स्क्रीन खोल सकता है, इसलिए इंटरफ़ेस में दो विधियाँ होंगी।

 interface QuestionNavigation { fun openWrongAnswer() fun openRightAnswer() } 

आखिरी चीज है टुकड़ा। इस टुकड़े के लिए, हम एक साथी विधि जोड़ेंगे जो एक Bundle लौटाता है ताकि हम प्रश्न आईडी को पास कर सकें और उसका उपयोग कर सकें। टुकड़े का लेआउट ।

 class QuestionFragment : Fragment() { companion object { private const val EXTRA_QUESTION_ID = "me.vponomarenko.modular.navigation.question.id" fun createBundle(questionId: Long) = Bundle().apply { putLong(EXTRA_QUESTION_ID, questionId) } } private val navigation: QuestionNavigation by lazy { XInjectionManager.findComponent<QuestionNavigation>() } private val questionId: Long by lazy { arguments?.getLong(EXTRA_QUESTION_ID) ?: throw IllegalStateException("no questionId") } override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?): View? = inflater.inflate(R.layout.fragment_question, container, false) override fun onViewCreated(view: View, savedInstanceState: Bundle?) { super.onViewCreated(view, savedInstanceState) text_question.text = getString(R.string.question, questionId) button_right_answer.setOnClickListener { navigation.openRightAnswer() } button_wrong_answer.setOnClickListener { navigation.openWrongAnswer() } } } 

परिणाम मॉड्यूल

अंतिम फीचर मॉड्यूल एक परिणाम मॉड्यूल है। दो टुकड़े होंगे जो एक सही और गलत उत्तर दिखाते हैं। एक एंड्रॉइड लाइब्रेरी मॉड्यूल बनाएं और उसे परिणाम दें , फिर मॉड्यूल के बिल्ड.ग्रेड को बदलें ताकि उसमें पिछले फीचर मॉड्यूल के समान निर्भरता हो।

 //build.gradle (for the result module) apply plugin: 'com.android.library' apply plugin: 'kotlin-android' apply plugin: 'kotlin-android-extensions' android { ... } dependencies { ... implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version" implementation 'androidx.appcompat:appcompat:1.1.0-alpha01' implementation 'androidx.constraintlayout:constraintlayout:1.1.3' implementation "com.github.valeryponomarenko.componentsmanager:androidx:2.0.1" ... } 

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

 interface RightAnswerNavigation { fun openAllQuestions() } 

RightAnswerFragment , इसका लेआउट ।

 class RightAnswerFragment : Fragment() { private val navigation: RightAnswerNavigation by lazy { XInjectionManager.findComponent<RightAnswerNavigation>() } override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?): View? = inflater.inflate(R.layout.fragment_right, container, false) override fun onViewCreated(view: View, savedInstanceState: Bundle?) { super.onViewCreated(view, savedInstanceState) button_all_questions.setOnClickListener { navigation.openAllQuestions() } } } 

जैसा कि मैंने पहले कहा था, इस मॉड्यूल में दो Fragments , तो चलिए एक गलत उत्तर स्क्रीन को लागू करते हैं।

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

 interface WrongAnswerNavigation { fun tryAgain() } 

और WrongAnswerFragment, इसका लेआउट ।

 class WrongAnswerFragment : Fragment() { private val navigation: WrongAnswerNavigation by lazy { XInjectionManager.findComponent<WrongAnswerNavigation>() } override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?): View? = inflater.inflate(R.layout.fragment_wrong, container, false) override fun onViewCreated(view: View, savedInstanceState: Bundle?) { super.onViewCreated(view, savedInstanceState) button_try_again.setOnClickListener { navigation.tryAgain() } } } 

ऐप मॉड्यूल

हमने मॉड्यूल बनाए हैं और उन्हें कनेक्ट करने और ऐप चलाने का समय आ गया है।

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

 //build.gradle (for the app module) apply plugin: 'com.android.application' apply plugin: 'kotlin-android' apply plugin: 'kotlin-android-extensions' android { ... } dependencies { ... implementation project(':questions') implementation project(':question') implementation project(':result') implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version" implementation 'androidx.appcompat:appcompat:1.1.0-alpha01' implementation 'com.github.valeryponomarenko.componentsmanager:androidx:2.0.1' implementation 'android.arch.navigation:navigation-fragment-ktx:1.0.0-alpha11' ... } 

नेविगेशन के साथ काम करने वाली कक्षाओं को लागू करने से पहले, हमें खुद को नेविगेशन जोड़ना होगा। इसे बनाने के लिए हम नैविगेशन कंपोनेंट का उपयोग करेंगे।

एक नेविगेशन संसाधन फ़ाइल बनाएं और इसे nav_graph.xml पर कॉल करें। तीन कनेक्शन होंगे:

• QuestionsFragment साथ QuestionFragment
• WrongAnswerFragment साथ WrongAnswerFragment
• The RightAnwerFragment साथ RightAnwerFragment । इस संबंध में थोड़ा अंतर है। यदि उपयोगकर्ता RightAnswerFragment और उपयोगकर्ता बैक बटन दबाता है, तो उसे RightAnswerFragment में वापस कर दिया जाएगा। कैसे हो सकता है? बस उस तीर का चयन करें जो questionFragment को rightAnswerFragment जोड़ता है, फिर questionsFragment का चयन करने के लिए पॉप के पास ड्रॉप-डाउन सूची में।

यहाँ नेविगेशन ग्राफ का 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" android:id="@+id/nav_graph" app:startDestination="@id/questionsFragment"> <fragment android:id="@+id/questionsFragment" android:name="me.vponomarenko.modular.navigation.questions.QuestionsFragment" android:label="QuestionsFragment"> <action android:id="@+id/action_questionsFragment_to_questionFragment" app:destination="@id/questionFragment" /> </fragment> <fragment android:id="@+id/questionFragment" android:name="me.vponomarenko.modular.navigation.question.QuestionFragment" android:label="QuestionFragment"> <action android:id="@+id/action_questionFragment_to_wrongAnswerFragment" app:destination="@id/wrongAnswerFragment" /> <action android:id="@+id/action_questionFragment_to_rightAnswerFragment" app:destination="@id/rightAnswerFragment" app:popUpTo="@+id/questionsFragment" /> </fragment> <fragment android:id="@+id/wrongAnswerFragment" android:name="me.vponomarenko.modular.navigation.result.wrong.WrongAnswerFragment" android:label="WrongAnswerFragment" /> <fragment android:id="@+id/rightAnswerFragment" android:name="me.vponomarenko.modular.navigation.result.right.RightAnswerFragment" android:label="RightAnswerFragment" /> </navigation> 

फिर, एक Navigator वर्ग बनाएं। जाहिर है, खंडों के बीच परिवर्तन करने के लिए वर्ग जिम्मेदार है। यह फीचर मॉड्यूल से सभी नेवीगेशन इंटरफेस को लागू करता है, आवश्यक स्क्रीन को खोलने के लिए संबंधित क्रियाओं की कॉल को जोड़ना न भूलें। इसके अलावा, कक्षा के पास navController को बांधने और इसे अनबाइंड करने के तरीके हैं।

 class Navigator : QuestionsNavigation, QuestionNavigation, RightAnswerNavigation, WrongAnswerNavigation { private var navController: NavController? = null override fun openQuestion(questionId: Long) { navController?.navigate( R.id.action_questionsFragment_to_questionFragment, QuestionFragment.createBundle(questionId) ) } override fun openWrongAnswer() { navController?.navigate(R.id.action_questionFragment_to_wrongAnswerFragment) } override fun openRightAnswer() { navController?.navigate(R.id.action_questionFragment_to_rightAnswerFragment) } override fun openAllQuestions() { navController?.popBackStack() } override fun tryAgain() { navController?.popBackStack() } fun bind(navController: NavController) { this.navController = navController } fun unbind() { navController = null } } 

8 वीं पंक्ति में आप देख सकते हैं कि कैसे मैं प्रश्न आईडी को प्रश्नफल में पास करता हूं।

उसके बाद, एक NavApplication class बनाएं। दरअसल, मुझे Navigator को अन्य वर्गों के लिए उपलब्ध कराने के लिए इस वर्ग को जोड़ना था, अन्यथा, सुविधा मॉड्यूल में नेविगेटर प्राप्त करना कठिन होगा। इस वर्ग को मेनिफेस्ट में जोड़ना न भूलें।

 class NavApplication : Application() { override fun onCreate() { super.onCreate() XInjectionManager.bindComponentToCustomLifecycle(object : IHasComponent<Navigator> { override fun getComponent(): Navigator = Navigator() }) } } 

4 वीं -6 वीं पंक्तियों के साथ, XInjectionManager.findComponent () कॉल करके सुविधाओं के नेविगेशन इंटरफ़ेस के कार्यान्वयन को प्राप्त करना संभव होगा।

अंतिम लेकिन कम से कम, MainActivity वर्ग और उसके लेआउट को न बदलें।

 class MainActivity : AppCompatActivity() { private val navigator: Navigator by lazy { XInjectionManager.findComponent<Navigator>() } override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) } override fun onResume() { super.onResume() navigator.bind(findNavController(R.id.nav_host_fragment)) } override fun onPause() { super.onPause() navigator.unbind() } override fun onSupportNavigateUp(): Boolean = findNavController(R.id.nav_host_fragment).navigateUp() } 

यह सब है, अब आप ऐप चला सकते हैं और देख सकते हैं कि यह कैसे काम करता है।

सारांश

अच्छा काम! हमने एक नेविगेशन सिस्टम बनाया है:

• अलग-अलग फ़ीचर मॉड्यूल में टुकड़े के बीच कनेक्शन को तोड़ता है,
• आसानी से बदला जा सकता है,
• परीक्षण करना आसान है।

Krosspost