iOS 同时兼容 Xcode 7 和 Xcode 8

最新推荐文章于 2022-11-26 21:24:31 发布
最新推荐文章于 2022-11-26 21:24:31 发布
阅读量2.7k 收藏 1
点赞数
分类专栏： iOS

做为 iOS 开发者，你肯定会对 iOS 10 中的新特性感到无比兴奋，并迫不及待地想要在应用中进行实践。虽然你想马上就动手以便第一时间就能“上船“。但 iOS 10 正式上线却是几个月以后的事情，而且在那之前，你还需要保持每几周就发布一次的频率。这个情况听起来是不是跟你现在的处境很像呢？

当然，目前你还不能用 Xcode 8 来编译需要发布的应用——因为它无法通过 App Store 的验证。所以你需要把项目拆分成两个分支，稳定分支和 iOS 10 开发分支……

而不可避免地是，这烂透了。如果只是在分支上做一点某个特性的开发还是可以的。但是如果是持续好几个月来维护这个庞大的分支呢？不仅它的整个代码库都发生了变化，而且主分支也一直在演进，这时候你就会碰到一些不可描述的合并之痛了。我说的是，你有尝试过处理 .xcodeproj 文件的合并冲突么？

这篇文章的目的就是告诉你如何彻底避免使用分支。对于大部分应用而言，只用一个工程文件就同时支持 iOS 9（Xcode 7）和 iOS 10（Xcode 8）是完全可能的。而且即使你不得不使用分支，这些小技巧也可以帮助你减少两个分支之间的差异，从而更舒服的对它们进行同步。

你要用的是 Swift 2.3

我先说明一点：

我们都为 Swift 3 而兴奋。它很棒，但是如果你正在读这篇文章，请别用它（或者暂时别）。虽然它很好，但是它在代码层面上存在很大的不兼容，比一年前 Swift 2 的不兼容还要严重得多。而且一旦应用存在对第三方 Swift 库的依赖，就得等这些库都升级到 Swift 3，它才可以跟着升级。

而好消息是，同时也是史无前例的事情，Xcode 8 支持两个版本的 Swift：2.3 和 3.0。

为了防止你错过了某些通知，Xcode 7 中的 Swift 2.3 和 Swift 2.3 基本是一致的，除了少数的 API 调整（之后会详细介绍）。

所以！为了保持兼容性，我们还是用 Swift 2.3 来进行开发。

Xcode 的设置

说这么多你应该已经很明白了。现在我来教你如何设置你的 Xcode 项目，让它可以在这两个版本上运行。

Swift version

这里写图片描述

首先，在 Xcode 7 中打开你的项目。然后打开项目的设置页，选中 Build settings 选项，然后点击 “+“来增加一个 User-Defined 设置项：

<code class="hljs fix has-numbering" style="display: block; padding: 0px; color: inherit; box-sizing: border-box; font-family: 'Source Code Pro', monospace;font-size:undefined; white-space: pre; border-radius: 0px; word-wrap: normal; background: transparent;"><span class="hljs-attribute" style="box-sizing: border-box;">“SWIFT_VERSION” </span>=<span class="hljs-string" style="color: rgb(0, 136, 0); box-sizing: border-box;"> “2.3”</span></code><ul class="pre-numbering" style="box-sizing: border-box; position: absolute; width: 50px; top: 0px; left: 0px; margin: 0px; padding: 6px 0px 40px; border-right-width: 1px; border-right-style: solid; border-right-color: rgb(221, 221, 221); list-style: none; text-align: right; background-color: rgb(238, 238, 238);"><li style="box-sizing: border-box; padding: 0px 5px;">1</li></ul>

这个选项是 Xcode 8 新增的，所以当它告诉 Xcode 8 使用 Swift 2.3 时，Xcode 7（实际上它并没有 Swift 2.3）会完全忽略这个设置并继续使用 Swift 2.2 来进行构建。

Framework provisioning

Framework provisioning 的工作方式在 Xcode 8 上稍有不同——如果是模拟器，它们会按原样继续编译，而对于真机会构建失败。

修复这个问题的方式是，遍历 Build Settings 中所有的 Framework targets 并增加如下的选项，就像 SWIFT_VERSION：

<code class="hljs fix has-numbering" style="display: block; padding: 0px; color: inherit; box-sizing: border-box; font-family: 'Source Code Pro', monospace;font-size:undefined; white-space: pre; border-radius: 0px; word-wrap: normal; background: transparent;"><span class="hljs-attribute" style="box-sizing: border-box;">“PROVISIONING_PROFILE_SPECIFIER” </span>=<span class="hljs-string" style="color: rgb(0, 136, 0); box-sizing: border-box;"> “ABCDEFGHIJ/“</span></code><ul class="pre-numbering" style="box-sizing: border-box; position: absolute; width: 50px; top: 0px; left: 0px; margin: 0px; padding: 6px 0px 40px; border-right-width: 1px; border-right-style: solid; border-right-color: rgb(221, 221, 221); list-style: none; text-align: right; background-color: rgb(238, 238, 238);"><li style="box-sizing: border-box; padding: 0px 5px;">1</li></ul>

