1. What It Is and Why You Need It

\nR.swift is a powerful library for the Swift language that provides type-safe access to resources of your iOS/macOS/tvOS/watchOS application. Instead of using string literals to reference images, fonts, colors, localized strings, and other resources, R.swift generates strictly typed structures for them. This means the compiler can verify the correctness of a resource name at compile time, rather than during application runtime.\n

\nWhy is this needed? In standard Apple development, you often write code like UIImage(named: "myImage") or NSLocalizedString("hello_key", comment: ""). If you make a typo in a file name or localization key, the application will crash with an error only at runtime. R.swift solves this problem radically: after code generation, you access resources as properties of generated structures. For example: R.image.myImage or R.string.localizable.helloKey(). The compiler will immediately point to a non-existent resource, and Xcode will offer autocompletion.\n

\nAdditionally, R.swift automatically handles Asset Catalogs, .strings files, .storyboard, .xib, .json, .plist, fonts, colors, and even Data files. This makes code cleaner, safer, and significantly speeds up development thanks to autocompletion in Xcode. The library is actively maintained by the community and is used in thousands of projects worldwide.\n

2. Installation

\nR.swift is installed via Swift Package Manager (SPM) or CocoaPods. We recommend SPM as it is the modern standard for Swift projects.\n

Installation via Swift Package Manager (SPM)

Add the package to your project via Xcode:

\n
1. Open your project in Xcode.
\n
2. Go to File > Add Packages....
\n
3. Paste the URL: https://github.com/mac-cain13/R.swift
\n
4. Select the version (latest stable recommended) and click Add Package.
\n
5. Ensure the package is added to your main target.
\n

You can also add it manually in Package.swift:

// swift-tools-version:5.7\nimport PackageDescription\n\nlet package = Package(\n    name: "YourProject",\n    dependencies: [\n        .package(url: "https://github.com/mac-cain13/R.swift", from: "7.0.0")\n    ],\n    targets: [\n        .target(\n            name: "YourTarget",\n            dependencies: [\n                .product(name: "RswiftLibrary", package: "R.swift")\n            ]\n        )\n    ]\n)\n

Installation via CocoaPods

If you use CocoaPods, add to Podfile:

platform :ios, '13.0'\nuse_frameworks!\n\ntarget 'YourApp' do\n  pod 'R.swift', '~> 7.0'\nend\n

Then run the command:

pod install\n

Build Phase Setup (mandatory!)

After installation, you need to add a Run Script Phase in the Build Phases of your target:

\n
1. Go to Build Phases of your target.
\n
2. Click + and select New Run Script Phase.
\n
3. Drag this phase so it runs before the Compile Sources phase.
\n
4. In the script field, paste:
\n

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

If you use SPM, the script will look like this:

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

After building the project, a file will be generated

Also in library

Logging in Go (Golang): Best Libraries and Solutions 2024 Working with YAML in Rust: the serde_yaml library Gradle Kotlin DSL for Kotlin: Complete Guide with Examples Caching in Rust: Redis, Memcached, and Built-in Solutions ClosedXML for C# (.NET): Complete Guide with Examples