Presentación de la versión 13.0 del SDK de la plataforma de Facebook y novedades relacionadas

Hoy lanzamos la versión 13.0 del SDK de Facebook y otras novedades adicionales para los SDK de nuestra plataforma. En esta publicación se describen dichas novedades y los pasos necesarios que deben seguir los desarrolladores para evitar interrupciones en la integración de sus aplicaciones con nuestra plataforma en caso de ser necesario. A continuación, se presenta un breve resumen de algunas de las novedades incluidas como parte del lanzamiento de la versión 13.0 del SDK:

• Compatibilidad de la versión 13.0 de la API Graph: añadimos compatibilidad con la versión 13.0 de la API Graph y la API de marketing.
• Solicitud insertada de permisos para el identificador del anunciante de Android en el SDK de Facebook para Android: la versión 13.0 del SDK para Android ahora incluirá una solicitud de permisos para el identificador del anunciante de Android de manera predeterminada, de conformidad con la política de Google Play Services sobre identificadores del anunciante. Todos los desarrolladores que utilicen el SDK de Facebook para Android tendrán que adoptar medidas antes del inicio del requisito planificado de Google en abril de 2022 para evitar interrupciones en el servicio.
• Entrada en vigor del requisito de insertar el identificador de acceso del cliente en el SDK: con el lanzamiento de la versión 13.0 del SDK de Facebook, los desarrolladores ahora deben insertar los identificadores de acceso del cliente en el SDK.
• Entrada en vigor del requisito de usar el código de bytes de Java 8: exigimos a los desarrolladores utilizar el código de bytes de Java 8 a fin de evitar errores de compilación de la aplicación.
• Anuncios de retirada: la versión 12 del SDK (incluidas la 12.1, 12.2, etc.) ahora se encuentra en estado de retirada. A partir de hoy, los desarrolladores deben empezar a migrar a la versión 13.0 a fin de evitar usar los SDK retirados para sus aplicaciones.

Puedes encontrar información adicional sobre estas novedades a continuación.

Lanzamiento de la versión 13.0 del SDK

Hoy se lanza la versión 13.0 del SDK de nuestra plataforma para Android y iOS. Como parte de este lanzamiento, añadimos compatibilidad del SDK con la versión 13.0 de la API Graph y la API de marketing de Facebook. Hemos creado esta publicación en el blog para destacar más anuncios, novedades sobre los productos y recordatorios relacionados con el lanzamiento de la versión 13.0 de la API Graph y la API de marketing.

Otras novedades importantes

A continuación, se presenta un resumen de otras novedades y cambios que se incluyen como parte del lanzamiento de la versión 13.0 del SDK:

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

Estamos convirtiendo el código del SDK de Objective-C a Swift en consonancia con la modernización de los SDK de nuestra plataforma. El lanzamiento de la versión 13.0 del SDK incluye varios cambios con respecto al esfuerzo de conversión que pueden requerir que los desarrolladores realicen alguna acción. Entre estos cambios, se incluyen los siguientes:

• Varios tipos se han convertido de Objective-C a Swift. Es posible que los desarrolladores necesiten usar instrucciones de importación modular al utilizar GamingServicesKit y la mayor parte del kit ShareKit para evitar errores de compilación en Objective-C. En estos casos, los desarrolladores tendrán que usar @import en lugar de #import en archivos de Objective-C al utilizar símbolos de estos kits. Los desarrolladores también pueden consultar el registro de cambios para obtener más información sobre cómo usar las instrucciones de importación modular.
• Asimismo, reducimos todavía más el uso de las prácticas de tipos de valor de 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: el cumplimiento del protocolo NSCopying, las capacidades personalizadas de equiparación y aplicación de hash, y el cumplimiento del protocolo NSSecureCoding. Los desarrolladores pueden consultar el registro de cambios para obtener información adicional.
• También hemos realizado actualizaciones adicionales en los tipos de interfaces de informes de eventos de la aplicación para que ahora usen nombres formales de parámetros y eventos de la aplicación. Los desarrolladores que trabajan en código Swift deben usar las instancias AppEvents.Name y AppEvents.ParameterName para representar los nombres de eventos de la aplicación y los nombres de parámetros, respectivamente. Los desarrolladores que trabajan en código Objective-C pueden seguir usando valores de cadena para hacer referencia a las interfaces de informes. Los desarrolladores pueden consultar el registro de cambios para obtener información adicional.

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

Como parte del lanzamiento de la versión 13.0 del SDK, hemos migrado seis tipos públicos de componentes de juegos de ShareKit a GamingServicesKit. Además, dichos tipos públicos se han convertido de Objective-C a Swift. Los seis tipos públicos migrados son los siguientes: GameRequestActionType, GameRequestContent, GameRequestDialog, GameRequestDialogDelegate, GameRequestFilter y GameRequestURLProvider.

Retiradas y cambios de última hora

Solicitud insertada de permisos de identificador del anunciante de Android en el SDK de Facebook para Android

La versión 13.0 del SDK para Android ahora incluye una solicitud de permisos de identificador del anunciante de Android de manera predeterminada. Llevamos a cabo este cambio de conformidad con la política de Google Play Services sobre identificadores del anunciante. Exigimos a los desarrolladores que adopten las medidas señaladas a continuación antes de abril de 2022 para evitar interrupciones en el servicio de su aplicación:

• Todos los desarrolladores que utilicen la versión 12.1 y anteriores del SDK para Android deben actualizarlo a la versión 13.0.
• Los desarrolladores que utilicen eventos de la aplicación deben seguir estos pasos:
  • Si usan la versión 12.1 o anterior, deben realizar la actualización a la versión 13.0.
  • Si usan la versión 12.2 o 12.3, deben incluir una solicitud de permisos de identificador del anunciante de Android en el archivo de manifiesto de la aplicación para recibir un identificador del anunciante válido (más información aquí).
  • Si usan la versión 13.0 o posterior, no es necesario llevar a cabo ninguna acción; la solicitud de permisos de identificador del anunciante de Android se incluye de manera predeterminada.
• Los desarrolladores que no utilicen eventos de la aplicación deben seguir estos pasos:
  • Si usan la versión 12.3 o anterior, deben asegurarse de que la marca de eventos de la aplicación está desactivada (más información aquí).
  • Si usan la versión 13.0 o posterior, deben asegurarse de que la marca de eventos de la aplicación está desactivada (más información aquí) y eliminar la solicitud de permisos de identificador del anunciante de Android (más información aquí).

Entrada en vigor del requisito de insertar el identificador de acceso del cliente en el SDK

A partir del lanzamiento de la versión 13.0 del SDK de la plataforma, los desarrolladores deben insertar un identificador de acceso del cliente en el SDK para realizar llamadas a la API Graph. La inclusión de los identificadores de acceso del cliente en el SDK nos permite analizar los problemas de la plataforma de forma más eficaz y mejorar el rendimiento de la plataforma en su conjunto. Con el lanzamiento de la versión 13.0 del SDK de la plataforma, ahora usaremos identificadores de acceso del cliente para procesar las llamadas a la API Graph cuando un identificador de acceso o autenticación no esté disponible. Como resultado, las aplicaciones que utilicen la versión 13.0 o posterior del SDK que no incluyan un identificador de acceso del cliente devolverán una excepción al inicializar el SDK. Para evitar interrupciones en el servicio, los desarrolladores pueden obtener más información sobre cómo insertar el identificador de acceso del cliente de su aplicación en el SDK para Android en este artículo. Si, por el contrario, quieren insertarlo en el SDK para iOS, deben consultar este otro artículo.

Entrada en vigor del requisito de usar el código de bytes de Java 8

De conformidad con el anuncio de Kotlin de que el compilador de Kotlin/JVM producirá un código de bytes de Java 8 de manera predeterminada, ahora exigimos a los desarrolladores que utilizan el SDK de Facebook para Android actualizar al código de bytes de Java 8 para evitar problemas durante la compilación de la aplicación. Los desarrolladores pueden obtener más información sobre la actualización al código de bytes de Java 8 aquí.

Retirada de la versión 12.0 del SDK de la plataforma

Con el lanzamiento de la versión 13.0 del SDK, anunciamos que la versión 12.0 se encontrará en estado de retirada durante un periodo de 2 años. Durante este periodo de retirada, no se proporcionará asistencia de mantenimiento formal para los problemas que se produzcan en la versión 12.0 del SDK. Al final de este periodo de retirada de 2 años, la versión 12.0 del SDK dejará de estar disponible y operativa. Ante la retirada de la versión 12.0 del SDK, recomendamos a los desarrolladores iniciar el proceso de migración a la versión 13.0 lo antes posible para usar el mejor y más reciente SDK con asistencia de mantenimiento formal.

Retiradas de versiones

A continuación, se incluyen las versiones retiradas de los SDK de la plataforma de Facebook y las correspondientes fechas:

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

Registro de cambios

Consulta el registro de cambios para revisar las modificaciones específicas de los SDK y estar al día de las mejoras previstas:

• SDK de Facebook para iOS
• SDK de Facebook para Android