iOS 8 - विजेट

IOS 8 की रिलीज़ के साथ, डेवलपर्स के पास टुडे स्क्रीन के लिए अपने स्वयं के विजेट बनाने का अवसर है। अब तक, एपीआई अंत में बंद नहीं हुआ है, एक ज्ञात समस्या है और प्रलेखन में वर्णित कई क्षण नहीं हैं। लेकिन अगर आप अभी भी अपना विजेट बनाना चाहते हैं, तो मैं एक कट (नोट, स्विफ्ट उदाहरणों में उपयोग किया जाता है) के लिए पूछता हूं।

एक्सटेंशन

IOS ने एक नई अवधारणा पेश की - एक्सटेंशन। एक्सटेंशन आपको एप्लिकेशन के बाहर कुछ सामग्री और कार्यक्षमता उपलब्ध कराने की अनुमति देता है।

एक्सटेंशन का समर्थन करने वाले सिस्टम के हिस्से को एक्सटेंशन प्वाइंट कहा जाता है। निम्नलिखित विस्तार बिंदु iOS के लिए उपलब्ध है:

• आज (अधिसूचना केंद्र) - जल्दी से एक कार्रवाई करते हैं या अधिसूचना केंद्र में आज स्क्रीन के माध्यम से जानकारी प्राप्त करते हैं
• शेयर - किसी भी साइट पर दोस्तों के साथ या फ़ीड में सामग्री साझा करें
• कार्रवाई - किसी अन्य एप्लिकेशन के संदर्भ में सामग्री को देखें या प्रबंधित करें
• फोटो एडिटिंग - फोटो ऐप के अंदर फोटो या वीडियो को एडिट करें
• स्टोरेज प्रोवाइडर - वर्तमान एप्लिकेशन के लिए उपलब्ध दस्तावेजों के सेट से एक दस्तावेज़ का चयन करें
• कस्टम कीबोर्ड - सभी अनुप्रयोगों में उपयोग के लिए अपने मूल iOS कीबोर्ड को अपने साथ बदलें

एक्सटेंशन केवल एक्सटेंशन कंटेनर में वितरित किए जा सकते हैं, जो एक नियमित एप्लिकेशन का बंडल है। एक कंटेनर में कई एक्सटेंशन हो सकते हैं।

यह ध्यान दिया जाना चाहिए कि एक्सटेंशन एक विशेष प्रकार की बाइनरी फाइलें हैं। यह एक आवेदन नहीं है!
दुर्भाग्य से, एक्सटेंशन ऐप को ऐप आईपीसी (पाइप, सॉकेट, ...) का समर्थन नहीं करते हैं, और इसलिए आपको परिचित [UIApplication OpenURL] का उपयोग करने की आवश्यकता है: (अब यह एक्सटेंशन के लिए काम नहीं करता है, ज्ञात समस्या देखें) या, उदाहरण के लिए, ऐप समूह ।

प्रत्येक एक्सटेंशन एक अलग प्रक्रिया में चलता है। इस प्रकार, विभिन्न अनुप्रयोगों के संदर्भ में समान एक्सटेंशन अलग-अलग प्रक्रियाएं हैं, और आपको सिंक्रनाइज़ेशन समस्याओं के बारे में चिंता करने की आवश्यकता नहीं है।

एक्सटेंशन प्रलेखन यहाँ है ।

विजेट

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

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

कंटेनर और विजेट के बीच का संबंध NotificationCenter.framework के माध्यम से है।

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

विजेट को हमेशा अपडेट रहने के लिए, iOS कभी-कभी विजेट स्नैपशॉट बनाता है। जब विजेट फिर से दिखाई देता है, तो आखिरी स्नैपशॉट पहले दिखाया जाता है, और उसके बाद ही असली विजेट विंडो। स्नैपशॉट से पहले अपने राज्य को अपडेट करने के लिए विजेट के लिए, NCWidgetProviding प्रोटोकॉल का उपयोग किया जाता है ।

