IOS के लिए फेसबुक एसडीके के साथ शुरुआत करना

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

जब मैंने लगभग एक साल पहले फेसबुक एसडीके को समझना शुरू किया था, तब भी फेसबुक-आईफोन-एसडीके नामक एक संस्करण था। वह अब काम कर रही है। लेकिन मैंने एप्लिकेशन में अजीब दुर्घटनाओं को नोटिस करना शुरू कर दिया और यह जांचने का फैसला किया कि क्या कुछ नया सामने आया है। यह परियोजना पतित हो गई, और डेवलपर्स को अब facebook-ios-sdk का उपयोग करने की सिफारिश की जाती है, जहां, जैसा कि कहा गया है, यह अभी भी सरल है। और जैसा कि यह निकला, वे झूठ नहीं बोलते थे।


आप यहाँ से SDK - https://github.com/facebook/facebook-ios-sdk डाउनलोड कर सकते हैं

Xcode 4.0 उपयोगकर्ता सीधे SDK को विकास के वातावरण से डाउनलोड कर सकते हैं। ऐसा करने के लिए, ऑर्गनाइज़र खोलें, रिपॉजिटरी सेक्शन पर जाएँ, और निचले बाएँ कोने में प्लस साइन के बाद, चेकआउट या क्लोन रिपोजिटरी चुनें।



नमूना निर्देशिका में एक डेमो एप्लिकेशन है, जिसे हम थोड़ा संशोधित करेंगे और इसके साथ सौदा करेंगे। लेकिन उसे तुरंत शुरू करने की कोशिश करते समय एक समस्या थी। कुछ प्रोजेक्ट पैरामीटर नए Xcode4 में इसके संकलन में हस्तक्षेप करते हैं और गलत आर्किटेक्चर के बारे में एक त्रुटि उत्पन्न होती है। आपको परियोजना सेटिंग्स में जाने की जरूरत है और बस आर्किटेक्चर अनुभाग में सब कुछ मारना है और फिर परियोजना से केवल दो मापदंडों को पुनर्स्थापित करना है:
वास्तुकला - मानक (हथियार 6, हथियार 7)
BaseSDK - नवीनतम iOS (iOS 4.3)



यदि यह काम नहीं करता है, तो मैं नीचे एक कार्य प्रारूप संलग्न कर रहा हूं।

उसके बाद, हमारी परियोजना का निर्माण शुरू होता है, सिम्युलेटर में चलता है और तुरंत दुर्घटनाग्रस्त हो जाता है, सांत्वना का संकेत देता है - "2011-03-29 11: 49: 02.301 डेमोएप [3098: 207] लापता ऐप आईडी!"। ऐसा इसलिए है क्योंकि हमने अपने आवेदन की आईडी निर्दिष्ट नहीं की है।

हम http://www.facebook.com/developers/ पर जाते हैं और या तो अपने मौजूदा एप्लिकेशन का चयन करते हैं या "+ नया एप्लिकेशन बनाएं" बटन पर क्लिक करते हैं। एक सरल पंजीकरण के बाद, सिस्टम आपको अन्य बातों के अलावा, "एप्लीकेशन आईडी" बताएगा। उसे और केवल हमें एसडीके के नए संस्करण में उसकी आवश्यकता है। फ़ाइल में DemoAppViewController.m हम निम्नलिखित पाठ देख सकते हैं:

// Your Facebook APP Id must be set before running this example
// See www.facebook.com/developers/createapp.php
// Also, your application must bind to the fb[app_id]:// URL
// scheme (substitue [app_id] for your real Facebook app id).
static NSString* kAppId = nil;

हमारे आवेदन आईडी के साथ शून्य बदलें। यह मत भूलो कि यह एक स्ट्रिंग है। उदाहरण के लिए हमारी आईडी 11111111111 है

static NSString* kAppId = @"11111111111";

हम विन्यास फाइल रिसोर्स / डेमोएप-इन्फो.प्लिस्ट में जाते हैं और हमारे fb111111111 के साथ चित्र में मान fb [your-app-id] को प्रतिस्थापित करते हैं - और कोष्ठक आपको भ्रमित नहीं करना चाहिए, आपको उनके बिना मूल्य निर्धारित करने की आवश्यकता है!



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







सबसे पहले, XIB फ़ाइल पर एक नज़र डालें।



