[翻譯練習] Swift Package Manager 重寫 macOS 部署目標

譯自：oleb.net/blog/2017/0…

---

Swift 3.1 修復了 Swift Package Manager 沒法重寫 MacOS 部署目標的 Bug。

當你在 macOS 上執行 swift build 命令時，包管理器目前（Swift 3.0 和 3.1）會將部署目標硬編碼爲 macOS 10.10。¹ 在 Swift 3.0 中沒法重寫部署目標，被證實是因爲命令參數的一個 Bug 引發的。

所以，你不能輕鬆編譯用到了最新 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, *) { ... } 或相似的代碼塊進行包裹。

---

若有任何知識產權、版權問題或理論錯誤，還請指正。 https://juejin.im/post/5a3217eb51882534af25f88c 轉載請註明原做者及以上信息。