मार्गपरिवर्तनकर्ता का उपयोग करके UIViewControllers के कॉन्फ़िगरेशन उदाहरण

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

राउटर कॉन्फ़िगरेशन को कैसे पार्स करता है

शुरू करने के लिए, विचार करें कि राउटर आपके द्वारा लिखे गए कॉन्फ़िगरेशन को कैसे पार्स करता है। पिछले लेख से उदाहरण लें:

let productScreen = StepAssembly(finder: ClassFinder(options: [.current, .visible]), factory: ProductViewControllerFactory()) .using(UINavigationController.pushToNavigation()) .from(SingleContainerStep(finder: NilFinder(), factory: NavigationControllerFactory())) .using(GeneralAction.presentModally()) .from(GeneralStep.current()) .assemble() 

राउटर पहले से शुरू होने वाले चरणों की श्रृंखला से गुजरेगा, जब तक कि किसी एक चरण (प्रदान किए गए Finder का उपयोग करके) यह सूचित नहीं करता कि वांछित UIViewController पहले UIViewController ही स्टैक पर है। (उदाहरण के लिए, GeneralStep.current() नियंत्रक स्टैक में मौजूद रहने की गारंटी दी गई है)। फिर राउटर वापस ले जाना शुरू कर देगा, साथ ही आवश्यक UIViewController का उपयोग करते हुए प्रदान किए गए UIViewController का उपयोग करते हुए और निर्दिष्ट निर्दिष्ट एस का उपयोग करके उन्हें एकीकृत करना होगा। संकलन चरण पर भी टाइप करने के लिए धन्यवाद, सबसे अधिक बार, आप प्रदान किए गए Fabric साथ असंगत UITabBarController.addTab का उपयोग करने में सक्षम नहीं होंगे (अर्थात, आप NavigationControllerFactory UITabBarController.addTab द्वारा बनाए गए UITabBarController.addTab कंट्रोलर में UITabBarController.addTab का उपयोग नहीं कर पाएंगे)।

यदि आप ऊपर वर्णित कॉन्फ़िगरेशन की कल्पना करते हैं, तो यदि आपके पास स्क्रीन पर बस एक निश्चित ProductViewController , तो निम्न चरणों का पालन किया जाएगा:

