要同時支援 iOS 6.1 與 iOS 7.0 時,光靠執行期的版本判斷是不夠的——有些 API 在低版本 SDK 中根本不存在,編譯階段就會直接報錯。本文說明這個差異與解法。
以下示範用的是 Xcode 5.0,其中同時有 6.1 與 7.0 兩個版本的 SDK(6.1 的 SDK 預設沒有,需自行匯入)。
新建工程,預設的 deployment target、base SDK 與模擬器版本都是 7.0,在 AppDelegate 的 didFinishLaunchingWithOptions: 中寫下:
self.window.tintColor = [UIColor redColor];
執行完全正常,沒有任何錯誤。
接著把 deployment target、base SDK 與模擬器版本都改成 6.1,再執行,就會出現編譯錯誤——因為 tintColor 這個屬性在 iOS 6.1 中並不存在。
直覺上會想用版本判斷保護起來:
if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 7.0) {
self.window.tintColor = [UIColor redColor];
}
但這樣依然會報錯。原因很簡單:編譯 → 編譯 → 執行,是這樣的順序。編譯器在編譯階段讀取的是 SDK 標頭檔,它根本不認識 tintColor 這個選擇器,程式根本還沒跑到 if 判斷就被擋下了。
#ifdef __IPHONE_7_0
if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 7.0) {
self.window.tintColor = [UIColor redColor];
}
#endif
記得導入對應的標頭:
#import <Availability.h>
(在部分環境下需寫成 <usr/include/Availability.h>。)這樣編譯就能通過。
每個 SDK 的 usr/include 目錄下都有 Availability.h,裡面定義了一大批版本宏。在 SDK 6.1 中,與 iPhone 相關的部分是:
#define __IPHONE_2_0 20000 #define __IPHONE_2_1 20100 #define __IPHONE_2_2 20200 #define __IPHONE_3_0 30000 #define __IPHONE_3_1 30100 #define __IPHONE_3_2 30200 #define __IPHONE_4_0 40000 #define __IPHONE_4_1 40100 #define __IPHONE_4_2 40200 #define __IPHONE_4_3 40300 #define __IPHONE_5_0 50000 #define __IPHONE_5_1 50100 #define __IPHONE_6_0 60000 #define __IPHONE_6_1 60100 #define __IPHONE_NA 99999 /* not available */
而在 SDK 7.0 中,就多出了 #define __IPHONE_7_0 70000 這一行(原文範例寫成 60100 應是筆誤,實際值為 70000)。iOS 8 也是同樣道理,對應 __IPHONE_8_0。
所以 #ifdef __IPHONE_7_0 的意義是:「只有在用 iOS 7.0 或更新的 SDK 編譯時,才把這段程式碼放進來」。用 6.1 的 SDK 編譯時,這段程式碼在預處理階段就被整段剔除,編譯器根本不會看到 tintColor。
編譯 framework 或 .a 時,可用的 API 取決於「當時的編譯環境」。若用 iOS 6 的 SDK 能順利編出 framework,但最終組裝成 App 時,必須確保編譯 App 用的 SDK 與編譯 framework 用的 SDK 一致,同時在 App 端加上執行期判斷(也就是 systemVersion 那段)。
1. 低版本 SDK 編譯,裝到高版本裝置(iOS 6 編譯 → iOS 7 執行)
不會出問題,因為 iOS 7 向下相容 iOS 6。但代價是無法使用 iOS 7 的新功能,因為那些程式碼在預處理階段就被屏蔽掉了。
2. 高版本 SDK 編譯,裝到低版本裝置(iOS 7 編譯 → iOS 6 執行)
若沒有加上執行期判斷,就會出問題,甚至 crash。因為 App 裡含 iOS 7 才有的新 API 呼叫,而 iOS 6 的系統根本沒有實作這些方法,執行到那行程式時會收到 unrecognized selector。
在現代的 Xcode 中,比較推薦的做法有兩種:
可用性註記(availability annotation):在方法或類別宣告前加上 API_AVAILABLE(ios(7.0)),或在實作上寫 if (@available(iOS 7.0, *)),編譯器會自動幫你檢查最低版本是否覆蓋到所有呼叫路徑,比手寫 #ifdef 更不容易出錯。
改用 respondsToSelector: 檢查能力:與其判斷系統版本,不如直接問物件「你有沒有這個方法」。這才是物件導向環境中判斷 API 可用性的正解,因為同一個方法可能透過私有 API、分類或 runtime 在舊系統上被補回來,也可能在新系統上被移除。
此外,若 deployment target 已高於某個版本,那個版本以下的 #ifdef 都可以直接刪掉——累積一堆永不為真的條件判斷,只會讓程式碼越來越難讀。