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 Meta Developer account
• A Meta App ID
• A Client Token
• A project with UIKit App Delegate selected for Life Cycle

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.