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.

Passaggio 2: download dell'SDK di Facebook per iOS

  1. Scarica l'SDK usando il pulsante sotto.
  2. Scarica l'SDK per iOS

  3. Decomprimi l'archivio in ~/Documents/FacebookSDK.

Passaggio 3: aggiunta dell'SDK al progetto

Per aggiungere l'SDK in Xcode:

  1. Apri il progetto Xcode della tua app.
  2. Se non disponi di un gruppo Frameworks (Framework) nel progetto, creane uno.
  3. Apri ~/Documents/FacebookSDK usando il Finder.
  4. Trascina i file Bolts.framework, FBSDKCoreKit.framework, FBSDKLoginKit.framework e FBSDKShareKit.framework nel gruppo Frameworks (Framework) di Project Navigator (Struttura del progetto) di Xcode. Nella finestra di dialogo visualizzata, scegli Create groups for any added folders (Crea gruppi per qualsiasi cartella aggiunta) e deseleziona Copy items if needed (Copia elementi se necessario). In questo modo, verrà creato un riferimento all'SDK nella posizione in cui lo hai installato anziché copiare l'SDK nella tua app.
  5. Apri la tab Build Settings (Impostazioni della build) di Xcode nel tuo progetto.
  6. Aggiungi ~/Documents/FacebookSDK all'impostazione Framework Search Paths (Percorsi di ricerca dei framework) del progetto.

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

Passaggio 4: configurazione del progetto Xcode

  1. In Xcode, apri l'area di lavoro.
  2. Clicca con il tasto destro del mouse sul file contenente la lista delle proprietà relative alle informazioni (info.plist) e seleziona Open As (Apri come) - > Source Code (Codice sorgente).
  3. Inserisci lo snippet XML seguente nel corpo del tuo file subito prima dell'elemento </dict> finale.
  4. <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>
  5. Sostituisci il codice seguente:
    • Sostituisci fb{your-app-id} con l'ID app Facebook, preceduto da fb. Ad esempio, se il tuo ID app Facebook è 1234567890, allora sostituisci fb{your-app-id} con fb1234567890. Puoi trovare il tuo ID app nella Dashboard gestione app di Facebook.
    • Sostituisci {your-app-id} con il tuo ID app.
    • Sostituisci {your-app-name} con il nome visualizzato che hai specificato nella Dashboard gestione app.
    • Sostituisci {human-readable reason for photo access} con il motivo per cui la tua app richiede l'accesso alle foto.
  6. Crea il progetto, quindi eseguilo nel simulatore.

Passaggio 5: 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 6: 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.

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 GraphPulsante "Mi piace" per iOS
Configurazione avanzata