SDK do Facebook para iOS
Voltar para Português (Brasil)
Este documento foi atualizado.
A tradução para Português (Brasil) não foi concluída ainda.
Atualização em inglês: 2 de jun de 2022

Guia de atualização do SDK do Facebook para iOS

É importante atualizar os seus projetos para usar a versão mais recente do SDK do Facebook. Este tópico ensinará as etapas para isso.

Análise das alterações na versão mais recente

Antes de atualizar para a nova versão do SDK do Facebook, analise o registro de alterações no GitHub. Isso ajudará você a entender quais mudanças serão necessárias no código devido à atualização.

Observação: a opção autoInitEnabled foi removida do SDK nas versões 9.0.0 e posteriores. Para iniciar o SDK, é necessário inicializá-lo de modo explícito com o método initializeSDK ou implicitamente por meio de uma chamada em applicationDidFinishLaunching. Para saber mais, confira a seção 9.0.0 do registro de alterações.

Atualização com o Gerenciador de Pacote do Swift (SPM)

Caso o seu aplicativo use o Gerenciador de Pacote do Swift (SPM, pelas iniciais em inglês) para integrar-se ao SDK do Facebook para iOS, siga estas etapas.

Observe que o link acima orienta que você selecione Up to Next Major na opção Version. Isso significa que a ferramenta não atualizará automaticamente além da versão principal que você especificou (se você selecionou 8.x.x, ela não atualizará para uma versão principal 9.x.x). Essa ação ajuda a prevenir que ocorra a atualização para uma versão incompatível com o pacote usado no momento.

Atualização incremental

Caso a atualização de versão seja incremental (como versões secundárias ou com patches).

No Xcode, clique em File > Swift Packages > Update to Latest Package Versions.

A imagem abaixo mostra um exemplo:

Atualização da versão principal

Antes de atualizar a versão principal, verifique os registros de alterações. Se a atualização da versão foi uma alteração na versão principal, talvez seja necessário mudar as configurações do pacote.

  1. Acesse as configurações do projeto e clique na aba Swift Packages. A imagem abaixo mostra um exemplo:

  2. Selecione o pacote Facebook para mostrar as configurações. Altere o campo Version para a versão principal que você deseja (no exemplo da imagem, versão 9.0.0) e clique em Done.

  3. Atualize o pacote. No Xcode, clique em File > Swift Packages > Update to Latest Package Versions. A imagem abaixo mostra um exemplo:

    4. Observe que é possível reverter a versão-alvo alterando a versão principal nas configurações do projeto e executando novamente Update to Latest Package Versions.

Atualização com o CocoaPods

Caso o seu aplicativo use o CocoaPods para se integrar ao SDK do Facebook, siga estas etapas.

  1. Verifique se os pods estão desatualizados. Este comando listará os pods que estão desatualizados.

    pod outdated

  2. Atualize os pods desatualizados com o seguinte comando.

    pod update  [PODNAME]

O CocoaPods buscará uma versão atualizada do pod especificado por [PODNAME] e fará a atualização para a versão mais recente, possivelmente de acordo com as restrições do seu Podfile. Talvez seja necessário modificar as suas restrições para atualizar entre versões principais.

Recompilar e resolver problemas

Depois de finalizar a atualização dos SDKs de destino, recompile e corrija problemas resultantes. Normalmente, você verá erros apenas ao atualizar para novas versões principais.

Verifique o registro de alterações no GitHub para entender possíveis problemas de compilação.

Atualização para uma nova versão da Graph API

Caso você queira atualizar para uma nova versão da Graph API, use a ferramenta de atualização para avaliar as mudanças que serão necessárias no seu aplicativo. Além disso, você pode analisar o registro de alterações da Graph API.