हम iPhone के लिए Yandex.Metrics के लिए एक क्लाइंट लिख रहे हैं

जैसा कि आप में से बहुत से लोग जानते हैं, Yandex.Metrica में एक अद्भुत API है जो आपको XML या JSON में अपने काउंटरों पर डेटा प्राप्त करने की अनुमति देता है।

लंबे समय तक, मेरे हाथों ने मोबाइल क्लाइंट लिखने के लिए अपने हाथों को खरोंच दिया, क्योंकि दिन के दौरान मैं अक्सर उन संसाधनों की उपस्थिति को देखता हूं जो मैं करता हूं।

IPhone के लिए मौजूदा क्लाइंट मेरे लिए भयानक लग रहे थे और आखिरकार मेरे हाथों ने खरोंच करना बंद कर दिया और लिखना शुरू कर दिया

क्लाइंट बनाना निम्नलिखित चरणों में विभाजित किया जा सकता है:

1. यैंडेक्स में आवेदन रजिस्टर करें
2. OAuth उपयोगकर्ता प्राधिकरण और टोकन प्राप्त कर रहा है
3. टोकन सहेज रहा है
4. विभिन्न डेटा प्राप्त करना
5. प्रदर्शन

पंजीकरण

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

OAuth प्राधिकरण

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

तकनीकी रूप से, OAuth प्रमाणीकरण काफी सरल है - हम अपनी खुद की URL-योजना को आवेदन में जोड़ते हैं (उदाहरण के लिए, myapp), Yandex वेबसाइट पर एप्लिकेशन सेटिंग्स में (जहाँ आवेदन पंजीकृत था), myapp: // जैसी कुछ चीज़ों को निर्दिष्ट करें: Caller URI के रूप में, जिसके बाद हम इसलिए कोड देते हैं कि प्राधिकरण के बाद एप्लिकेशन myl पर url खोलने की कोशिश करता है: //, इसलिए url हमारे एप्लिकेशन में खुलेगा, और इसमें पहले से ही access_token सहित सभी डेटा हैं।
Habré पर सिर्फ इस तरह के प्राधिकरण और यैंडेक्स के लिए सटीक रूप से एक उत्कृष्ट लेख है , जिसने मुझे समय बचाया, इसलिए मैं विशेष रूप से प्राधिकरण का वर्णन नहीं करूंगा, ताकि दोहराया न जाए। प्राधिकरण के बाद, हमारे पास एक टोकन है, जिसे हम बचाएंगे।

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

NSHTTPCookie *cookie; NSHTTPCookieStorage *storage = [NSHTTPCookieStorage sharedHTTPCookieStorage]; for (cookie in [storage cookies]) { [storage deleteCookie:cookie]; } [NSUserDefaults standardUserDefaults] synchronize]; 

टोकन सहेज रहा है

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

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

खैर, अब टोकन को सहेजना और हटाना कुछ लाइनों में कम हो गया है:

 //  KeychainItemWrapper *keychainWrapper = [[KeychainItemWrapper alloc] initWithIdentifier:@"OAuthToken" accessGroup:nil]; [keychainWrapper setObject:@"accountName" forKey:(__bridge id)(kSecAttrAccount)]; [keychainWrapper setObject:tokenToSave forKey:(__bridge id)(kSecValueData)]; 

 //  KeychainItemWrapper *keychainWrapper = [[KeychainItemWrapper alloc] initWithIdentifier:@"OAuthToken" accessGroup:nil]; [keychainWrapper resetKeychainItem]; 

विभिन्न डेटा प्राप्त करना

व्यक्तिगत रूप से, मुझे JSON में डेटा प्राप्त करना अधिक पसंद है। अनुरोधों के साथ सब कुछ काफी सरल है - हम एपीआई से विधि के लिए आवश्यक अनुरोध भेजते हैं, हम शीर्षक में OAuth <access_token> प्राधिकरण शामिल करते हैं। वैसे, टोकन को गेट-पैरामीटर के रूप में भी पारित किया जा सकता है, उदाहरण के लिए:
api-metrika.yandex.ru/counters?oauth_token=<access_token>

