原因
这个源于一个编号为 SE-0005 的提案,并且已经审核通过。这个方案的提出,源于这样一个痛点。 Swift 应用于 iOS App 开发,就免不了会依赖于原生的 Cocoa Touch 库。而由于历史原因,大家也都知道, iOS 原生库大多时基于 Objc 来实现的。所以他们的编码规范也都遵循着 Objc 的规范,诸如函数,方法的命名规则这些,都有自己的一套标准。
而 Swift 3.0 也发布了自己的 API 设计规范,同时 Objc 也有自己的设计规范,这样一来我们使用 Swift 开发 iOS App 的时候,其实总是在游走于两套规范的 API 之间,对开发者的体验嘛,就不是很好了。
例子
咱们用一个实际的例子来说明这个问题。 比如 NSString 有这样一个方法:
let content = listItemView.text.stringByTrimmingCharactersInSet( |
stringByTrimmingCharactersInSet
会剪掉字符串头尾中的某些字符。从这个方法名中,明显的可以看出它是以 Objc 规范来命名的。
如果以 Swift 的编码规范,这个方法其实应该这样命名:
从这里可以看出,objc 的命名方式,很多会把函数的返回值类型,以及参数类型都包含在函数名里面。比如我们上面的stringByTrimmingCharactersInSet
方法。但这和 Swift 命名规则就不同了。而且随着 Swift 规范的清晰,这个问题就越来越凸显出来了。
所以 Swift 3.0 才会将这个问题提上日程,并在这个版本中准备解决这个问题。
规则
解决这个问题,肯定不能手动的替换。因为系统库的方法实在太多了,所以就需要总结出一系列替换规则。根据这些规则将相应的标识替换完成。
那么 Swift 具体是怎么做的呢, 咱们来了解一下。
扩大 swift_name
编译属性的应用范围 - 这个涉及到 Swift 底层的概念,当我们将 Objc 的 API 导入到 Swift 的时候,我们是可以指定一个编译属性swift_name
的。而这个编译属性,可以将 Objc 中的标识名称在 Swift 中以不同的名字表现出来。但在之前的版本中,这个编译属性只能对枚举项和工厂方法有效,这次将会扩大它的范围。
去除多余的类型名称 - Objc 的编码规范中,会建议在方法名称中将参数名和类型也表示出来,而这个在 Swift 中就是多余的,我们前面那个例子也演示了。这个也是着重处理的点。
添加默认参数 - 对于 Objc 需要默认参数的地方,会在 Swift 中添加上默认参数,比如一些选项参数:
这个 option 参数就会提供默认参数。
添加第一个参数的参数标签 - 为方法的第一个参数添加合适的参数标签。
在布尔属性前面加上 is
- 在最新的 Swift 规范中,需要在布尔属性前面加上 is
,而 Objc 规范恰巧不建议使用 is
,所以在 Swift 3 中会将 Objc 迁移过来的布尔属性,按照 Swift 规范来进行修改。可以参考 Swift 规范中关于布尔属性的部分内容。
值类型变成小写 - 会将 Objc 的属性值以小写开头, 比如 URLHandler
会变为 urlHandler
.
下面是一个官方文档中给出的转换的例子:
转换后:
init(ovalIn rect: CGRect) move(to point: CGPoint) addLine(to point: CGPoint) addCurve(to endPoint: CGPoint,controlPoint1 controlPoint1: CGPoint,controlPoint2 controlPoint2: CGPoint) addQuadCurve(to endPoint: CGPoint,controlPoint controlPoint: CGPoint) append(_ bezierPath: UIBezierPath) reversing() -> UIBezierPath apply(_ transform: CGAffineTransform) var isEmpty: Bool { contains(_ point: CGPoint) -> Bool fill(_ blendMode: CGBlendMode,alpha alpha: CGFloat) stroke(copy(with zone: NSZone = nil) -> AnyObject encode(with aCoder: NSCoder) } |
是不是感觉方法名清晰很多呢。
总结
以上就是 Swift 3 对 Objc 依赖库中的优化了,这次优化后,我们以后在用 Swift 来开发 iOS App 的时候,就不会再混合两种代码风格啦。