A partir da próxima versão estável do Flutter, 3.44, o Swift Package Manager (SwiftPM) substituirá o CocoaPods como gerenciador de dependências padrão para aplicativos iOS e macOS. Isso significa que você não precisará mais se preocupar com a instalação do Ruby ou do CocoaPods apenas para fazer seu app funcionar!

O CocoaPods está oficialmente em modo de manutenção e seu registro se tornará de leitura apenas a partir de 2 de dezembro de 2026. Embora as versões existentes ainda funcionem, nenhuma nova versão ou pacote será adicionado ao repositório após essa data. Para garantir que seus aplicativos continuem recebendo atualizações de dependências e para fornecer acesso ao ecossistema de pacotes Swift, o Flutter está se transferindo para a solução oficial de gerenciamento de dependências da Apple: Swift Package Manager.

Se você já migrou seu(s) plugin(ns) para usar SwiftPM, leia a seção abaixo intitulada “Desenvolvedores de plugins” para novos requisitos de migração.

Aqui está como gerenciar a transição.

Desenvolvedores de aplicativos

Para desenvolvedores de aplicativos, o Flutter CLI lida com a migração. Quando você executa ou constrói seu aplicativo iOS ou macOS, o CLI atualiza automaticamente seu projeto Xcode para usar Swift Package Manager. Consulte os documentos de migração do Flutter para desenvolvedores de aplicativos para mais detalhes.

Se seu app depende de plugins que ainda não adotaram o Swift Package Manager, o Flutter imprimirá um aviso listando exatamente quais das suas dependências são não suportadas. O Flutter reverterá temporariamente para CocoaPods para plugins que ainda não adotaram pacotes Swift. Como o suporte ao CocoaPods será removido completamente no futuro, se um plugin não atualizar e quebrar sua build, abra uma issue com o mantenedor da dependência para solicitar suporte a pacotes Swift ou encontre outro pacote alternativo.

Sabemos que migrações às vezes podem enfrentar problemas. Se o SwiftPM causar um problema crítico, você pode desativá-lo temporariamente para seu projeto. Abra o 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 não usar, por favor, reporte um bug usando o modelo de issue do GitHub Flutter e nos informe! Inclua os detalhes do erro, uma lista dos seus plugins e versões, e cópias dos arquivos do seu projeto Xcode para ajudar a resolver o problema antes que CocoaPods seja completamente removido.

Desenvolvedores de plugins

Para autores de plugins que mantêm um plugin para iOS ou macOS, é necessário adicionar suporte ao Swift Package Manager se você ainda não o fez. Até agora, 61% dos 100 principais plugins iOS já migraram. Precisamos que os outros plugins participem para que os desenvolvedores de aplicativos não fiquem presos a uma ferramenta obsoleta. Para incentivar a adoção, pacotes sem suporte ao Swift Package Manager agora recebem pontuações mais baixas no pub.dev até que migrem.

Para adicionar esse suporte, adicione um arquivo Package.swift e mova seus arquivos de origem para corresponder à estrutura padrão do pacote Swift. Se você já migrou seu plugin durante o piloto de 2025, você precisa completar uma nova etapa: deve adicionar FlutterFramework como dependência em seu arquivo Package.swift. Leia a documentação completa sobre migração do Flutter para autores de plugins.

Agradecemos sua ajuda nesta migração para Swift Package Manager. Esperamos que isso simplifique e melhore a experiência de desenvolvimento em iOS e macOS!