Presentazione dell'SDK della piattaforma Facebook v13.0 e aggiornamenti correlati

Oggi rilasciamo l'SDK di Facebook v13.0 e aggiornamenti aggiuntivi ai nostri SDK della piattaforma Facebook. Questo post descrive i suddetti aggiornamenti e i passaggi necessari che gli sviluppatori devono eseguire, se necessario, per l'integrazione delle loro app con la nostra piattaforma, al fine di evitare interruzioni. Ecco una breve panoramica di alcuni degli aggiornamenti inclusi nel rilascio dell'SDK v13.0:

• Supporto per l'API Graph v13.0: è stato aggiunto il supporto per l'API Graph v13.0 e l'API Marketing v13.0.
• Richiesta di autorizzazione incorporata per l'ID dell'inserzionista Android nell'SDK di Facebook per Android: ora l'Android SDK v13.0 include una richiesta di autorizzazione per l'ID dell'inserzionista Android per impostazione predefinita, in linea con la normativa di Google Play Services sugli ID dell'inserzionista. Per evitare interruzioni del servizio, tutti gli sviluppatori che utilizzano l'SDK di Facebook per Android dovranno intervenire prima dell'inizio dell'applicazione programmata di Google ad aprile 2022.
• Il requisito di incorporazione del token client nell'SDK diviene effettivo: con il rilascio dell'SDK di Facebook v13.0, gli sviluppatori devono incorporare i token client nell'SDK.
• Il requisito di utilizzo del bytecode di Java 8 diviene effettivo: ora gli sviluppatori devono utilizzare il bytecode di Java 8 per evitare errori di compilazione dell'app.
• Avvisi di obsolescenza: SDK v12 (comprese v12.1, v12.2 ecc.) è stato dichiarato obsoleto. A partire da oggi, gli sviluppatori devono iniziare la migrazione alla v13.0 per evitare di utilizzare SDK obsoleti per le loro app.

Di seguito sono riportati dettagli aggiuntivi sui suddetti aggiornamenti.

Rilascio dell'SDK v13.0

Oggi viene lanciato l'SDK della piattaforma v13.0 sulle piattaforme Android e iOS. Nell'ambito di questo rilascio, è stato aggiunto il supporto per l'API Graph v13.0 e l'API Marketing v13.0 di Facebook. Abbiamo creato questo post sul blog per mettere in evidenza avvisi aggiuntivi, aggiornamenti sui prodotti e promemoria correlati al rilascio dell'API Graph v13.0 e dell'API Marketing v13.0.

Altri aggiornamenti chiave

Di seguito è riportata una breve panoramica di altri aggiornamenti e modifiche inclusi nel rilascio dell'SDK v13.0.

Modernizzazione dell'SDK: conversione da Objective-C a Swift

Il codice dell'SDK è stato convertito da Objective-C a Swift in linea con la modernizzazione degli SDK della piattaforma. Il rilascio dell'SDK v13.0 comprende diverse modifiche correlate alle iniziative di conversione che potrebbero richiedere azioni da parte degli sviluppatori. Ecco cosa includono tali modifiche:

• Alcuni tipi sono stati convertiti da Objective-C a Swift. Gli sviluppatori potrebbero dover utilizzare istruzioni di importazione modulare quando usano GamingServicesKit e la maggior parte di ShareKit per evitare di riscontrare errori di compilazione in Objective-C. In questi casi gli sviluppatori dovranno utilizzare @import invece di #import nei file Objective-C quando utilizzano i simboli dai suddetti kit. Gli sviluppatori possono anche consultare il registro modifiche per maggiori dettagli sulla modalità di utilizzo delle istruzioni di importazione modulare.
• Inoltre, abbiamo ridotto ulteriormente l'utilizzo di pratiche di tipo di valore Objective-C in ShareKit. A partire dal rilascio dell'SDK v13.0, i tipi di contenuto ShareKit non implementeranno più i seguenti comportamenti: conformità al protocollo NSCopying, hashability ed equabilità personalizzate e conformità a NSSecureCoding. Per ulteriori dettagli, gli sviluppatori possono consultare il registro modifiche.
• Abbiamo anche apportato altri aggiornamenti ai tipi di interfacce di segnalazione degli eventi nell'app in modo da utilizzare nomi di parametri ed eventi nell'app formali. Gli sviluppatori che lavorano con codice Swift devono utilizzare le istanze AppEvents.Name e AppEvents.ParameterName per rappresentare rispettivamente i nomi degli eventi nell'app e dei parametri. Gli sviluppatori che lavorano con codice Objective-C possono continuare a utilizzare i valori di stringa per fare riferimento alle interfacce di segnalazione. Per ulteriori dettagli, gli sviluppatori possono consultare il registro modifiche.

Migrazione dei componenti di gaming da ShareKit a GamingServicesKit

Nell'ambito del rilascio dell'SDK v13.0, abbiamo eseguito la migrazione di sei tipi pubblici di componenti di gaming da ShareKit a GamingServicesKit e anche questi tipi pubblici sono stati convertiti da Objective-C a Swift. I sei tipi pubblici migrati sono: GameRequestActionType, GameRequestContent, GameRequestDialog, GameRequestDialogDelegate, GameRequestFilter e GameRequestURLProvider.

