Fique por dentro dos destaques do Firebase no Google I/O 2023. Saiba mais

Migrar para o uso das APIs de extensão do Swift nos módulos principais

Estamos mesclando nossos SDKs de extensão do Swift nos SDKs principais para disponibilizar as APIs nativas do Swift de maneira mais ampla e aumentar nossa capacidade de oferecer suporte a novos recursos da linguagem Swift no futuro. As mudanças que estamos fazendo e os impactos esperados nos projetos estão documentados abaixo.

O que muda?

A partir do SDK do Firebase para Apple 10.17.0, os SDKs de extensão do Swift foram mesclados nos SDKs principais correspondentes. Por exemplo, todas as APIs do módulo FirebaseFirestoreSwift foram adicionadas a FirebaseFirestore. Portanto, não é mais necessário importar o módulo FirebaseFirestoreSwift para acessar essas APIs.

Como todas as extensões Swift agora fazem parte dos módulos principais, os SDKs de extensão não são mais necessários e foram descontinuados. A inclusão ou o uso dos SDKs de extensão do Swift vai gerar um aviso do compilador e, a partir de fevereiro de 2024, vamos parar de lançar as extensões do Swift.

★ Observação: as versões atuais ou anteriores das extensões Swift continuarão funcionando. No entanto, recomendamos que você migre seu app para usar as APIs Swift do módulo principal. Assim, você vai continuar recebendo correções e vai poder aproveitar as mudanças e os novos recursos.

Datas importantes para essa mudança

Em outubro de 2023

Os SDKs de extensão do Swift foram mesclados aos SDKs principais e foram descontinuados e substituídos pelos SDKs principais. Consulte as notas da versão 10.17.0 que anunciam essa mudança.

Agora você pode usar as APIs do SDK de extensão do Swift diretamente dos módulos principais do SDK. O uso dos SDKs de extensão ainda será possível até o próximo lançamento da versão principal, mas um aviso de descontinuação será exibido quando usados.

A partir de fevereiro de 2024.

Não lançaremos novas versões das extensões do Swift e removeremos as extensões do Swift do Package.swift do Firebase. As versões mais antigas continuarão funcionando, mas não receberão atualizações.

Como migrar para usar APIs nativas do Swift do módulo principal

Se você não usa os SDKs de extensão do Swift no momento, nenhuma ação é necessária. Se você usa um SDK de extensão do Swift, faça as mudanças a seguir no seu projeto.

Alterações na área de trabalho

Gerenciador de pacotes do Swift

Depois de atualizar o Firebase para a versão 10.17.0 ou mais recente, navegue até a seção "Frameworks, Bibliotecas e Conteúdo incorporado" na guia "Geral" das configurações do destino e remova o SDK de extensão do Swift (como FirebaseFirestoreSwift).

CocoaPods

Depois de atualizar o Firebase para a versão 10.17.0 ou mais recente, acesse o Podfile e remova a linha correspondente à dependência do projeto ao adicionar a seção de frameworks do destino e remova o SDK de extensão do Swift (como pod, por exemplo, FirebaseFirestoreSwift). Em seguida, execute novamente o comando pod install.

Distribuição de ZIP e Cartago

Depois de atualizar o Firebase para a versão 10.17.0 ou mais recente, remova qualquer extensão do Swift xcframeworks do seu projeto (como FirebaseFirestoreSwift.xcframework).

Mudanças no código-fonte

Para todos os SDKs de extensão do Swift usados anteriormente, realize as seguintes ações:

Exclua todas as instruções de importação que fazem referência ao SDK de extensão do Swift. Se o SDK principal não tiver sido importado separadamente, você vai precisar substituir a importação da extensão do Swift pela importação principal do SDK, excluindo o Swift no final da linha.
Se você usou o namespace do módulo explícito do Swift para fazer referência a qualquer tipo de SDK de extensão do Swift, será necessário substituí-los pelo SDK principal correspondente. Por exemplo, FirebaseFirestoreSwift.QueryPredicate precisaria ser renomeado como FirebaseFirestore.QueryPredicate.