Swift Package Manager (SPM): Guia completo para desenvolvedores Swift

O Swift Package Manager (SPM) é a ferramenta oficial para gerenciar dependências, compilar e distribuir código em Swift. Integrado diretamente ao ecossistema Swift, o SPM oferece uma maneira padronizada e unificada de trabalhar com pacotes, eliminando a necessidade de soluções de terceiros como CocoaPods ou Carthage. O SPM é fortemente integrado ao compilador Swift e ao Xcode, tornando-o a escolha ideal para projetos modernos.

Por que usar o Swift Package Manager? Primeiro, para gerenciar dependências. Qualquer projeto não trivial utiliza bibliotecas externas: para redes (Alamofire, URLSession), para parsing de JSON (SwiftyJSON), para bancos de dados (GRDB, SQLite.swift) e muito mais. O SPM baixa, compila e vincula automaticamente essas bibliotecas ao seu projeto. Segundo, o SPM permite que você crie e publique seus próprios pacotes, tornando seu código reutilizável. Terceiro, ele oferece uma ferramenta poderosa para compilar projetos, incluindo suporte a testes, recursos e plugins.

Ao contrário do CocoaPods, o SPM não requer a instalação de uma gem Ruby separada ou a configuração de um Podfile complexo. Ao contrário do Carthage, o SPM não exige a vinculação manual de frameworks. O SPM é o gerenciador de pacotes "nativo" que entende a estrutura de projetos Swift "de fábrica". Ele usa o arquivo Package.swift para descrever o projeto e suas dependências, tornando o processo de configuração transparente e previsível.

Instalação

O Swift Package Manager acompanha a distribuição oficial do Swift. Não é necessária instalação separada. Se você tem o Swift instalado (a partir da versão 5.0), o SPM já está disponível no seu sistema.

Verificando a instalação:

swift --version

Se você vir a versão do Swift, o SPM está pronto para uso. Você também pode verificar a presença da ferramenta em si:

swift package --version

Instalando o Swift (caso não esteja instalado):

macOS: Instale o Xcode pela Mac App Store. O Swift e o SPM já vêm incluídos.
Linux (Ubuntu, CentOS, Amazon Linux): Baixe e instale a distribuição do site oficial swift.org.
Windows: Baixe e instale a distribuição do swift.org.

Início rápido

Vamos criar um novo projeto executável usando o SPM. Este é um exemplo funcional mínimo.

1. Criando o projeto:

mkdir MeuProjetoSwift
cd MeuProjetoSwift
swift package init --type executable

Este comando criará a estrutura do projeto:

Package.swift — o arquivo de manifesto.
Sources/MeuProjetoSwift/main.swift — o ponto de entrada.
Tests/ — diretório para testes.

2. Conteúdo do Package.swift:

// swift-tools-version:5.9
import PackageDescription

let package = Package(
    name: "MeuProjetoSwift",
    targets: [
        .executableTarget(
            name: "MeuProjetoSwift"
        )
    ]
)

3. Conteúdo do main.swift: