Apresentamos a versão 13.0 do SDK da plataforma do Facebook e as atualizações relacionadas

Hoje, estamos lançando a versão 13.0 do SDK do Facebook e atualizações adicionais aos SDKs da plataforma do Facebook. Esta publicação descreve essas atualizações e as etapas que os desenvolvedores devem seguir para evitar interrupções na integração dos próprios aplicativos à nossa plataforma. Confira a seguir uma rápida visão geral de algumas das atualizações incluídas no lançamento da versão 13.0 do SDK.

• Compatibilidade com a versão 13.0 da Graph API: adicionamos a compatibilidade com a versão 13.0 da Graph API e da API de Marketing.
• Solicitação de permissão incorporada do ID de publicidade do Android no SDK do Facebook para Android: a partir de agora, a versão 13.0 do Android SDK incluirá por padrão uma solicitação de permissão do ID de publicidade do Android, de acordo com a política do Google Play Services sobre identificações de anunciante. Para evitar interrupções no serviço, todos os desenvolvedores que usam o SDK do Facebook para Android precisarão tomar as medidas necessárias antes do início da aplicação planejada do Google em abril de 2022.
• Aplicação de requisito de incorporação de token de cliente no SDK: com o lançamento da versão 13.0 do SDK do Facebook, os desenvolvedores agora precisam incorporar tokens de cliente ao SDK.
• Aplicação de requisito de uso do bytecode Java 8 no SDK: agora, é necessário que os desenvolvedores usem o bytecode do Java 8 para evitar erros de compilação do aplicativo.
• Avisos de versão obsoleta: a versão 12 do SDK (incluindo as versões 12.1, 12.2 etc.) agora está em estado obsoleto. A partir de hoje, os desenvolvedores precisam começar a migração para a versão 13.0, de modo a evitar o uso de SDKs obsoletos nos próprios aplicativos.

Confira abaixo mais detalhes sobre essas atualizações.

Lançamento da versão 13.0 do SDK

Hoje, estamos lançando a versão 13.0 do SDK nas plataformas Android e iOS. Nesse lançamento, incluímos a compatibilidade com a versão 13.0 da Graph API e da API de Marketing do Facebook. Criamos uma publicação de blog para destacar outros avisos, atualizações de produtos e lembretes relacionados ao lançamento da versão 13.0 da Graph API e da API de Marketing.

Outras atualizações importantes

Confira abaixo uma rápida visão geral de outras atualizações e alterações incluídas no lançamento da versão 13.0 do SDK.

Modernização do SDK: conversão de Objective-C para Swift

Estamos convertendo o código do SDK de Objective-C para Swift, de acordo com o processo de modernização dos SDKs da nossa plataforma. O lançamento da versão 13.0 do SDK inclui diversas alterações referentes à conversão que podem exigir ações dos desenvolvedores. Essas mudanças incluem o seguinte:

• Alguns tipos foram convertidos de Objective-C para Swift. Talvez os desenvolvedores precisem de declarações de importação modular ao usar o GamingServicesKit e a maior parte do ShareKit, a fim de evitar erros de compilação em Objective-C. Nesses casos, os desenvolvedores precisarão usar @import no lugar de #import nos arquivos em Objective-C quando usarem símbolos desses kits. Os desenvolvedores também podem consultar o registro de alterações para mais detalhes sobre como usar declarações de importação modular.
• Além disso, reduzimos ainda mais o uso das práticas de tipo de valor de Objective-C no ShareKit. A partir do lançamento da versão 13.0 do SDK, os tipos de conteúdo do ShareKit deixarão de implementar os seguintes comportamentos: conformidade com o protocolo NSCopying, aplicação de hashes e equidade personalizadas, bem como conformidade com NSSecureCoding. Para mais detalhes, os desenvolvedores podem consultar o registro de alterações.
• Também realizamos mais atualizações aos tipos de interface dos relatórios do evento do aplicativo. Agora, eles usam os nomes formais do evento do aplicativo e do parâmetro. Os desenvolvedores que estiverem usando código Swift precisarão usar as instâncias AppEvents.Name e AppEvents.ParameterName para representar os nomes de evento do aplicativo e de parâmetro, respectivamente. Os desenvolvedores que estiverem trabalhando com código Objective-C podem continuar usando valores de string para fazer referência a interfaces de relatórios. Para mais detalhes, os desenvolvedores podem consultar o registro de alterações.

Migração de componentes de jogos do ShareKit para o GamingServicesKit

Como parte do lançamento da versão 13.0 do SDK, fizemos a migração de seis tipos de componentes públicos de jogos para o GamingServicesKit. Esses tipos públicos também foram convertidos de Objective-C para Swift. Estes são os tipos públicos migrados: GameRequestActionType, GameRequestContent, GameRequestDialog, GameRequestDialogDelegate, GameRequestFilter e GameRequestURLProvider.

