身為 iOS 開發者,你一定對 iOS 10 的新特性躍躍欲試,恨不得馬上動手實作。無奈 iOS 10 正式上線還要好幾個月,在那之前你仍得維持每幾週發一個新版的節奏。而目前你無法用 Xcode 8 編譯要送審的 App,因為它過不了 App Store 驗證。於是很多人被迫把專案拆成穩定分支與 iOS 10 開發分支——然後噩梦開始了。
暫時在分支上試點功能還無傷大雅,但隨著整個程式碼庫演進、主分支持續推進,要維護一個龐大分支好幾個月,你就會飽受合併之痛。你試過處理 .xcodeproj 的合併衝突嗎?
這篇文章的目標,就是教你徹底告別分支。對大多數 App 而言,用單一工程同時支援 iOS 9(Xcode 7)與 iOS 10(Xcode 8)是完全可行的;即便你不得不開分支,这些小技巧也能減少兩邊差異,讓同步更輕鬆。
先說結論:我們都為 Swift 3 到來而振奮,但如果你正在讀這篇,請先別用它(或暫時別)。Swift 3 在程式碼層面的不相容比一年前的 Swift 2 還嚴重,且一旦依賴第三方 Swift 庫,就得等它們都升級到 Swift 3 才能跟進。
好消息是,史無前例地,Xcode 8 同時支援兩個 Swift 版本:2.3 與 3.0。而且除了少數 API 微調,Xcode 7 的 Swift 2.2 與 Swift 2.3 幾乎一致。因此為了相容,我們就用 Swift 2.3 開發。

