Primeros pasos con el SDK de Facebook para iOS

El SDK de Facebook para iOS es la forma más sencilla de integrar tu aplicación para iOS con Facebook. Incluye:

• Inicio de sesión con Facebook: permite la autenticación con las credenciales de Facebook.
• Cuadros de diálogo de envío y contenido compartido: permiten compartir contenido en Facebook desde tu aplicación.
• Eventos de la aplicación: registran eventos en tu aplicación.
• API Graph: lee y escribe en la API Graph.

Hay dos maneras de configurar tu aplicación para utilizar el SDK de Facebook. Si aún no registraste tu aplicación en Facebook, la manera más rápida y sencilla es mediante la herramienta de inicio rápido. La alternativa consiste en omitir el inicio rápido y seguir las instrucciones manuales que aparecen a continuación.

Configuración manual

Paso 1: Configurar la aplicación de Facebook para iOS

Paso 2: Descargar el SDK de Facebook para iOS

Paso 3: Agregar el SDK al proyecto

Paso 4: Configurar el proyecto de Xcode

Paso 5: Conectar el delegado de la aplicación

Paso 6: Agregar eventos de la aplicación

Paso 1: Configurar la aplicación de Facebook para iOS

1. Haz clic en el siguiente botón para abrir el panel de aplicaciones de Facebook y selecciona tu aplicación.

Abrir panel de aplicaciones de Facebook

2. En el menú de navegación izquierdo, selecciona Configuración.
3. Haz clic en Agregar plataforma en la parte inferior de la página y selecciona iOS.
4. Ubica el identificador del paquete en Xcode y cópialo en el portapapeles.



5. Regresa al panel de aplicaciones y pega el identificador del paquete en el campo Identificador del paquete.



6. Activa la opción Inicio de sesión único.
7. Haz clic en Guardar cambios en la parte inferior de la ventana del panel de aplicaciones.

Paso 2: Descargar el SDK de Facebook para iOS

1. Descarga el SDK con el botón que aparece abajo.

Descargar SDK para iOS

2. Descomprime el archivo en ~/Documents/FacebookSDK.

Paso 3: Agregar el SDK al proyecto

Para agregar el SDK en Xcode:

1. Abre el proyecto de Xcode de tu aplicación.
2. Si aún no tienes un grupo de marcos en tu proyecto, crea uno.
3. Abre ~/Documents/FacebookSDK mediante la aplicación Finder.
4. Arrastra los archivos Bolts.framework, FBSDKCoreKit.framework, FBSDKLoginKit.framework y FBSDKShareKit.framework al grupo de marcos del navegador de proyectos de Xcode. En el cuadro de diálogo que aparece, elige Create groups for any added folders y anula la selección de Copy items into destination group's folder. Esto establece una referencia al SDK en donde lo instalaste, en lugar de copiarlo en tu aplicación.
5. Abre la pestaña Build Settings de Xcode en tu proyecto.
6. Agrega ~/Documents/FacebookSDK a la configuración Framework Search Paths del proyecto.

Paso 4: Configurar el proyecto de Xcode

1. En Xcode, haz clic con el botón secundario en el archivo .plist de tu proyecto y selecciona Open As > Source Code.

2. Inserta el siguiente fragmento de código XML en el cuerpo del archivo justo antes del elemento </dict> final.

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

3. Reemplaza fb{your-app-id} con el identificador de la aplicación de Facebook, antecedido por el prefijo fb. Por ejemplo, fb123456. Encontrarás el identificador de la aplicación en el panel de aplicaciones de Facebook.
4. Reemplaza {your-app-id} con el identificador de la aplicación.
5. Reemplaza {your-app-name} con el nombre para mostrar que especificaste en el panel de aplicaciones.
6. Reemplaza {human-readable reason for photo access} con la razón por la cual tu aplicación necesita acceso a las fotos.

Paso 5: Conectar el delegado de la aplicación

Para realizar el procesamiento posterior de los resultados de acciones que requieren que cambies a la aplicación de Facebook nativa o a Safari, como el inicio de sesión con Facebook o los cuadros de diálogo de Facebook, necesitas conectar tu clase AppDelegate al objeto FBSDKApplicationDelegate. Para lograrlo, agrega el siguiente código a tu archivo 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;
}

Paso 6: Agregar eventos de la aplicación

Ahora que el SDK está instalado y configurado, la manera más sencilla de probarlo es agregar eventos de la aplicación a tu aplicación. Los eventos de la aplicación te ayudan a conocer cómo utilizan las personas tu aplicación. Para ello, debes registrar eventos usando uno de los 14 eventos predefinidos, como artículo agregado al carrito en una aplicación de comercio o nivel alcanzado en un juego. Incluso puedes definir tus propios eventos personalizados.

Registrar las activaciones de la aplicación

Para ver cuántas personas usan tu aplicación, registra las activaciones de la aplicación. Para ello, agrega el siguiente código a tu archivo AppDelegate.m.

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

Para verificar el registro:

1. Compila y ejecuta la aplicación.
2. Ve al panel de Analytics for Apps y selecciona tu aplicación.

Abrir panel de Analytics for Apps

3. En el menú de la izquierda, selecciona Actividad > Eventos.

Las activaciones tardarán un poco en aparecen en el panel de eventos. Si no ves nada, espera un minuto y actualiza la página.

Próximos pasos

Para obtener información sobre cómo implementar eventos de la aplicación y otros productos de Facebook en tu aplicación, haz clic en uno de los siguientes botones.