Facebook Login for iOS - Quickstart

When people log into your app with Facebook, they can grant permissions to your app so you can retrieve information or perform actions on Facebook on their behalf.

The following steps are for adding Facebook Login to your iOS project.

1. Login

Please log in to Facebook to create apps or register as a developer.

2. Set up Your Development Environment

Use the latest Facebook SDK for iOS to keep your app compatible with the current iOS version.

If you link to the SDKs with CocoaPods, you must update your pods for the SDKs your app uses and recompile your app. You can also download the latest version of the Facebook iOS SDK, integrate it into your app, and recompile.

Set up your development environment before using Facebook Login for iOS.

SDK: Swift Package Manager

Using Swift Package Manager (SPM)

Only available for Xcode 11.2 and above.

In Xcode, click File > Swift Packages > Add Package Dependency.
In the dialog that appears, enter the repository URL: https://github.com/facebook/facebook-ios-sdk.
In Version, select Up to Next Major and take the default option.
Complete the prompts to select the libraries you'd like to use in your project.

Using Cocoapods

To always link to the most recent version, link to the Facebook iOS SDK with CocoaPods rather than downloading the SDK itself.

Navigate to *.xcworkspace in your project folder in a terminal window.
Make sure you have the CocoaPods gem installed on your machine before installing the Facebook Login pod.
```
    $ sudo gem install cocoapods
    $ pod init
    
```
This will create a file named Podfile in your project's root directory.
Add the following to your Podfile:
```
    pod 'FBSDKLoginKit'
    
```
Run the following command in your project root directory from a terminal window:
```
    $ pod install
    
```

Your Cartfile should look something like:

github "facebook/facebook-ios-sdk"

3. Register and Configure Your App with Facebook

3a. Add your Bundle Identifier

You need to login to complete this step.

3b. Enable Single Sign-On for Your App

You need to login to complete this step.

4. Configure Your Project

Configure the Info.plist file with an XML snippet that contains data about your app.

Right-click Info.plist, and choose Open As ▸ Source Code.

Copy and paste the following XML snippet into the body of your file ( <dict>...</dict>).

<key>CFBundleURLTypes</key>
<array>
  <dict>
  <key>CFBundleURLSchemes</key>
  <array>
    <string>fbAPP-ID</string>
  </array>
  </dict>
</array>
<key>FacebookAppID</key>
<string>APP-ID</string>
<key>FacebookClientToken</key>
<string>CLIENT-TOKEN</string>
<key>FacebookDisplayName</key>
<string>APP-NAME</string>

In <array><string> in the key [CFBundleURLSchemes], replace APP-ID with your App ID.
In <string> in the key FacebookAppID, replace APP-ID with your App ID.
In <string> in the key FacebookClientToken, replace CLIENT-TOKEN with the name of your app.
In <string> in the key FacebookDisplayName, replace APP-NAME with the name of your app.

To use any of the Facebook dialogs (e.g., Login, Share, App Invites, etc.) that can perform an app switch to Facebook apps, your application's Info.plist also needs to include: <dict>...</dict>).

<key>LSApplicationQueriesSchemes</key>
<array>
  <string>fbapi</string>
  <string>fbapi20130214</string>
  <string>fbapi20130410</string>
  <string>fbapi20130702</string>
  <string>fbapi20131010</string>
  <string>fbapi20131219</string>
  <string>fbapi20140410</string>
  <string>fbapi20140116</string>
  <string>fbapi20150313</string>
  <string>fbapi20150629</string>
  <string>fbapi20160328</string>
  <string>fbauth</string>
  <string>fb-messenger-share-api</string>
  <string>fbauth2</string>
  <string>fbshareextension</string>
</array>

5. Connect Your App Delegate

Upon initialization, the SDK will perform various network calls to fetch configuration information. If you would like to defer these operations you may want to wrap initialization in a method that can conditionally run code based on a server response. There are a number of ways to do this. The following code block is pseudocode to demonstrate what a potential solution might look like.

FlagFetcher.fetchFlags { result in
    if case let .success(flags) = result,
      flags.contains("use_facebook") {
        // Initialize the SDK
        ApplicationDelegate.shared.application(
            application,
            didFinishLaunchingWithOptions: launchOptions
        )			
    }
}

Replace the code in the AppDelegate method with the following code. This code initializes the SDK when your app launches, and allows the SDK handle results from the native Facebook app when you perform a Login or Share action.

Swift

    
// Swift
//
// AppDelegate.swift
import UIKit
import FBSDKCoreKit

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
    
    func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
          
        ApplicationDelegate.shared.application(
            application,
            didFinishLaunchingWithOptions: launchOptions
        )

        return true
    }
          
    func application(
        _ app: UIApplication,
        open url: URL,
        options: [UIApplication.OpenURLOptionsKey : Any] = [:]
    ) -> Bool {

        ApplicationDelegate.shared.application(
            app,
            open: url,
            sourceApplication: options[UIApplication.OpenURLOptionsKey.sourceApplication] as? String,
            annotation: options[UIApplication.OpenURLOptionsKey.annotation]
        )

    }  

}

Objective C

