每周 Swift 社區問答:@available 和 #available
Swift 2.0 中,引入了可用性的概念。對于函數,類,協議等,可以使用 @available 聲明這些類型的生命周期依賴于特定的平臺和操作系統版本。而 #available 用在判斷語句中(if, guard, while等),在不同的平臺上做不同的邏輯。
@available
用法
@available 放在函數(方法),類或者協議前面。表明這些類型適用的平臺和操作系統。看下面一個例子:
@available(iOS 9, *) func myMethod() { // do something }
@available(iOS 9, *) 必須包含至少2個特性參數,其中 iOS 9 表示必須在 iOS 9 版本以上才可用。如果你部署的平臺包括 iOS 8 , 在調用此方法后,編譯器會報錯。
另外一個特性參數:星號(*),表示包含了所有平臺,目前有以下幾個平臺:
- iOS
- iOSApplicationExtension
- OSX
- OSXApplicationExtension
- watchOS
- watchOSApplicationExtension
- tvOS
- tvOSApplicationExtension
一般來講,如果沒有特殊的情況,都使用 * 表示全平臺。
@available(iOS 9, *) 是一種簡寫形式。全寫形式是 @available(iOS, introduced=9.0) 。 introduced=9.0 參數表示指定平臺(iOS)從 9.0 開始引入該聲明。為什么可以采用簡寫形式呢?當只有 introduced 這樣一種參數時,就可以簡寫成以上簡寫形式。同理:@available(iOS 8.0, OSX 10.10, *) 這樣也是可以的。表示同時在多個平臺上(iOS 8.0 及其以上;OSX 10.10及其以上)的可用性。
另外, @available 還有其他一些參數可以使用,分別是:
- deprecated=版本號 :從指定平臺某個版本開始過期該聲明
- obsoleted=版本號 :從指定平臺某個版本開始廢棄(注意棄用的區別, deprecated 是還可以繼續使用,只不過是不推薦了, obsoleted 是調用就會編譯錯誤)該聲明
- message=信息內容 :給出一些附加信息
- unavailable :指定平臺上是無效的
- renamed=新名字 :重命名聲明
以上參數具體可以參考 官方文檔
#available
#available 用在條件語句代碼塊中,判斷不同的平臺下,做不同的邏輯處理,比如:
if #available(iOS 8, *) { // iOS 8 及其以上系統運行 } guard #available(iOS 8, *) else { return //iOS 8 以下系統就直接返回 }
stackoverflow 相關問題整理
-
Difference between @available and #available in swift 2.0 : @available 和 #available
帖子里面還提到一個問題: @available 是編譯期間判斷的嗎?而 #available 是運行時行為嗎?