1. ClassFinder को ProductViewController नहीं मिलेगा और राउटर आगे बढ़ जाएगा
2. NilFinder को कभी भी कुछ नहीं मिलेगा और राउटर आगे बढ़ जाएगा
3. GeneralStep.current हमेशा स्टैक पर सबसे ऊपरी UIViewController लौटाएगा।
4. प्रारंभ UIViewController पाया UIViewController है, राउटर वापस मुड़ जाएगा
5. `नेविगेशनकंट्रोलरफैक्टरी का उपयोग करके एक UINavigationController बनाता है
6. यह GeneralAction.presentModally का उपयोग करके GeneralAction.presentModally
7. ProductViewControllerFactory ProductViewControllerFactory ProductViewController ProductViewController ProductViewController ProductViewControllerFactory
8. बनाए गए ProductViewController को UINavigationController का उपयोग करके पिछले UINavigationController में एकीकृत करता है
9. नेविगेशन समाप्त करें

NB: यह समझा जाना चाहिए कि वास्तव में इसके अंदर कुछ UIViewController बिना एक UINavigationController मामूली रूप से दिखाना असंभव है। इसलिए, 5-8 चरणों को थोड़ा अलग क्रम में राउटर द्वारा किया जाएगा। लेकिन आपको इसके बारे में नहीं सोचना चाहिए। विन्यास क्रमिक रूप से वर्णित है।

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

StackIteratingFinder और इसके विकल्प:

आप Finder अवधारणा को किसी भी तरह से लागू कर सकते हैं जो आपको लगता है कि सबसे स्वीकार्य है। हालांकि, सबसे आसान तरीका स्क्रीन पर व्यू कंट्रोलर्स के ग्राफ के माध्यम से चलना है। इस लक्ष्य को सरल बनाने के लिए, पुस्तकालय StackIteratingFinder और विभिन्न कार्यान्वयन प्रदान करता है जो इस कार्य को करेंगे। आपको बस इस सवाल का जवाब देना है - क्या यह UIViewController जिसकी आप उम्मीद करते हैं।

StackIteratingFinder के व्यवहार को प्रभावित करने और यह बताने के लिए कि ग्राफ़ के किन हिस्सों (स्टैक) में मैं चाहता हूं कि नियंत्रक इसे देखें, आप इसे बनाते समय SearchOptions संयोजन को निर्दिष्ट कर सकते हैं। और उन्हें और अधिक विस्तार से जाना चाहिए:

• current : स्टैक पर सबसे ऊपरी दृश्य नियंत्रक। (वह जो UIWindow का rootViewController या वह जो बहुत ऊपर से rootViewController दिखाया गया है)
• visible : यदि UIViewController एक कंटेनर है, तो इसके दृश्य UIViewController आह में देखें (उदाहरण के लिए: UINavigationController हमेशा एक दिखाई देने वाला UIViewController , UISplitController एक या दो है यह कैसे प्रस्तुत किया जाता है इसके आधार पर हो सकता है।)
• contained : इस घटना में कि UIViewController एक कंटेनर है, अपने सभी नेस्टेड UIViewController में खोज करें (उदाहरण के लिए: दिखाई देने वाले सहित UINavigationController सभी दृश्य नियंत्रकों के माध्यम से जाएं)
• presenting : UIViewController तहत सभी UIViewController आह में खोजें (यदि वहाँ पाठ्यक्रम के हैं)
• presented : उपलब्ध कराए गए के लिए UIViewController खोजें ( StackIteratingFinder यह विकल्प समझ में नहीं आता है, क्योंकि यह हमेशा ऊपर से शुरू होता है)

निम्नलिखित आंकड़ा अधिक स्पष्ट ऊपर स्पष्टीकरण कर सकते हैं:

मैं एक पिछले लेख में कंटेनरों की अवधारणा से खुद को परिचित करने की सिफारिश करूंगा।

उदाहरण यदि आप चाहते हैं कि आपका Finder संपूर्ण स्टैक में एक AccountViewController की तलाश करे, लेकिन केवल दृश्यमान UIViewController s के बीच, तो इसे इस तरह लिखा जाना चाहिए:

 ClassFinder<AccountViewController, Any?>(options: [.current, .visible, .presenting]) 

NB यदि किसी कारण से प्रदान की गई सेटिंग कुछ कम होगी - तो आप हमेशा Finder ए के अपने कार्यान्वयन को आसानी से लिख सकते हैं। एक उदाहरण इस लेख में होगा।

चलिए, वास्तव में, उदाहरणों के लिए।

स्पष्टीकरण के साथ विन्यास के उदाहरण

मेरे पास एक निश्चित UIViewController , जो कि UIWindow का rootViewController , और मैं चाहता हूं कि इसे नेविगेशन के अंत में एक निश्चित HomeViewController साथ बदल दिया जाए:

 let screen = StepAssembly( finder: ClassFinder<HomeViewController, Any?>(), factory: XibFactory()) .using(GeneralAction.replaceRoot()) .from(GeneralStep.root()) .assemble() 

XibFactory HomeViewController की xib फ़ाइल से HomeViewController.xib लोड XibFactory

यह मत भूलो कि यदि आप संयोजन में Finder और Factory अमूर्त कार्यान्वयन का उपयोग करते हैं, तो आपको कम से कम एक संस्था के लिए UIViewController और संदर्भ का प्रकार निर्दिष्ट करना होगा - ClassFinder<HomeViewController, Any?>

क्या होता है, अगर ऊपर के उदाहरण में, मैं GeneralStep.root को GeneralStep.current बदल GeneralStep.current ?

कॉन्फ़िगरेशन उस समय तक काम करेगा जब तक यह उस समय नहीं कहा जाता है जब स्क्रीन पर कोई भी मोडल UIViewController । इस स्थिति में, GeneralAction.replaceRoot रूट कंट्रोलर को प्रतिस्थापित करने में सक्षम नहीं होगा, क्योंकि इसके ऊपर एक मोडल नियंत्रक है, और राउटर एक त्रुटि की सूचना देगा। यदि आप चाहते हैं कि यह कॉन्फ़िगरेशन किसी भी तरह से काम करे, तो आपको राउटर को यह समझाने की ज़रूरत है कि आप GeneralAction.replaceRoot विशेष रूप से रूट UIViewController लागू करना चाहते हैं। फिर राउटर सभी सामान्य रूप से प्रतिनिधित्व किए गए UIViewController को हटा देगा और कॉन्फ़िगरेशन किसी भी स्थिति में काम करेगा।

मैं कुछ AccountViewController दिखाना चाहता हूं, अगर यह अभी भी अच्छी तरह से दिखाया गया है, किसी भी UINavigationController अंदर और जो वर्तमान में कहीं न कहीं स्क्रीन पर है (भले ही यह UINavigationController कुछ modal UIViewController तहत हो:

 let screen = StepAssembly( finder: ClassFinder<AccountViewController, Any?>(), factory: XibFactory()) .using(UINavigationController.pushToNavigation()) .from(SingleStep(ClassFinder<UINavigationController, Any?>(), NilFactory())) .from(GeneralStep.current()) .assemble() 

इस कॉन्फ़िगरेशन में NilFactory क्या अर्थ है? इसके द्वारा, आप राउटर को बताते हैं कि यदि वह स्क्रीन पर कोई UINavigationController नहीं ढूंढ पाया, तो आप नहीं चाहते कि वह इसे बनाए और सिर्फ इस मामले में कुछ न करे। वैसे, चूंकि यह NilFactory , आप इसके बाद Action उपयोग नहीं कर सकते।

मैं कुछ AccountViewController दिखाना चाहता हूं, अगर यह पहले से ही नहीं दिखाया गया है, किसी भी UINavigationController अंदर और जो वर्तमान में स्क्रीन पर कहीं है, और अगर ऐसा नहीं होता है, तो इसे बनाएं और इसे सामान्य रूप से दिखाएं:

 let screen = StepAssembly( finder: ClassFinder<AccountViewController, Any?>(), factory: XibFactory()) .using(UINavigationController.PushToNavigation()) .from(SwitchAssembly<UINavigationController, Any?>() .addCase(expecting: ClassFinder<UINavigationController, Any?>(options: .visible)) //   -    .assemble(default: { //      return ChainAssembly() .from(SingleContainerStep(finder: NilFinder(), factory: NavigationControllerFactory())) .using(GeneralAction.presentModally()) .from(GeneralStep.current()) .assemble() }) ).assemble() 

मैं UITabBarController को UITabBarController साथ दिखाना चाहता हूं जिसमें HomeViewController और HomeViewController को वर्तमान रूट के साथ प्रतिस्थापित करना है:

 let tabScreen = SingleContainerStep( finder: ClassFinder(), factory: CompleteFactoryAssembly(factory: TabBarControllerFactory()) .with(XibFactory<HomeViewController, Any?>(), using: UITabBarController.addTab()) .with(XibFactory<AccountViewController, Any?>(), using: UITabBarController.addTab()) .assemble()) .using(GeneralAction.replaceRoot()) .from(GeneralStep.root()) .assemble() 

क्या मैं GeneralAction.presentModally कार्रवाई के साथ कस्टम UIViewControllerTransitioningDelegate उपयोग कर सकता हूं:

 let transitionController = CustomViewControllerTransitioningDelegate() //     .using(GeneralAction.PresentModally(transitioningDelegate: transitionController)) 

मैं AccountViewController जाना चाहता हूं, जहां भी उपयोगकर्ता किसी अन्य टैब में या यहां तक ​​कि किसी प्रकार की मोडल विंडो में भी है:

 let screen = StepAssembly( finder: ClassFinder<AccountViewController, Any?>(), factory: NilFactory()) .from(tabScreen) .assemble() 

हम NilFactory उपयोग क्यों कर रहे NilFactory ? अगर यह नहीं पाया जाता है तो हमें एक AccountViewController बनाने की आवश्यकता नहीं है। यह tabScreen कॉन्फ़िगरेशन में बनाया जाएगा। उसे ऊपर देखें।

मैं ForgotPasswordViewController रूप से ForgotPasswordViewController दिखाना चाहता ForgotPasswordViewController , लेकिन, निश्चित रूप से, LoginViewController अंदर LoginViewController बाद:

 let loginScreen = StepAssembly( finder: ClassFinder<LoginViewController, Any?>(), factory: XibFactory()) .using(UINavigationController.pushToNavigation()) .from(NavigationControllerStep()) .using(GeneralAction.presentModally()) .from(GeneralStep.current()) .assemble() let forgotPasswordScreen = StepAssembly( finder: ClassFinder<ForgotPasswordViewController, Any?>(), factory: XibFactory()) .using(UINavigationController.pushToNavigation()) .from(loginScreen.expectingContainer()) .assemble() 

आप नेविगेशन में ForgotPasswordViewController और LoginViewController ForgotPasswordViewController लिए उदाहरण का उपयोग कर सकते हैं

उपरोक्त उदाहरण में expectingContainer क्यों expectingContainer रही है?

चूँकि pushToNavigation क्रिया के लिए UINavigationController की उपस्थिति की आवश्यकता होती है और इसके बाद के कॉन्फ़िगरेशन में, expectingContainer है कि हमें विधि यह सुनिश्चित करके एक संकलन त्रुटि से बचने की अनुमति देती है कि हम ध्यान रखें कि जब राउटर loginScreen में loginScreen पहुंचता loginScreen , तो UINavigationController होगा।

क्या होगा अगर ऊपर विन्यास में मैं GeneralStep.current को GeneralStep.root बदल GeneralStep.root ?

यह काम करेगा, लेकिन जब से आप राउटर को बताते हैं कि आप चाहते हैं कि रूट UIViewController से एक चेन बनाना शुरू कर दे, अगर इसके ऊपर कोई मोडल UIViewController खुलता है, तो राउटर आपको चेन बनाना शुरू करने से पहले छिपा देगा।

मेरे आवेदन में टैब के रूप में HomeViewController और BagViewController युक्त UITabBarController । मैं चाहता हूं कि उपयोगकर्ता हमेशा की तरह टैब पर आइकन का उपयोग करके उनके बीच स्विच कर सकें। लेकिन अगर मैं कॉन्फ़िगरेशन को प्रोग्रामेटिक रूप से कॉल करता हूं (उदाहरण के लिए, उपयोगकर्ता HomeViewController अंदर "Go to Bag" पर क्लिक करता है), एप्लिकेशन को टैब स्विच नहीं करना चाहिए, लेकिन BagViewController को BagViewController दिखाना चाहिए।

कॉन्फ़िगरेशन में इसे प्राप्त करने के 3 तरीके हैं:

1. StackIteratingFinder को केवल [.current, .vouble] का उपयोग करके दृश्यमान लोगों में खोजने के लिए सेट करें।
2. NilFinder उपयोग करें जिसका अर्थ है कि राउटर को BagViewController में BagViewController कभी नहीं मिलेगा और हमेशा इसे बनाएगा। हालांकि, इस दृष्टिकोण का एक साइड इफेक्ट है - अगर, उदाहरण के लिए, BagViewController में पहले से ही एक उपयोगकर्ता को BagViewController से प्रस्तुत किया गया है, और, उदाहरण के लिए, एक सार्वभौमिक लिंक पर क्लिक करता है जिसे BagViewController उसे दिखाना चाहिए, तो राउटर इसे नहीं BagViewController और दूसरा उदाहरण BagViewController इसके ऊपर दिखाएगा। मोडल। यह वह नहीं हो सकता जो आप चाहते हैं।
3. थोड़ा ClassFinder बदलें ताकि यह केवल BagViewController को BagViewController दिखाए और बाकी को अनदेखा कर BagViewController , और पहले से ही कॉन्फ़िगरेशन में इसका उपयोग कर सके।

 struct ModalBagFinder: StackIteratingFinder { func isTarget(_ viewController: BagViewController, with context: Any?) -> Bool { return viewController.presentingViewController != nil } } let screen = StepAssembly( finder: ModalBagFinder(), factory: XibFactory()) .using(UINavigationController.pushToNavigation()) .from(NavigationControllerStep()) .using(GeneralAction.presentModally()) .from(GeneralStep.current()) .assemble() 

एक निष्कर्ष के बजाय

मुझे उम्मीद है कि राउटर को कॉन्फ़िगर करने के तरीके कुछ हद तक स्पष्ट हो गए हैं। जैसा कि मैंने कहा, हम 3 एप्लिकेशन में इस दृष्टिकोण का उपयोग करते हैं और अभी तक ऐसी स्थिति का सामना नहीं किया है जहां यह पर्याप्त लचीला नहीं है। पुस्तकालय, साथ ही साथ प्रदान किए गए राउटर के कार्यान्वयन, रनटाइम के साथ किसी भी उद्देश्य चाल का उपयोग नहीं करता है और पूरी तरह से सभी कोको टच अवधारणाओं का पालन करता है, केवल रचना प्रक्रिया को चरणों में तोड़ने में मदद करता है और उन्हें दिए गए अनुक्रम में निष्पादित करता है और iOS 9 से 12. के साथ परीक्षण किया जाता है। , यह दृष्टिकोण उन सभी वास्तुशिल्प पैटर्न में फिट बैठता है जिसमें UIViewController स्टैक (MVC, MVVM, VIP, RIB, VIPER, आदि) के साथ काम करना शामिल है।

मुझे आपकी टिप्पणियों और सुझावों के लिए खुशी होगी। खासकर अगर आपको लगता है कि कुछ पहलुओं पर अधिक विस्तार से ध्यान देना उचित है। शायद संदर्भों की अवधारणा को स्पष्टीकरण की आवश्यकता है।