Getting Started with the Facebook SDK for iOS

This guide shows you how to integrate your iOS app with Facebook using the Facebook SDK for iOS.

The Facebook SDK enables:

• Facebook Login - Authenticate people with their Facebook credentials.
• Share and Send dialogs - Enable sharing content from your app to Facebook.
• App Events - Log events in your application.
• Graph API - Read and write to Graph API.

Before You Start

You will need:

• A Facebook Developer account
• A Facebook App ID for your app
• Configure your app's settings in the App Dashboard
• A project with UIKit App Delegate selected for Life Cycle

Get Your App ID

Each app that you create has a unique ID. To get the ID for an app, do the following:

1. Sign into your developer account.
2. Open the Apps page.
3. Find your app and click the App ID. The app ID is copied to the clipboard.

Get Your Client Token

Each app that you create has a unique client token that you use to access Facebook. For more information, see Access Tokens. To get the Client Token for an app, do the following:

1. Sign into your developer account.
2. On the Apps page, select an app to open the dashboard for that app.
3. On the Dashboard, navigate to Settings > Advanced > Security > Client token.

Step 1: Set Up Your Development Environment

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

If You Want To	Add This Package to your project
Allow your app to use the Facebook services	FacebookCore
Allow users to log into your app and for your app to ask for permissions to access data	FacebookLogin
Allow your app to share content on Facebook	FacebookShare
Allow users to log into your app to enable engagement and promote social features	FacebookGamingServices

Step 2: Configure Your Project

Step 3: Connect the App Delegate

    
// AppDelegate.swift
import UIKit
import FacebookCore

@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]
        )
    }  
}

// SceneDelegate.swift
import FacebookCore
  ...
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]
    )
}

Step 4: Build and Then Run Your Project in the Simulator

Step 5: See the Results in Events Manager

Next Steps

To learn how to implement App Events and other Facebook products to your app, click one of the buttons below.