關(guān)鍵詞: iOS 低版本 調(diào)用 高版本 API
我們在編程過程中經(jīng)常遇到新的Api無法兼容低版本系統(tǒng)造成Crash問題,如何讓Xcode編譯時對于高于工程版本的Api顯示警告呢突梦?今天特意研究一番:
一般是通過兩種方式:
方案一:
使用開源的MJGAvailability.h
把MJGAvailability.h文件加入工程中拥刻,在預(yù)編譯頭文件最開頭加上下面的代碼即可:
#define __IPHONE_OS_VERSION_SOFT_MAX_REQUIRED __IPHONE_7_0
#import "MJGAvailability.h"
一般需要配置Enable Modules
為NO齿椅;大多數(shù)工程可能不適合竹勉,所以效果一般在刺;
方案二:
修改Xcode中的iOS SDK
在Xcode中贷岸,NS_AVAILABLE(10_5, 2_0)
我們通過其宏定義一步步點進去:
1)、NS_AVAILABLE(10_5, 2_0)
2)嵌削、#define NS_AVAILABLE(_mac, _ios) CF_AVAILABLE(_mac, _ios)
3)毛好、#define CF_AVAILABLE(_mac, _ios) __attribute__((availability(macosx,introduced=_mac)))
所以望艺,我們可以通過重寫CF_AVAILABLE(_mac, _ios)
來提示是否應(yīng)該API是否合法
其宏定義所屬文件夾:/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneSimulator.platform/Developer/SDKs/iPhoneSimulator.sdk/System/Library/Frameworks/CoreFoundation.framework/Headers/CFAvailability.h
在該文件夾下打開CFAvailability.h
(注意不要使用Xcode來打開(需要權(quán)限),用其他編輯軟件來打開肌访,比如:Sublime等)
我這里是針對自己的iOS工程最低適配到iOS8.0找默,所以在(CFAvailability.h 60行)#elif (TARGET_OS_EMBEDDED || TARGET_OS_IPHONE)
這個條件下重寫CF_AVAILABLE_IOS(_ios)
, CF_AVAILABLE(_mac, _ios)
這兩個宏定義,具體代碼如下:
#define __NEP_2_0 availability(ios,introduced=2.0)
#define __NEP_2_1 availability(ios,introduced=2.1)
#define __NEP_2_2 availability(ios,introduced=2.2)
#define __NEP_3_0 availability(ios,introduced=3.0)
#define __NEP_3_1 availability(ios,introduced=3.1)
#define __NEP_3_2 availability(ios,introduced=3.2)
#define __NEP_4_0 availability(ios,introduced=4.0)
#define __NEP_4_1 availability(ios,introduced=4.1)
#define __NEP_4_2 availability(ios,introduced=4.2)
#define __NEP_4_3 availability(ios,introduced=4.3)
#define __NEP_5_0 availability(ios,introduced=5.0)
#define __NEP_5_1 availability(ios,introduced=5.1)
#define __NEP_6_0 availability(ios,introduced=6.0)
#define __NEP_6_1 availability(ios,introduced=6.1)
#define __NEP_7_0 availability(ios,introduced=7.0)
#define __NEP_7_1 availability(ios,introduced=7.1)
#define __NEP_8_0 availability(ios,introduced=8.0)
#define __NEP_8_1 availability(ios,introduced=8.1) deprecated("mqc:::: API version newer than iOS8.0")
#define __NEP_8_2 availability(ios,introduced=8.2) deprecated("mqc:::: API version newer than iOS8.0")
#define __NEP_8_3 availability(ios,introduced=8.3) deprecated("mqc:::: API version newer than iOS8.0")
#define __NEP_9_0 availability(ios,introduced=9.0) deprecated("mqc:::: API version newer than iOS8.0")
#define __NEP_9_1 availability(ios,introduced=9.1) deprecated("mqc:::: API version newer than iOS8.0")
#define __NEP_9_2 availability(ios,introduced=9.1) deprecated("mqc:::: API version newer than iOS8.0")
#define __NEP_9_3 availability(ios,introduced=9.1) deprecated("mqc:::: API version newer than iOS8.0")
#define __NEP_9_4 availability(ios,introduced=9.1) deprecated("mqc:::: API version newer than iOS8.0")
#define __NEP_9_5 availability(ios,introduced=9.1) deprecated("mqc:::: API version newer than iOS8.0")
#define __NEP_10_0 availability(ios,introduced=10.0) deprecated("mqc:::: API version newer than iOS8.0")
#define __NEP_10_1 availability(ios,introduced=10.1) deprecated("mqc:::: API version newer than iOS8.0")
#define __NEP_10_2 availability(ios,introduced=10.2) deprecated("mqc:::: API version newer than iOS8.0")
#define __NEP_10_3 availability(ios,introduced=10.3) deprecated("mqc:::: API version newer than iOS8.0")
#define __NEP_10_4 availability(ios,introduced=10.4) deprecated("mqc:::: API version newer than iOS8.0")
#define __NEP_10_5 availability(ios,introduced=10.5) deprecated("mqc:::: API version newer than iOS8.0")
#define __NEP_10_6 availability(ios,introduced=10.6) deprecated("mqc:::: API version newer than iOS8.0")
#define __NEP_10_7 availability(ios,introduced=10.7) deprecated("mqc:::: API version newer than iOS8.0")
#define __NEP_10_8 availability(ios,introduced=10.8) deprecated("mqc:::: API version newer than iOS8.0")
#define __NEP_10_9 availability(ios,introduced=10.9) deprecated("mqc:::: API version newer than iOS8.0")
#define __NEP_10_10 availability(ios,introduced=10.10) deprecated("mqc:::: API version newer than iOS8.0")
#define __NEP_11_1 availability(ios,introduced=11.1) deprecated("mqc:::: API version newer than iOS8.0")
#define __NEP_11_2 availability(ios,introduced=11.2) deprecated("mqc:::: API version newer than iOS8.0")
#define __NEP_11_3 availability(ios,introduced=11.3) deprecated("mqc:::: API version newer than iOS8.0")
#define __NEP_11_4 availability(ios,introduced=11.4) deprecated("mqc:::: API version newer than iOS8.0")
#define __NEP_11_5 availability(ios,introduced=11.5) deprecated("mqc:::: API version newer than iOS8.0")
#define __NEP_11_6 availability(ios,introduced=11.6) deprecated("mqc:::: API version newer than iOS8.0")
#define CF_AVAILABLE_IOS(_ios) __attribute__((,__NEP_##_ios))
#define CF_AVAILABLE(_mac, _ios) __attribute__((,__NEP_##_ios))
具體提示內(nèi)容可以自定義吼驶。
注意:
以上方式針對Xcode8版本是有效的惩激,針對Xcode9
Xcode9以后上述方式會出現(xiàn)Xcode編譯出錯,原因是:
在iOS11的frameworks中出現(xiàn)了NS_CLASS_AVAILABLE_IOS(8.0)
這樣的宏蟹演,Xcode之前的代碼一般的寫法為NS_CLASS_AVAILABLE_IOS(8_0)
這樣的下劃線方式风钻,而且這個地方是蘋果宏定義聚集的地方,應(yīng)該非常忌諱用小數(shù)點來表示酒请,我的猜測多半是新員工搞事情骡技;
如果是“8.0”這樣的方式出現(xiàn)我們再使用宏定義的方式改寫蘋果的API肯定是不行,因為“ISO C99”不支持這樣的字符串格式羞反。
不過好在Xcode9已經(jīng)支持檢測低版本API的兼容問題布朦,你只需要搜索“is only available on iOS 8.0”查看適配情況就OK了。例如:
'UIImageRenderingModeAlwaysOriginal' is only available on iOS 7.0 or newer
只需要點擊fix就行昼窗。
如果Xcode9提供的你就是不想用(任性)是趴,重寫#define NS_CLASS_AVAILABLE_IOS(_ios) NS_CLASS_AVAILABLE(NA, _ios)
這個宏定義;
思路:
在“CFAvailability.h”文件中新建一個宏定義的澄惊,然后通過重寫“NSObjCRuntime.h”文件中的#define NS_CLASS_AVAILABLE_IOS(_ios) NS_CLASS_AVAILABLE(NA, _ios)
為新加的宏定義即可唆途。