Démarrer avec le SDK Facebook pour iOS

Le SDK Facebook pour iOS est le moyen le plus simple d’intégrer votre app iOS à Facebook. Il permet d’utiliser les fonctionnalités suivantes :

Vous pouvez configurer votre application de deux manières pour utiliser le SDK Facebook. Si vous n’avez pas enregistré votre application sur Facebook, utiliser l’outil de démarrage rapide est l’option la plus simple et la plus rapide. Sinon, vous pouvez ignorer le démarrage rapide et utiliser les instructions manuelles suivantes.

Démarrage rapide pour iOS

Étape 1 : configurer les paramètres de l’application Facebook pour iOS

  1. Ouvrez l’Espace App Facebook : cliquez sur le bouton ci-dessous et sélectionnez votre application.
  2. Ouvrir l’Espace App Facebook

  3. Sélectionnez Paramètres sur la gauche de l’écran.
  4. Cliquez sur Ajouter une plate-forme au bas de la page et sélectionnez iOS.
  5. Localisez votre identifiant de paquet dans Xcode et copiez-le dans votre presse-papier.
  6. Revenez à l’Espace App et collez votre identifiant de paquet dans le champ ID du pack.
  7. Activez Authentification unique.
  8. Cliquez sur Enregistrer les modifications en bas de la fenêtre de l’Espace App.

Étape 2 : télécharger le SDK Facebook pour iOS

  1. Téléchargez le SDK en utilisant le bouton ci-dessous.
  2. Télécharger le SDK pour iOS

  3. Décompressez l’archive dans ~/Documents/FacebookSDK.

Étape 3 : ajouter le SDK au projet

Pour ajouter le SDK dans Xcode :

  1. Ouvrez le projet Xcode de votre application.
  2. Créez un nouveau groupe Frameworks dans votre projet si vous n’en avez pas.
  3. Ouvrez ~/Documents/FacebookSDK à l’aide du Finder.
  4. Faites glisser les fichiers Bolts.framework, FBSDKCoreKit.framework, FBSDKLoginKit.framework et FBSDKShareKit.framework vers le groupe Frameworks du Project Navigator de Xcode. Dans la boîte de dialogue qui s’affiche, sélectionnez Create groups for any added folders (Créer des groupes pour tout dossier ajouté) et désélectionnez Copy items if needed (Copier les éléments si nécessaire). Cela fait référence au SDK à l’endroit où vous l’avez installé, plutôt que de devoir le copier dans votre app.
  5. Ouvrez l’onglet des paramètres Build Settings de Xcode dans votre projet.
  6. Ajoutez ~/Documents/FacebookSDK au paramètre Framework Search Paths du projet.

Lorsque vous utilisez le SDK Facebook, les évènements dans votre app sont automatiquement consignés et collectés pour Facebook Analytics, à moins de désactiver la consignation automatique des évènements. Pour en savoir plus sur les informations collectées et sur la façon de désactiver la consignation automatique des évènements, consultez la section Consignation automatique des App Events.

Étape 4 : configurer le projet Xcode

  1. Dans Xcode, ouvrez l’espace de travail.
  2. Faites un clic secondaire sur le fichier de liste de propriétés d’informations (info.plist) et sélectionnez Open As -> Source Code.
  3. Insérez l’extrait XML suivant dans le corps de votre fichier juste avant le dernier élément </dict>.
  4. <key>CFBundleURLTypes</key>
    <array>
      <dict>
        <key>CFBundleURLSchemes</key>
        <array>
          <string>fb{your-app-id}</string>
        </array>
      </dict>
    </array>
    <key>FacebookAppID</key>
    <string>{your-app-id}</string>
    <key>FacebookDisplayName</key>
    <string>{your-app-name}</string>
    <key>LSApplicationQueriesSchemes</key>
    <array>
      <string>fbapi</string>
      <string>fb-messenger-api</string>
      <string>fbauth2</string>
      <string>fbshareextension</string>
    </array>
    <key>NSPhotoLibraryUsageDescription</key>
      <string>{human-readable reason for photo access}</string>
  5. Remplacez le code suivant :
    • Remplacez fb{your-app-id} par votre ID d’app Facebook et le préfixe fb. Par exemple, si votre ID d’app Facebook est 1234567890, remplacez fb{your-app-id} par fb1234567890. Votre ID d’app se trouve sur l’Espace App Facebook.
    • Remplacez {your-app-id} par votre ID d’app.
    • Remplacez {your-app-name} par le nom d’affichage que vous avez indiqué dans l’Espace App.
    • Remplacez {human-readable reason for photo access} par la raison pour laquelle votre app nécessite un accès photo.
  6. Créez le projet et exécutez-le dans le simulateur.

Étape 5 : connecter l’App Delegate

Pour post-traiter les résultats des actions nécessitant de passer à l’application native Facebook ou à Safari, telles que Facebook Login ou les boîtes de dialogue Facebook, vous devez connecter votre classe AppDelegate à l’objet FBSDKApplicationDelegate. Pour ce faire, ajoutez le code suivant à votre fichier AppDelegate.m.

//  AppDelegate.m
#import <FBSDKCoreKit/FBSDKCoreKit.h>

- (BOOL)application:(UIApplication *)application 
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  
  [[FBSDKApplicationDelegate sharedInstance] application:application
    didFinishLaunchingWithOptions:launchOptions];
  // Add any custom logic here.
  return YES;
}

- (BOOL)application:(UIApplication *)application 
            openURL:(NSURL *)url 
            options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options {

  BOOL handled = [[FBSDKApplicationDelegate sharedInstance] application:application
    openURL:url
    sourceApplication:options[UIApplicationOpenURLOptionsSourceApplicationKey]
    annotation:options[UIApplicationOpenURLOptionsAnnotationKey]
  ];
  // Add any custom logic here.
  return handled;
}

Remarque : dans l’échantillon d’implémentation de -application:openURL:sourceApplication:annotation: ci-dessus, l’appel à FBSDKApplicationDelegate est requis pour que les liens profonds différés fonctionnent correctement.

Étape 6 : ajouter des App Events

Maintenant que le SDK est installé et configuré, la meilleure façon de tester votre implémentation est d’ajouter des App Events à votre app. Les App Events vous aident à comprendre la manière dont les personnes utilisent votre application. Pour ce faire, enregistrez des évènements au moyen de l’un des 14 évènements prédéfinis, comme Ajouté au panier dans une application de commerce ou Niveau réussi dans un jeu. Vous pouvez même définir des évènements personnalisés.

Enregistrement des activations d’app

Pour connaître le nombre de personnes qui utilisent votre application, enregistrez les activations d’app en ajoutant à votre fichier AppDelegate.m le code suivant.

//  AppDelegate.m
#import <FBSDKCoreKit/FBSDKCoreKit.h>
- (void)applicationDidBecomeActive:(UIApplication *)application {
  [FBSDKAppEvents activateApp];
}

Pour vérifier la connexion :

  1. Compilez et exécutez votre app.
  2. Accédez au tableau de bord de Facebook Analytics et sélectionnez votre app.
  3. Ouvrez Facebook Analytics.

  4. Sélectionnez Activité -> Évènements dans le menu de gauche.

Il peut y avoir un léger décalage avant l’affichage de vos activations dans le tableau de bord des évènements. Si rien ne s’affiche, attendez une minute et actualisez la page.

É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.

Partage sur iOSAjouter Facebook LoginAjouter des App EventsUtiliser l’API GraphBouton J’aime pour iOS
Configuration avancée