Introdução ao SDK do Facebook para iOS

O SDK do Facebook para iOS é a maneira mais fácil de integrar seu aplicativo iOS ao Facebook. Ele permite:

Você tem duas maneiras de configurar seu aplicativo para usar o SDK do Facebook. Se você não registrou seu aplicativo no Facebook, a opção mais simples e rápida é usar a ferramenta de Início Rápido. A alternativa é ignorar o Início Rápido e usar as instruções manuais abaixo.

Início rápido do iOS

Etapa 1: definir as configurações do aplicativo do Facebook para iOS

  1. Abra o Painel de Aplicativos do Facebook clicando no botão abaixo e selecionando seu aplicativo.
  2. Abrir o Painel de Aplicativos do Facebook

  3. Selecione Configurações da navegação à esquerda.
  4. Clique em Adicionar plataforma na parte inferior da página e selecione iOS.
  5. Localize o identificador de pacote no Xcode e copie-o para sua área de transferência.
  6. Retorne ao Painel de Aplicativos e cole o identificador de pacote no campo ID do pacote.
  7. Habilite o Login único.
  8. Clique em Salvar alterações na parte inferior da janela do Painel de Aplicativos.

Etapa 2: baixar o SDK do Facebook para iOS

  1. Baixe o SDK usando o botão abaixo.
  2. Baixar SDK do iOS

  3. Descompacte o arquivo para ~/Documents/FacebookSDK.

Etapa 3: adicionar o SDK ao projeto

Para adicionar o SDK no Xcode:

  1. Abra o projeto do Xcode do seu aplicativo.
  2. Se você não tiver um grupo de Estruturas no seu projeto, crie um.
  3. Abra o ~/Documents/FacebookSDK usando o Finder.
  4. Arraste os arquivos Bolts.framework, FBSDKCoreKit.framework, FBSDKLoginKit.framework e FBSDKShareKit.framework para o grupo Estruturas do Navegador de projetos do Xcode. No diálogo de exibição, escolha Criar grupos para qualquer pasta adicionada e desmarque Copiar itens se necessário. Isso fará com que o SDK seja referenciado onde foi instalado em vez de ser copiado no aplicativo.
  5. Abra a guia Configurações de criação do Xcode no seu projeto.
  6. Adicione ~/Documents/FacebookSDK às configurações de Caminhos de pesquisa de estrutura do projeto.

Quando você usa o SDK do Facebook, os eventos no aplicativo são registrados e coletados automaticamente para o Facebook Analytics, a menos que desabilite o log de eventos automático. Para saber mais sobre as informações que são coletadas e sobre como desabilitar o log de eventos automático, confira o tópico Log de eventos automático do aplicativo.

Etapa 4: configurar o projeto do 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>

Etapa 5: conectar o representante do aplicativo

Para pós-processar os resultados das ações que exigem que você mude para o aplicativo nativo do Facebook ou do Safari, como o Login no Facebook ou Diálogos do Facebook, você precisa conectar sua classe AppDelegate ao objeto FBSDKApplicationDelegate. Para conseguir isso, adicione o seguinte código ao seu arquivo 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;
}

Observação: No exemplo de implementação de -application:openURL:sourceApplication:annotation: acima, a chamada para FBSDKApplicationDelegate é necessária para que o deep linking diferido funcione corretamente.

Etapa 6: adicionar Eventos do Aplicativo

Agora que o SDK está instalado e configurado, a maneira mais fácil de testá-lo é adicionar Eventos do Aplicativo ao seu aplicativo. Os Eventos do Aplicativo ajudam você a entender como as pessoas estão usando seu aplicativo. Isso é feito pelo registro dos eventos usando um dos 14 eventos predefinidos, como adicionado ao carrinho em um aplicativo de comércio ou nível concluído em um jogo. Você pode até mesmo definir seus próprios eventos personalizados.

Registrar ativações do aplicativo

Para ver quantas pessoas estão usando seu aplicativo, registre as ativações do aplicativo adicionando o seguinte código ao seu arquivo AppDelegate.m.

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

Para verificar o registro:

  1. Compile e execute o aplicativo.
  2. Vá para o Painel do Facebook Analytics e selecione seu aplicativo.
  3. Abrir o Facebook Analytics

  4. No menu à esquerda, selecione Atividade -> Eventos.

Será necessário aguardar um pouco até que as ativações sejam exibidas no painel de eventos. Caso você não veja nada, espere alguns minutos e atualize a página.

Próximas etapas

Para saber como implementar Eventos do Aplicativo e outros produtos do Facebook em seu aplicativo, clique em um dos botões abaixo.

Como compartilhar no iOSAdicionar Login no Facebookadicionar Eventos do AplicativoUsar a Graph APIBotão Curtir para iOS
Configurações avançadas