1. ¿Qué es y para qué sirve?

CocoaPods es el gestor de dependencias más popular para proyectos en Swift y Objective-C. Permite a los desarrolladores integrar fácilmente librerías de terceros en sus proyectos de Xcode, gestionando automáticamente versiones, dependencias y configuración de compilación. Sin CocoaPods, los desarrolladores tendrían que descargar, configurar y vincular manualmente cada librería, lo que provoca errores, conflictos de versiones y pérdida de tiempo.

CocoaPods resuelve tres problemas clave: gestión de versiones (especificas la versión deseada de una librería y Podfile.lock fija las versiones exactas de todas las dependencias), configuración automática (CocoaPods crea un workspace, configura las rutas de búsqueda de cabeceras, flags del compilador y enlazado) y actualización centralizada (un solo comando pod update actualiza todas las dependencias a las últimas versiones compatibles).

El ecosistema de CocoaPods cuenta con más de 100,000 librerías y se utiliza en millones de aplicaciones. Soporta no solo Swift, sino también Objective-C y proyectos híbridos. CocoaPods se integra con sistemas CI/CD, admite repositorios privados y permite crear archivos podspec propios para publicar librerías.

2. Instalación

CocoaPods se instala a través de RubyGems. Asegúrate de tener Ruby instalado (generalmente viene preinstalado en macOS).

# Instalación de CocoaPods
sudo gem install cocoapods

# Verificar la instalación
pod --version

Si tienes problemas de permisos, usa:

# Instalación en el directorio personal del usuario
gem install --user-install cocoapods

Después de instalar, inicializa CocoaPods en tu proyecto:

# Ve al directorio del proyecto
cd /ruta/a/tu/proyecto

# Inicializar Podfile
pod init

# Instalar dependencias (crea .xcworkspace)
pod install

Importante: Después de ejecutar pod install, abre siempre el archivo .xcworkspace, no el .xcodeproj.

3. Inicio rápido — ejemplo mínimo funcional

Vamos a crear un proyecto simple que use la librería Alamofire para hacer peticiones HTTP.

Paso 1: Crea un Podfile en la raíz del proyecto:

# Podfile
platform :ios, '15.0'

target 'MiApp' do
  use_frameworks!
  pod 'Alamofire', '~> 5.9'
end

Paso 2: Instala las dependencias:

pod install

Paso 3: Usa la librería en tu código:

import UIKit
import Alamofire

class ViewController: UIViewController {
    override func viewDidLoad() {
        super.viewDidLoad()
        
        // Petición GET simple con Alamofire
        AF.request("https://api.github.com/users/octocat").responseJSON { response in
            switch response.result {
            case .success(let data):
                print("Datos recibidos: \(data)")
            case .failure(let error):
                print("Error: \(error)")
            }
        }
    }
}

Este ejemplo mínimo muestra lo fácil que es integrar y usar una librería externa con CocoaPods.

4. Métodos/funciones/clases principales

Veamos las clases y métodos clave que ofrece CocoaPods para gestionar dependencias. La mayoría se usan en el Podfile, escrito en Ruby DSL.

4.1. <