Guía completa de SwiftyJSON para Swift con ejemplos

1. ¿Qué es y por qué usarla?

SwiftyJSON es una librería ligera para Swift que simplifica drásticamente el trabajo con datos JSON. En Swift estándar, trabajar con JSON a través de JSONSerialization requiere mucho código repetitivo: hay que verificar tipos manualmente, manejar valores opcionales (Optional) y escribir múltiples construcciones if let o guard let. Esto hace que el código sea pesado, difícil de leer y propenso a errores.

SwiftyJSON resuelve este problema ofreciendo una API elegante y segura. En lugar de lidiar con diccionarios crudos [String: Any] y arreglos [Any], trabajas con un objeto JSON que admite encadenamiento de llamadas (chaining), extracción segura de valores con sintaxis de subíndice y conversión automática de tipos. La librería maneja automáticamente los valores nil sin provocar fallos en la app y proporciona mensajes de error claros.

El objetivo principal de SwiftyJSON es hacer que el código que trabaja con JSON sea tan limpio y conciso como el propio Swift. Es ideal para proyectos donde se parsean frecuentemente respuestas de APIs REST, se procesan archivos de configuración o se trabaja con cualquier otra estructura JSON. La librería cuenta con un sólido respaldo de la comunidad, más de 22,000 estrellas en GitHub y se utiliza en miles de aplicaciones.

2. Instalación

SwiftyJSON se distribuye a través de Swift Package Manager (SPM), CocoaPods y Carthage. El método recomendado es SPM, ya que está integrado en Xcode.

Mediante Swift Package Manager (recomendado)

1. En Xcode, ve a File → Add Packages...
2. Pega la URL del repositorio: https://github.com/SwiftyJSON/SwiftyJSON.git
3. Selecciona la versión (se recomienda la última estable, por ejemplo, 5.0.1)
4. Haz clic en Add Package

O agrega lo siguiente en tu archivo Package.swift:

// swift-tools-version:5.3
import PackageDescription

let package = Package(
    name: "TuProyecto",
    dependencies: [
        .package(url: "https://github.com/SwiftyJSON/SwiftyJSON.git", from: "5.0.1")
    ],
    targets: [
        .target(name: "TuTarget", dependencies: ["SwiftyJSON"])
    ]
)

Mediante CocoaPods

Añade esto a tu Podfile:

pod 'SwiftyJSON', '~> 5.0'

Luego ejecuta pod install.

Mediante Carthage

Añade esto a tu Cartfile:

github "SwiftyJSON/SwiftyJSON" ~> 5.0

Luego ejecuta carthage update.

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

Después de instalar, importa la librería y crea un objeto JSON a partir de una cadena o Data:

import SwiftyJSON

// Ejemplo de cadena JSON
let jsonString = """
{
    "nombre": "Carlos",
    "edad": 30,
    "esEstudiante": false,
    "direccion": {
        "ciudad": "Madrid",
        "codigoPostal": "28001"
    },
    "hobbies": ["leer", "nadar", "programar"]
}
"""

// Convertimos la cadena a Data
guard let jsonData = jsonString.data(using: .utf8) else {
    fatalError("No se pudo convertir la cadena a Data")
}

// Creamos el objeto JSON
let json = JSON(jsonData)

// Extraemos los valores
let nombre = json["nombre"].stringValue      // "Carlos"
let edad = json["edad"].intValue             // 30
let esEstudiante = json["esEstudiante"].boolValue // false
let ciudad = json["direccion"]["ciudad"].stringValue // "Madrid"
let primerHobby = json["hobbies"][0].stringValue // "leer"

print("Nombre: \(nombre), Edad: \(edad), Ciudad: \(ciudad)")
print("Primer hobby: \(primerHobby)")

Este ejemplo muestra la idea clave: acceso a datos mediante sintaxis de subíndice y el uso de propiedades .string