Swift Package Manager 重写 macOS 部署目标

原文连接=oleb.net/blog/2017/0…
做者=Ole Begemann
原文日期=2017-04-07
译者=EyreFree
校对=liberalism,Firecrest
定稿=CMB

注：小编友情提醒：由于这篇文章翻译得比较早，因此有些内容不是最新的，不过度析问题的思路和一些底层原理的知识仍是值得学习的～

Swift 3.1 修复了 Swift Package Manager 没法重写 MacOS 部署目标的 Bug。

当你在 macOS 上执行 swift build 命令时，包管理器目前（Swift 3.0 和 3.1）会将部署目标硬编码为 macOS 10.10 ¹ 现已证实是命令参数的一个 Bug 引发的 Swift 3.0 中没法重写部署目标这个问题。

所以，你不能轻松编译用到了最新 API 的代码 ² 举个栗子，假设有一个很是简单的包，只包含几行代码在一个源文件中。这个程序用到了 macOS 10.12 引入的新的 单位和测量类型 来将一个值从以 km/h 转换为 m/s ：

// main.swift
import Foundation

let kph = Measurement(value: 100,
    unit: UnitSpeed.kilometersPerHour)
let mps = kph.converted(to: .metersPerSecond)
print("\(kph) is \(mps)")
复制代码

在 macOS（Swift 3.0 或 3.1）上用 swift build 命令编译上面这段代码会报错，由于这段代码用到的 API 在 macOS 10.10 上不可用：

$ swift build
Compile Swift Module 'Units' (1 sources)
main.swift:3:11: error: 'Measurement' is only available on OS X 10.12 or newer
let kph = Measurement(value: 100,
          ^
main.swift:3:11: note: add 'if #available' version check
let kph = Measurement(value: 100,
          ^
...
<unknown>:0: error: build had 1 command failures
error: exit(1): /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/swift-build-tool -f .build/debug.yaml
复制代码

在 Swift 3.1 中，你能够在命令行中修改部署目标，以下所示：

$ swift build -Xswiftc "-target" \
    -Xswiftc "x86_64-apple-macosx10.12"
Compile Swift Module 'Units' (1 sources)
Linking ./.build/debug/Units
复制代码

如今，你能够正常执行以前的这段代码了：

$ .build/debug/Units
100.0 km/h is 27.7778 m/s
复制代码

结论

除了部署目标，另外一个常见的自定义编译设置例子是传递一个 DEBUG 标志给编译器，因此能够在你的代码中使用 #if DEBUG/#endif 代码段做为标志传递给编译器，从而来判断是否处于 Debug 模式 - 当前包管理器并无在 Debug 构建模式下自动完成这些工做。你能够经过 swift build -Xswiftc "-D" -Xswiftc "DEBUG" 命令实现这一目的。

这仍然不够理想 - 你在每次执行 swift build 或 swift test 命令时都须要手动输入命令行参数 - 但至少这是可行的。

对于包管理器来讲可以在包配置清单中指定自定义编译设置是 Swift 4 路线图的一部分。我猜咱们很快就会看到一个和这一特性有关的 Swift 发展提案。

---

1. 你能够经过添加以下代码段到你的 main.swift 文件而后编译并执行对应包的方式来验证这一点：

#if os(macOS)
     print("macOS deployment target:", __MAC_OS_X_VERSION_MIN_REQUIRED)
#endif
复制代码

若是在 macOS 执行，将会打印：

macOS deployment target: 101000
复制代码

2. 你必须把全部依赖新 API 的代码用 if #available(macOS 10.12, iOS 10.0, tvOS 10.0, watchOS 3.0, *) { ... } 或相似的 block 进行包裹。