protocol NCWidgetProviding : NSObjectProtocol { // Called to allow the client to update its state prior to a snapshot being taken, or possibly other operations. // Clients should call the argument block when the work is complete, passing the appropriate 'NCUpdateResult'. @optional func widgetPerformUpdateWithCompletionHandler(completionHandler: ((NCUpdateResult) -> Void)!) // Clients wishing to customize the default margin insets can return their preferred values. // Clients that choose not to implement this method will receive the default margin insets. @optional func widgetMarginInsetsForProposedMarginInsets(defaultMarginInsets: UIEdgeInsets) -> UIEdgeInsets } 

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

• NCUpdateResultNewData - नई सामग्री के लिए विंडो अपडेट की आवश्यकता होती है
• NCUpdateResultNoData - विजेट को अपडेट करने की आवश्यकता नहीं है
• NCUpdateResultFailed - अद्यतन प्रक्रिया के दौरान एक त्रुटि हुई

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

अधिसूचना केंद्र विजेट की चौड़ाई निर्धारित करता है, जबकि विजेट स्वयं इसकी ऊंचाई निर्धारित करता है। ऊँचाई निर्धारित करने के लिए, विजेट ऑटो लेआउट या पसंद किया जा सकता है UIViewController उदाहरण से संबंधित संपत्ति।

 override func viewDidLoad() { super.viewDidLoad() self.preferredContentSize.height = 350 } 

यह पता चलता है कि विगेट्स के लिए निम्नलिखित आवश्यकताएं हैं:

• सुनिश्चित करें कि प्रदर्शित सामग्री अद्यतित है
• उपयोगकर्ता कार्यों के लिए उचित जवाब
• जितना संभव हो उतना कम संसाधनों का उपभोग करें (आईओएस एक विजेट को मार सकता है यदि यह बहुत अधिक मेमोरी का उपभोग करता है)

कृपया ध्यान दें कि विजेट UI में निम्नलिखित सीमाएँ हैं:

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

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

विजेट बातचीत

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

 NCWidgetController.widgetController().setHasContent(true, forWidgetWithBundleIdentifier: "com.e-legion.Traffic.Widget") 

इस वर्ग का उपयोग विजेट और कंटेनर एप्लिकेशन से किया जा सकता है।

कंटेनर एप्लिकेशन के साथ डेटा का आदान-प्रदान

कंटेनर के साथ संवाद करने के लिए, NSExtensionContext वस्तु का उपयोग किया जाता है, जो कि UIViewController के स्वामित्व वाली एक्सटेंशनकॉन्टेक्स संपत्ति के माध्यम से सुलभ है।

 class NSExtensionContext : NSObject { // The list of input NSExtensionItems associated with the context. If the context has no input items, this array will be empty. var inputItems: AnyObject[]! { get } // Signals the host to complete the app extension request with the supplied result items. The completion handler optionally contains any work which the extension may need to perform after the request has been completed, as a background-priority task. The `expired` parameter will be YES if the system decides to prematurely terminate a previous non-expiration invocation of the completionHandler. Note: calling this method will eventually dismiss the associated view controller. func completeRequestReturningItems(items: AnyObject[]!, completionHandler: ((Bool) -> Void)!) // Signals the host to cancel the app extension request, with the supplied error, which should be non-nil. The userInfo of the NSError will contain a key NSExtensionItemsAndErrorsKey which will have as its value a dictionary of NSExtensionItems and associated NSError instances. func cancelRequestWithError(error: NSError!) // Asks the host to open an URL on the extension's behalf func openURL(URL: NSURL!, completionHandler: ((Bool) -> Void)!) } 

यानी, विजेट से कंटेनर एप्लिकेशन को खोलने के लिए, कंटेनर को स्कीम को पंजीकृत करना होगा (उदाहरण के लिए, "ट्रैफ़िक: //"), और आपको विजेट कोड में जोड़ना होगा

 self.extensionContext.openURL(NSURL(string: "traffic://"), completionHandler: nil) 

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

परिणामस्वरूप, एंटाइटेलमेंट फ़ाइल में निम्नलिखित सामग्री होगी:

 <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> <key>com.apple.security.application-groups</key> <array> <string>group.96GT47C53G.traffic</string> </array> </dict> </plist> 

96GT47C53G पर ध्यान दें। यह डेवलपमेंट टीम आईडी है। आप इसे अपनी प्रोफ़ाइल में देख सकते हैं। सिम्युलेटर पर चलने के लिए, आप किसी भी मूल्य का उपयोग कर सकते हैं, उदाहरण के लिए, group.traffic, ...

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

