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

R.swift es una potente librería para el lenguaje Swift que proporciona acceso type-safe (tipado seguro) a los recursos de tu aplicación iOS/macOS/tvOS/watchOS. En lugar de usar cadenas de texto literales para acceder a imágenes, fuentes, colores, cadenas localizadas y otros recursos, R.swift genera estructuras fuertemente tipadas para ellos. Esto significa que el compilador puede verificar la validez del nombre del recurso en tiempo de compilación, no durante la ejecución de la aplicación.

¿Para qué sirve? En el desarrollo estándar de Apple, a menudo escribes código como UIImage(named: "miImagen") o NSLocalizedString("clave_saludo", comment: ""). Si te equivocas al escribir el nombre del archivo o la clave de localización, la aplicación fallará con un error solo en tiempo de ejecución. R.swift resuelve este problema de raíz: tras generar el código, accedes a los recursos como si fueran propiedades de las estructuras generadas. Por ejemplo: R.image.miImagen o R.string.localizable.claveSaludo(). El compilador te señalará inmediatamente un recurso inexistente y Xcode te ofrecerá autocompletado.

Además, R.swift maneja automáticamente catálogos de activos (Asset Catalogs), archivos .strings, .storyboard, .xib, .json, .plist, fuentes, colores e incluso archivos de datos (Data). Esto hace que el código sea más limpio, seguro y acelera significativamente el desarrollo gracias al autocompletado en Xcode. La librería cuenta con un sólido respaldo de la comunidad y se utiliza en miles de proyectos en todo el mundo.

2. Instalación

R.swift se instala a través de Swift Package Manager (SPM) o CocoaPods. Recomendamos SPM, ya que es el estándar moderno para proyectos Swift.

Instalación mediante Swift Package Manager (SPM)

Añade el paquete a tu proyecto a través de Xcode:

1. Abre tu proyecto en Xcode.
2. Ve a File > Add Packages....
3. Pega la URL: https://github.com/mac-cain13/R.swift
4. Selecciona la versión (se recomienda la última estable) y haz clic en Add Package.
5. Asegúrate de que el paquete se haya añadido a tu objetivo principal.

También puedes añadirlo manualmente en Package.swift:

// swift-tools-version:5.7
import PackageDescription

let package = Package(
    name: "TuProyecto",
    dependencies: [
        .package(url: "https://github.com/mac-cain13/R.swift", from: "7.0.0")
    ],
    targets: [
        .target(
            name: "TuObjetivo",
            dependencies: [
                .product(name: "RswiftLibrary", package: "R.swift")
            ]
        )
    ]
)

Instalación mediante CocoaPods

Si usas CocoaPods, añade lo siguiente en tu Podfile:

platform :ios, '13.0'
use_frameworks!

target 'TuApp' do
  pod 'R.swift', '~> 7.0'
end

Luego ejecuta el comando:

pod install

Configuración de Build Phase (¡obligatorio!)

Después de la instalación, debes añadir una Run Script Phase en las fases de compilación de tu objetivo:

1. Ve a Build Phases de tu objetivo.
2. Haz clic en + y selecciona New Run Script Phase.
3. Arrastra esta fase para que se ejecute antes de la fase Compile Sources.
4. En el campo de script, pega lo siguiente:

"$PODS_ROOT/R.swift/rswift" generate "$SRCROOT/R.generated.swift"

Si usas SPM, el script será así:

"${BUILD_DIR%/Build/*}/SourcePackages/checkouts/R.swift/rswift" generate "$SRCROOT/R.generated.swift"

Después de compilar el proyecto, se generará el archivo R.generated.swift. Añádelo a tu proyecto (no olvides arrastrarlo a la carpeta correspondiente).