चूंकि हम सुरक्षा के बारे में शुरू से ही पागल हैं, तो सभी अनुरोधों को https के माध्यम से भेजा जा सकता है (लेकिन यह http के माध्यम से भी हो सकता है)। हम JSON में डेटा प्राप्त करते हैं, इसे अंतर्निहित NSJSONSerialization के माध्यम से पार्स करते हैं:

 dataObject = [NSJSONSerialization JSONObjectWithData:result options:NSJSONReadingMutableContainers error:&e]; 

परिणाम, उदाहरण के लिए, काउंटरों की सूची प्राप्त करने के लिए:

ठीक है, फिर प्राप्त आंकड़ों को किसी तरह प्रदर्शित करने की आवश्यकता है।

प्रदर्शन

यदि आप मीट्रिक वेब-इंटरफ़ेस को देखते हैं, तो मूल रूप से 2 डेटा प्रतिनिधित्व हैं - पाठ डेटा और ग्राफ़ के साथ तालिकाएं।
तालिकाओं के साथ सब कुछ स्पष्ट प्रतीत होता है - हम UITableView का उपयोग करते हैं। लगभग सभी डेटा में समान सामान्य संकेतक होते हैं - दृश्य, विज़िट, अद्वितीय आगंतुक, गहराई को देखने, साइट पर समय और उछाल दर। इसलिए, मैंने UITableViewCell का एक वंशज वर्ग बनाया ताकि UIViewController में से प्रत्येक में एक ही कोड का एक गुच्छा उत्पन्न न हो और फिर विधि में
- (UITableViewCell *) tableView: (UITableView *) tableView सेलफोरराउट IndexPath: (NSIndexPath *) indexPath
हम केवल पहले से प्राप्त डेटा के साथ एक सेल बनाते हैं, उदाहरण के लिए:

 NSString *CellIdentifier = [NSString stringWithFormat:@"CellId_%li_%li", (long)indexPath.section, (long)indexPath.row]; SourcesTableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:CellIdentifier]; if ( cell == nil ) { cell = [[SourcesTableViewCell alloc] initWithStyle:UITableViewCellStyleDefault reuseIdentifier:CellIdentifier textOnLabel:@"" labelTextColor:[UIColor black]]; } //   [cell changeValuesWithpageViewsNum:pageViewsNum visitTime:visitTime denials:denialsValue visitsNum:visitsNum ]; 

साइट पर बिताया गया समय वैसे भी सेकंड में वापस आ जाता है, इसलिए इसे अभी भी मिमी: एसएस प्रारूप में खूबसूरती से प्रदर्शित करना होगा, और विफलता की दर 0 से 1 तक है, इसलिए 50% 0.5 के रूप में वापस आ जाएगी।

ड्राइंग रेखांकन के लिए, कई तैयार किए गए समाधान हैं। कुछ, फिर से, हैबे पर पाया जा सकता है । व्यक्तिगत रूप से, मुझे गिन्थ पर PNChart पसंद आया - न्यूनतम, सुंदर। हम कोकोपोड्स से जुड़ते हैं और चलते हैं।

PNChart में चार्ट बनाने के उदाहरण गितुब पर प्रोजेक्ट पेज पर हैं।

हम सब कुछ UITabsViewController में बनाते हैं, थोड़ा बाहर करते हैं और आउटपुट के रूप में आपकी जेब में तेजी से आंकड़े प्राप्त करते हैं।


मैंने परिणाम को AppStore पर अपलोड करने का निर्णय लिया, कोई भी इसे स्थापित कर सकता है ।

विकास जारी रखने के लिए एक प्रोत्साहन के लिए, मैंने आवेदन का भुगतान किया। मैं 10 प्रचार कोड संलग्न कर रहा हूं:
A49RNFA4W6KR
37LWRW7TYH36
RMPHML3EL6EL
JKWWFATEJ4YE
4RETFRLEPRFW
AWKN4LYRM4LK
L4K6NJNTN4RJ
NT9Y97HN7HKA
TRPXHFXX47PE
E96MN3JP9X9Y

उपयोगी लिंक:
CocoaPods एक उद्देश्य-सी डेवलपर के हाथों में एक शक्तिशाली उपकरण है
IOS में Yandex OAuth प्राधिकरण
PNChart (चार्टिंग)
कीचैनइमवॅपर ( कीचेन के आसपास रैपर)