R.swift 让iOS项目像Android R 一样管理资源

什么是 R.Swift

搞过的Android开发同学都知道，在Android开发中，其对于资源的引用非常方便，我们可以通过”R机制”来对Android中的图片(Drawable)、布局(Layout)、动画配置(Anim)、国际化字符串(String)、尺寸(Dimen)等等资源进行非常方便快捷的引用。

开妈搞iOS的时候，我瞬间觉得iOS的资源引用略为恶心，跟Android比起来，它更加蛋疼麻烦。

R.Swift是一款基于Swift平台，针对iOS以及TVOS开发的仿Android资源引用框架。它所针对的问题，就是类似于刚刚我在上方提到的一样，避免使用字符串来构造某些资源实例。R.Swift能够在我们修改项目资源后动态地进行配置，最终，你能够使用类似语法R.资源类型.资源名称来对某资源进行引用构建。R.Swift有着动态生成代码的机制，由此，它具有以下极具魅力的优点：

代码自动补全：就像输入其他的代码一样，R.Swift支持IDE的代码自动补全，当你的资源量非常庞大时，你只需把资源调用语法的前沿部分敲出来，IDE就会自动给予代码提示以及补全，这对资源的引用效率有着显著的提高。
自动检测：当我们写入某些错误的代码时，IDE会向我们反馈错误以及警告，如我们调用某个类中不存在的方法时，IDE就会立即检测出代码的错误，并给予反馈。在R.Swift中，若我们将资源重命名，或干脆将资源删除了，R.Swift会自动重新进行配置，而在之前我们对该资源进行引用的地方，IDE也会相应的向我们报错，表明资源的不存在，如此一来，我们就不必担心资源的修改删除对代码的蝴蝶效应了。

R.Swift的安装配置

传送门: https://github.com/mac-cain13/R.swift

在这里我们使用的是CocoaPods来对R.Swift进行安装，相关的步骤也不必累赘说明，一句pod install后我们把R.Swift安装进来了。

pod 'R.swift'

进入终端执行：

pod install

下面要进行R.Swift的配置，主要有几个步骤：

进入项目的配置界面，在左边的TARGETS项下面选择我们的项目，并在右边点击Build Phases这个tab。
进入Build Phases这个tab后，我们看到左上角有一个”+”按钮，点击并在弹出的选项卡中选择New Run Script Phase。
我们会看到界面的下方多出了一个Run Script项，展开它，并在脚本输入区域输入"$PODS_ROOT/R.swift/rswift" "$SRCROOT" (第二对双引号括起来所代码的是项目的根目录，你也可以放到根目录下的其他目录中，只需将其修改为"$SRCROOT/XXX"，XXX为目标目录名)。这里把生成的 R.generated.swift 放在了工程的main路径下
我们按住新建的这个Run Script项向上移动，移到Compile Source项的上方，不过也要保证此时它也在Check Pods Manifest.lock项的下方。
Command + B，编译一下，编译成功后，在Finder进入到刚刚我们制定的目录中，此时我们会看到一个名为R.generated.swift的文件已经创建了，直接把此文件拖入Xcode项目中，记住不要勾选Copy items if needed项。

配置到此完成，我们可以构建自己的项目了

R.Swift的使用

在这里要说明一下，每当我们修改了资源，我们需要Command + B来编译一下项目从而让R.Swift自动进行配置更新。

下面就来用实例演示一下R.Swift的使用，并与原生的API进行比对：

Image - 图片

//  不使用R.Swift
let pImage = UIImage(named: "image_test")
//  使用R.Swift
let nImage = R.image.image_test()
File - 数据文件

//  不使用R.Swift
let pFile = NSBundle.mainBundle().pathForResource("DataFile",ofType: "json")
//  使用R.Swift
let nFile = R.file.dataFileJson.path()

Font - 字体

// 不使用R.Swift
let pFont = UIFont(name: "chalkduster",size: 35)
// 使用R.Swift
let nFont = R.font.chalkduster(size: 35)
// 你看，非常神奇，在上面的方法中你不仅可以选择字体类型，还能设置字体大小

Nib

//  不使用R.Swift
tableView.registerNib(UINib(nibName: "TanTableViewCell",bundle: nil),forCellReuseIdentifier: CELL_IDENTIFIER)
//  使用R.Swift
tableView.registerNib(R.nib.tanTableViewCell(),forCellReuseIdentifier: CELL_IDENTIFIER)

Color - 颜色

颜色这里我觉得有必要细讲一下，一个较为庞大的项目，其颜色资源配置也是相应比较复杂，如某些视图的背景颜色、字体的颜色等等，以往我们进行颜色资源的配置，一般会定义一个全局的Config文件或类，里面就存有各种颜色，每种颜色用有意义的名称去标识。R.Swift与其不同的是，它还能有更赞的方式导入颜色资源： Color Palette

呵呵，这个方式可以说是非常的花式，配合R.Swift使用起来简直6得飞起！
当我们在可视化视图编辑界面（如Storyboard）中为一个视图配置某些颜色时，我们可以进入颜色调色板来选择更多的颜色，如图：

新建一个调色板

找到该调色板文件

将该调色板文件复制到项目，并确保其中资源编译列表中

// 当调色板文件名为app.clr
let clr = R.color.app.base()

参考文章

http://www.jianshu.com/p/10461449bb77
https://github.com/mac-cain13/R.swift