你需要把“ABCDEFGHIJ“替换成你的团队ID（你可以在 Apple Developer Portal 中找到它），然后保留最后的斜杠。

这实际上就是告诉 Xcode 8“嘿，我是来自这个团队的，你注意下 codesign，好吗？“，然后 Xcode 7 仍然会忽略这个设置，这样就万事大吉了。

Interface Builder

遍历所有的 .xib 和 .storyboard 文件，打开右侧边栏，选中第一个选项（File inspector），然后找到“Opens in“设置项。

大部分情况下它显示的内容是 “Default (7.0)“，把它修改为“Xcode 7.0“。这可以保证即使你是在 Xcode 8 中新建的这个文件，它也只能做一些可以向后兼容 Xcode 7 的变动。

再次提醒一定要注意在 Xcode 8 中对 XIB 所做的改动。因为它会添加一些 Xcode 版本相关的数据（不能确定的是应用上传到 App Store 之后这些数据是否会被移除掉），而且某些时候它还会尝试把文件回滚到只支持 Xcode 8 的格式（这是个 bug）。所以我们要尽可能避免在 Xcode 8 中创建 interface 文件，如果实在没办法，那么再每次提交代码的时候都要仔细 review 代码，然后只提交你需要的那几行。

SDK version

确保所有的项目和构建目标的 “Base SDK“设置项都被设置为 “Latest iOS“。（大部分情况下默认设置就是这样的，但是还是要再次确认下。）这样一来，Xcode 7 就会针对 iOS 9 来编译，同时同样的项目在 Xcode 8 中就可以获得 iOS 10 的新特性。

CocoaPods settings

如果你用了 CocoaPods， 你同样也需要更新 Pods 项目的设置，确保其 Swift 和 provisioning 的设置是正确的。

同时你也可以通过在 Podfile 文件中添加如下 post-install 代码的方式来代替手动设置：

<code class="hljs livecodeserver has-numbering" style="display: block; padding: 0px; color: inherit; box-sizing: border-box; font-family: 'Source Code Pro', monospace;font-size:undefined; white-space: pre; border-radius: 0px; word-wrap: normal; background: transparent;">post_install <span class="hljs-built_in" style="color: rgb(102, 0, 102); box-sizing: border-box;">do</span> |installer|
  installer.pods_project.build_configurations.<span class="hljs-keyword" style="color: rgb(0, 0, 136); box-sizing: border-box;">each</span> <span class="hljs-built_in" style="color: rgb(102, 0, 102); box-sizing: border-box;">do</span> |config|
    <span class="hljs-comment" style="color: rgb(136, 0, 0); box-sizing: border-box;"># Configure Pod targets for Xcode 8 compatibility</span>
    config.build_settings[<span class="hljs-string" style="color: rgb(0, 136, 0); box-sizing: border-box;">'SWIFT_VERSION'</span>] = <span class="hljs-string" style="color: rgb(0, 136, 0); box-sizing: border-box;">'2.3'</span>
    config.build_settings[<span class="hljs-string" style="color: rgb(0, 136, 0); box-sizing: border-box;">'PROVISIONING_PROFILE_SPECIFIER'</span>] = <span class="hljs-string" style="color: rgb(0, 136, 0); box-sizing: border-box;">'ABCDEFGHIJ/'</span>
    config.build_settings[<span class="hljs-string" style="color: rgb(0, 136, 0); box-sizing: border-box;">'ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES'</span>] = <span class="hljs-string" style="color: rgb(0, 136, 0); box-sizing: border-box;">'NO'</span>
  <span class="hljs-function" style="box-sizing: border-box;"><span class="hljs-keyword" style="color: rgb(0, 0, 136); box-sizing: border-box;">end</span></span>
<span class="hljs-function" style="box-sizing: border-box;"><span class="hljs-keyword" style="color: rgb(0, 0, 136); box-sizing: border-box;">end</span></span></code><ul class="pre-numbering" style="box-sizing: border-box; position: absolute; width: 50px; top: 0px; left: 0px; margin: 0px; padding: 6px 0px 40px; border-right-width: 1px; border-right-style: solid; border-right-color: rgb(221, 221, 221); list-style: none; text-align: right; background-color: rgb(238, 238, 238);"><li style="box-sizing: border-box; padding: 0px 5px;">1</li><li style="box-sizing: border-box; padding: 0px 5px;">2</li><li style="box-sizing: border-box; padding: 0px 5px;">3</li><li style="box-sizing: border-box; padding: 0px 5px;">4</li><li style="box-sizing: border-box; padding: 0px 5px;">5</li><li style="box-sizing: border-box; padding: 0px 5px;">6</li><li style="box-sizing: border-box; padding: 0px 5px;">7</li><li style="box-sizing: border-box; padding: 0px 5px;">8</li></ul>

同样，记得把 ABCDEFGHIJ 替换成你的团队 ID。然后运行 pod install 来重新生成 Pods 项目。

（如果发现这个 Pod 不兼容 Swift 2.3，那么你需要为 Xcode 8 单独拉一个不同的分支， 这是由 Igor Palaguta 提供的一个解决方案）

在 Xcode 8 中打开

好了，现在就可以在 Xcode 8 中打开这个项目了。第一次打开的时候你会被大量的请求所轰炸

Xcode 会提醒你更新到最新版本的 Swift。忽略。

Xcode 还会建议更新项目的设置为 “推荐设置“，同样忽略。

记住，我们已经对项目做了设置，让它可以在两个版本下都可以编译通过。所以现在我们要做的是尽量少做改动，从而保证同时兼容。更重要的是，因为我们发布到 App Store 的文件是同一个，所以我们不希望 .xcodeproj 文件中包含任何 Xcode 8 相关的数据。

处理 Swift 2.3 的差异

就像我之前说过的，Swift 2.3 和 Swift 2.2 是相同的语言。然而，iOS 10 SDK 的 frameworks 已经更新了一些 Swift 的注释。我说的不是大改动（那只是 Swift 3.0 的事情）——但是，Swift 2.3 的一些命名，类型和 API 的可选性还是稍微有些变化。

条件编译

考虑到你可能会忽略这一点， Swift 2.2 就引入了编译预处理宏。用法很简单：

<code class="hljs cs has-numbering" style="display: block; padding: 0px; color: inherit; box-sizing: border-box; font-family: 'Source Code Pro', monospace;font-size:undefined; white-space: pre; border-radius: 0px; word-wrap: normal; background: transparent;"><span class="hljs-preprocessor" style="color: rgb(68, 68, 68); box-sizing: border-box;">#<span class="hljs-keyword" style="box-sizing: border-box;">if</span> swift(>=2.3)</span>
<span class="hljs-comment" style="color: rgb(136, 0, 0); box-sizing: border-box;">// this compiles on Xcode 8 / Swift 2.3 / iOS 10</span>
<span class="hljs-preprocessor" style="color: rgb(68, 68, 68); box-sizing: border-box;">#<span class="hljs-keyword" style="box-sizing: border-box;">else</span></span>
<span class="hljs-comment" style="color: rgb(136, 0, 0); box-sizing: border-box;">// this compiles on Xcode 7 / Swift 2.2 / iOS 9</span>
<span class="hljs-preprocessor" style="color: rgb(68, 68, 68); box-sizing: border-box;">#<span class="hljs-keyword" style="box-sizing: border-box;">endif</span></span></code><ul class="pre-numbering" style="box-sizing: border-box; position: absolute; width: 50px; top: 0px; left: 0px; margin: 0px; padding: 6px 0px 40px; border-right-width: 1px; border-right-style: solid; border-right-color: rgb(221, 221, 221); list-style: none; text-align: right; background-color: rgb(238, 238, 238);"><li style="box-sizing: border-box; padding: 0px 5px;">1</li><li style="box-sizing: border-box; padding: 0px 5px;">2</li><li style="box-sizing: border-box; padding: 0px 5px;">3</li><li style="box-sizing: border-box; padding: 0px 5px;">4</li><li style="box-sizing: border-box; padding: 0px 5px;">5</li></ul>

太棒了！一个文件，不需要分支就同时兼容了 Xcode 的两个版本

有两个需要注意的事项：

  • #if swift(<2.3) 这种写法是不存在的，只有 >=。如果要表达相反的意思，你可以写 #if !swift(>=2.3)。（如果需要的话你还可以使用 #else 和#elseif）。
  • 和 C 的预处理不同，#if 和 #else 必须是有效的 Swift 代码，例如，你不能只改变方法签名而不改变方法体。（对于这点后面会有相应的处理方案）

可选性的变化

Swift 2.3 中很多签名都把不必要的可选性都去掉了，而有些（比如很多 NSURL 的属性）也变成 了可选值。

你当然也可以用条件编译来处理这个问题，比如：