यह अत्यंत सरल है - 5 बटन। जब अनुप्रयोग शुरू होता है, तो केवल FBLoginButton दिखाया जाता है - यह उसी नाम के वर्ग द्वारा नियंत्रित किया जाता है जिसे प्रोजेक्ट में जोड़ा जाता है। ViewDidLoad विधि पर एक नज़र डालें

/**
* Set initial view
*/
(void)viewDidLoad {
// facebook
_facebook = [[Facebook alloc] initWithAppId:kAppId];
[self.label setText:@"Please log in"];
//
_getUserInfoButton.hidden = YES;
_getPublicInfoButton.hidden = YES;
_publishButton.hidden = YES;
_uploadPhotoButton.hidden = YES;
_fbButton.isLoggedIn = NO;
[_fbButton updateImage];
}

ध्यान दें कि अब फेसबुक वर्ग के किसी ऑब्जेक्ट को इनिशियलाइज़ करना कितना आसान है - आपको एप्लिकेशन आईडी और उसकी आवश्यकता है।

_facebook = [[Facebook alloc] initWithAppId:kAppId];

जब बटन दबाया जाता है, तो विधि कहा जाता है:

/**
* Called on a login/logout button click.
*/
- (IBAction)fbButtonClick:(id)sender {
if (_fbButton.isLoggedIn) {
[self logout];
} else {
[self login];
}
}

और अगर हमने अभी तक प्रवेश नहीं किया है, तो हम विधि कहते हैं:

/**
* Show the authorization dialog.
*/
- (void)login {
[_facebook authorize:_permissions delegate:self];
}

जहां _permissions फेसबुक पर विभिन्न कार्यों के लिए अनुमतियाँ हैं। हमारे उदाहरण में, हम अपने नियंत्रक को आरंभीकृत करते समय अधिकार मांगते हैं

- (id)initWithNibName:(NSString *)nibNameOrNil bundle:(NSBundle *)nibBundleOrNil {

...
_permissions = [[NSArray arrayWithObjects:
@"read_stream", @"offline_access",nil] retain];
}

...
}

यहाँ प्रलेखन के अनुसार - http://developers.facebook.com/docs/authentication/permissions/ , read_stream फ़ीड पढ़ने का अधिकार है, और offline_access आपके आवेदन के लिए बहुत लंबे समय तक जुड़े रहने की क्षमता है। इस अधिकार के बिना, एक्सेस टोकन काफी तेज़ी से बाहर जलेंगे। हम थोड़ी देर बाद इस विषय पर लौटेंगे। वैसे, यह इन अधिकारों की पुष्टि थी जो हमने अनुरोध किया था जब हमने ऊपर अनुमति बटन पर क्लिक किया था।

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

एक और बहुत महत्वपूर्ण बिंदु संबंधित है कि हम प्राधिकरण के बाद अपने आवेदन पर कैसे लौटते हैं। याद रखें, हमने संसाधन / DemoApp-Info.plist फ़ाइल में ऊपर कुछ पैरामीटर दर्ज किए हैं। और अगर हम फाइल को DemoAppAppDelegate.m में देखते हैं तो हम वहां एक छोटा सा तरीका देखेंगे, जो हमारे आवेदन पर वापस आने के लिए जिम्मेदार है।

- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url {
return [[controller facebook] handleOpenURL:url];
}

इसलिए संक्षेप में। यदि आप खरोंच से आवेदन करेंगे, तो एसडीके के सफल संचालन के लिए आपको निश्चित रूप से आवश्यकता होगी

1. कोड में ऐप आईडी को इंडिकेट करें
2. अपने एप्लिकेशन के पैरामीटर फ़ाइल में ऐप आईडी निर्दिष्ट करें
3. अपने आवेदन के * AppDelegate.m में, विधि को लागू करें

- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url {
return [[controller facebook] handleOpenURL:url];
}

अंतिम दो बिंदुओं के बिना, आप प्राधिकरण विंडो के बाद अपने आवेदन पर नहीं लौटेंगे।

इस बात पर निर्भर करता है कि आपने आवेदन के साथ क्या लौटाया, तीन तरीकों में से एक जिसे हमने एक प्रतिनिधि के रूप में स्थापित किया है।
/**
* , .
*/
- (void)fbDidLogin {
[self.label setText:@"logged in"];
_getUserInfoButton.hidden = NO;
_getPublicInfoButton.hidden = NO;
_publishButton.hidden = NO;
_uploadPhotoButton.hidden = NO;
_fbButton.isLoggedIn = YES;
[_fbButton updateImage];
}

