Swift 4.0 Migration

Swift-4

最近完成了Swift 4.0的迁移,记录下迁移过程中遇到的坑

Agenda

Swift 4.0 简介
Swift 4.0 语法变化简介
Swift 4.0 Migration 流程
Swift 4.0 Migration 过程中遇到的“坑”

Swift 4.0 简介

Swift 4.0的目标由ABI(Application Binary Interface)稳定,变为了源码兼容,其中ABI的兼容和源码的兼容都代表什么意思呢?

  • ABI 兼容:Swift 3 预先编译出来的库,不用重新编译,也可以在 Swift 4 中正常链接
  • 源码兼容:Swift 3 编写的源码不用经过修改,就可以在 Swift 4 中正常编译

Swift 3.2,源码兼容,Swift 3.0 几乎不需要修改,只需重新编译,Swift 4.0 与 Swift 3.2 framework支持混编,可见Swift 4.0的兼容性还是比较高的

Swift 4.0 Migration_第1张图片
Swift-Re-Learn

Swift 4.0 语法变化简介

Swift 4.0 Migration_第2张图片
grammar-changes

Swift 4.0语法变化还是不少的,但是值得一提的大概是以下四个:

String

首先是String再次变成了一个Collection,Swift 1.0的时候,String是一个Collection类型,Swift 2.0将其变成了一个独有的String类型,Swift 4.0其再次变成了Collection类型

let greeting = "Hello, World!"
greeting.count
for char in greeting {
    print(char)
}

其中substring方法被弃用,现在我们使用集合的方式来查找子字符串,且子字符串现在是一个新类型即Substring

let greeting = "Hello, World!"
let comma = greeting.index(of: ",")!
let substring = greeting[..

private

以前我们总抱怨Swift中的Extension访问不到private的属性或方法,我们不得不使用fileprivate来解决这个问题,在Swift 4.0中,这个问题得到了解决,我们终于可以在Extension中访问到private的属性了。

Swift 3.x
class Demo {
  fileprivate let id: Int

  init(id: Int) {
    self.id = id
  }
}

extension Demo: Equatable {
  static func ==(lhs: Demo, rhs: Demo) -> Bool {
    return lhs.id == rhs.id
  }
}
Swift 4.0
class Demo {
  private let id: Int

  init(id: Int) {
    self.id = id
  }
}

extension Demo: Equatable {
  static func ==(lhs: Demo, rhs: Demo) -> Bool {
    return lhs.id == rhs.id
  }
}

支持组合Class和Protocol来定义变量

let demo: (Demo & DemoProtocol)?

@objc

最后也是最大的变化,@objc,Apple将Swift从默认与OC兼容改为了手动兼容,现在我们如果想在OC代码中调用Swift代码,我们需要手动在属性和方法前添加@objc关键字。如下:

@objc let demo: Demo!
@objc func doSomething()

苹果对此的解释是这减小了App的尺寸,举例的话即Apple自己的Music App减少了大约6%,但是我觉得,这可能以为着Apple打算分裂Swift和OC语言了,甚至Apple打算弃用Objective-C语言了。

Swift 4.0 Migration 流程

Swift 4.0 Migration_第3张图片
Swift

环境

Xcode 9

Xcode 9是Apple官方推出的IDE,自带Swift 4.0的编译环境。

Xcode 8.3

有些开发人员可能会进行不止一个项目的开发,可能会希望保留Xcode 8.3,这时我们也可以使用Xcode 8.3来开发Swift 4。其步骤如下:

  • 从 swift.org 下载最新的 Swift 4.0 snapshot
  • 运行安装程序
  • 在Xcode中,Xcode > Toolchains > Manage Toolchains… 然后选择 snapshot

流程

Swift 4.0 Migration_第4张图片
migration-process

迁移流程如上图所示,具体可分为如下几步:

  • 从Build Settings中选择Swift版本
Swift 4.0 Migration_第5张图片
select-version
  • 使用内置工具完成迁移 Edit > Convert > To Current Swift Syntax…

[图片上传失败...(image-d7396a-1516387382216)]

  • 选择要迁移的Target
Swift 4.0 Migration_第6张图片
select-target
  • 选择你希望迁移工具的迁移行为
Swift 4.0 Migration_第7张图片
select-convertion-mode
  • 编译你的代码

之后编译你的代码,你会看到如下图所示的警告,将其对应的方法添加@objc即可

objc-warning

  • 在Build Settings中将Swift 3 @objc Inference设置为 Default
swift-3-objc-inference

Swift 4.0 迁移过程中遇到的问题

Swift 4.0 Migration_第8张图片
questions

@objc 带来的“坑”

虽然90%的@objc都会在编译期间被检查出来,但是仍然有一些我们无法在编译检查出来,就是运行时的错误。

if ([controller respondsToSelector:@selector(method_name)])
{
    [controller performSelector:@selector(method_name)];
}

上面这对代码问题在于,如果我们method_name没有加@objc,那么我们上面的if判断就会失败,并且没有警告或错误,你会发现你的功能直接失效了。

[demo setValue:value toKeyPath:path];

上面这对代码问题在于,我们Set keyPath的时候,如果被set的path对应的属性没有加@objc,那么我们调用setKeyPath就会造成App崩溃,这里同样不会有警告或错误,如果错误本身不是在主要功能中,很可能被我们忽略而造成线上Bug。

Cocoapods Swift3, Swift4 版本混编的问题

前文我们提到了Swift这个版本的源码兼容性很高,且支持Swift3.2和Swift4.0 framework的混编,然而...

Swift 4.0 Migration_第9张图片
problems

我们会发现当我们将项目的Swift版本改为4.0之后,我们所有Cocoapods安装的依赖的Swift版本也变为了4.0,这导致我们完全浪费了Apple的Swift3.2和4.0 framework混编的优势,导致我们不得不等待我们所有依赖的库升级到Swift4.0之后才能升级我们自己的Target到Swift4.0,或者不得不用一个私有的Pod Module自己升级,增加了许多不必要的工作量,这里给大家分享一下我们项目上的解决方案。

Pod install hook

第一种是我们修改Pod install hook,来将我们希望的依赖的Swift版本手动改为Swift 3.2版本,如下面代码所示,我们将Quick改为了Swift3.2版本(Quick最为常用的测试库,从1.2.0版本开始支持Swift 4.0,之前版本为1.1.0不支持Swift4.0)。

post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      if config.build_settings['PRODUCT_NAME'] == 'Quick'
        config.build_settings['SWIFT_VERSION'] = 3.2
      end
    end
  end
end
xcconfig文件

我们可以将Swift的版本写入xcconfig文件中,删除Build Settings里面的设置,这样也可以让我们的Pod module的Swift版本设置为3.2版本

如果我们使用的库连3.2都编译不过,或者说使用的库Swift版本低于3.0(因为Swift 3的代码不许要修改就可以用Swift3.2的编译器编译),那么我建议我们应该暂停升级Swift4.0,先将这个库替换成在持续更新的库。

总结

总得来说,这次版本迁移并不像Swift前几个版本那样困难,想对兼容性也比较好。本文介绍了Swift 4.0的语法变化,例如@objcprivate的问题,之后讨论了迁移的基本流程,最后讨论了我遇到的一些"坑",例如@objcCocoapods带来的问题。现在我们该开始期待Swift 5.0了,希望下个版本可以做到ABI稳定。

你可能感兴趣的:(Swift 4.0 Migration)