迁移程序到 Swift 3.0

   <p>在昨晚 WWDC 之后，相必大家都已经下载到最新 Beta 版本的 XCode 甚至已经把手机升级到 iOS10 了吧。本次的 WWDC 虽然有很多人表示不满，感觉并无新意，但是在折腾完 Beta 版，投入实际开发后，还是对 iOS10 的内功有了一定的认识，不夸张的讲，这还真是内功了。当然这内功好不好练，以及练了是否值得，还有待各位看官自行判断，反正我是练了。。。</p>    <p>好了，还是回到正题，讲讲 Swift 3。每当看到新的编程语言我总是会有相当大的兴趣，是的，Swift 3是一门『新语言』，因为它看起来，怎么都不像过往的 Swift。打开一个老的项目时，发现满目疮痍，基本上能标红的代码全被标红了。先来个截图提提神：</p>    <p style="text-align: center;"><img alt="迁移程序到 Swift 3.0" src="https://simg.open-open.com/show/73f9238e56779b5a47e9ec5c07d89873.png"></p>    <p style="text-align: center;">图一 代码标红</p>    <p>怎么样，清醒点了没？可能你会觉得奇怪，怎么连 whiteColor() 这种通用的东西都不能用了？其实这是本次 Swift（和 SDK）大改的一个重要目标，就是『去重』。新的 SDK 去除了大量可有可无的东西，并且把库做深度的修整，现在的 SDK 看起来更好用了（当然你也可以吐槽又要记大量新的东西了，不过 Swift 哪次新版发布时你不改程序了，对吧）。下面我一一来讲述。</p>    <h2><strong>一、去重 </strong></h2>    <p>Swift 3 对于重复输入的表达式深恶痛绝，如上图所示的 whiteColor()，现在一律被改为了 white()。我们可以推断出其他类似的改动（或者让 IDE 帮助我们），如：</p>    <pre>  <code class="language-swift">UIColor.whiteColor()   被改为  UIColor.white()</code></pre>    <pre>  <code class="language-swift">list.objectAtIndex(i)  被改为  list.object(at: i)</code></pre>    <p>同样的，方法也被如此修改了，如：</p>    <pre>  <code class="language-swift">presentViewController(controller, animated: true)  被改为  present(toViewController: controller, animated: true)</code></pre>    <pre>  <code class="language-swift">dequeueReusableCellWithIdentifier("Cell", forIndexPath:indexPath)  被改为  dequeueReusableCell(withIdentifier: "Cell", for: indexPath)</code></pre>    <pre>  <code class="language-swift">func numberOfSectionsInTableView(tableView: UITableView) -> Int  被改为  func numberOfSections(in tableView: UITableView) -> Int</code></pre>    <p>一个很不幸而且几乎会让人崩溃的消息是，这样的改动几乎发生在每一处函数调用，这使用开发人员不得不重新审视几乎所有的代码，因为老的代码可能都在新的 SDK 下变得毫无建树。</p>    <h2><strong>二、参数 </strong></h2>    <p>Swift 3 对参数的传入做了大幅改动，主要是添加了参数名称的限定，在 Swift 3 下，一个方法所接受的参数必须拥有『名称』，而让全部参数都拥有名称这件事，改动实在太大了，因此 Swift 又想出了一招可以让你不写名称，使用单个下划线作为允许匿名符号。参考以下实例：</p>    <pre>  <code class="language-swift">override func viewWillAppear(animated: Bool)  被改为  override func viewWillAppear(_ animated: Bool)</code></pre>    <p>下面再看一个实例的调用例子，加深印象：</p>    <pre>  <code class="language-swift">func myFunc(x: Int, y: Int)  这个函数在调用时必须使用以下代码  myFunc(x: 1, y: 2)</code></pre>    <p>若是允许匿名参数，则修改之：</p>    <pre>  <code class="language-swift">func myFunc(_ x: Int, _ y: Int)  这个函数在调用时允许不带参数名称  myFunc(1, 2)</code></pre>    <p>这样的改动较大程度的影响了原有继承下来的方法，如<code>viewWillAppear</code>，UITableView 的回调函数等。对于自己写的方法，稍加注意即可，这两种方法都有着各自适用的场景。</p>    <h2><strong>三、命名 </strong></h2>    <p>在早期的 Objective-C 或 Swift 中，系统内的常量、函数等的命名一直是一件让人头疼的事，例如<code>UIControlContentHorizontalAlignmentCenter</code>这种，简直又臭又长，超级难记，虽说有 Xcode 这种强大的 IDE，也难免会弄错。在 Swift 3 内，所有的相关常量都被划到指定的枚举类中，而常量和函数均遵守相当良好的代码规范。来看几个实例：</p>    <pre>  <code class="language-swift">lbl.textAlignment = NSTextAlignment.Center  被改为  lbl.textAlignment = NSTextAlignment.center</code></pre>    <pre>  <code class="language-swift">tableFooterView = UIView(frame: CGRectZero)  被改为  tableFooterView = UIView(frame: CGRect.zero)</code></pre>    <p>另外，现在的新的命名方式也更注重突出实际作用，再给个例子体会下：</p>    <pre>  <code class="language-swift">lbl.hidden = false  被改为  lbl.isHidden = false</code></pre>    <p>与此同时，所有NS类的类名也变得简洁了，不再需要NS前缀，再配合其他的改动（如去重），对代码的精简形成了相当大的影响：</p>    <pre>  <code class="language-swift">let bundle = NSBundle.mainBundle()  被改为  let bundle = Bundle.main()</code></pre>    <pre>  <code class="language-swift">let mgr = NSFileManager.defaultManager()  被改为  let mgr = FileManager.default()</code></pre>    <p>再次告知一个不幸的消息，这样的改动几乎也牵动了全部的代码！！讲到这里可能有一部分人已经哭了，居然要改那么多代码，还能不能好好玩耍了？ 别担心，下面还有一半。</p>    <h2><strong>四、方法的返回值处理 </strong></h2>    <p>我们在开发中可能会经常调用一些带有返回值的方法，但是却不处理返回值，例如以下这种：</p>    <pre>  <code class="language-swift">navigationController!.popViewControllerAnimated(true)</code></pre>    <p>这个方法实际上返回一个 UIViewController，但是很少有人会用，更多的场景是把它当成无返回的方法来使用。但是在 Swift 3 中，这样做是不行的，你必须处理掉这个返回值，如下：</p>    <pre>  <code class="language-swift">let _ = navigationController!.popViewController(animated: true)</code></pre>    <p>使用单个下划线来指代一个不会被使用的变量。</p>    <p>另外，Swift 3 不再允许传入传出的对象，之前带有 var 的方法声明将全部作废：</p>    <pre>  <code class="language-swift">func myFunc(var a: Int) -> Int</code></pre>    <p>如以上这种声明，已不可再使用，对于有多个值要返回的方法，必须改为：</p>    <pre>  <code class="language-swift">fun myFunc(a: Int) -> (Int, Int)</code></pre>    <h2><strong>五、可选类型 </strong></h2>    <p>Swift 3 对可选类型的处理更严格了，必须显式的在任何地方使用感叹号，例如我们有以下代码：</p>    <pre>  <code class="language-swift">var str: String! = "a"  var s = str  print(s)</code></pre>    <p>在 Swift 以往的版本中，print 语句会打印出 str 的值，也就是『a』。而在 Swift 2.3 下，则是会打印出『Optional("a")』。因此很多对字符串处理（特别是路径处理）的代码都会出错，因为会莫名其妙的带上了各种各样的『Optional』字样。正确的处理方式是：</p>    <pre>  <code class="language-swift">var str: String! = "a"  var s = str!  print(s)</code></pre>    <p>或者</p>    <pre>  <code class="language-swift">var str: String! = "a"  var s = str  print(s!)</code></pre>    <p>同样的，在实际开发中，如果用到字符串模板，也需要非常注意这样的变化：</p>    <pre>  <code class="language-swift">var str  = "Loaded: \(data)"  需要被修改为  var str  = "Loaded: \(data!)"</code></pre>    <h2><strong>六、Selector </strong></h2>    <p>Swift 对于 Selector 的修改可能是最让人无奈的了，我们来细数一下经历过的版本：</p>    <pre>  <code class="language-swift">self.performSelector(onMainThread: #selector(handle(ret:)), with: ret, waitUntilDone: true)  就以 Swift 3 下的这个函数为基准吧，老版本的Selector获取方法是这样的：  #selector(ViewController.handle(_:))    // 2.2  #selector(ViewController.handle(:))     // 2.1  #selector(handle)                       // 2.0  @selector("handle:")                    // 1.x  x等于几已经不记得了  "handle:"                               // 没记错的话是 1.0 时代，直接传个字符串就是 Selector  N/A                                     // Swift 的历史上，还真有过没有 Selector 的版本</code></pre>    <p>回到 Swift 3 上来，目前的 Selector 写法如最上面那种，需要注意的是，Selector 的方法名和参数名必须与实际被调用的方法完全一致，否则编译时就会报错。</p>    <p>另外，Selector 传参时，只能传递对象，不能传基础数据类型，传基础数据类型的情况下，一律变成0（希望这只是当前版本的 bug，不然太蛋疼了）。虽说苹果已经把大部分的 NS 类都去掉了前缀，但是 NSNumber 这东西还是得经常用一下呢，至少目前是这样的。</p>    <h2><strong>七、类库 </strong></h2>    <p>随着 Swift 3 一起发布的 iOS SDK 10，其改动也不小，特别是对一些类库的改动，删除了大量的方法，有些方法可能是对我们过去的开发带来大量帮助的。但是没有办法，我们必须接受这样的改变。</p>    <p>类库的改动没有办法一一说明，我用到的 SDK 成员也非常有限，所以就只讲几个例子。</p>    <ul>     <li> <p>针对有 option 选项的 protocol，目前强制要求为每一条都写上 @objc，如：</p> <pre>  <code class="language-swift">@objc protocol MyProtocol: NSObjectProtocol {        optional func foo(myClass: MyClass?)        optional func bar(myClass: MyClass?)  }  需要改为  @objc protocol MyProtocol: NSObjectProtocol {        @objc optional func foo(myClass: MyClass?)        @objc optional func bar(myClass: MyClass?)  }</code></pre> </li>     <li> <p>不再有<code>CGRectMake</code>，<code>CGSizeMake</code>等常用函数了，如：</p> <pre>  <code class="language-swift">UIView(frame: CGRectMake(0, 0, 48, 48))  被改为  UIView(frame: CGRect(x: 0, y: 0, width: 48, height: 48))</code></pre> </li>     <li> <p>Normal选项用方括号对来代替，如：</p> <pre>  <code class="language-swift">btn.setTitleColor(UIColor.whiteColor(), forState: UIControlState.Normal)  被改为  btn.setTitleColor(UIColor.white(), for: [])</code></pre> <p>至于为什么会如此改，我是没想明白，不管怎么说，<code>UIControlState</code>内已经没有<code>normal</code>这个选项了，目前也只能这么做。方括号非常容易引起对于数组或是集合等的联想，但是此处却又完全不是数组或集合，方括号的语义并不清晰。</p> </li>     <li> <p>图形图象库有较大改动，给个具体例子参考下：</p> <pre>  <code class="language-swift">let imgData = UIImageJPEGRepresentation(img, 1)  let imgPath = "\(FileUtils.getDocumentPath())/\(name)"  imgData!.writeToFile(imgPath, atomically: true)  必须改为  let imgData = UIImageJPEGRepresentation(img, 1)  let imgPath = "\(FileUtils.getDocumentPath()!)/\(name!)"  NSData(data: imgData!).write(toFile: imgPath, atomically: true)</code></pre> </li>    </ul>    <h2><strong>结束语 </strong></h2>    <p>就先讲这么些吧，已经够各位改一阵子了。虽然 Swift 这么虐，但是随着一次次迭代，还是可以看到它在稳固的进步着，希望以后不要再那么大变化了吧。至少语法给个兼容，类库给个 Mapping，不要直接全屏飘红（可以飘黄呀...），或许这样才能走得更快更稳吧。</p>    <p>最后多讲一句，临时改标题是不对的，但是我还是改了，跟大家说声抱歉。昨天犯了个错误，XCode8 里面的确是 Swift3，只是我们都被它内置的 2.3 给误导了，真正的 Swift3 编译器被放在一个奇怪的地方：</p>    <pre>  <code class="language-swift">Swift 2.2: Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/swift  Swift 2.3: Developer/Toolchains/Swift_2.3.xctoolchain/usr/bin/swift  Swift 3:   Developer/Toolchains/XcodeDefault.xctoolchain/usr/lib/swift-migrator/swift</code></pre>    <p> </p>    <p>文／<a href="/misc/goto?guid=4959674455450838477">何晓杰Dev</a>（简书）</p>