Swinject para Swift: guía completa con ejemplos

¿Qué es Swinject y para qué sirve?

Swinject es una biblioteca ligera para la inyección de dependencias (Dependency Injection, DI) en el lenguaje Swift. Proporciona una forma simple y declarativa de gestionar las dependencias entre objetos, lo que hace que el código sea más modular, testeable y mantenible.

En el enfoque tradicional, los objetos crean sus propias dependencias, lo que genera un fuerte acoplamiento en el código. Por ejemplo, la clase UserService podría crear directamente una instancia de NetworkClient. Si desea reemplazar NetworkClient por un objeto mock para pruebas, tendría que modificar el código de UserService. Swinject resuelve este problema trasladando la creación y vinculación de objetos a un contenedor separado.

Principales ventajas de Swinject:

\n
• Reducción del acoplamiento: Las clases no saben cómo se crean sus dependencias.
\n
• Mejora de la testabilidad: Es fácil reemplazar dependencias reales por mocks y stubs.
\n
• Simplificación de la configuración: Toda la configuración de dependencias se centraliza en un solo lugar.
\n
• Soporte del ciclo de vida: Gestión del tiempo de vida de los objetos (singleton, nueva instancia, etc.).
\n
• Arquitectura limpia: Favorece el cumplimiento de los principios SOLID, especialmente el Principio de Inversión de Dependencias.
\n

Swinject es especialmente útil en proyectos grandes, donde la cantidad de clases y sus dependencias crece, y la gestión manual de las mismas se vuelve compleja y propensa a errores.

Instalación de Swinject

Swinject se instala a través de Swift Package Manager (SPM) o CocoaPods. Veremos ambos métodos.

Instalación mediante Swift Package Manager (recomendado)

En Xcode, vaya a File → Add Packages.... En la barra de búsqueda, introduzca la URL del repositorio: https://github.com/Swinject/Swinject.git. Seleccione la versión deseada (normalmente la última estable) y haga clic en Add Package.

Alternativamente, puede agregar la dependencia en su Package.swift:

// swift-tools-version:5.7\nimport PackageDescription\n\nlet package = Package(\n    name: "YourProject",\n    dependencies: [\n        .package(url: "https://github.com/Swinject/Swinject.git", from: "2.8.0")\n    ],\n    targets: [\n        .target(\n            name: "YourTarget",\n            dependencies: ["Swinject"])\n    ]\n)\n

Instalación mediante CocoaPods

Agregue a su Podfile:

pod 'Swinject', '~> 2.8'

Luego ejecute el comando pod install.

Nota: A diferencia de Python (pip) o Node.js (npm), en Swift no existe un único gestor de paquetes, pero SPM es el estándar y está integrado en Xcode.

Inicio rápido con un ejemplo de código

Veamos un ejemplo muy simple: tenemos un protocolo LoggerProtocol y su implementación ConsoleLogger. Queremos que la clase UserService reciba el logger mediante inyección de dependencias.

import Swinject\n\n// 1. Definimos el protocolo\nprotocol LoggerProtocol {\n    func log(message: String)\n}\n\n// 2. Implementación del protocolo\nclass ConsoleLogger: LoggerProtocol {\n    func log(message: String) {\n        print("LOG: \\(message)")\n    }\n}\n\n// 3. Clase que usa la dependencia\nclass UserService {\n    private let logger: LoggerProtocol\n\n    // Inyección a través del inicializador\n    init(logger: LoggerProtocol) {\n        self.logger = logger\n    }\n\n    func createUser(name: String) {\n        logger.log(message: "Creating user: \\(name)")\n        // Lógica de creación de usuario\n    }\n}\n\n// 4. Configuración del contenedor\nlet container = Container()\ncontainer.register(LoggerProtocol.self) { _ in ConsoleLogger() }\ncontainer.register(UserService.self) { r in\n    UserService(logger: r.resolve(LoggerProtocol.