Volver a las novedades para desarrolladores

Presentación de la versión 13.0 del SDK de la plataforma de Facebook y las actualizaciones relevantes

24 de febrero de 2022DeJim Phillips

Hoy lanzamos la versión 13.0 del SDK de Facebook y las actualizaciones adicionales de nuestros SDK de la plataforma de Facebook. En esta publicación, se detallan las actualizaciones y los pasos que deberían realizar los desarrolladores, de ser necesario, para evitar que se produzcan interrupciones en la integración de sus apps con nuestra plataforma. Este es un breve resumen de algunas de las actualizaciones que se incluyen en el lanzamiento de la versión 13.0 del SDK:

  • Compatibilidad de la versión 13.0 de la API Graph API: ampliamos la compatibilidad de la versión 13.0 de la API Graph y de la API de marketing.
  • Solicitud de permiso integrada para el ID del anunciante de Android en el SDK de Facebook para Android: la versión 13.0 del SDK de Android contará ahora con una solicitud de permiso predeterminada para el ID del anunciante de Android de conformidad con la política de identificadores del anunciante de Google Play Services. A fin de evitar que se produzcan interrupciones en el servicio, todos los desarrolladores que utilicen el SDK de Facebook para Android deberán tomar medidas antes de abril de 2022, fecha en la que Google comenzará a aplicar las políticas.
  • Entra en vigor el requisito de insertar el token de cliente en el SDK: con el lanzamiento de la versión 13.0 del SDK de Facebook, los desarrolladores deben insertar ahora los tokens de cliente en el SDK.
  • Entra en vigor el requisito de usar bytecode de Java 8: es necesario que los desarrolladores usen ahora bytecode de Java 8 para evitar que se produzcan errores en la compilación de las apps.
  • Anuncios de elementos obsoletos: la versión 12.0 del SDK (también la versión 12.1, la 12.2, etc.) quedarán obsoletas desde ahora. A partir del día de hoy, los desarrolladores deberán comenzar a migrar a la versión 13.0 para evitar usar SDK obsoletos para las apps.

Podrás encontrar a continuación información adicional sobre estas actualizaciones.

Lanzamiento de la versión 13.0 del SDK

Hoy se lanza la versión 13.0 del SDK de la plataforma para todas las plataformas Android y iOS. Como parte de este lanzamiento, ampliamos la compatibilidad del SDK con la versión 13.0 de la API Graph de Facebook y de la API marketing. Creamos esta publicación de blog para destacar los anuncios adicionales, las actualizaciones de productos y los recordatorios relacionados con el lanzamiento de la versión 13.0 de la API Graph y de la API de marketing.

Otras actualizaciones clave

Lo que sigue a continuación es un resumen de las actualizaciones de algunos de los cambios que se incluyen en el lanzamiento de la versión 13.0 del SDK:

Modernización del SDK: conversión de Objective-C a Swift

Estamos en proceso de conversión del código del SDK de Objective-C a Swift como consecuencia de la modernización de los SDK de la plataforma. El lanzamiento de la versión 13:0 del SDK incluye varios cambios relacionados con la iniciativa de conversión que requerirá de la intervención de los desarrolladores. Entre los cambios, se incluyen los siguientes:

  • Se convirtió una cantidad de tipos de Objective-C a Swift. Es posible que los desarrolladores necesiten usar instrucciones de importación modular cuando usan GamingServicesKit y la mayoría de ShareKit. De esta manera, evitan que se produzcan errores de compilación en Objective-C. En estos casos, los desarrolladores deberán usar @import en vez de #import en los archivos de Objective-C cuando se utilicen los símbolos de estos kits. Los desarrolladores también podrán consultar el registro de cambios para obtener mayor información sobre cómo usar las instrucciones de importación modular.
  • Asimismo, nos encontramos reduciendo el uso de las prácticas de tipo-valor en Objective-C en ShareKit. A partir del lanzamiento de la versión 13.0 del SDK, los tipos de contenido de ShareKit dejarán de implementar los siguientes comportamientos: conformidad con el protocolo NSCopying, la posibilidad de utilizar equiparaciones y hashtags personalizados y conformidad con NSSecureCoding. Los desarrolladores pueden consultar el registro de cambios para obtener información detallada adicional.
  • También realizamos más actualizaciones de los tipos de interfaces de generación de eventos de la app. Ahora usan nombres de parámetros y de eventos de la app formales. Los desarrolladores que trabajan con código Swift deben usar las instancias AppEvents.Name y AppEvents.ParameterName para presentar los nombres de eventos de la app y los nombres de los parámetros, respectivamente. Los desarrolladores que trabajen con código Objective-C pueden continuar usando los valores de cadena para consultar las interfaces de generación de informes. Los desarrolladores pueden consultar el registro de cambios para obtener información detallada adicional.

Migración de los componentes de juegos de ShareKit a GamingServicesKit:

