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 :

• 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 app sur Facebook.
• App Events : permet d’enregistrer des évènements dans votre app.
• API Graph : permet de lire et d’écrire dans l’API Graph.

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.

Configuration manuelle

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

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

Étape 3 : ajouter le SDK au projet

Étape 4 : configurer le projet Xcode

Étape 5 : Connecter l’App Delegate

Étape 6 : Ajouter des App Events

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

Ouvrir l’Espace App Facebook

2. Sélectionnez Paramètres sur la gauche de l’écran.
3. Cliquez sur Ajouter une plate-forme au bas de la page et sélectionnez iOS.
4. Localisez votre identifiant de paquet dans Xcode et copiez-le dans votre presse-papier.



5. Revenez à l’Espace App et collez votre identifiant de paquet dans le champ ID du pack.



6. Activez Authentification unique.
7. 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.

Télécharger le SDK pour iOS

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

Étape 4 : configurer le projet Xcode

<key>CFBundleURLTypes</key>
<array>
  <dict>
  <key>CFBundleURLSchemes</key>
  <array>
    <string>fb[APP_ID]</string>
  </array>
  </dict>
</array>
<key>FacebookAppID</key>
<string>[APP_ID]</string>
<key>FacebookDisplayName</key>
<string>[APP_NAME]</string>

É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;
}

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

Ouvrez Facebook Analytics.

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