Repository files navigation

Get strong typed, autocompleted resources like images, fonts and segues in Swift projects

It makes your code that uses resources:

• Fully typed, less casting and guessing what a method will return
• Compile time checked, no more incorrect strings that make your app crash at runtime
• Autocompleted, never have to guess that image name again

Currently you type:

leticon=UIImage(named:"settings-icon")letfont=UIFont(name:"San Francisco", size:42)letcolor=UIColor(named:"indicator highlight")letviewController=CustomViewController(nibName:"CustomView", bundle:nil)letstring=String(format:NSLocalizedString("welcome.withName", comment:""), locale:NSLocale.current,"Arthur Dent")

With R.swift it becomes:

leticon=R.image.settingsIcon()letfont=R.font.sanFrancisco(size:42)letcolor=R.color.indicatorHighlight()letviewController=CustomViewController(nib:R.nib.customView)letstring=R.string.localizable.welcomeWithName("Arthur Dent")

Check outmore examples or hear abouthow Fabric.app uses R.swift!

Autocompleted images:

Compiletime checked images:

This is only the beginning, check outmore examples!

Mathijs Kadijk presented R.swift at the September 2016 CocoaHeadsNL meetup.Talking about the ideas behind R.swift and demonstrating how to move from plain stringly-typed iOS code to statically typed code.

After installing R.swift into your project you can use theR-struct to access resources. If the struct is outdated just build and R.swift will correct any missing/changed/added resources.

R.swift currently supports these types of resources:

• Images
• Fonts
• Resource files
• Colors
• Localized strings
• Storyboards
• Segues
• Nibs
• Reusable cells
• Project
• Entitlements
• Info.plist

Runtime validation withR.validate():

• If all images used in storyboards and nibs are available
• If all named colors used in storyboards and nibs are available
• If all view controllers with storyboard identifiers can be loaded
• If all custom fonts can be loaded

• Why was R.swift created?
• Why should I choose R.swift over alternative X or Y?
• What are the requirements to run R.swift?
• How to fix missing imports in the generated file?
• How to use classes with the same name as their module?
• Can I ignore resources?
• Can I use R.swift in a library?
• How does R.swift work?
• How to upgrade to a new major version?
• How can I only run specific generators?

As of Rswift 7, Swift Package Manager is the recommended method of installation.

Demo video: Updating from R.swift 6 to Rswift 7 (Starting at 1:06, this describes the installation of Rswift 7).

Demo Video: Install R.swift in Xcode with SPM

1. In Project Settings, on the tab "Package Dependencies", click "+", search forhttps://github.com/mac-cain13/R.swift and click "Add Package".
2. Select the target that will use R.swift next to "RswiftLibrary" and click "Add Package".
3. Now click on your target, on the tab "Build Phases", in the section "Run Build Tool Plug-ins", click "+" and addRswiftGenerateInternalResources. (Screenshot)
4. Now theR struct should be available in your code, use auto-complete to explore all static references.

Note: The first build you might need to approve the new plugin by clicking the build error warning you about the new plugin.

On your CI server you can't explicitly allow the build plugin to run, so you need to disable plugin validation to be able to build without user interaction:

5. Run a script on your CI that runs:defaults write com.apple.dt.Xcode IDESkipPackagePluginFingerprintValidatation -bool YES before Xcode starts building.

On Xcode Cloud you can add acustom build script inci_scripts/ci_post_clone.sh with this line that Xcode will run.

1. Add a dependency in Package.swift:

   dependencies:[.package(url:"https://github.com/mac-cain13/R.swift.git", from:"7.0.0")]

2. For each relevant target, add a dependency and a plugin

   .target(    name:"Example",    dependencies:[.product(name:"RswiftLibrary",package:"R.swift")],    plugins:[.plugin(name:"RswiftGeneratePublicResources",package:"R.swift")])

3. Build your project, now theR struct should be available in your code, use auto-complete to explore all static references

We'll love contributions, read thecontribute docs for info on how to report issues, submit ideas and submit pull requests!

R.swift is created byMathijs Kadijk andTom Lokhorst released under aMIT License.