// Objective-C
//
// AppDelegate.m  
@implementation AppDelegate

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  
  [[FBSDKApplicationDelegate sharedInstance] application:application
                           didFinishLaunchingWithOptions:launchOptions];
  return YES;
}


- (BOOL)application:(UIApplication *)application
            openURL:(NSURL *)url
            options:(nonnull NSDictionary<UIApplicationOpenURLOptionsKey, id> *)options
{
  [[FBSDKApplicationDelegate sharedInstance] application:application
                                                 openURL:url
                                                 options:options];
  return YES;
}

iOS 13 moved opening URL functionality to the SceneDelegate. If you are using iOS 13, add the following method to your SceneDelegate so that operations like logging in or sharing function as intended:

Swift

// Swift
//
// SceneDelegate.swift
import FBSDKCoreKit
  ...
func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
    guard let url = URLContexts.first?.url else {
        return
    }

    ApplicationDelegate.shared.application(
        UIApplication.shared,
        open: url,
        sourceApplication: nil,
        annotation: [UIApplication.OpenURLOptionsKey.annotation]
    )
}

Objective C

// Objective-C
//
// SceneDelegate.m
#import <FBSDKCoreKit/FBSDKCoreKit.h>

@import FacebookCore;

@interface SceneDelegate ()

@end

@implementation SceneDelegate

- (void)scene:(UIScene *)scene openURLContexts:(NSSet<UIOpenURLContext *> *)URLContexts
{
  UIOpenURLContext *context = URLContexts.allObjects.firstObject;
  [FBSDKApplicationDelegate.sharedInstance application:UIApplication.sharedApplication
                                               openURL:context.URL
                                     sourceApplication:context.options.sourceApplication
                                            annotation:context.options.annotation];
}

6. Add Facebook Login to Your Code

Use the Facebook Login button in your iOS app.

6a. Add Facebook Login to Your Code

To add a Facebook-branded Login button to your app, add the following code snippet to a view controller.

// Swift
//
// Add this to the header of your file, e.g. in ViewController.swift 

import FBSDKLoginKit

// Add this to the body
class ViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
	
        let loginButton = FBLoginButton()
        loginButton.center = view.center
        view.addSubview(loginButton)
    }
}

// Objective-C
//
// Add this to the header of your file, e.g. in ViewController.m 
// after #import "ViewController.h"
#import <FBSDKCoreKit/FBSDKCoreKit.h>
#import <FBSDKLoginKit/FBSDKLoginKit.h>

// Add this to the body
@implementation ViewController

- (void)viewDidLoad {
  [super viewDidLoad];
  FBSDKLoginButton *loginButton = [[FBSDKLoginButton alloc] init];
  // Optional: Place the button in the center of your view.
  loginButton.center = self.view.center;
  [self.view addSubview:loginButton];
}

@end

At this point you should be able to run your app and log in using the Facebook Login button.

6b. Check Current Login Status

Your app can only have one person logged in at a time. We represent each person logged into your app with the [FBSDKAccessToken currentAccessToken].

The FBSDKLoginManager sets this token for you and when it sets currentAccessToken it also automatically writes it to a keychain cache.

The FBSDKAccessToken contains userID which you can use to identify the user.

You should update your view controller to check for an existing token at load. This avoids unnecessary showing the login flow again if someone already granted permissions to your app:

// Swift

override func viewDidLoad() {
    super.viewDidLoad()

    if let token = AccessToken.current,
        !token.isExpired {
        // User is logged in, do work such as go to next view controller.
    }
}

// Objective-C
      
- (void)viewDidLoad
{
  [super viewDidLoad];
  if ([FBSDKAccessToken currentAccessToken]) {
   // User is logged in, do work such as go to next view controller. 
  }
}

6c. Ask for Permissions

When using Facebook Login, your app can ask for permissions on a subset of a person's data.

Read Permissions for Facebook Login Button

To request additional read permissions, set the readPermissions property on the FBSDKLoginButton object.

// Swift
//
// Extend the code sample from 6a. Add Facebook Login to Your Code
// Add to your viewDidLoad method:
loginButton.permissions = ["public_profile", "email"]

// Objective-C
//
// Extend the code sample from 6a. Add Facebook Login to Your Code
// Add to your viewDidLoad method:
loginButton.readPermissions = @[@"public_profile", @"email"];

The user will be prompted to grant your app with the requested permissions. Note that some permissions will require a Login Review. See Managing Permissions for more information on permissions.

7. Next Steps

Congrats, you've added Facebook Login to your iOS app! Be sure to check out our other documentation pages for more advanced guides.

Implement a Data Deletion Callbackshare-external

Implement a data deletion callback to respond the people's request to delete their data from Facebook.

Add App Eventsshare-external

Add events to your app to view analytics, measure ad performance and build audiences for ad targeting.

Advanced Topics & Setupshare-external

Check out our advanced setup for Facebook Login for iOS apps.

Permissionsshare-external

Manage what data your app has access to through Facebook Login.

Handling Errorsshare-external

Check out how to responds to errors returned by the Facebook SDK.

Testing a Login Flowshare-external

Test and verify that your Facebook Login flow works.

App Reviewshare-external

Depending on the Facebook data you request from people using Facebook Login, you may need to submit your app for review prior to launch.