Swiftpack.co - Package - mac-cain13/R.swift

R.swift Version License Platform

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


⚠️ R.swift and Xcode 10 / Swift 4.2

The currently latest release of R.swift (5.0.0.alpha.2) supports Swift 4.2, but with a couple of known issues:

When using the new build system and using R.swift as a build step:

  • The initial compile will fail if no output file is configured
  • However, when setting an output file, subsequent incremental build won't run the R.swift build step

Current known work-arounds for these issues:

  1. Use the Legacy Build System
  2. Don't configure an output file, but compile twice (difficult on a CI)
  3. Configure an output file, but always do a clean build when an asset has been added (difficult to remember when developing)
  4. Commit the R.generated.swift file to source control, so the CI has the lastest version from development

We're working on finding a better solution to these issues, see also: https://github.com/mac-cain13/R.swift/issues/456


Why use this?

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:

let icon = UIImage(named: "settings-icon")
let font = UIFont(name: "San Francisco", size: 42)
let color = UIColor(named: "indictator highlight")
let viewController = CustomViewController(nibName: "CustomView", bundle: nil)
let string = String(format: NSLocalizedString("welcome.withName", comment: ""), locale: NSLocale.current, "Arthur Dent")

With R.swift it becomes:

let icon = R.image.settingsIcon()
let font = R.font.sanFrancisco(size: 42)
let color = R.color.indicatorHighlight()
let viewController = CustomViewController(nib: R.nib.customView)
let string = R.string.localizable.welcomeWithName("Arthur Dent")

Check out more examples or hear about how Fabric.app uses R.swift!

Demo

Autocompleted images:

Autocompleted images

Compiletime checked images:

Compiletime checked images

This is only the beginning, check out more examples!

CocoaHeadsNL presentation

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.

R.swift presentation at CocoaHeadsNL

Features

After installing R.swift into your project you can use the R-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:

Runtime validation with R.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

Q&A

Installation

CocoaPods is the recommended way of installation, as this avoids including any binary files into your project.

Note on Carthage: R.swift is a tool used in a build step, it is not a dynamic library. Therefore it is not possible to install it with Carthage.

⚠️ Change between R.swift 3 and R.swift 4

Be aware:
For R.swift 3.x and below, the rswift executable should be called with only one argument: rswift $SRCROOT
For R.swift 4, the rswift executable should be called with two arguments: rswift generate $SRCROOT

CocoaPods (recommended)

There is also a short video of this instruction.

  1. Add pod 'R.swift' to your Podfile and run pod install
  2. In Xcode: Click on your project in the file list, choose your target under TARGETS, click the Build Phases tab and add a New Run Script Phase by clicking the little plus icon in the top left
  3. Drag the new Run Script phase above the Compile Sources phase and below Check Pods Manifest.lock, expand it and paste the following script:
    "$PODS_ROOT/R.swift/rswift" generate "$SRCROOT"
    
  4. Build your project, in Finder you will now see a R.generated.swift in the $SRCROOT-folder, drag the R.generated.swift files into your project and uncheck Copy items if needed

Tip: Add the *.generated.swift pattern to your .gitignore file to prevent unnecessary conflicts.

Manually

  1. Add the R.swift.Library to your project
  2. Download a R.swift release, unzip it and put it into your source root directory
  3. In Xcode: Click on your project in the file list, choose your target under TARGETS, click the Build Phases tab and add a New Run Script Phase by clicking the little plus icon in the top left
  4. Drag the new Run Script phase above the Compile Sources phase, expand it and paste the following script:
    "$SRCROOT/rswift" generate "$SRCROOT"
    
  5. Build your project, in Finder you will now see a R.generated.swift in the $SRCROOT-folder, drag the R.generated.swift files into your project and uncheck Copy items if needed

Tip: Add the *.generated.swift pattern to your .gitignore file to prevent unnecessary conflicts.

Building from source

R.swift is built using Swift Package Manager (SPM).

  1. Check out the code
  2. Run swift build -c release -Xswiftc -static-stdlib from the root directory
  3. Follow the manual installation steps with the binary you now have

For developing on R.swift in Xcode, run swift package generate-xcodeproj --xcconfig-overrides RswiftConfig.xcconfig.

Contribute

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

License

R.swift and R.swift.Library are created by Mathijs Kadijk and released under a MIT License.

Special thanks to Tom Lokhorst for his major contributions and help maintaining this project.

Github

link
Stars: 5512
Help us keep the lights on

Dependencies

Releases

v5.0.0.alpha.2 - Sep 3, 2018

  • Nib parsing fixes for Xcode 10 from @rafaelnobrepd

v5.0.0.alpha.1 - Jun 23, 2018

  • Removed CLR file support, use color resources instead
  • Easier nib loading with new method
  • Ignore file supports explicit include (by @renrawnalon)
  • Validation for named colors
  • Empty structs are not generated anymore (by @soberman)
  • Compatible with Xcode 10 / Swift 4.2 / iOS 12 SDK, this release is not compatible with older versions use R.swift 4 if you still need that compatibility

v4.0.0 - Oct 2, 2017

  • Improved Xcodeproj errors
  • New color assets are now supported
  • Better capitalization is now enabled by default
  • Xcode 9/Swift 4/SPM fixes
  • Deprecate clr based color resources
  • Introduce color asset based color resources

v4.0.0.alpha.4 - Sep 6, 2017

  • Changes for latest Swift 4 betas
  • Improved Xcodeproj errors

v4.0.0.alpha.3 - Jun 19, 2017

  • New color assets are now supported
  • Better capitalization is now enabled by default
  • Use new XcodeEdit version that warns when your projectfile is corrupt
  • Xcode 9/Swift 4/SPM fixes