1. Was ist R.swift und warum brauchst du es?

R.swift ist eine leistungsstarke Bibliothek für Swift, die einen type-sicheren (typensicheren) Zugriff auf Ressourcen deiner iOS/macOS/tvOS/watchOS-App ermöglicht. Anstatt String-Literale für den Zugriff auf Bilder, Schriftarten, Farben, lokalisierte Strings und andere Ressourcen zu verwenden, generiert R.swift streng typisierte Strukturen. Das bedeutet, dass der Compiler die Korrektheit des Ressourcennamens bereits zur Compile-Zeit überprüfen kann – und nicht erst zur Laufzeit.

Warum ist das wichtig? In der Standardentwicklung unter Apple schreibst du oft Code wie UIImage(named: "myImage") oder NSLocalizedString("hello_key", comment: ""). Wenn du dich bei einem Dateinamen oder Lokalisierungsschlüssel vertippst, stürzt die App erst zur Laufzeit mit einem Fehler ab. R.swift löst dieses Problem grundlegend: Nach der Codegenerierung greifst du auf Ressourcen als Eigenschaften der generierten Strukturen zu. Zum Beispiel: R.image.myImage oder R.string.localizable.helloKey(). Der Compiler zeigt sofort auf eine nicht vorhandene Ressource, und Xcode bietet dir Autovervollständigung an.

Darüber hinaus verarbeitet R.swift automatisch Asset Catalogs, .strings-Dateien, .storyboard, .xib, .json, .plist, Schriftarten, Farben und sogar Datendateien (Data). Das macht den Code sauberer, sicherer und beschleunigt die Entwicklung erheblich durch die Autovervollständigung in Xcode. Die Bibliothek wird von der Community aktiv unterstützt und in tausenden Projekten weltweit eingesetzt.

2. Installation

R.swift wird über den Swift Package Manager (SPM) oder CocoaPods installiert. Wir empfehlen SPM, da es der moderne Standard für Swift-Projekte ist.

Installation über den Swift Package Manager (SPM)

Füge das Paket über Xcode zu deinem Projekt hinzu:

1. Öffne dein Projekt in Xcode.
2. Gehe zu File > Add Packages....
3. Füge die URL ein: https://github.com/mac-cain13/R.swift
4. Wähle die Version (empfohlen wird die neueste stabile Version) und klicke auf Add Package.
5. Stelle sicher, dass das Paket zu deinem Hauptziel hinzugefügt wurde.

Du kannst es auch manuell in deiner Package.swift hinzufügen:

// swift-tools-version:5.7
import PackageDescription

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

Installation über CocoaPods

Wenn du CocoaPods verwendest, füge Folgendes in dein Podfile ein:

platform :ios, '13.0'
use_frameworks!

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

Führe dann den Befehl aus:

pod install

Build Phase einrichten (Pflicht!)

Nach der Installation musst du eine Run Script Phase in den Build Phases deines Ziels hinzufügen:

1. Gehe zu Build Phases deines Ziels.
2. Klicke auf + und wähle New Run Script Phase.
3. Ziehe diese Phase so, dass sie vor der Phase Compile Sources ausgeführt wird.
4. Füge in das Skriptfeld Folgendes ein:

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

Wenn du SPM verwendest, sieht das Skript so aus:

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

Nach dem Build des Projekts wird die Datei R.generated.swift generiert. Füge sie zu deinem Projekt hinzu (vergiss nicht, sie in dein Projektverzeichnis zu ziehen).