Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Migrar do CocoaPods

O CocoaPods anunciou que se tornará somente leitura em dezembro de 2026, após o que novas versões de pods não poderão mais ser publicadas. As seções a seguir fornecem mais informações sobre essa mudança e explicam como migrar seus apps para outros gerenciadores de instalação.

Visão geral

O que muda? O CocoaPods está passando para um estado somente leitura, e o Firebase vai parar de publicar novas versões no CocoaPods em outubro de 2026.
Meu app vai parar de funcionar? Não. As versões atuais das bibliotecas do Firebase vão permanecer disponíveis indefinidamente no registro do CocoaPods, e seus apps que usam essas versões do CocoaPod vão continuar funcionando.
Por que migrar? Para continuar recebendo os recursos mais recentes, melhorias de desempenho e correções críticas, migre o uso para o Gerenciador de pacotes do Swift ou para a instalação manual.

Para atender ao anúncio do CocoaPods, o Firebase vai parar de publicar novas versões no CocoaPods em outubro de 2026. Essas mudanças afetam todos os pods a seguir e suas subdependências:

Pods do Firebase afetados
`Firebase`	`FirebaseAuth`	`FirebaseInstallations`
`FirebaseABTesting`	`FirebaseCore`	`FirebaseMessaging`
`FirebaseAI`	`FirebaseCrashlytics`	`FirebaseMLModelDownloader`
`FirebaseAILogic`	`FirebaseDatabase`	`FirebasePerformance`
`FirebaseAnalytics`	`FirebaseFirestore`	`FirebaseRemoteConfig`
`FirebaseAppCheck`	`FirebaseFunctions`	`FirebaseStorage`
`FirebaseAppDistribution`	`FirebaseInAppMessaging`

Essas mudanças também vão afetar todas as distribuições do Firebase que envolvem o SDK nativo do Firebase para Apple, incluindo o SDK do Firebase para Unity, SDK do Firebase para C++ e o FlutterFire.

Migrar seus apps da Apple

Se você estiver migrando outras dependências (não do Firebase) do CocoaPods, observe que é uma prática recomendada do setor usar um único método de instalação para todo o projeto. A combinação do CocoaPods e do Gerenciador de pacotes do Swift (SPM, na sigla em inglês) no mesmo destino pode levar a ciclos de dependência complexos e erros de build. Se suas dependências que não são do Firebase ainda não oferecem suporte ao SPM, usar a instalação manual para bibliotecas do Firebase é a maneira mais estável de consolidar seu fluxo de trabalho durante a migração.

Gerenciador de pacotes do Swift (SPM)

O que é o Gerenciador de pacotes do Swift?

O Gerenciador de pacotes do Swift (SPM) é a ferramenta nativa da Apple para gerenciar a distribuição de código. Ele é integrado diretamente ao Xcode, eliminando a necessidade de ferramentas de CLI externas, como o CocoaPods, e simplificando a estrutura do projeto, removendo a necessidade de um .xcworkspace para a maioria das configurações padrão.

Migrar para o uso do Gerenciador de pacotes do Swift

Para a maioria dos projetos, a migração para o Gerenciador de pacotes do Swift não exige a mudança do código do aplicativo, a menos que o projeto tenha configurações ou dependências personalizadas do Xcode que façam uso intenso de scripts de instalação do CocoaPods.

Confira como migrar para o Gerenciador de pacotes do Swift do CocoaPods:

Verifique se cada uma das dependências do seu app oferece suporte ao Gerenciador de pacotes do Swift. Todas as bibliotecas do Firebase oferecem suporte ao SPM, mas você precisa verificar o suporte ao SPM para suas dependências que não são do Firebase nos repositórios do GitHub ou nas páginas de produtos. Se algumas das suas dependências que não são do Firebase não oferecem suporte ao SPM, então usar a instalação manual em vez do SPM é o caminho de migração mais estável do CocoaPods.
Com o Xcode fechado, remova o CocoaPods do seu projeto:
1. Desinstale as dependências do CocoaPods executando o seguinte comando no diretório do projeto:
```
pod deintegrate
```
2. Exclua o .xcworkspace gerado pelo CocoaPods.
No Xcode, atualize seu projeto com as dependências do Gerenciador de pacotes do Swift:
1. Abra o arquivo .xcodeproj do projeto pelo Xcode.
2. Adicione novamente as dependências do app usando File > Add Package Dependencies.
Depois que o pacote do Firebase for adicionado, você poderá atualizar as bibliotecas do Firebase de que depende navegando até as configurações do projeto no Xcode, selecionando o destino do app e atualizando as bibliotecas em Frameworks, Libraries, and Embedded Content.

Saiba mais sobre como usar o SPM no Xcode na documentação da Apple.

Instalação manual

O que é a instalação manual?

A instalação manual envolve o download do arquivo Firebase.zip, que contém XCFrameworks pré-compilados para todos os produtos do Firebase. Isso permite arrastar e soltar SDKs específicos diretamente no projeto do Xcode sem usar um gerenciador de dependências.

Migrar para o uso da instalação manual

Com o Xcode fechado, remova o CocoaPods do seu projeto:
1. Desinstale as dependências do CocoaPods executando o seguinte comando no diretório do projeto:
```
pod deintegrate
```
2. Exclua o .xcworkspace gerado pelo CocoaPods.
Siga as etapas no nosso guia de instalação para adicionar o Firebase ao seu projeto manualmente.

Migrar seus apps do Unity, C++ e Flutter

SDK do Firebase para Unity e FlutterFire

Nenhuma ação é necessária para a maioria dos desenvolvedores do Unity e do Flutter. A atualização para a versão mais recente do Firebase no Unity ou no Flutter migrará automaticamente o gerenciador de dependências subjacente nas plataformas da Apple para o Gerenciador de pacotes do Swift.

Observação: se você estiver gerenciando dependências que não são do Firebase pelo CocoaPods, talvez seja necessário migrá-las manualmente.

SDK do Firebase para C++

Se você estava incluindo as dependências subjacentes do iOS pelo CocoaPods, siga as instruções de migração acima para atualizar as dependências do CocoaPod do Firebase para usar o Gerenciador de pacotes do Swift.

Perguntas frequentes

Preciso continuar usando o CocoaPods após outubro de 2026. Como faço para manter meu app em execução?

Você pode usar as versões antigas dos pods do Firebase ou copiar os podspecs do Firebase do GitHub e hospedá-los no seu próprio repositório de especificações.

Em ambos os casos, recomendamos que você migre do CocoaPods o mais rápido possível. Não vamos oferecer suporte oficial para a instalação do Firebase diretamente do podspec após a descontinuação do suporte ao CocoaPods em outubro de 2026. Se você optar por hospedar seus próprios podspecs, será responsável por mantê-los atualizados.

Por que o suporte ao CocoaPods será descontinuado em outubro de 2026, quando o CocoaPods poderá ser publicado até dezembro de 2026?

Escolhemos outubro para garantir que as versões finais publicadas no CocoaPods sejam estáveis antes do bloqueio do registro em dezembro. Essa linha do tempo oferece uma margem necessária para coordenar com segurança essas atualizações finais e garante que os SDKs multiplataforma, que dependem do SDK nativo, mas têm ciclos de lançamento atrasados, tenham bastante tempo para preparar seus próprios lançamentos.

Meu app vai parar de funcionar se eu não atualizar?

Não, essa descontinuação afeta apenas os lançamentos futuros das bibliotecas do Firebase. As versões atuais no CocoaPods vão continuar instaláveis, e os apps implantados que usam essas versões de pod não serão afetados.

Isso afeta o faturamento do projeto?

Não.

Estou recebendo um erro "FirebaseLibrary not found" ao compilar meu projeto após a migração para o Gerenciador de pacotes do Swift. Como resolvo esse problema?

Verifique se você adicionou o pacote do Firebase ao seu projeto do Xcode.

Ao adicionar o pacote do Firebase, o Xcode vai pedir que você adicione frameworks do Firebase aos destinos de build do app. Se você esquecer de adicionar um framework durante essa etapa, sempre poderá adicioná-lo mais tarde nas configurações do destino em Build Phases > Link Binary with Libraries. Se o projeto contiver vários destinos, verifique se o Firebase foi adicionado aos destinos corretos.

Essa transição vai interromper meus pipelines de CI/CD?

Não, os pipelines que executam pod install ou pod update vão continuar funcionando para as versões atuais. No entanto, eles não vão extrair novas atualizações da biblioteca do Firebase lançadas após outubro de 2026.