Guida all'aggiornamento dell'SDK di Facebook per iOS

Rivedere le modifiche nell'ultima versione

Prima di effettuare l'aggiornamento a una nuova versione dell'SDK di Facebook, devi esaminare il registro modifiche su GitHub. In questo modo potrai comprendere meglio le modifiche da apportare al codice come risultato di un aggiornamento.

Nota: se effettui l'aggiornamento alla versione 9.0.0 o versione successiva, l'opzione autoInitEnabled è stata rimossa dall'SDK. Devi inizializzare l'SDK in modo esplicito con il metodo initializeSDK o implicito chiamandolo in applicationDidFinishLaunching. Per maggiori informazioni, consulta la sezione 9.0.0 del registro modifiche.

Effettuare l'aggiornamento utilizzando Swift Package Manager (SPM)

Se la tua app utilizza SPM per integrare l'SDK di Facebook per iOS, segui questi passaggi.

L'avvio rapido nel link precedente richiede di selezionare Up to Next Major Version (Fino alla versione principale successiva) per l'opzione Version (Versione), in questo modo lo strumento non effettuerà automaticamente l'aggiornamento oltre la versione specificata (se selezioni la versione 8.x.x, non verrà effettuato l'aggiornamento a una versione principale 9.x.x). Questo aiuta a prevenire aggiornamenti a una versione incompatibile con il pacchetto correntemente in uso.

Aggiornamento incrementale

Se l'aggiornamento della versione è incrementale (viene incrementata la versione secondaria o patch)

In Xcode, clicca su File > Swift Packages > Update to Latest Package Versions (File > Pacchetti Swift > Aggiorna alle ultime versioni dei pacchetti).

L'immagine seguente mostra un esempio:

Aggiornamento a una versione principale

Prima di effettuare l'aggiornamento a una versione principale, assicurati di controllare i registri modifiche. Se l'aggiornamento della versione è una modifica della versione principale, potrebbe essere necessario modificare le impostazioni del pacchetto.

1. Accedi alle impostazioni del progetto e clicca sulla tab Swift Packages (Pacchetti Swift). L'immagine seguente mostra un esempio:


2. Seleziona il pacchetto Facebook per visualizzare le relative impostazioni. Modifica Versione impostandola sulla versione principale a cui desideri effettuare l'aggiornamento, in questa immagine di esempio è la 9.0.0, quindi clicca su Fine.


3. Ora aggiorna il pacchetto. In Xcode, clicca su File > Swift Packages > Update to Latest Package Versions (File > Pacchetti Swift > Aggiorna alle ultime versioni dei pacchetti). L'immagine seguente mostra un esempio:
   

Tieni presente che puoi eseguire il rollback alla versione target modificando il target della versione principale nelle impostazioni del progetto ed eseguendo nuovamente Aggiorna alle ultime versioni dei pacchetti.

Effettuare l'aggiornamento con CocoaPods

Se la tua app integra l'SDK di Facebook per iOS mediante CocoaPods, segui questi passaggi.

1. Controlla se sono presenti pod scaduti. Il comando seguente elencherà i pod scaduti.

   pod outdated
   

2. Aggiorna i pod scaduti con il comando seguente.

   pod update  [PODNAME]
   

Tieni presente che CocoaPods tenterà di trovare una versione aggiornata del pod specificato da [PODNAME] e aggiornerà il pod all'ultima versione possibile sulla base di eventuali restrizioni di versione nel tuo profilo. Se hai restrizioni di versione, potrebbe essere necessario modificarle per effettuare l'aggiornamento tra versioni principali.

Ricompilare e risolvere problemi

Al termine dell'aggiornamento degli SDK target, ricompila e correggi eventuali errori generati. Di solito, vengono generati errori solo quando si effettua l'aggiornamento a una nuova versione principale.

Assicurati di consultare il registro modifiche su GitHub per comprendere gli errori di compilazione che potresti riscontrare.

Effettuare l'aggiornamento a una nuova versione dell'API Graph

Se desideri effettuare l'aggiornamento a una nuova versione dell'API Graph, puoi usare lo strumento di aggiornamento per valutare le modifiche da apportare alla tua app. Puoi anche consultare il registro modifiche dell'API Graph.