Versões obsoletas e alterações disruptivas

Solicitação de permissão incorporada do ID de publicidade do Android no SDK do Facebook para Android

A versão 13.0 do Android SDK agora inclui uma solicitação de permissão do ID de publicidade do Android por padrão. Essa alteração foi realizada de acordo com a política do Google Play Services sobre identificações de anunciante. Para evitar interrupções de serviços nos próprios aplicativos, solicitamos que os desenvolvedores realizem as ações abaixo até abril de 2022.

• Todos os desenvolvedores que usam a versão 12.1 do Android SDK ou anteriores devem atualizar para a versão 13.0.
• Os desenvolvedores que usam Eventos do Aplicativo precisam seguir as etapas abaixo.
  • Se estiver usando a versão 12.1 ou anteriores: atualize para a versão 13.0.
  • Se estiver usando a versão 12.2 ou 12.3: inclua uma solicitação de permissão do ID de publicidade do Android no arquivo de manifesto do aplicativo para receber uma identificação de anunciante válida (saiba mais aqui).
  • Se estiver usando a versão 13.0 ou posteriores: nenhuma ação é necessária, pois a solicitação de permissão do ID de publicidade do Android está incluída por padrão.
• Os desenvolvedores que não usam Eventos do Aplicativo precisam seguir as etapas abaixo.
  • Se estiver usando a versão 12.3 ou anteriores: verifique se a sinalização de Eventos do Aplicativo está desativada (saiba mais aqui).
  • Se estiver usando a versão 13.0 ou posteriores: verifique se a sinalização de Eventos do Aplicativo está desativada (saiba mais aqui) e remova a solicitação de permissão do ID de publicidade do Android (saiba mais aqui).

Aplicação de requisito de incorporação de tokens de cliente no SDK

A partir do lançamento da versão 13.0 do SDK da plataforma, os desenvolvedores precisarão incorporar um token de cliente ao SDK para chamadas da Graph API. A inclusão de tokens de cliente no SDK permite a análise de problemas da plataforma de forma mais eficiente, além de melhorar o desempenho da plataforma como um todo. Com a versão 13.0 do SDK da plataforma, usaremos tokens de cliente para processar chamadas da Graph API quando o token de acesso ou de autenticação estiver indisponível. Dessa forma, os aplicativos que usarem a versão 13.0 ou superior do SDK e não incluírem o token de cliente criarão uma exceção na inicialização do SDK. Para evitar interrupções no serviço, os desenvolvedores vejam mais sobre como incorporar o token de cliente do aplicativo ao Android SDK aqui e ao SDK do iOS aqui.

Aplicação de requisito de uso do bytecode Java 8 no SDK

De acordo com o anúncio da Kotlin de que o compilador Kotlin/JVM produzirá bytecode do Java 8 por padrão, solicitaremos que os desenvolvedores que usam o SDK do Facebook para Android façam a atualização para esse código, a fim de evitar problemas durante a compilação de aplicativos. Os desenvolvedores podem saber mais sobre a atualização para o bytecode Java 8 aqui.

Versão 12.0 do SDK da plataforma se torna obsoleta

Com o lançamento da versão 13.0 do SDK, anunciamos que a versão 12.0 do SDK ficará em estado obsoleto por dois anos. Durante esse período, não haverá suporte formal de manutenção para quaisquer problemas na versão 12.0 do SDK. Ao final dos dois anos, a versão 12.0 do SDK será descontinuada e deixará de funcionar. Devido ao fato de que a versão 12.0 do SDK se tornou obsoleta, incentivamos os desenvolvedores a iniciarem o processo de migração para a versão 13.0 assim que possível. Assim, poderão usar o melhor e mais recente SDK e acessar suporte formal de manutenção.

Versões obsoletas

Confira abaixo as versões obsoletas dos SDKs da plataforma do Facebook e as datas associadas.

• 24 de fevereiro de 2022: versão 12 do SDK do iOS e do Android SDK (obsoleta)
• 21 de outubro de 2021: versão 11 do SDK do iOS e do Android SDK (obsoleta)
• 8 de junho de 2021: versão 9 do SDK do iOS, do Android SDK e do SDK do Unity (obsoleta)
• 19 de janeiro de 2021: versão 8.2 e anteriores do SDK do iOS, do Android SDK e do SDK do Unity (obsoletas)

Registro de alterações

Acesse os registros de alterações para analisar alterações específicas aos SDKs e ficar por dentro de melhorias planejadas:

• SDK do Facebook para iOS
• SDK do Facebook para Android