Primi passi con l'SDK di Facebook per iOS

L'SDK di Facebook per iOS è il modo più facile per integrare la tua app per iOS con Facebook. Abilita:

  • Facebook Login: consente di autenticare gli utenti con le loro credenziali di Facebook.
  • Finestre di condivisione e invio: consentono di abilitare la condivisione dei contenuti della tua app su Facebook.
  • App Events: consente di registrare le azioni nella tua app.
  • API Graph: consente di scrivere sull'API Graph e di leggere i relativi contenuti.

La configurazione della tua app per l'uso dell'SDK di Facebook può essere eseguita in due modi. Se non hai registrato la tua app con Facebook, l'opzione più semplice e veloce è usare lo strumento di avvio rapido. In alternativa, puoi usare le istruzioni manuali indicate di seguito.

Avvio rapido per iOS

Passaggio 1: configurazione delle impostazioni dell'app Facebook per iOS

  1. Apri la Dashboard gestione app di Facebook cliccando sul pulsante sotto e selezionando la tua app.
  2. Apri Dashboard gestione app

  3. Seleziona Impostazioni nel menu di navigazione a sinistra.
  4. Clicca su Aggiungi piattaforma nella parte inferiore della pagina e seleziona iOS.
  5. Individua l'identificatore del tuo bundle in Xcode e copialo negli appunti.
  6. Torna alla Dashboard gestione app e incolla l'identificatore del tuo bundle nel campo ID bundle.
  7. Abilita Accesso singolo.
  8. Clicca su Salva modifiche nella parte inferiore della finestra della Dashboard gestione app.

Per collegarti sempre alla versione più recente, collega l'SDK iOS di Facebook con CocoaPods.

  1. Accedi alla cartella del tuo progetto mediante una finestra del terminale.
  2. Assicurati di aver installato il gem di CocoaPods sul computer prima di installare il pod per Facebook Login.
    $ sudo gem install cocoapods
    $ pod init
    Questo creerà un file chiamato Podfile nella directory principale del tuo progetto.

  3. Aggiungi quanto segue al tuo Podfile:
    pod 'FBSDKLoginKit'
  4. Esegui il seguente comando nella directory principale del tuo progetto da una finestra del terminale:
    $ pod install

Passaggio 3: configurazione del file Info.plist

  1. In Xcode, clicca con il tasto destro del mouse sul file Info.plist del tuo progetto e seleziona Open As (Apri come) -> Source Code (Codice sorgente).
  2. Inserisci lo snippet XML seguente nel corpo del tuo file subito prima dell'elemento </dict> finale.

  3. <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-share-api</string>
      <string>fbauth2</string>
      <string>fbshareextension</string>
    </array>
  4. Sostituisci {your-app-id} e {your-app-name} con l'ID e il nome della tua app, disponibili nella Dashboard gestione app di Facebook.

Passaggio 4: connessione dell'app delegate

Per la post-elaborazione dei risultati delle azioni che richiedono il passaggio all'app Facebook nativa o a Safari, come Facebook Login o le finestre di dialogo di Facebook, devi connettere la tua classe AppDelegate all'oggetto FBSDKApplicationDelegate. Per eseguire questa operazione, aggiungi il seguente codice al tuo file 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: Nell'esempio di implementazione di -application:openURL:sourceApplication:annotation: sopra, la chiamata a FBSDKApplicationDelegate è richiesta per il corretto funzionamento dei deferred deep link.

Passaggio 5: aggiunta di App Events

Ora che l'SDK è installato e configurato, il modo più semplice per testarlo è aggiungere App Events alla tua app. App Events ti aiuta a capire in che modo gli utenti usano la tua app. Nello specifico, registra le azioni tramite una delle 14 azioni predefinite come articolo aggiunto al carrello in un'app di e-commerce o livello completato in un gioco. Puoi persino definire le tue azioni personalizzate.

Registrazione delle attivazioni dell'app

Per scoprire quanti utenti usano la tua app, registra le attivazioni dell'app aggiungendo il seguente codice al tuo file AppDelegate.m.

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

Per verificare la registrazione:

  1. Compila ed esegui la tua app.
  2. Accedi alla dashboard di Facebook Analytics e seleziona la tua app.
  3. Apri Facebook Analytics

  4. Dal menu a sinistra, seleziona Attività -> Azioni.

Saranno necessari alcuni istanti prima che le attivazioni vengano mostrate nella dashboard delle azioni. Se non vedi nulla, aspetta un minuto e aggiorna la pagina.

Quando usi l'SDK di Facebook, alcuni eventi nella tua app vengono registrati e raccolti automaticamente per Facebook Analytics a meno che non disabiliti la registrazione automatica degli eventi. Per maggiori dettagli sul tipo di informazioni raccolte e su come disabilitare la registrazione automatica degli eventi, consulta Registrazione automatica degli eventi nelle app.

Passaggi successivi

Per scoprire come implementare App Events e altri prodotti di Facebook nella tua app, clicca su uno dei pulsanti sotto.

Condivisione in iOSAggiunta di Facebook Loginaggiunta di App EventsUso dell'API Graph
Configurazione avanzata