Migrar do CocoaPods

O CocoaPods anunciou que vai se tornar somente leitura em dezembro de 2026. Depois disso, não será mais possível publicar novas versões de pods. 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á mudando para um estado somente leitura. O Firebase 12 é a última versão principal publicada no CocoaPods, 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 no registro do CocoaPods, e os apps que usam essas versões do CocoaPods vão continuar funcionando enquanto houver suporte ao ecossistema do CocoaPods.
• Por que migrar? Para continuar recebendo os recursos mais recentes, melhorias de desempenho e correções críticas, migre para o Gerenciador de pacotes do Swift ou faça a instalação manual.

Para se adequar 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 as subdependências deles:

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, o SDK do Firebase para C++ e o FlutterFire.

Migrar apps da Apple

Se você estiver migrando outras dependências (que não são do Firebase) do CocoaPods, saiba que a prática recomendada do setor é usar um único método de instalação para todo o projeto. Misturar o CocoaPods e o 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 as dependências que não são do Firebase ainda não forem compatíveis com o SPM, use a instalação manual para as bibliotecas do Firebase. Essa é 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, na sigla em inglês) é 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 ao remover 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 mudanças no código do aplicativo, a menos que o projeto tenha configurações personalizadas do Xcode ou dependências que usem muito os scripts de instalação do CocoaPods.

Veja como migrar do CocoaPods para o Gerenciador de Pacotes do Swift:

1. Verifique se cada uma das dependências do app é compatível com o Swift Package Manager. Todas as bibliotecas do Firebase são compatíveis com o SPM, mas você precisa verificar se as dependências que não são do Firebase são compatíveis com o SPM nos repositórios do GitHub ou nas páginas do produto. Se algumas das suas dependências que não são do Firebase não forem compatíveis com o SPM, usar a instalação manual em vez do SPM é o caminho de migração mais estável para sair do CocoaPods.
2. 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.
3. 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.
4. Depois que o pacote do Firebase for adicionado, você poderá atualizar as bibliotecas do Firebase de que depende. Para isso, acesse as configurações do projeto no Xcode, selecione o destino do app e atualize 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 que você arraste e solte SDKs específicos diretamente no projeto do Xcode sem usar um gerenciador de dependências.

Migrar para a instalação manual

1. 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.
2. Siga as etapas no nosso guia de instalação para adicionar o Firebase ao seu projeto manualmente.

Migrar seus apps Unity, C++ e Flutter

SDK do Firebase para Unity e FlutterFire

A maioria dos desenvolvedores do Unity e do Flutter não precisa fazer nada. A atualização para a versão mais recente do Firebase no Unity ou no Flutter vai migrar automaticamente o gerenciador de dependências nas plataformas da Apple para o Swift Package Manager.

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

SDK para C++ do Firebase

Se você estava incluindo as dependências do iOS usando o 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 instalar o Firebase diretamente do podspec depois que o suporte ao CocoaPods for desativado 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 se as publicações podem ser feitas 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. Esse cronograma oferece uma margem de segurança para coordenar essas atualizações finais e garante que os SDKs multiplataforma, que dependem do SDK nativo, mas têm ciclos de lançamento atrasados, tenham tempo suficiente para preparar as próprias versões.

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

Não, essa descontinuação afeta apenas as versões futuras das bibliotecas do Firebase. O Firebase 12 é a última versão principal publicada no CocoaPods, e as versões atuais (v12 e anteriores) no CocoaPods vão continuar instaláveis e funcionais enquanto o suporte ao ecossistema do CocoaPods continuar.

Isso afeta o faturamento do projeto?

Não.

Estou recebendo um erro "FirebaseLibrary não encontrada" ao compilar meu projeto depois de migrar 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 solicitar que você adicione frameworks do Firebase aos destinos de build do seu app. Se você esquecer de adicionar um framework durante essa etapa, poderá fazer isso mais tarde nas configurações do destino em Build Phases > Link Binary with Libraries. Se o projeto tiver 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 receber novas atualizações da biblioteca do Firebase lançadas após outubro de 2026.