<code class="hljs cs has-numbering" style="display: block; padding: 0px; color: inherit; box-sizing: border-box; font-family: 'Source Code Pro', monospace;font-size:undefined; white-space: pre; border-radius: 0px; word-wrap: normal; background: transparent;"><span class="hljs-preprocessor" style="color: rgb(68, 68, 68); box-sizing: border-box;">#<span class="hljs-keyword" style="box-sizing: border-box;">if</span> swift(>=2.3)</span>
<span class="hljs-keyword" style="color: rgb(0, 0, 136); box-sizing: border-box;">let</span> specifier = url.resourceSpecifier ?? <span class="hljs-string" style="color: rgb(0, 136, 0); box-sizing: border-box;">""</span>
<span class="hljs-preprocessor" style="color: rgb(68, 68, 68); box-sizing: border-box;">#<span class="hljs-keyword" style="box-sizing: border-box;">else</span></span>
<span class="hljs-keyword" style="color: rgb(0, 0, 136); box-sizing: border-box;">let</span> specifier = url.resourceSpecifier
<span class="hljs-preprocessor" style="color: rgb(68, 68, 68); box-sizing: border-box;">#<span class="hljs-keyword" style="box-sizing: border-box;">endif</span></span></code><ul class="pre-numbering" style="box-sizing: border-box; position: absolute; width: 50px; top: 0px; left: 0px; margin: 0px; padding: 6px 0px 40px; border-right-width: 1px; border-right-style: solid; border-right-color: rgb(221, 221, 221); list-style: none; text-align: right; background-color: rgb(238, 238, 238);"><li style="box-sizing: border-box; padding: 0px 5px;">1</li><li style="box-sizing: border-box; padding: 0px 5px;">2</li><li style="box-sizing: border-box; padding: 0px 5px;">3</li><li style="box-sizing: border-box; padding: 0px 5px;">4</li><li style="box-sizing: border-box; padding: 0px 5px;">5</li></ul>

但是下面的方法可能会小有帮助：

<code class="hljs coffeescript has-numbering" style="display: block; padding: 0px; color: inherit; box-sizing: border-box; font-family: 'Source Code Pro', monospace;font-size:undefined; white-space: pre; border-radius: 0px; word-wrap: normal; background: transparent;">func optionalize<T><span class="hljs-function" style="box-sizing: border-box;"><span class="hljs-params" style="color: rgb(102, 0, 102); box-sizing: border-box;">(x: T?)</span> -></span> T? {
    <span class="hljs-keyword" style="color: rgb(0, 0, 136); box-sizing: border-box;">return</span> x
}</code><ul class="pre-numbering" style="box-sizing: border-box; position: absolute; width: 50px; top: 0px; left: 0px; margin: 0px; padding: 6px 0px 40px; border-right-width: 1px; border-right-style: solid; border-right-color: rgb(221, 221, 221); list-style: none; text-align: right; background-color: rgb(238, 238, 238);"><li style="box-sizing: border-box; padding: 0px 5px;">1</li><li style="box-sizing: border-box; padding: 0px 5px;">2</li><li style="box-sizing: border-box; padding: 0px 5px;">3</li></ul>

我知道这有点难理解。也许你看过结果之后就会容易得多了：

<code class="hljs cs has-numbering" style="display: block; padding: 0px; color: inherit; box-sizing: border-box; font-family: 'Source Code Pro', monospace;font-size:undefined; white-space: pre; border-radius: 0px; word-wrap: normal; background: transparent;"><span class="hljs-keyword" style="color: rgb(0, 0, 136); box-sizing: border-box;">let</span> specifier = optionalize(url.resourceSpecifier) ?? <span class="hljs-string" style="color: rgb(0, 136, 0); box-sizing: border-box;">""</span> <span class="hljs-comment" style="color: rgb(136, 0, 0); box-sizing: border-box;">// works on both versions!</span></code><ul class="pre-numbering" style="box-sizing: border-box; position: absolute; width: 50px; top: 0px; left: 0px; margin: 0px; padding: 6px 0px 40px; border-right-width: 1px; border-right-style: solid; border-right-color: rgb(221, 221, 221); list-style: none; text-align: right; background-color: rgb(238, 238, 238);"><li style="box-sizing: border-box; padding: 0px 5px;">1</li></ul>

这样就发挥了可选值的封装优势，从而避免在调用的时候写恶心的条件编译代码了。optionalize() 方法做的事情就是把任何传进去的值转换成可选值，除非传入的已经是可选值的情况，它就把参数直接返回。这样一来，不管 url.resourceSpecifier 是（Xcode 8）或者不是（Xcode 7）可选值，“optionalized“版本永远是一样的。

（更深入地说：在 Swift 里面， Foo 可以被理解为 Foo? 的子类，因为你可以在不丢失信息的情况下把任何一个 Foo 类型的值封装成可选值。编译器一旦知道这点，它就允许传入一个非可选值到一个可选值参数中－把 Foo 封装成 Foo?。）

用别名来拯救方法签名的变化

Swift 2.3 中，一些方法（特别是在 macOS 的 SDK 中）修改了参数类型。

比如，之前 NSWindow 的构造方法是这样的：

<code class="hljs http has-numbering" style="display: block; padding: 0px; color: inherit; box-sizing: border-box; font-family: 'Source Code Pro', monospace;font-size:undefined; white-space: pre; border-radius: 0px; word-wrap: normal; background: transparent;"><span class="hljs-attribute" style="box-sizing: border-box;">init(contentRect</span>: <span class="hljs-string" style="color: rgb(0, 136, 0); box-sizing: border-box;">NSRect, styleMask: Int, backing: NSBackingStoreType, defer: Bool)</span></code><ul class="pre-numbering" style="box-sizing: border-box; position: absolute; width: 50px; top: 0px; left: 0px; margin: 0px; padding: 6px 0px 40px; border-right-width: 1px; border-right-style: solid; border-right-color: rgb(221, 221, 221); list-style: none; text-align: right; background-color: rgb(238, 238, 238);"><li style="box-sizing: border-box; padding: 0px 5px;">1</li></ul>