先在 Xcode 7 中打開專案,於 Build Settings 點「+」新增一項 User-Defined 設定:
SWIFT_VERSION = "2.3"
這是 Xcode 8 才認得的設定,因此 Xcode 7 會完全忽略它,繼續用 Swift 2.2 構建。
Xcode 8 對 Framework provisioning 的處理略有不同:模擬器照常編譯,但真機會構建失敗。解法是仿照 SWIFT_VERSION 的做法,遍歷所有 Framework target,加入:
PROVISIONING_PROFILE_SPECIFIER = "ABCDEFGHIJ/"
把 ABCDEFGHIJ 換成你的團隊 ID(可在 Apple Developer Portal 找到),並保留最後的斜線。這等於告訴 Xcode 8「我來自這個團隊,請注意 codesign」,而 Xcode 7 依舊忽略,兩邊都安好。
逐一檢視所有 .xib 與 .storyboard,開啟右側 File inspector,找到「Opens in」,很可能顯示「Default (7.0)」,把它改成「Xcode 7.0」,就能保證即使在 Xcode 8 中編輯,也只做向後相容的變更。
特別提醒:Xcode 8 修改 XIB 時會加入版本相關資料,偶爾還會把檔案回滾成只支援 Xcode 8 的格式(這是 bug)。能避免就別在 Xcode 8 裡動 interface 檔;若不得已,務必仔細 review diff,只提交必要的那幾行。
確認所有 target 的 Base SDK 都設為「Latest iOS」。這樣 Xcode 7 會針對 iOS 9 編譯,而你仍能在 Xcode 8 中打開同一專案並使用 iOS 10 新特性。
若使用 CocoaPods,也需更新 Pods 的 Swift 與 provisioning 設定。可在 Podfile 加入 post-install 鉤子代替手動設定:
post_install do |installer|
installer.pods_project.build_configurations.each do |config|
config.build_settings['SWIFT_VERSION'] = '2.3'
config.build_settings['PROVISIONING_PROFILE_SPECIFIER'] = 'ABCDEFGHIJ/'
config.build_settings['ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES'] = 'NO'
end
end
記得把 ABCDEFGHIJ 換成你的團隊 ID,再跑 pod install 重新產生 Pods。若某個 Pod 不相容 Swift 2.3,就得為 Xcode 8 單獨拉分支(這是由 Igor Palaguta 提供的方案)。
現在用 Xcode 8 打開專案,第一次會被大量提示轟炸:升級 Swift?忽略。更新為「推薦設定」?同樣忽略。我們已經把專案調成兩版都能編譯,現在要做的是盡量少改,並確保 .xcodeproj 不摻入任何 Xcode 8 相關資料。
Swift 2.3 與 2.2 是相同的語言,但 iOS 10 SDK 的 frameworks 更新了一些 Swift 註解。這不是大規模改名(那只發生在 Swift 3.0),但許多 API 的名稱、型別與可選性略有變化。
Swift 2.2 就引入了編譯預處理巨集,用法簡單:
#if swift(>=2.3)
// Xcode 8 / Swift 2.3 / iOS 10
#else
// Xcode 7 / Swift 2.2 / iOS 9
#endif
一個檔案、零分支,同時相容兩版 Xcode。有兩點要注意:只有 >= 沒有 <(要表達相反可用 #if !swift(>=2.3));且 #if 與 #else 之間必須是合法 Swift 程式碼,不能只改函式簽章而不改函式體。
Swift 2.3 拿掉了許多不必要的可選性,也有些(如不少 NSURL 屬性)變成了可選值。除了條件編譯,還有個小幫手:
func optionalize<T>(x: T?) -> T? { return x }
看個例子就懂了:
let specifier = optionalize(url.resourceSpecifier) ?? "" // 兩版通用!
optionalize() 會把傳入值轉為可選值,若本來就是可選值則原樣返回。這樣無論 url.resourceSpecifier 在 Xcode 8 是否為可選,optionalized 版本都一致,免去到處寫條件編譯。原理是 Swift 中 Foo 可視為 Foo? 的子類,編譯器允許傳入非可選值。
Swift 2.3 中一些方法(尤其 macOS SDK)改了參數型別。例如 NSWindow 的建構子:
// 舊 init(contentRect: NSRect, styleMask: Int, backing: NSBackingStoreType, defer: Bool) // 新 init(contentRect: NSRect, styleMask: NSWindowStyleMask, backing: NSBackingStoreType, defer: Bool)
styleMask 從松散的 Int 變成更合理的 OptionSetType。由於無法對「函式體相同、簽章不同」的兩版做條件編譯,可用別名解決:
#if !swift(>=2.3) typealias NSWindowStyleMask = Int #endif
這樣你就能像 Swift 2.3 一樣在簽章中使用 NSWindowStyleMask;對 Swift 2.2 而言它只是 Int 的別名,型別檢查照常運作。
Swift 2.3 把一些非正式協議改成正式協議。例如實作 CALayer 代理,以前只需繼承 NSObject,現在有了 CALayerDelegate 協議。直接對類別宣告那行做條件編譯不可行,但可在 Swift 2.2 中宣告虛協議:
#if !swift(>=2.3)
private protocol CALayerDelegate {}
#endif
class MyView: NSView, CALayerDelegate { ... }
(Joe Groff 指出,也可把 CALayerDelegate 別名為 Any,效果相同且開銷更低。)
至此專案已能在 Xcode 7 與 8 雙向編譯,不需任何分支。但要留意:只用 @available(iOS 10, *) 和 if #available 並不足夠。首先別在送審版本裡編譯任何 iOS 10 程式碼;更重要的是編譯器需檢查這些 API 是否存在,若用了 iOS 9 SDK 沒有的方法,Xcode 7 就會編譯失敗。因此要把 iOS 10 專屬程式碼包在 #if swift(>=2.3) 中(目前可視 Swift 2.3 等同 iOS 10)。多數時候你會同時需要條件編譯與 @available/#available。最簡單的做法是把 iOS 10 專屬邏輯抽到獨立檔案,整份用 #if swift... 包住。
你可能想為 iOS 10 加入新的 App 擴充,而不只是往主 App 塞程式碼。這就棘手了:我們能條件編譯程式碼,卻沒有「條件 target」這種東西。
好消息是,只要 Xcode 7 不必實際編譯這些 target,它就不會抱怨(頂多警告部署版本高於 Base SDK,無傷大雅)。做法是:保留所有 target 與程式碼,但有選擇地從主 App 的 Build Phases 中,把 Target Dependencies 與 Embed App Extensions 裡的 iOS 10 擴充移除。最佳实践是預設在設定中停用擴充以相容 Xcode 7,僅在 Xcode 8 使用時暫時加回,且永不提交這些變更。
手動做太繁瑣,於是有個腳本可用:
sudo gem install configure_extensions # 提交前移除 iOS 10 專用擴充 configure_extensions remove MyApp.xcodeproj MyAppTarget NotificationsUI Intents # 在 Xcode 8 使用時加回 configure_extensions add MyApp.xcodeproj MyAppTarget NotificationsUI Intents
你可以把它放進 script/ 資料夾,掛到 Xcode 預處理、Git pre-commit hook,或整合進 CI。最後提醒:Xcode 為擴充產生的範本是基於 Swift 3,記得把擴充的「Use Legacy Swift Language Version」設為 Yes,並用 Swift 2.3 重寫。
9 月 iOS 10 問世後,就该移除對 Xcode 7 的支援並清理專案。這份確認清單請收好:
祝順利!