Update (27 June 2012) : You can find the latest updated facebook integration tutorial on our blog at: Facebook iOS SDK Tutorial : iPhone App Facebook integration with SSO (Single Sign On)
Please note that this tutorial is now obsolete. Please use facebook’s official tutorial

Now a days social networking websites like facebook are becoming very popular, so integrating facebook with app has become a necessity to make you application popular. We are going to do the same through this tutorial. The Facebook Connect SDK provides code which third-party developers can embed into their applications to connect to their Facebook accounts and exchange information with iPhone apps. It’s a way of embedding “social context” to an iPhone app, according to Facebook.

Create a Viewbased Application with name ‘FacebookAPI’.

Prerequisite:

  • .Download Facebook Connect for iPhone SDK (//svn.facebook.com/svnroot/platform/clients/packages/fbconnect-iphone.zip) or you can download same from here
    Just go through the project. In particular, the “Connect” sample project. Sample Project gives demo of some of the functionality.
    • Open src/FBConnect.xcodeproj from SDK that you downloaded, and your own project as well.
    • Drag n drop FBConnect group. Make sure “Copy items into destination group folder” is NOT checked. It should look as shown below
      iPhone FBConnect: Facebook Connect Tutorial

    • Go to Project Menu ->Edit project settings and scroll down to “User Header Search Path” add entry which will point to “src folder”
      iPhone FBConnect: Facebook Connect Tutorial

    • To test import all .m n .h files in case any miss. And compile.
  • Login to Facebook. After that go to Developers Page (//www.facebook.com/developers/) as shown below.
    iPhone FBConnect: Facebook Connect Tutorial

  • Register your application with Facebook
    • Click on Set up New Application Button in the upper right hand corner.
    • Give Application name and click on create application button. Then you will see new application screen with detail including “API key”and “API Secret Key”

    Note : This application will not work until you provide your Facebook application’s API keys.

Now to get started with actual coding:

Append Following code in FacebookAPIAppDelegate.h

#import<UIKit/UIKit.h>
#import "FBConnect/FBConnect.h"
#import "FBConnect/FBSession.h"

@class FacebookAPIViewController;

@interface FacebookAPIAppDelegate : NSObject  {
          UIWindow *window;
          FacebookAPIViewController *viewController;
          FBSession *_session;
}

@property (nonatomic, retain) IBOutlet UIWindow *window;
@property (nonatomic, retain) IBOutlet
                           FacebookAPIViewController *viewController;
@property (nonatomic,retain) FBSession *_session;
@end


Append Following code in FacebookAPIAppDelegate.m

#import "FacebookAPIAppDelegate.h"
#import "FacebookAPIViewController.h"

@implementation FacebookAPIAppDelegate

@synthesize window;
@synthesize viewController;
@synthesize _session;

- (void)applicationDidFinishLaunching:(UIApplication *)application {

// Override point for customization after app launch
[window addSubview:viewController.view];
[window makeKeyAndVisible];
}

- (void)dealloc {
          [_session release];
          [viewController release];
          [window release];
          [super dealloc];
}

@end


Here in FacebookAPIAppDelegate we have just declared _session variable of type FBSession to keep track of the session and to check if session for current user exists or not.

Append Following code in FacebookAPIViewController.h

#import <UIKit/UIKit.h>

#import "FBConnect/FBConnect.h"
#import "FBConnect/FBSession.h"

@interface FacebookAPIViewController : UIViewController   {
             FBLoginButton *loginButton;
             UIAlertView *facebookAlert;
             FBSession *usersession;
             NSString *username;
             BOOL post;
}

@property(nonatomic,retain) FBLoginButton *loginButton;
@property(nonatomic,retain)	UIAlertView *facebookAlert;
@property(nonatomic,retain)  FBSession *usersession;
@property(nonatomic,retain) NSString *username;
@property(nonatomic,assign) BOOL post;

- (BOOL)textFieldShouldReturn:(UITextField *)textField;
-(void)getFacebookName;
-(void)postToWall;

@end

Append Following code in FacebookAPIViewController.m

#import "FacebookAPIViewController.h"
#import "FacebookAPIAppDelegate.h"

#define _APP_KEY @"Your API Key Goes here"
#define _SECRET_KEY @"Your Secrete Key Goes here"

@implementation FacebookAPIViewController
@synthesize loginButton;
@synthesize facebookAlert;
@synthesize usersession;
@synthesize username;
@synthesize post;

- (void)viewDidLoad {
               FacebookAPIAppDelegate *appDelegate =
                          (FacebookAPIAppDelegate *)   [[UIApplication
                                            sharedApplication]delegate];
                if (appDelegate._session == nil){
                appDelegate._session = [FBSession
                                   sessionForApplication:_APP_KEY
                                   secret:_SECRET_KEY delegate:self];
                 }
                 if(self.loginButton == NULL)
                 self.loginButton = [[[FBLoginButton alloc] init] autorelease];
                 loginButton.frame = CGRectMake(0, 0, 100, 50);
                 [self.view addSubview:loginButton];

                 [super viewDidLoad];
}

- (void)dealloc {
               [username release];
               [usersession release];
               [loginButton release];
               [super dealloc];
}

- (void)session:(FBSession*)session didLogin:(FBUID)uid {
                self.usersession =session;
                NSLog(@"User with id %lld logged in.", uid);
                [self getFacebookName];
}

- (void)getFacebookName {
         NSString* fql = [NSString stringWithFormat:
         @"select uid,name from user where uid == %lld",
                               self.usersession.uid];
        NSDictionary* params =
        [NSDictionary dictionaryWithObject:fql
        forKey:@"query"];
   [[FBRequest requestWithDelegate:self]
  call:@"facebook.fql.query" params:params];
   self.post=YES;
}

- (void)request:(FBRequest*)request didLoad:(id)result {
              if ([request.method isEqualToString:@"facebook.fql.query"]) {
                          NSArray* users = result;
                          NSDictionary* user = [users objectAtIndex:0];
                          NSString* name = [user objectForKey:@"name"];
                          self.username = name;

                          if (self.post) {
                                     [self postToWall];
                                     self.post = NO;
                          }
              }
}

- (void)postToWall {

               FBStreamDialog *dialog = [[[FBStreamDialog alloc] init]
                                             autorelease];
               dialog.userMessagePrompt = @"Enter your message:";
               dialog.attachment = [NSString
                    stringWithFormat:@"{\"name\":\"Facebook Connect for
                    iPhone\",\"href\":\"//developers.facebook.com/
                    connect.phptab=iphone\",\"caption\":\"Caption\",
                    \"description\":\"Description\",\"media\":[{\"type\":
                    \"image\",\"src\":\"//img40.yfrog.com/img40/
                     5914/iphoneconnectbtn.jpg\",\"href\":
                     \"//developers.facebook.com/connect.php?
                      tab=iphone/\"}],\"properties\":{\"another link\":
                      {\"text\":\"Facebook home page\",\"href\":
                      \"//www.facebook.com\"}}}"];

               [dialog show];

}

- (BOOL)textFieldShouldReturn:(UITextField *)textField
{
                [textField resignFirstResponder];
                return YES;
}

@end


Define API key and Secret key with the keys you received while registering your app on facebook.

#define _APP_KEY @"43e37a535cc09c2013bd76fde78dfcc7"
#define _SECRET_KEY @"cc14801521a0c4d1dc31b7cacb891072"


Validate session variable in ViewDidLoad. If it doesn’t exist then create the same for using API key and Secret key. For that, one needs to conform the protocol FBSessionDelegate in respective header file. Also create a login button using FBLoginButton.

While implementing protocol FBSessionDelegate one needs to implement following mandatory method

(void)session:(FBSession*)session didLogin:(FBUID)uid


This methos is automatically called when user is logged in using FBConnect SDK.
In this method we get session for that user and it’s uid which unique identifier for that user.

Once FBSession session is avaiable, we can accesss all the APIs provided by Facebook.
For now, we will see how to post user name and status on the facebook wall.

To get Facebook username a request is send in which select query is written to get username using uid.

NSString* fql = [NSString stringWithFormat:
@"select uid,name from user where uid == %lld", self.usersession.uid];
NSDictionary* params = [NSDictionary dictionaryWithObject:fql forKey:@"query"];
[[FBRequest requestWithDelegate:self] call:@"facebook.fql.query" params:params];


Override following FBRequestDelegate method to check the reponse of above query.

(void)request:(FBRequest*)request didLoad:(id)result


The argument result is an array of NSDictionary Objects which contains info for that user as key-value pairs. Retrieve it as follows:

NSArray* users = result;
NSDictionary* user = [users objectAtIndex:0];
NSString* name = [user objectForKey:@"name"];


Use FBStreamDialog class post message on the facbook wall. A dialog pops up with a message box to post on Wall.

FBStreamDialog *dialog = [[[FBStreamDialog alloc] init] autorelease];
dialog.userMessagePrompt = @"Enter your message:";
dialog.attachment = [NSString stringWithFormat:@"{\"name\":\"Facebook Connect for iPhone\",\"href\":\"http://developers.facebook.com/connect.php?tab=iphone\",\"caption\":\"Caption\",\"description\":\"Description\",\"media\":[{\"type\":\"image\",\"src\":\"http://img40.yfrog.com/img40/5914/iphoneconnectbtn.jpg\",\"href\":\"http://developers.facebook.com/connect.php?tab=iphone/\"}],\"properties\":{\"another link\":{\"text\":\"Facebook home page\",\"href\":\"http://www.facebook.com\"}}}"];
[dialog show];


Now Save project (Command +S). Build and Run Project.
Simulator will look like as follows

iPhone FBConnect: Facebook Connect Tutorial

Click on Fconnect Button and Facebook Login Dialog will appear.

iPhone FBConnect: Facebook Connect Tutorial

Login with your user name and Password . Wait for untill post to Wall Dialog pops up

iPhone FBConnect: Facebook Connect Tutorial

The Msg on Facebook will something look like this

iPhone FBConnect: Facebook Connect Tutorial

You can download the source code from here