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-Re-Learn

Swift 4.0 语法变化简介

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[..<comma]

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

环境

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

流程

migration-process

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

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

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

  • 选择要迁移的Target
select-target
  • 选择你希望迁移工具的迁移行为
select-convertion-mode
  • 编译你的代码

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

objc-warning

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

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

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的混编,然而...

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稳定。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 202,980评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,178评论 2 380
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 149,868评论 0 336
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,498评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,492评论 5 364
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,521评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,910评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,569评论 0 256
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,793评论 1 296
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,559评论 2 319
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,639评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,342评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,931评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,904评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,144评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,833评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,350评论 2 342

推荐阅读更多精彩内容