Migrar do CocoaPods

O CocoaPods anunciou que vai ficar em modo somente leitura em dezembro de 2026. Depois disso, não será mais possível publicar novas versões de pod. 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 vai passar 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 os apps que usam essas versões do CocoaPods 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 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 do Firebase para Apple nativo, incluindo o SDK do Firebase para Unity, SDK do Firebase para C++ e FlutterFire.

Migrar seus apps da Apple

Se você estiver migrando outras dependências (não do Firebase) do CocoaPods, saiba que é uma prática recomendada do setor usar um único método de instalação para todo o projeto. Misturar CocoaPods e gerenciador de pacotes do Swift (SPM) no mesmo destino pode levar a ciclos de dependência complexos e erros de build. Se as dependências não relacionadas ao 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 Swift Package Manager (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 ao remover a necessidade de um .xcworkspace para a maioria das configurações padrão.

Migrar para o uso do Swift Package Manager

Para a maioria dos projetos, a migração para o Swift Package Manager não exige a mudança do código do aplicativo, a menos que o projeto tenha configurações personalizadas do Xcode ou dependências que usem muito scripts de instalação do CocoaPods.

Saiba 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 o suporte do 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 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:
    • Desinstale as dependências do CocoaPods executando o seguinte comando no diretório do projeto: 
      pod deintegrate
    • Exclua o .xcworkspace gerado pelo CocoaPods.
  3. No Xcode, atualize seu projeto com as dependências do Gerenciador de pacotes do Swift:
    • Abra o arquivo .xcodeproj do projeto no Xcode.
    • 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 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 é uma 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 a instalação manual

  1. Com o Xcode fechado, remova o CocoaPods do seu projeto:
    • Desinstale as dependências do CocoaPods executando o seguinte comando no diretório do projeto: 
      pod deintegrate
    • 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 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 Flutter migra automaticamente seu gerenciador de dependências nas plataformas da Apple para o Swift Package Manager.

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 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 e usar o Swift Package Manager.

Perguntas frequentes

Preciso continuar usando o CocoaPods depois de 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 as podspecs do Firebase do GitHub e hospedá-las no seu próprio repositório de especificações.

Em qualquer caso, 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 do CocoaPods for descontinuado em outubro de 2026. Se você escolher hospedar suas próprias podspecs, será responsável por mantê-las atualizadas.

Por que o suporte ao CocoaPods será desativado em outubro de 2026, se ele pode 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. Esse cronograma 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 os próprios lançamentos.

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. As versões atuais no CocoaPods vão continuar instaláveis, e os apps implantados usando essas versões do pod não serão afetados.

Isso afeta o faturamento do projeto?

Não.

Recebo um erro "FirebaseLibrary not found" 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 pedir que você adicione frameworks do Firebase aos destinos de build do app. Se você esquecer de adicionar um framework durante esta etapa, poderá fazer isso mais tarde nas configurações do destino em Fases de compilação > Vincular binário com bibliotecas. Se o projeto tiver várias metas, verifique se o Firebase foi adicionado às metas corretas.

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 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.