Alamofire para Swift: guía completa con ejemplos

¿Qué es Alamofire y para qué sirve?

Alamofire es una biblioteca elegante y potente para trabajar con solicitudes de red en el lenguaje Swift. Proporciona una interfaz conveniente para realizar solicitudes HTTP, procesar respuestas, cargar y descargar datos, así como trabajar con autenticación y serialización. Está escrita en Swift puro y es compatible con iOS, macOS, tvOS y watchOS.

Principales razones para usar Alamofire:

\n
• Facilidad de uso — una API intuitiva que reduce la cantidad de código en comparación con URLSession.
\n
• Serialización automática — soporte incorporado para JSON, Property List y formatos personalizados.
\n
• Cadenas de solicitudes — combina fácilmente varias solicitudes y procésalas secuencialmente.
\n
• Manejo de errores — información detallada sobre errores de red y del servidor.
\n
• Soporte de SSL-pinning — conexión segura con el servidor.
\n
• Descarga de archivos — soporte para progreso y reanudación de descargas.
\n
• Comunidad activa — actualizaciones regulares y numerosos ejemplos.
\n

Instalación de Alamofire

Alamofire se instala a través de Swift Package Manager (SPM), CocoaPods o Carthage. El método recomendado es SPM.

Instalación mediante Swift Package Manager (SPM)

\n
1. En Xcode, abre tu proyecto: File → Add Packages...
\n
2. Pega la URL del repositorio: https://github.com/Alamofire/Alamofire.git
\n
3. Selecciona la versión (la última estable) y haz clic en Add Package.
\n
4. Asegúrate de que el paquete se haya agregado a tu target.
\n

Instalación mediante CocoaPods

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

Después de esto, ejecuta pod install.

Instalación mediante Carthage

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

Luego ejecuta carthage update --platform iOS.

Inicio rápido con ejemplo de código

Después de la instalación, importa la biblioteca y realiza una solicitud GET simple:

import Alamofire\n\n// Solicitud GET simple\nAF.request("https://jsonplaceholder.typicode.com/posts/1")\n    .responseJSON { response in\n        switch response.result {\n        case .success(let data):\n            print("Datos recibidos: \\(data)")\n        case .failure(let error):\n            print("Error: \\(error.localizedDescription)")\n        }\n    }

Este código envía una solicitud a una API de prueba, recibe JSON y lo imprime en la consola. Alamofire maneja automáticamente la sesión URL, la creación de la solicitud y la serialización de la respuesta.

Métodos y funciones principales de Alamofire

Veamos 10 métodos clave de la biblioteca con descripción detallada y ejemplos.

1. AF.request() — solicitud HTTP básica

Qué hace: Envía una solicitud HTTP de cualquier método (GET, POST, PUT, DELETE, etc.) a la URL especificada.

Parámetros:

\n
• _ url: URLConvertible — URL o cadena de URL.
\n
• method: HTTPMethod = .get — método HTTP (get, post, put, delete, patch, etc.).
\n
• parameters: Parameters? = nil — diccionario de parámetros de la solicitud.
\n
• encoding: ParameterEncoding = URLEncoding.default — forma de codificar los parámetros.
\n
• headers: HTTPHeaders? = nil — encabezados de la solicitud.
\n
• interceptor: RequestInterceptor? = nil — interceptor para modificar la solicitud.
\n

Ejemplo:

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