 NSFileManager.defaultManager().containerURLForSecurityApplicationGroupIdentifier("group.96GT47C53G.traffic") 

उदाहरण

तो, आइए एक विजेट बनाने की कोशिश करें जो ट्रैफिक जाम के साथ एक नक्शा दिखाएगा। हम Yandex.Maps API का उपयोग करके चित्र के रूप में ट्रैफ़िक जानकारी प्राप्त करेंगे।

एक तस्वीर प्राप्त करने के लिए एक लिंक का एक उदाहरण: http://static-maps.yandex.ru/1.x/?ll=30.35,59.9690273&spn=0.01,0.2&size=300,250&l-map,trf
दरअसल, लेट और लोन मैप का केंद्र होते हैं, और spn डिग्री में मैप डिस्प्ले एरिया की सीमा होती है।

प्रोजेक्ट के लिए सोर्स कोड GitHub पर उपलब्ध है ।

एक कंटेनर एप्लिकेशन बनाएं

कंटेनर का कार्य उपयोगकर्ता को विजेट को कॉन्फ़िगर करने की क्षमता देना है, अर्थात् मानचित्र पर एक क्षेत्र का चयन करने के लिए। इस प्रकार, एप्लिकेशन में एक क्षेत्र और एक "सेट फ्रेम" बटन का चयन करने के लिए एक मानचित्र दृश्य होगा, जो इस क्षेत्र को विजेट में स्थानांतरित कर देगा।


एप्लिकेशन को उपयोगकर्ता को lat, lon, spn पैरामीटर का चयन करने और उन्हें विजेट में पास करने के लिए सक्षम करना चाहिए। निम्न कोड ऐसा करता है:

 @IBAction func updateWidgetButtonTapped(sender : AnyObject) { var dict : NSMutableDictionary = NSMutableDictionary() dict["spn"] = self.mapView.region.span.latitudeDelta dict["lat"] = self.mapView.region.center.latitude dict["lon"] = self.mapView.region.center.longitude var dictUrl : NSURL = NSFileManager.defaultManager().containerURLForSecurityApplicationGroupIdentifier("group.96GT47C53G.traffic").URLByAppendingPathComponent("settings.dict") dict.writeToFile(dictUrl.path, atomically: true) NCWidgetController.widgetController().setHasContent(true, forWidgetWithBundleIdentifier: "com.e-legion.Traffic.Widget") } 

विजेट जोड़ें

विजेट जोड़ना एक नया लक्ष्य जोड़ने के लिए नीचे आता है।
File-> New-> Target पर क्लिक करें और iOS-> Application Extension-> Today Extension चुनें।



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

 init(coder aDecoder: NSCoder!) { super.init(coder: aDecoder) } 

टेम्पलेट से Info.plist फ़ाइल पर ध्यान दें। इसमें NSExtension कुंजी है, जो कुछ विजेट मापदंडों को परिभाषित करता है।

 <key>NSExtension</key> <dict> <key>NSExtensionMainStoryboard</key> <string>MainInterface</string> <key>NSExtensionPointIdentifier</key> <string>com.apple.widget-extension</string> </dict> 

NSExtensionMainStoryboard स्टोरीबोर्ड का नाम स्टोर करता है जो विजेट के लिए नियंत्रक को संग्रहीत करता है। NSExtensionPrincipalClass के साथ NSExtensionMainStoryboard कुंजी की जगह और मूल्य के रूप में नियंत्रक के नाम का उपयोग करके नियंत्रक को स्पष्ट रूप से निर्दिष्ट किया जा सकता है।

प्रत्येक विजेट में थोड़ी बाईं ओर बदलाव होता है। यदि आप इसे से छुटकारा पाना चाहते हैं, तो आपको widgetMarginInsetsForProposedMarginInsets विधि में वांछित UIEdgeInsets लौटाना होगा।

  func widgetMarginInsetsForProposedMarginInsets(defaultMarginInsets: UIEdgeInsets) -> UIEdgeInsets { return UIEdgeInsets(top: 0, left: 0, bottom: 0, right: 0) } 

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

निष्कर्ष

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