现在变成了这样：

<code class="hljs http has-numbering" style="display: block; padding: 0px; color: inherit; box-sizing: border-box; font-family: 'Source Code Pro', monospace;font-size:undefined; white-space: pre; border-radius: 0px; word-wrap: normal; background: transparent;"><span class="hljs-attribute" style="box-sizing: border-box;">init(contentRect</span>: <span class="hljs-string" style="color: rgb(0, 136, 0); box-sizing: border-box;">NSRect, styleMask: NSWindowStyleMask, backing: NSBackingStoreType, defer: Bool)</span></code><ul class="pre-numbering" style="box-sizing: border-box; position: absolute; width: 50px; top: 0px; left: 0px; margin: 0px; padding: 6px 0px 40px; border-right-width: 1px; border-right-style: solid; border-right-color: rgb(221, 221, 221); list-style: none; text-align: right; background-color: rgb(238, 238, 238);"><li style="box-sizing: border-box; padding: 0px 5px;">1</li></ul>

注意看 styleMask 的类型。之前它是一个 Int 松散类型（以全局常量方式输入的选项），但是在 Xcode 8 中，它以更合理的 OptionSetType 类型输入。

不幸的是你不能条件编译方法体相同，而方法签名不同的两个版本。别担心，你可以通过条件编译给类型起别名的方式来解决这个问题！

<code class="hljs cs has-numbering" style="display: block; padding: 0px; color: inherit; box-sizing: border-box; font-family: 'Source Code Pro', monospace;font-size:undefined; white-space: pre; border-radius: 0px; word-wrap: normal; background: transparent;"><span class="hljs-preprocessor" style="color: rgb(68, 68, 68); box-sizing: border-box;">#<span class="hljs-keyword" style="box-sizing: border-box;">if</span> !swift(>=2.3)</span>
typealias NSWindowStyleMask = Int
<span class="hljs-preprocessor" style="color: rgb(68, 68, 68); box-sizing: border-box;">#<span class="hljs-keyword" style="box-sizing: border-box;">endif</span></span></code><ul class="pre-numbering" style="box-sizing: border-box; position: absolute; width: 50px; top: 0px; left: 0px; margin: 0px; padding: 6px 0px 40px; border-right-width: 1px; border-right-style: solid; border-right-color: rgb(221, 221, 221); list-style: none; text-align: right; background-color: rgb(238, 238, 238);"><li style="box-sizing: border-box; padding: 0px 5px;">1</li><li style="box-sizing: border-box; padding: 0px 5px;">2</li><li style="box-sizing: border-box; padding: 0px 5px;">3</li></ul>

这样你就可以像 Swift 2.3 一样在方法签名中使用 NSWindowStyleMask 了。对于 Swift 2.2 而言，这个类型并不存在，NSWindowStyleMask 只是 Int 的一个别名，类型检查器仍然可以完美工作。

非正式 vs 正式协议

Swift 2.3 把一些之前的非正式协议 改成了正式协议。

比如，要实现一个 CALayer 代理，你只需要继承 NSObject 就可以了，不需要声明它符合 CALayerDelegate 协议。事实上，这个协议在 Xcode 7 中根本就不存在，只是现在有了。

同样，直接对类声明那行代码做条件编译是不可行的。但是你可以通过在 Swift 2.2 中声明虚协议的方式来解决这个问题，就像下面这样：

<code class="hljs vala has-numbering" style="display: block; padding: 0px; color: inherit; box-sizing: border-box; font-family: 'Source Code Pro', monospace;font-size:undefined; white-space: pre; border-radius: 0px; word-wrap: normal; background: transparent;"><span class="hljs-preprocessor" style="color: rgb(68, 68, 68); box-sizing: border-box;">#if !swift(>=2.3)</span>
<span class="hljs-keyword" style="color: rgb(0, 0, 136); box-sizing: border-box;">private</span> protocol CALayerDelegate {}
<span class="hljs-preprocessor" style="color: rgb(68, 68, 68); box-sizing: border-box;">#endif</span>

