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

iOS 多版本適配:#ifdef __IPHONE_7_0 預處理的正確用法

編輯:iOS 開發綜合

要同時支援 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>。)這樣編譯就能通過。

原理: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 靜態庫時

編譯 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 都可以直接刪掉——累積一堆永不為真的條件判斷,只會讓程式碼越來越難讀。

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