/**
* , .
*/
-(void)fbDidNotLogin:(BOOL)cancelled {
NSLog(@"did not login");
}

/**
* , logout .
*/
- (void)fbDidLogout {
[self.label setText:@"Please log in"];
_getUserInfoButton.hidden = YES;
_getPublicInfoButton.hidden = YES;
_publishButton.hidden = YES;
_uploadPhotoButton.hidden = YES;
_fbButton.isLoggedIn = NO;
[_fbButton updateImage];
}

चूंकि हमने सफलतापूर्वक लॉग इन किया था, इसलिए हमारे अन्य सभी बटन स्क्रीन पर दिखाई दिए। आप सीख सकते हैं कि वे क्या कर रहे हैं; हम बाद में और अधिक विस्तार से उनके पास लौटेंगे। उदाहरण के लिए, कॉल ग्राफ एपीआई बटन आपको अपना पहला और अंतिम नाम दिखाएगा, और कॉल रीस्ट एपीआई बटन आपको आईडी = 4 में व्यक्ति का पहला और अंतिम नाम माइक ज़करबर्ग दिखाएगा। आईडी = 1 के तहत कौन छुपा रहा है, यह पता लगाने का प्रयास असफल रहा और एप्लिकेशन क्रैश हो गया। तो, जो लोग इस मुद्दे का अध्ययन कर सकते हैं वे अपने दम पर करना चाहते हैं। और जब मैं अंतिम पैराग्राफ लिख रहा था, तो मुझे कम से कम कई बार लॉगिन बटन को फिर से दबाना पड़ा। ऐसा क्या किया जा सकता है कि एक बार जब आप आवेदन में लॉग इन करते हैं, तो आपको फिर से फेसबुक पर लॉग इन करने की आवश्यकता नहीं है। अब इसे करते हैं। इसके लिए हमें बस जरूरत है कि हम NSUserDefaults में दो वेरिएबल्स के मूल्यों को स्टोर करें। viewDidLoad इस तरह दिखेगा:

- (void)viewDidLoad {
_facebook = [[Facebook alloc] initWithAppId:kAppId];

_facebook.accessToken = [[NSUserDefaults standardUserDefaults] stringForKey:@"AccessToken"];
_facebook.expirationDate = (NSDate *) [[NSUserDefaults standardUserDefaults] objectForKey:@"ExpirationDate"];

if ([_facebook isSessionValid] == NO) {
[self.label setText:@"Please log in"];
_getUserInfoButton.hidden = YES;
_getPublicInfoButton.hidden = YES;
_publishButton.hidden = YES;
_uploadPhotoButton.hidden = YES;
_fbButton.isLoggedIn = NO;
[_fbButton updateImage];
} else {
[self.label setText:@"logged in"];
_getUserInfoButton.hidden = NO;
_getPublicInfoButton.hidden = NO;
_publishButton.hidden = NO;
_uploadPhotoButton.hidden = NO;
_fbButton.isLoggedIn = YES;
[_fbButton updateImage];
}
}

हम जांचते हैं कि (isSessionValid) सत्र हमारे NSUserDefaults में संग्रहीत AccessToken और expirationDate मापदंडों के साथ मान्य है या नहीं। यदि ऐसा है, तो हम पहले से ही लॉग इन हैं और आगे की कार्रवाई कर सकते हैं।

हम क्रमशः fbDidLogin और fbDidLogout विधियों में जोड़ देंगे

fbDidLogin - पैरामीटर लिखें

[[NSUserDefaults standardUserDefaults] setObject:self.facebook.accessToken forKey:@"AccessToken"];
[[NSUserDefaults standardUserDefaults] setObject:self.facebook.expirationDate forKey:@"ExpirationDate"];

fbDidLogout - उन्हें शून्य करें

[[NSUserDefaults standardUserDefaults] setObject:nil forKey:@"AccessToken"];
[[NSUserDefaults standardUserDefaults] setObject:nil forKey:@"ExpirationDate"];

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

और आज के लेख को समाप्त करने के लिए, आइए देखें कि क्वेरी तंत्र और प्रतिक्रिया प्रसंस्करण कैसे काम करते हैं।

