Premiers pas avec le SDK Facebook pour iOS

Ce guide vous explique comment intégrer votre application iOS dans Facebook à l’aide du SDK Facebook pour iOS.

Le SDK Facebook permet d’utiliser les fonctionnalités suivantes :

• Facebook Login : authentifie les utilisateurs grâce à leurs identifiants Facebook.
• Boîtes de dialogue Partager et Envoyer : permettent de partager du contenu issu de votre application sur Facebook.
• Évènements d’application : permettent d’enregistrer des évènements dans votre application.
• API Graph : permet de lire et d’écrire dans l’API Graph.

Avant de commencer

Vous aurez besoin des éléments suivants :

• Un compte de développeur·se Meta
• Un ID d’application Meta
• Un token client
• Un projet pour lequel le cycle de vie sélectionné est UIKit App Delegate

Étape 1 : configurer votre environnement de développement

1. Dans Xcode, cliquez sur File > Swift Packages > Add Package Dependency (Fichier > Packages Swift > Ajouter une dépendance de package).
2. Dans la boîte de dialogue qui s’affiche, saisissez l’URL de dépôt suivante : https://github.com/facebook/facebook-ios-sdk.
   
3. Dans Version, sélectionnez Up to Next Major (Jusqu’à la prochaine version avec des changements importants) et choisissez l’option par défaut.
4. Suivez les invites de manière à sélectionner les bibliothèques que vous souhaitez utiliser dans votre projet.

Si vous souhaitez…	… ajoutez ce package à votre projet
autoriser votre application à utiliser les services Facebook	FacebookCore
autoriser les utilisateurs à se connecter à votre application, et votre application à demander des autorisations d’accès aux données	FacebookLogin
autoriser votre application à partager du contenu sur Facebook	FacebookShare
autoriser les utilisateurs à se connecter à votre application pour stimuler les interactions et mettre en avant des fonctionnalités sociales	FacebookGamingServices

Étape 2 : configurer votre projet

Étape 3 : connecter l’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]
    )
}

Étape 4 : créer le projet et l’exécuter dans le simulateur

Étape 5 : afficher les résultats dans le Gestionnaire d’évènements

Étapes suivantes

Pour savoir comment implémenter des App Events et d’autres produits Facebook dans votre application, cliquez sur l’un des boutons ci-dessous.