<span class="hljs-class" style="box-sizing: border-box;"><span class="hljs-keyword" style="color: rgb(0, 0, 136); box-sizing: border-box;">class</span> <span class="hljs-title" style="box-sizing: border-box; color: rgb(102, 0, 102);">MyView</span>: <span class="hljs-title" style="box-sizing: border-box; color: rgb(102, 0, 102);">NSView</span>, <span class="hljs-title" style="box-sizing: border-box; color: rgb(102, 0, 102);">CALayerDelegate</span> {</span> . . . }
</code><ul class="pre-numbering" style="box-sizing: border-box; position: absolute; width: 50px; top: 0px; left: 0px; margin: 0px; padding: 6px 0px 40px; border-right-width: 1px; border-right-style: solid; border-right-color: rgb(221, 221, 221); list-style: none; text-align: right; background-color: rgb(238, 238, 238);"><li style="box-sizing: border-box; padding: 0px 5px;">1</li><li style="box-sizing: border-box; padding: 0px 5px;">2</li><li style="box-sizing: border-box; padding: 0px 5px;">3</li><li style="box-sizing: border-box; padding: 0px 5px;">4</li><li style="box-sizing: border-box; padding: 0px 5px;">5</li><li style="box-sizing: border-box; padding: 0px 5px;">6</li></ul>

（Joe Groff 提到过可以给 CALayerDelegate 起一个 Any 的别名——同样的结果，但是没什么开销。）

构建 iOS 10 的特性

至此，你的项目可以同时在 Xcode 7 和 Xcode 8 上进行编译，不需要建立任何分支，这简直太棒了！

现在就是构建 iOS 10 特性的时候了，因为已经有了上面所说的各种提示和小技巧，所以这件事情会变得非常简单。但是，还是有一些需要注意的事情：

  1. 只用 @available(iOS 10, *) 和 #available(iOS 10, *) 是不够的。首先，不要在发布的应用中编译任何 iOS 10 的代码，因为这样更安全。更重要的是，因为编译器需要检查这些代码，从而保证 API 的使用是安全的，这样就需要注意被调用的 API 是存在的。如果你使用了 iOS 9 的 SDK 中不存在的方法或者类型，那么你的代码就无法在 Xcode 7 中通过编译。
  2. 你需要把所有 iOS 10 专用的代码封装在 #if swift(>=2.3) 中（目前你可以认为 Swift 2.3 和 iOS 10 是相等的）。
  3. 大部分时候，你会同时需要条件编译（这样你就不会在 Xcode 7 中编译那些不可用的代码） 和 @available/#available （用来通过 Xcode 8 的安全检查）。
  4. 如果需要处理 iOS 10 独有的特性，最简单的方式就是把相关代码抽离到单独的文件中——这样一来你就可以把整个文件的内容都包含在一个#if swift… 判断中。（在 Xcode 7 中这个文件还是可能会被编译器处理到，但是里面的内容都会被忽略。）

应用扩展

但问题是，你可能想要在 iOS 10 上为你的应用添加一些新的扩展，而不是仅仅给应用本身添加更多的代码。

这就很棘手了。我们可以条件编译我们的代码，但是没有“条件目标“这种东西。

好消息是因为 Xcode 7 并不需要真正编译这些目标，所以它并不会向你抱怨什么。（当然，它会发出警告，告诉你项目中有一个目标，它会发布到一个比 base SDK 版本更高的 iOS 版本上，但是这不是什么大问题。）

所以方法就是：在每个地方都保留构建目标和它的代码，但是有选择地从应用构建目标的 “Target Dependencies“和“Embed App Extensions“ 选项中移除它们。

怎么做呢？我找到的最好方式就是把构建设置中的应用扩展设置成不可用，从而默认兼容 Xcode 7。然后只有在使用 Xcode 8的时候，才临时添加这些扩展，并且从来不提交这些变动。

如果每次都手动做，听起来太反复无常了（更别说与 CI 和自动化构建的不兼容），别担心，我帮你写了一个脚本！

安装：

<code class="hljs bash has-numbering" style="display: block; padding: 0px; color: inherit; box-sizing: border-box; font-family: 'Source Code Pro', monospace;font-size:undefined; white-space: pre; border-radius: 0px; word-wrap: normal; background: transparent;"><span class="hljs-built_in" style="color: rgb(102, 0, 102); box-sizing: border-box;">sudo</span> gem install configure_extensions</code><ul class="pre-numbering" style="box-sizing: border-box; position: absolute; width: 50px; top: 0px; left: 0px; margin: 0px; padding: 6px 0px 40px; border-right-width: 1px; border-right-style: solid; border-right-color: rgb(221, 221, 221); list-style: none; text-align: right; background-color: rgb(238, 238, 238);"><li style="box-sizing: border-box; padding: 0px 5px;">1</li></ul>

在提交 Xcode 项目的任何变化之前，从应用的构建目标中移除 iOS 10 专用的应用扩展：

<code class="hljs cmake has-numbering" style="display: block; padding: 0px; color: inherit; box-sizing: border-box; font-family: 'Source Code Pro', monospace;font-size:undefined; white-space: pre; border-radius: 0px; word-wrap: normal; background: transparent;">configure_extensions <span class="hljs-keyword" style="color: rgb(0, 0, 136); box-sizing: border-box;">remove</span> MyApp.xcodeproj MyAppTarget NotificationsUI Intents</code><ul class="pre-numbering" style="box-sizing: border-box; position: absolute; width: 50px; top: 0px; left: 0px; margin: 0px; padding: 6px 0px 40px; border-right-width: 1px; border-right-style: solid; border-right-color: rgb(221, 221, 221); list-style: none; text-align: right; background-color: rgb(238, 238, 238);"><li style="box-sizing: border-box; padding: 0px 5px;">1</li></ul>

