Introducción a SwiftGen

SwiftGen es una herramienta de generación de código para Swift que crea código con verificación de tipos para assets, storyboards, cadenas localizables y otros recursos. Este enfoque elimina las APIs basadas en cadenas y proporciona ventajas significativas en el desarrollo de aplicaciones iOS.

Beneficios clave de SwiftGen

• Seguridad de tipos: El código generado verifica los tipos en tiempo de compilación, eliminando errores de ejecución comunes.
• Actualización automática: Cuando los recursos cambian, basta con regenerar el código para mantener todo sincronizado.
• Compatibilidad amplia: Soporta imágenes, colores, fuentes, storyboards y cadenas de localización.
• Personalización: Ofrece plantillas configurables para adaptar la generación a las necesidades del proyecto.

Configuración inicial

Instalación mediante el gestor de paquetes

Se puede instalar SwiftGen utilizando Homebrew en macOS:

brew install swiftgen

Configuración del proyecto

Crea un archivo de configuración swiftgen.yml en la raíz del proyecto. Ejemplo de configuración básica:

input_dir: ./Recursos
output_dir: ./CodigoGenerado
xcassets:
  inputs: Assets.xcassets
  outputs:
    templateName: xcassets
    output: XCAssets.swift

Implementación de actualizaciones transparenets de recursos

Para lograr actualizaciones de recursos sin intervención manual, SwiftGen debe integrarse en el flujo de construcción de la aplicación.

Integración con Xcode

Añade un script de fase de construcción en tu target de Xcode:

1. Selecciona el proyecto en el navegador de proyectos.
2. Ve a la pestaña "Build Phases".
3. Añade una nueva fase "Run Script".
4. Inserta el siguiente comando:

if which swiftgen > /dev/null; then
  swiftgen
else
  echo "SwiftGen no instalado. Omitiendo generación de código."
fi

Ejemplo práctico: Gestión de imágenes

Considera una aplicación con un conjunto de assets llamado MiApp.xcassets. Tras ejecutar SwiftGen, se genera una estructura de enumeración segura para acceder a las imágenes:

enum ImagenApp {
    static let iconoPrincipal = UIImage(asset: .iconoPrincipal)
    static let fondoPantalla = UIImage(asset: .fondoPantalla)
    
    enum Asset: String {
        case iconoPrincipal
        case fondoPantalla
    }
}

Estrategias de hotfix con SwiftGen

Las actualizaciones en caliente permiten corregir problemas sin pasar por el proceso completo de revisión de la App Store.

Flujo de trabajo recomendado

1. Almacenamiento remoto: Mantén los recursos actualizados en un servidor con control de versiones.
2. Detección de cambios: Implementa un mecanismo para verificar actualizaciones disponibles al iniciar la aplicación.
3. Descarga selectiva: Descarga solo los recursos que han cambiado.
4. Regeneración controlada: Ejecuta SwiftGen de manera programática después de atcualizar los recursos.

Implementación de verificación de recursos

Ejemplo de estructura para gestionar recursos remotos:

class GestorRecursosRemotos {
    private let urlBase = "https://servidor.com/recursos/"
    
    func verificarActualizaciones(versionLocal: String, completion: @escaping (Bool) -> Void) {
        // Lógica para comparar versiones
        let versionRemota = obtenerVersionRemota()
        completion(versionRemota != versionLocal)
    }
    
    func descargarRecursos(actualizados: [String], completion: @escaping () -> Void) {
        // Implementación de descarga
    }
}

Personalización avanzada

Creación de plantillas personalizadas

Puedes modificar las plantillas predeterminadas para ajustar el código generado. Las plantillas se encuentran en el directorio de instalación de SwiftGen.

Soporte para múltiples tipos de recursos

Consideraciones de rendimiento

Para proyectos grandes, considera:

• Ejecutar SwiftGen solo cuando sea necesario (por ejemplo, en un hook pre-commit).
• Utilizar caché para recursos que no cambian frecuentemente.
• Implementar regeneración incremental para módulos específicos.