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
Swiftno 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.QueryPredicateprecisaria ser renomeado comoFirebaseFirestore.QueryPredicate.