然后在 Xcode 8 中使用时，把它们添加回来：

<code class="hljs avrasm has-numbering" style="display: block; padding: 0px; color: inherit; box-sizing: border-box; font-family: 'Source Code Pro', monospace;font-size:undefined; white-space: pre; border-radius: 0px; word-wrap: normal; background: transparent;">configure_extensions <span class="hljs-keyword" style="color: rgb(0, 0, 136); box-sizing: border-box;">add</span> MyApp<span class="hljs-preprocessor" style="color: rgb(68, 68, 68); box-sizing: border-box;">.xcodeproj</span> MyAppTarget NotificationsUI Intents</code><ul class="pre-numbering" style="box-sizing: border-box; position: absolute; width: 50px; top: 0px; left: 0px; margin: 0px; padding: 6px 0px 40px; border-right-width: 1px; border-right-style: solid; border-right-color: rgb(221, 221, 221); list-style: none; text-align: right; background-color: rgb(238, 238, 238);"><li style="box-sizing: border-box; padding: 0px 5px;">1</li></ul>

你可以把这个放到你的 script/ 文件夹中，然后可以把它加到 Xcode 构建的预处理中，也可以加到 Git 的预提交 hook 上，或者集成到 CI 和自动化构建系统中。（更多信息请参照 GitHub）

关于 iOS 10 应用扩展需要注意的最后一点：Xcode 给这些扩展建立的模板是基于 Swift 3 的，而不是 Swift 2.3 的代码。所以一定要注意把应用扩展的 “Use Legacy Swift Language Version“ 构建选项设置为 “Yes“，然后把代码用 Swift 2.3 重写。

到了9月

到了 9 月份，iOS 10 就出来了，这个时候我们需要去掉对 Xcode 7 的支持并清理项目！

我给你准备了一个确认清单（记得加入书签，以便后面再来参考）：

  • 移除所有 Swift 2.2 的代码和不必要的 #if swift(>=2.3) 检查
  • 移除所有过渡处理，比如对 optionalize() 的使用，临时定义的别名，或者虚的协议
  • 移除 configure_extensions 脚本，然后把增加了新应用扩展支持的项目设置提交到代码库
  • 如果你使用了 CocoaPods，把它更新，然后移除之前我们添加到 Podfile 中 post_install hook（9月份以后基本就用不上了）
  • 更新为 Xcode 推荐的项目设置（在侧边栏中选中项目，然后在菜单中选择：Editor → Validate Settings…）
  • 考虑把 provisioning 设置升级，使用新的 PROVISIONING_PROFILE_SPECIFIER
  • 把所有的 .xib 和 .storyboard 的设置回滚为 “Opens in: Latest Xcode (8.0)“
  • 确保所有依赖的 Swift 库都更新到了 Swift 3。如果没有，考虑自己给 Swift 3 这个窗口做点贡献
  • 上面的步骤都搞定之后，就可以把应用更新到 Swift 3 了！找到 Edit → Convert → To Current Swift Syntax…，选择所有的构建目标（记住，你需要一次全部转换好），review 一下 diff，测试，然后提交！
  • 如果你还没有这样做，考虑移除对 iOS 8 的支持——这样一来你就可以去掉更多的 @available 检查和其他的条件语句。

祝好运！

u014068781
关注
  • 0
    点赞
  • 踩
  • 1
    收藏
    觉得还不错? 一键收藏
  • 1
    评论