Como parte del lanzamiento de la versión 13.0 del SDK, migramos seis tipos públicos de componentes de juegos de ShareKit a GamingServicesKit. También se convirtieron estos tipos públicos de Objective-C a Swift. Los seis tipos públicos migrados son los siguientes: GameRequestActionType, GameRequestContent, GameRequestDialog, GameRequestDialogDelegate, GameRequestFilter y GameRequestURLProvider.

Elementos obsoletos y cambios radicales:

Solicitud de permiso integrada para el ID del anunciante de Android en el SDK de Facebook para Android:

La versión 13.0 del SDK de Android incluye ahora una solicitud de permiso predeterminada para el ID del anunciante de Android. Este cambio se produce de conformidad con la política de identificadores del anunciante de Google Play Services. Les solicitamos a los desarrolladores que lleven a cabo las acciones que se describen a continuación antes de abril de 2022 para evitar que se interrumpa el servicio en sus apps:

  • Todos los desarrolladores que usen la versión 12.1 y anteriores deben actualizarla a la versión 13.0.
  • Los desarrolladores que utilicen los eventos de la app deben realizar los siguientes pasos:
    • Si usan la versión 12.1 o anteriores, deben actualizar a la versión 13.0.
    • Si usan la versión 12.2 o 12.3, deben incluir una solicitud de permiso de identificador del anunciante de Android en el archivo de manifiesto para recibir un identificador del anunciante válido (más información aquí).
    • Si usan la versión 13.0 o posteriores, no es necesario que realicen ninguna acción, ya que la solicitud de permiso de identificador del anunciante de Android está incluida de forma predeterminada.
  • Los desarrolladores que no utilicen los eventos de la app deben realizar los siguientes pasos:
    • Si usan la versión 12.3 o anteriores, deben asegurarse de que esté desactivado el marcado de los eventos de la app (más información aquí).
    • Si usan la versión 13.0 o posteriores, deben asegurarse de que esté desactivado el marcado de los eventos de la app (más información aquí) y de eliminar la solicitud de permiso de identificador del anunciante de Android (más información aquí).

El requisito de insertar los tokens de cliente en el SDK entrará en vigor:

Con el lanzamiento de la versión 13.0 del SDK de la plataforma, los desarrolladores deberán insertar ahora un token de cliente en el SDK para las llamadas de la API Graph. Incluir los tokens de cliente en el SDK nos permite analizar los problemas de la plataforma de una manera más efectiva y mejorar el rendimiento de toda la plataforma. Con el lanzamiento de la versión 13.0 del SDK de la plataforma, comenzaremos a usar los tokens de cliente para procesar las llamadas de la API Graph cuando no esté disponible un token de acceso o de autenticación. Como consecuencia, las apps que usen la versión 13.0 o posterior del SDK que no incluya un token de cliente producirán una excepción cuando se inicialice el SDK. Los desarrollador podrán obtener más información sobre cómo insertar el token de cliente de la app en el SDK de Android aquí y en el SDK de iOS aquí y, de esta manera, evitar interrupciones en el servicio.

El requisito para usar bytecode de Java 8 entrará en vigor:

De conformidad con el anuncio de Kotlin de que el compilador de Kotlin/JVM producirá bytecode de Java 8 de manera predeterminada, ahora les solicitamos a los desarrolladores que usen el SDK de Facebook de Android para actualizar a bytecode de Java 8 y, de esta manera, evitar que se produzcan errores cuando se compila la app. Los desarrolladores podrán obtener más información sobre la actualización a bytecode de Java 8 aquí.

Discontinuación de la versión 12.0 del SDK de la plataforma:

Con el lanzamiento de la versión 13.0 del SDK, anunciaremos que la versión 12.0 del SDK pasará ahora a un estado de obsolescencia por un período de 2 años. Durante este período, no se proporcionará soporte formal de mantenimiento para ninguno de los errores que se produzcan en la versión 12.0 del SDK. Una vez finalizado el período de discontinuación de 2 años, la versión 12.0 del SDK quedará obsoleta y dejará de funcionar. Dada la obsolescencia de la versión 12.0 del SDK, se les recomienda a los desarrolladores que comiencen a migrar a la versión 13.0 del SDK tan rápido como les sea posible y, de esta manera, poder usar el SDK más nuevo y más actualizado con soporte formal de mantenimiento.

Versiones obsoletas:

A continuación, encontrarás las versiones obsoletas de los SDK de la plataforma de Facebook y las fechas correspondientes:

  • 24 de febrero de 2022: versión 12 del SDK para iOS y Android (obsoleta)
  • 21 de octubre de 2021: versión 11 del SDK para iOS y Android (obsoleta)
  • 8 de junio de 2021: versión 9 del SDK para iOS, Android y Unity (obsoleta)
  • 19 de enero de 2021: versión 8.2 del SDK para iOS, Android y Unity (obsoleta)

Registro de cambios:

Vista nuestro registro de cambios para revisar los cambios específicos que afectan a los SDK y para mantenerte informado sobre las mejoras en curso: