Présentation du SDK de la plateforme Facebook v13.0 et des mises à jour connexes

Aujourd’hui marque la sortie du SDK Facebook v13.0 et de mises à jour supplémentaires pour les SDK de la plateforme Facebook. Cette publication présente ces mises à jour et la procédure que les développeurs et développeuses doivent éventuellement suivre pour éviter les problèmes lors de l’intégration de leurs applications à notre plateforme. Voici un bref aperçu de certaines des mises à jour incluses dans le SDK v13.0 :

• Prise en charge de l’API Graph v13.0 : l’API Graph v13.0 et l’API Marketing v13.0 sont à présent prises en charge.
• Demande d’autorisation d’ID d’annonceur Android intégrée dans le SDK Facebook pour Android : Android SDK v13.0 intègre désormais par défaut une demande d’autorisation d’ID d’annonceur Android conforme à la politique de Google Play Services relative aux ID d’annonceurs. Pour éviter les interruptions de service, tous les développeurs et développeuses qui utilisent le SDK Facebook pour Android devront agir avant la mise en application par Google prévue en avril 2022.
• Entrée en vigueur de l’obligation d’intégrer les tokens clients dans le SDK : avec le lancement du SDK Facebook v13.0, les développeurs et développeuses sont désormais tenu·es d’intégrer les tokens clients dans le SDK.
• Entrée en vigueur de l’obligation d’utiliser le d’octet Java 8 : nous demandons désormais aux développeurs et développeuses d’utiliser le code d’octet Java 8 afin d’éviter les erreurs lors de la compilation des applications.
• Annonces de fin de prise en charge : le SDK v12 (y compris les versions v12.1, v12.2, etc.) sera bientôt obsolète. À compter d’aujourd’hui, nous recommandons aux développeurs et développeuses de commencer à migrer vers la version 13.0 afin d’éviter l’utilisation de SDK obsolètes dans leurs applications.

Vous trouverez ci-dessous de plus amples informations sur ces mises à jour.

Lancement du SDK v13.0

Le SDK de la plateforme Facebook v13.0 sort aujourd’hui sur les plateformes Android et iOS. Cette version prend dorénavant en charge l’API Facebook Graph v13.0 et l’API Marketing v13.0. Nous avons créé une publication de blog pour mettre en avant les annonces supplémentaires, les mises à jour de produits et les rappels liés au lancement de ces nouvelles versions.

Autres mises à jour clés

Voici un aperçu des différentes mises à jour et modifications incluses dans le SDK v13.0 :

Modernisation des SDK avec la conversion du code Objective-C en Swift

Dans le cadre de la modernisation de nos SDK de plateforme, nous convertissons actuellement le code Objective-C en Swift. Le SDK v13.0 intègre plusieurs modifications issues de nos efforts de conversion qui peuvent nécessiter une action de la part des développeurs et développeuses. Ces changements incluront ce qui suit :

• Un certain nombre d’entrées Objective-C ont été converties en Swift. Afin d’éviter les erreurs de compilation en Objective-C, les développeurs et développeuses devront peut-être utiliser des instructions d’importation modulaires lorsqu’ils et elles ont recours à GamingServicesKit et à la majorité des ShareKits. Dans ces cas de figure, ils et elles devront opter pour @import plutôt que pour #import dans les fichiers Objective-C lors de l’utilisation de symboles issus de ces kits. Les développeurs et développeuses peuvent également consulter le changelog pour savoir comment utiliser les instructions d’importation modulaires.
• Par ailleurs, nous continuons à réduire l’utilisation des pratiques de type de valeur Objective-C dans ShareKit. À partir de la version 13.0 du SDK, les types de contenu ShareKit n’appliqueront plus les comportements suivants : conformité au protocole NSCopying, possibilité de hachage et de concordance personnalisés, et conformité avec NSSecureCoding. Les développeurs et développeuses peuvent consulter le changelog pour en savoir plus.
• Nous avons également mis à jour les types d’interfaces de signalement d’événements d’applications de manière à utiliser désormais des noms officiels d’événements d’applications et de paramètres. Les développeurs et développeuses travaillant en code Swift sont tenu·es d’utiliser les instances AppEvents.Name et AppEvents.ParameterName pour représenter respectivement les noms d’événements d’applications et de paramètres. Les développeurs et développeuses travaillant en code Objective-C peuvent continuer à utiliser des valeurs de chaîne pour référencer les interfaces de signalement. Ils et elles peuvent consulter le changelog pour en savoir plus.

Migration des composantes de jeux ShareKit vers GamingServicesKit :

Dans le cadre du lancement du SDK v13.0, nous avons migré six types publics de composantes de jeux ShareKit vers GamingServicesKit et les avons convertis en Swift. Ces opérations concernent GameRequestActionType, GameRequestContent, GameRequestDialog, GameRequestDialogDelegate, GameRequestFilter et GameRequestURLProvider.

Abandons et modifications importantes :

Demande d’autorisation d’ID d’annonceur Android intégrée dans le SDK Facebook pour Android :

Android SDK v13.0 inclut désormais par défaut une demande d’autorisation pour d’ID d’annonceur Android. Cette modification s’inscrit dans la lignée de la politique de Google Play Services sur les ID d’annonceur. Nous demandons aux développeurs et développeuses de prendre les mesures ci-dessous avant le mois d’avril 2022 afin d’éviter toute interruption de service sur leurs applications :

• Tous les développeurs et développeuses utilisant Android SDK v12.1 et les versions précédentes doivent effectuer une mise à jour vers la version 13.0.
• Les développeurs et développeuses qui utilisent App Events doivent prendre les mesures suivantes :
  • Pour la version 12.1 ou les précédentes : mise à jour vers la version 13.0.
  • Pour la version 12.2 ou 12.3 : ajout d’une demande d’autorisation d’ID d’annonceur Android dans le fichier App Manifest pour recevoir un ID d’annonceur valide (pour en savoir plus, cliquez ici).
  • Pour la version 13.0 ou les suivantes : aucune action n’est requise. La demande d’autorisation d’ID d’annonceur Android est incluse par défaut.
• Les développeurs et développeuses qui n’utilisent pas App Events doivent prendre les mesures suivantes :
  • Pour la version 12.3 ou les précédentes : s’assurer que le marqueur App Events est désactivé (pour en savoir plus, cliquez ici).
  • Pour la version 13.0 ou les suivantes : s’assurer que le marqueur App Events est désactivé (pour en savoir plus, cliquez ici) et supprimer la demande d’autorisation d’ID d’annonceur Android (pour en savoir plus, cliquez ici).

Entrée en vigueur de l’obligation d’intégrer les tokens clients dans le SDK :

Avec la sortie du SDK de la plateforme Facebook v13.0, les développeurs et développeuses sont désormais tenu·es d’intégrer les tokens clients dans le SDK pour les appels d’API Graph. Cette intégration nous permet d’analyser plus efficacement les problèmes rencontrés sur la plateforme et, de manière générale, d’en améliorer les performances. Avec la sortie du SDK de la plateforme Facebook v13.0, nous utiliserons désormais les tokens clients pour traiter les appels d’API Graph en l’absence de token d’accès ou d’authentification. Par conséquent, toutes les applications qui sont basées sur le SDK v13.0 et les versions suivantes et qui n’incluent pas de token client généreront une exception lors de l’initialisation du SDK. Pour éviter les interruptions de service, les développeurs et développeuses peuvent consulter la méthode d’intégration des tokens clients de leurs applications dans Android SDK en cliquant ici, et dans iOS SDK en suivant ce lien.

Entrée en vigueur de l’obligation d’utiliser le code d’octet Java 8 :

Kotlin a récemment annoncé que le compilateur Kotlin/JVM produira du code d’octet Java 8 par défaut. Conformément à cette annonce, nous demandons désormais aux développeurs et développeuses utilisant le SDK Facebook pour Android de passer au code d’octet Java 8 afin d’éviter les erreurs lors de la compilation des applications. Les développeurs et développeuses peuvent en savoir plus sur le passage au code d’octet Java 8 en cliquant ici.

Fin de la prise en charge du SDK de plateforme v12.0 :

La sortie du SDK v13.0 marque le début d’une période de deux ans pendant laquelle le SDK v12.0 sera considéré comme obsolète. Pendant cette période de deux ans, aucune assistance de maintenance officielle ne sera donc fournie pour les problèmes rencontrés avec le SDK v12.0. À la fin de cette période, le SDK v12.0 sera abandonné et ne sera plus opérationnel. Nous conseillons donc vivement aux développeurs et développeuses à migrer au plus tôt vers le SDK v13.0 afin de bénéficier d’un SDK récent et amélioré et d’une assistance de maintenance officielle.

Versions abandonnées :

Vous trouverez ci-dessous la liste des versions obsolètes du SDK de la Facebook et les dates associées :

• 24 février 2022 : iOS et Android SDK v12 (obsolètes)
• 21 octobre 2021 : iOS et Android SDK v11 (obsolètes)
• 8 juin 2021 : iOS, Android et Unity SDK v9 (obsolètes)
• 19 janvier 2021 : iOS, Android et Unity SDK v8.2 et précédentes (obsolètes)

Changelog :

Consultez nos changelogs pour prendre connaissance des modifications spécifiques apportées aux SDK et demeurer informé·es des améliorations prévues :

• SDK Facebook pour iOS
• SDK Facebook pour Android