专栏目录
低版本xcode兼容iOS15.zip
07-14
将解压缩后的文件放到以下文件夹（适当修改文件名）: 在访达中使用快捷键：低版本xcode兼容iOS15.0.zip、iOS9.0。镜像
ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES Inherited creates project validation issue
C
05-11 3895
进入构建设置 在顶部选择all和combined 在Build Options下，您应该看到Always Embed Swift Standard Libraries，它是粗体的。 单击它，然后单击删除。现在应该不是加粗了。 pod install 的警告应该消失。
iOS适配Unity-2019
一品大帅的专栏
11-26 2205
Xcode工程适配Unity 2019+
swift制作framework静态库
feelinghappy的专栏
10-31 837
新建项目选择Framework，命名MyViewSDK，语言是Swift。
target overrides the `ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES` build setting defined in `Pods/Target S
jia12216的专栏
06-11 4075
解决方案：Targets->Build Settings->Combined(All)搜索ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES,选中 选项，按下电脑的delete键，立即恢复为正常模式。
Xcode Build Settings 分析
bobo553443的博客
11-20 4563
Architectures picture1 Additional SDKs在编译的时候需要附加的SDK。Architectures支持的处理器架构。支持的指令集越多，就会编译出包含多个指令集代码的数据包，对应生成二进制包就越大，最终目标文件也会变大。 指令集可以参考：http://www.jianshu.com/p/3fce0bd6f045Base SDKApp所能支持的最大iOS版本。Xco
xcode支持iOS15.2和iOS15.4
02-16
xcode支持iOS15.2和iOS15.4
ios开发 Xcode免更新兼容ios11.4包
06-25
使用于老旧mac,虚拟机Mac已经黑苹果，再不能更新mac版本无法升级Xcode时，使用该兼容包。可使低版本Xcode对ios11.4的真机进行真机测试
ios开发 Xcode免更新兼容ios12.0包
10-12
Xcode开发，ios12.0(16A366)版本兼容包。适用于老旧mac,虚拟机Mac以及黑苹果，在不能更新mac版本无法升级Xcode时，使用该兼容包。可使低版本Xcode对ios11.4的真机进行真机测试
兼容iOS 10 升级xcode8出现的问题及一些适配问题的解决方案
01-05
xcode 升级到8之后很多人的推送接收不到了.获取不到token了 一朋友搞了一小时没找到原因. 只因看下图吧….我发觉xcode 我不打开他也能收到通知. 但是到了8(必须打开了才能收到推送) . 貌似不行了 大家对号入座吧. ...
The `XXXUITests [Debug]` target overrides the `ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES` build......
u013410274的专栏
06-05 2283
出现的警告： [!] The `ColorInHeartUITests [Debug]` target overrides the `ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES` build setting defined in `Pods/Target Support Files/Pods-ColorInHeart-ColorInHeartUITests/Pods-ColorInHeart-ColorInHeartUITests.debug.xcconfig'. Thi
[Xcode]Provisioning Profile配置文件的来龙去脉
超越
03-29 8358
在xcode打包时会用到provisioningProfile的设置。如图： 如图，parentsClient_dis从哪来呢？ 在这个界面生产添加得来的，它由配置参数APP ID和证书生产而来。如图： 点击下载到本地文件是parentsClient_dis.mobileprovision。双击次文件，则添加到 复制到这个目录“/Users/apple/Library/
如何设置Xcode 自动管理你的provisioning profiles
不怕梦想跌倒，就怕没有梦想
01-05 1万+
本文翻译原文源自苹果文档，并不是逐字逐句的翻译，^_^，理解是目的，翻译是过程而已。 许多管理过以前app的开发者们会在build setttings中指定对应的provisioning profile,本文呢主要讨论如何让Xcode帮你管理他们，以下说的同时适用于ios和os x 工程。 在开始之前，确保你已经再project->General 窗口选择你的team（如下图）： 一
同时兼容 Xcode7 和 Xcode8
weixin_34130389的博客
09-02 117
作者：radex.io，原文链接，原文日期：2016-07-28译者：ckitakishi；校对：Channe；定稿：CMB 作为一名 iOS 开发者，你一定对 iOS 10 带来的新特性感到无比兴奋，并迫不及待地想要在应用中实践。虽然你想马上就动手以便第一时间就能“上车”。但 iOS 10 正式上线却是几个月以后的事情，在那之前，你不得...
iOS内嵌WKWebView拨打电话、发短信、发邮件没反应
wm9028的专栏
01-25 6123
iOS内嵌WKWebView拨打电话没反应 a href="tel:13112345678">拨打号码a> 内嵌H5的发送短信，打电话，发送邮件代码的处理 实现webview的代理方法 swift3.0 代码： // 处理拨打电话、发短信、发邮件以及Url跳转等等 func webView(_ webView: WKWebView, decidePolicyFor
Xcode8 找不到Embedded Content Contains Swift Code
IOS_ZhuJianan的博客
02-05 4276
在build setting里边 搜索ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES 设置yes或者no 我在使用百度鹰眼sdk时 模拟器运行是没有问题的，但是真机运行时出现这样错误。
解决低版本Xcode不支持高版本iOS真机调试的问题
热门推荐
xiangzhihong8的专栏
10-26 2万+
今天在做真机调试的时候，遇到下面的一个问题： Could not locate device support files. This iPhone 6s is running iOS 11.1 (15B93), which may not be supported by this version of Xcode. 上面的意思是，在调试前我将我手机的iOS系统 升级到了最新版11.1版本，而我的
swift pods遇到问题[!] The `X` target overrides the `ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES` build setting...
weixin_30241919的博客
09-19 717
Build Settings ->ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES -> 选择'Other', 输入"$(inherited)" 转载于:https://www.cnblogs.com/xbios/p/7551721.html
mac+appium+ios+xcode10.13
最新发布
07-15
Mac上的Appium是一款支持iOS平台的自动化测试工具，开发者通常会在Xcode 10.13环境下使用它。Appium通过使用WebDriver协议和底层的UIAutomation库来执行iOS应用程序的自动化测试。 Appium有一系列优点。首先，它...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值