Obsolescenze e modifiche sostanziali

Richiesta di autorizzazione incorporata per l'ID dell'inserzionista Android nell'SDK di Facebook per Android

Ora l'Android SDK v13.0 include una richiesta di autorizzazione per l'ID dell'inserzionista Android per impostazione predefinita. Questa modifica è stata apportata in linea con la normativa di Google Play Services sugli ID dell'inserzionista. Chiediamo agli sviluppatori di intraprendere le azioni necessarie prima di aprile 2022 al fine di evitare interruzioni dei servizi nell'app.

• Tutti gli sviluppatori che utilizzano Android SDK v12.1 e versioni precedenti devono eseguire l'aggiornamento alla v13.0.
• Gli sviluppatori che utilizzano App Events devono eseguire i seguenti passaggi:
  • se utilizzano v12.1 o versioni precedenti: eseguire l'aggiornamento a v13.0;
  • se utilizzano v12.2 o 12.3: includere una richiesta di autorizzazione per l'ID dell'inserzionista Android nel file manifest dell'app per ricevere un ID dell'inserzionista valido (ulteriori informazioni qui);
  • se utilizzano v13.0 e versioni successive: non è richiesta alcuna azione, infatti la richiesta di autorizzazione per l'ID dell'inserzionista Android è inclusa per impostazione predefinita.
• Gli sviluppatori che non utilizzano App Events devono eseguire i seguenti passaggi:
  • se utilizzano v12.3 o versioni precedenti: assicurarsi che il flag App Events sia disabilitato (ulteriori informazioni qui);
  • se utilizzano v13.0 e versioni successive: assicurarsi che il flag App Events sia disabilitato (ulteriori informazioni qui) e rimuovere la richiesta di autorizzazione per l'ID dell'inserzionista Android (ulteriori informazioni qui).

Diviene effettivo il requisito di incorporazione del token client nell'SDK

A partire dal rilascio dell'SDK v13.0 della piattaforma, gli sviluppatori devono incorporare un token client nell'SDK per le chiamate all'API Graph. L'inclusione dei token client nell'SDK ci consente di analizzare i problemi della piattaforma in modo più efficiente e migliorare le prestazioni della piattaforma nel suo insieme. Con il lancio dell'SDK v13.0 della piattaforma, utilizzeremo i token client per elaborare le chiamate all'API Graph quando un token d'accesso o di autenticazione non è disponibile. Di conseguenza, tutte le app che utilizzano l'SDK v13.0 e versioni successive che non includono un token client genereranno un'eccezione al momento dell'inizializzazione dell'SDK. Per evitare interruzioni del servizio, gli sviluppatori possono consultare maggiori informazioni su come incorporazione il token client della loro app nell'Android SDK qui e nell'iOS SDK qui.

Diviene effettivo il requisito di utilizzo del bytecode di Java 8

In linea con l'avviso di Kotlin che il compilatore Kotlin/JVM produrrà bytecode di Java 8 per impostazione predefinita, gli sviluppatori che utilizzano l'SDK di Facebook per Android devono eseguire l'aggiornamento al bytecode di Java 8 per evitare di riscontrare problemi durante la compilazione dell'app. Qui sono disponibili maggiori informazioni per gli sviluppatori su come eseguire l'aggiornamento al bytecode di Java 8.

Obsolescenza dell'SDK della piattaforma v12.0

Con il rilascio dell'SDK v13.0, annunciamo che l'SDK v12.0 si trova in uno stato di obsolescenza per un periodo di 2 anni. Durante questo periodo di obsolescenza, non verrà garantito alcun supporto di manutenzione formale per eventuali problemi emersi in merito all'SDK v12.0. Alla fine del periodo di obsolescenza di 2 anni, l'SDK v12.0 non sarà più né disponibile né operativo. Alla luce dello stato di obsolescenza dell'SDK v12.0, gli sviluppatori sono incoraggiati a iniziare il processo di migrazione all'SDK v13.0 il prima possibile per utilizzare l'SDK più recente e migliore e ricevere supporto di manutenzione formale.

Versioni dichiarate obsolete

Di seguito sono riportate le versioni dichiarate obsolete degli SDK della piattaforma Facebook e le date correlate:

• 24 febbraio 2022: SDK iOS e Android v12 (dichiarati obsoleti)
• 21 ottobre 2021: SDK iOS e Android v11 (dichiarati obsoleti)
• 8 giugno 2021: SDK iOS, Android e Unity v9 (dichiarati obsoleti)
• 19 gennaio 2021: SDK iOS, Android e Unity v8.2 e versioni precedenti (dichiarati obsoleti)

Registro modifiche

Visita il nostro registro modifiche per consultare modifiche specifiche apportate agli SDK e non perderti i miglioramenti pianificati:

• SDK di Facebook per iOS
• SDK di Facebook per Android