您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

單一工程同時相容 Xcode 7 與 Xcode 8:Swift 2.3 適配實戰指南

編輯:iOS 開發綜合

身為 iOS 開發者,你一定對 iOS 10 的新特性躍躍欲試,恨不得馬上動手實作。無奈 iOS 10 正式上線還要好幾個月,在那之前你仍得維持每幾週發一個新版的節奏。而目前你無法用 Xcode 8 編譯要送審的 App,因為它過不了 App Store 驗證。於是很多人被迫把專案拆成穩定分支與 iOS 10 開發分支——然後噩梦開始了。

暫時在分支上試點功能還無傷大雅,但隨著整個程式碼庫演進、主分支持續推進,要維護一個龐大分支好幾個月,你就會飽受合併之痛。你試過處理 .xcodeproj 的合併衝突嗎?

這篇文章的目標,就是教你徹底告別分支。對大多數 App 而言,用單一工程同時支援 iOS 9(Xcode 7)與 iOS 10(Xcode 8)是完全可行的;即便你不得不開分支,这些小技巧也能減少兩邊差異,讓同步更輕鬆。

請使用 Swift 2.3

先說結論:我們都為 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 專案設定

Swift 版本

先在 Xcode 7 中打開專案,於 Build Settings 點「+」新增一項 User-Defined 設定:

SWIFT_VERSION = "2.3"

這是 Xcode 8 才認得的設定,因此 Xcode 7 會完全忽略它,繼續用 Swift 2.2 構建。

Framework provisioning

Xcode 8 對 Framework provisioning 的處理略有不同:模擬器照常編譯,但真機會構建失敗。解法是仿照 SWIFT_VERSION 的做法,遍歷所有 Framework target,加入:

PROVISIONING_PROFILE_SPECIFIER = "ABCDEFGHIJ/"

把 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 8 修改 XIB 時會加入版本相關資料,偶爾還會把檔案回滾成只支援 Xcode 8 的格式(這是 bug)。能避免就別在 Xcode 8 裡動 interface 檔;若不得已,務必仔細 review diff,只提交必要的那幾行。

SDK 版本

確認所有 target 的 Base SDK 都設為「Latest iOS」。這樣 Xcode 7 會針對 iOS 9 編譯,而你仍能在 Xcode 8 中打開同一專案並使用 iOS 10 新特性。

CocoaPods 設定

若使用 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 中打開

現在用 Xcode 8 打開專案,第一次會被大量提示轟炸:升級 Swift?忽略。更新為「推薦設定」?同樣忽略。我們已經把專案調成兩版都能編譯,現在要做的是盡量少改,並確保 .xcodeproj 不摻入任何 Xcode 8 相關資料。

處理 Swift 2.3 的差異

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 的別名,型別檢查照常運作。

非正式 vs 正式協議

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,效果相同且開銷更低。)

構建 iOS 10 特性

至此專案已能在 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 月:告別 Xcode 7

9 月 iOS 10 問世後,就该移除對 Xcode 7 的支援並清理專案。這份確認清單請收好:

  • 移除所有 Swift 2.2 程式碼與不必要的 #if swift(>=2.3) 檢查。
  • 移除過渡處理,如 optionalize()、臨時別名與虛協議。
  • 移除 configure_extensions 腳本,並提交啟用新擴充的設定。
  • 更新 CocoaPods 並移除 post_install 鉤子。
  • 更新為 Xcode 推薦設定(Editor → Validate Settings)。
  • 考慮改用新的 PROVISIONING_PROFILE_SPECIFIER。
  • 把 .xib/.storyboard 回滾為預設的「Opens in: Latest Xcode (8.0)」。
  • 確保依賴的 Swift 庫都升級到 Swift 3。
  • 用 Edit → Convert → To Current Swift Syntax 一次轉換所有 target,review diff、測試、提交。
  • 若尚未完成,可考慮放棄 iOS 8 支援,減少更多 @available 與條件判斷。

祝順利!

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved