Alamofire para Swift: guia completo com exemplos

O que é Alamofire e para que serve

Alamofire é uma biblioteca elegante e poderosa para trabalhar com requisições de rede na linguagem Swift. Ela fornece uma interface conveniente para executar requisições HTTP, processar respostas, fazer upload e download de dados, além de trabalhar com autenticação e serialização. Escrita em Swift puro, suporta iOS, macOS, tvOS e watchOS.

Principais razões para usar Alamofire:

\n
• Facilidade de uso — API intuitiva que reduz a quantidade de código em comparação com URLSession.
\n
• Serialização automática — suporte nativo para JSON, Property List e formatos personalizados.
\n
• Encadeamento de requisições — fácil combinar várias requisições e processá-las sequencialmente.
\n
• Tratamento de erros — informações detalhadas sobre erros de rede e servidor.
\n
• Suporte a SSL-pinning — conexão segura com o servidor.
\n
• Download de arquivos — suporte a progresso e retomada de download.
\n
• Comunidade ativa — atualizações regulares e muitos exemplos.
\n

Instalação do Alamofire

O Alamofire é instalado via Swift Package Manager (SPM), CocoaPods ou Carthage. O método recomendado é o SPM.

Instalação via Swift Package Manager (SPM)

\n
1. No Xcode, abra o projeto: File → Add Packages...
\n
2. Cole a URL do repositório: https://github.com/Alamofire/Alamofire.git
\n
3. Selecione a versão (a última estável) e clique em Add Package.
\n
4. Certifique-se de que o pacote foi adicionado ao seu target.
\n

Instalação via CocoaPods

# Podfile\nplatform :ios, '13.0'\nuse_frameworks!\n\ntarget 'YourApp' do\n  pod 'Alamofire', '~> 5.9'\nend

Depois disso, execute pod install.

Instalação via Carthage

# Cartfile\ngithub "Alamofire/Alamofire" ~> 5.9

Em seguida, execute carthage update --platform iOS.

Início rápido com exemplo de código

Após a instalação, importe a biblioteca e faça uma requisição GET simples:

import Alamofire\n\n// Requisição GET simples\nAF.request("https://jsonplaceholder.typicode.com/posts/1")\n    .responseJSON { response in\n        switch response.result {\n        case .success(let data):\n            print("Dados recebidos: \\(data)")\n        case .failure(let error):\n            print("Erro: \\(error.localizedDescription)")\n        }\n    }

Este código envia uma requisição para uma API de teste, recebe JSON e o exibe no console. O Alamofire gerencia automaticamente a sessão URL, a criação da requisição e a serialização da resposta.

Principais métodos e funções do Alamofire

Vamos analisar 10 métodos-chave da biblioteca com descrição detalhada e exemplos.

1. AF.request() — requisição HTTP básica

O que faz: Envia uma requisição HTTP de qualquer método (GET, POST, PUT, DELETE, etc.) para a URL especificada.

Parâmetros:

\n
• _ url: URLConvertible — URL ou string de URL.
\n
• method: HTTPMethod = .get — método HTTP (get, post, put, delete, patch, etc.).
\n
• parameters: Parameters? = nil — dicionário de parâmetros da requisição.
\n
• encoding: ParameterEncoding = URLEncoding.default — forma de codificação dos parâmetros.
\n
• headers: HTTPHeaders? = nil — cabeçalhos da requisição.
\n
• interceptor: RequestInterceptor? = nil — interceptador para modificar a requisição.
\n

Exemplo:

let parameters: [String: Any] = [\n    "userId": 1,\n    "title": "Novo post",\n    "body": "Texto do post"\n]\n\nAF.request("https://jsonplaceholder.typicode.com/posts",\n           method: .p