Migration

Pointers for migration between major versions.

Upgrading to 3.0

Make sure you use Swift 3 / Xcode 8 since we've adjusted to the syntax changes.
If you want to use Swift 2.3 / Xcode 8 use the latest R.swift 2 release.
Some methods are renamed to match the new Swift 3 naming conventions, there are annotations available so the compiler can help you migrate.

Upgrading to 2.0

Make sure you use Swift 2.2 / Xcode 7.3 since we've adjusted to the syntax changes.

Upgrading to 1.0

iOS 7 support is dropped, use R.swift 0.13 if you still have to support it.
Generated code now depends on the R.swift.Library, CocoaPods users don't need to do anything. Manual installation users need to include this library themselves, see the readme for instructions.
In general; properties that created new stuff are now functions to represent better that they actually create a new instance.

R.image.settingsIcon changed to R.image.settingsIcon()
R.file.someJson changed to R.file.someJson()
R.storyboard.main.initialViewController changed to R.storyboard.main.initialViewController()
R.storyboard.main.someViewController changed to R.storyboard.main.someViewController()

In general; Where you needed to use .initialize() to get the instance, a shorter function is available now:

R.storyboard.main.initialize() changed to R.storyboard.main()
R.nib.someView.initiate() changed to R.nib.someView()

Nib root view loading changed from R.nib.someView.firstView(nil, options: nil) to R.nib.someView.firstView(owner: nil)
Typed segue syntax changed from segue.typedInfoWithIdentifier(R.segue.someViewController.someSegue) to R.segue.someViewController.someSegue(segue: segue)
Runtime validation changed:

R.validate() now throws errors it encounters
R.assertValid() asserts on errors and only performs action in a debug/non-optimized build
For regular use cases using R.assertValid() is recommended