Adeus ao CocoaPods: o Swift Package Manager em breve será o padrão no Flutter!
A partir do Flutter 3.44, o Swift Package Manager substitui o CocoaPods como gerenciador de dependências padrão para apps iOS e macOS.
Adeus ao CocoaPods: o Swift Package Manager em breve será o padrão no Flutter!
A partir da próxima versão estável do Flutter, a 3.44, o Swift Package Manager (SwiftPM) substitui o CocoaPods como gerenciador de dependências padrão para apps iOS e macOS. Isso significa que não há mais necessidade de lidar com Ruby ou instalações do CocoaPods só para fazer o seu app rodar!
O CocoaPods está oficialmente em modo de manutenção, e o registro dele vai se tornar somente leitura de forma permanente em 2 de dezembro de 2026. Builds existentes ainda vão funcionar, mas nenhuma versão nova ou pod será adicionado ao trunk após essa data. Para garantir que seus apps continuem recebendo atualizações de dependências e para dar acesso ao ecossistema de pacotes Swift, o Flutter está migrando para a solução de gerenciamento de dependências suportada pela Apple: o Swift Package Manager.
Se você já migrou seu(s) plugin(s) para usar o SwiftPM, leia a seção “Desenvolvedores de plugins” abaixo para conhecer os novos requisitos de migração.
Veja como gerenciar a transição.
Desenvolvedores de apps
Para desenvolvedores de apps, a CLI do Flutter cuida da migração. Quando você roda ou compila seu app iOS ou macOS, a CLI atualiza automaticamente seu projeto do Xcode para usar o Swift Package Manager. Confira os documentos de migração do Flutter para desenvolvedores de apps para mais detalhes.
Se o seu app depende de plugins que ainda não adotaram o Swift Package Manager, o Flutter vai imprimir um aviso listando exatamente quais dependências não são compatíveis. O Flutter vai usar o CocoaPods temporariamente como fallback para os plugins que ainda não adotaram pacotes Swift. Como o suporte ao CocoaPods vai acabar sendo removido por completo, se um plugin não tiver sido atualizado e quebrar seu build, abra uma issue com o mantenedor da dependência pedindo suporte a pacotes Swift ou encontre um pacote alternativo.
Sabemos que as migrações às vezes podem dar problemas. Se o SwiftPM causar um problema que quebre tudo, você pode desativá-lo temporariamente no seu projeto. Abra seu arquivo pubspec.yaml, navegue até a seção flutter e defina enable-swift-package-manager
como false no bloco de configuração:
flutter:
config:
enable-swift-package-manager: false
Se você optar por sair, por favor, abra um relatório de bug usando o template de issue do GitHub do Flutter e nos avise! Inclua os detalhes do erro, uma lista dos seus plugins e versões, e cópias dos arquivos do seu projeto Xcode para nos ajudar a resolver o problema antes de o CocoaPods ser removido por completo.
Desenvolvedores de plugins
Para autores de plugins que mantêm um plugin iOS ou macOS, você precisa adicionar suporte ao Swift Package Manager se ainda não tiver feito isso. Até agora, 61% dos 100 principais plugins iOS migraram. Precisamos que os plugins restantes entrem nessa, para que os desenvolvedores de apps não fiquem presos dependendo de uma ferramenta descontinuada. Para incentivar a adoção, pacotes sem suporte ao Swift Package Manager agora recebem pontuações mais baixas no pub.dev até migrarem.
Para adicionar esse suporte, crie um arquivo Package.swift e mova seus arquivos de código-fonte para corresponder à estrutura padrão de pacote Swift. Se você já migrou seu plugin durante o piloto de 2025, precisa concluir um passo novo: adicione FlutterFramework como dependência no seu arquivo
Package.swift. Leia os documentos de migração do Flutter para autores de plugins
para as instruções completas.
Obrigado por ajudar nesta migração para o Swift Package Manager. Esperamos que isso simplifique e melhore sua experiência de desenvolvimento em iOS e macOS!
