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:

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.

Inicio rápido para iOS

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.
  2. Abrir panel de aplicaciones de Facebook

  3. En el menú de navegación izquierdo, selecciona Configuración.
  4. Haz clic en Agregar plataforma en la parte inferior de la página y selecciona iOS.
  5. Ubica el identificador del paquete en Xcode y cópialo en el portapapeles.
  6. Regresa al panel de aplicaciones y pega el identificador del paquete en el campo Identificador del paquete.
  7. Activa la opción Inicio de sesión único.
  8. 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.
  2. Descargar SDK para iOS

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

Cuando usas el SDK de Facebook, los eventos en tu aplicación se registran y recopilan automáticamente para Facebook Analytics, a menos que desactives automáticamente el registro de eventos. Para obtener información sobre qué información se recopila y cómo desactivar el registro de eventos de manera automática, consulta Registro automático de eventos de la aplicación.

Paso 4: Configurar el proyecto de 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>

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

Nota: En la anterior implementación de ejemplo de -application:openURL:sourceApplication:annotation:, es necesaria la llamada a FBSDKApplicationDelegate para que el enlace profundo diferido funcione correctamente.

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 Facebook Analytics y selecciona la aplicación.
  3. Abrir Facebook Analytics

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

Compartir en iOSAgregar inicio de sesión con FacebookAgregar eventos de la aplicaciónUsar API GraphBotón "Me gusta" para iOS
Configuración avanzada