Swift 3.0 预告 - 将 Objc 库转换成更符合 Swift 语法风格的形式

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