Facebook हमें पुराने REST API का उपयोग करने के बजाय GRAPH API का उपयोग करने का आग्रह करता है, जो अभी भी समर्थित नहीं है। इस पृष्ठ पर ( http://developers.facebook.com/docs/reference/api/ ) हम GRAPH API का उपयोग करने के उदाहरण देख सकते हैं और आपके लिए आउटपुट देख सकते हैं। डेमो कार्यक्रम में, फेसबुक निम्नलिखित अनुरोध का उपयोग करता है:

- (IBAction)getUserInfo:(id)sender {
[_facebook requestWithGraphPath:@"me" andDelegate:self];
}

उदाहरण के लिए, वे बताते हैं कि इस तरह के अनुरोध के साथ आउटपुट क्या होगा
graph.facebook.com/btaylor

{
"Id": "220439",
"नाम": "ब्रेट टेलर",
"First_name": "ब्रेट",
"अंतिम_नाम": "टेलर",
"लिंक": " www.facebook.com/btaylor ",
"उपयोगकर्ता नाम": "btaylor",
"लिंग": "पुरुष",
"लोकेल": "en_US"
}

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

- (void)request:(FBRequest *)request didReceiveResponse:(NSURLResponse *)response {
NSLog(@"received response");
}

और पार्स किया गया उत्तर स्वीकार करता है:

- (void)request:(FBRequest *)request didLoad:(id)result {
if ([result isKindOfClass:[NSArray class]]) {
result = [result objectAtIndex:0];
}
if ([result objectForKey:@"owner"]) {
[self.label setText:@"Photo upload Success"];
} else {
[self.label setText:[result objectForKey:@"name"]];
}
};

उत्तर (परिणाम) एक संख्या, एक स्ट्रिंग, एक सरणी या एक शब्दकोश हो सकता है। यदि हमें NSArray के रूप में तुरंत एक उत्तर मिला, तो हमें एक ही बार में कई उत्तर मिल गए और हमें उन्हें अलग-अलग उत्तरों में तोड़ने की आवश्यकता है। इस मामले में, जब हमने यह बताने के लिए कहा कि हम (मैं) कौन हैं, तो इसका जवाब NS सहकर्मी के पास है और कोई भी मालिक नहीं है, और इसलिए इस लाइन को कहा जाता है:
[self.label setText:[result objectForKey:@"name"]];

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

- (IBAction)getUserInfo:(id)sender {
[_facebook requestWithGraphPath:@"me/likes" andDelegate:self];
}


यदि आप इस अनुरोध के आउटपुट को फेसबुक साइट पर देखते हैं, तो आप देखेंगे कि इसका उत्तर है - केवल एक डेटा कुंजी के साथ एनएसबर्ड। यह कुंजी "नाम", "श्रेणी", "आईडी", "create_time" के साथ NSDictionary वस्तुओं की एक सरणी के अनुरूप होगा। अनुरोधित अधिकारों में "user_likes" जोड़ने के लिए नहीं भूलना भी महत्वपूर्ण है, अन्यथा प्रतिक्रिया में एक खाली NSDictionary वस्तु वापस आ जाएगी!

इस उत्तर को स्वीकार करने के लिए, हम अपनी विधि को फिर से लिखते हैं

- (void)request:(FBRequest *)request didLoad:(id)result {
if ([result isKindOfClass:[NSArray class]]) {
result = [result objectAtIndex:0];
}
if ([result objectForKey:@"owner"]) {
[self.label setText:@"Photo upload Success"];
} else if ([result objectForKey:@"data"]){
NSArray *likes = [result objectForKey:@"data"];
NSString *text=@"You don't like Steve";
for (NSDictionary* mylike in likes) {
NSString *mylikeName = [mylike objectForKey:@"name"];
if ([mylikeName isEqualToString:@"Steve Jobs"]) {
text=@"You like Steve";
break;
}
}
[self.label setText:text];
}
};

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

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

यह परियोजना मूल है , लेकिन गुणों में संशोधन के साथ, ताकि यह Xcode4 में शुरू हो

एक सत्र को बचाने के लिए अतिरिक्त क्षमता के साथ परियोजना

संशोधित अनुरोध परियोजना

केवल आपको अपना ऐपिड उनमें डालना होगा :)

पी एस और मैं भी Habré पर कोड स्वरूपण की तरह :)