1. 程式人生 > >(譯)openURL 在 iOS10中已棄用

(譯)openURL 在 iOS10中已棄用

蘋果在iOS 2 推出了 openURL:方法 作為一種開啟外部連結的方式。而與之相關的方法 canOpenURL: 在iOS 9隱私控制裡也禁止查詢裝置中已安裝的App。 蘋果在iOS 10 中已經棄用了openURL:這個舊方法,用openURL:options:completionHandler:來代替。這篇快速指南就是教你在iOS 10 下如何開啟一個外部連結的文章。
(Haley_Wong注:canOpenURL:是在iOS 3中新增的;開啟外部連結一般都是用來調起別的App,比如調起打電話、郵件、Safari、QQ、微信、支付寶等)

iOS 10 中的更新

The new UIApplication method
openURL:
options:completionHandler:, which is executed asynchronously and calls the specified completion handler on the main queue (this method replaces openURL:).

翻譯如下:

新的UIApplication 方法`openURL:options:completionHandler:` 會非同步執行,並在主佇列中呼叫這個指定的 `completion handler`回調。

這個棄用的方法有一個要開啟的URL 引數,並且返回一個表示成功或者失敗的布林值:

// Objective-C
- (BOOL)openURL:(NSURL*)url

// Swift
open func canOpenURL(_ url: URL) -> Bool

iOS 10中的新方法:

// Objective-C
- (void)openURL:(NSURL*)url options:(NSDictionary<NSString *, id> *)options
  completionHandler:(void (^ __nullable)(BOOL success))completion

// Swift
open func open(_ url: URL, options: [String : Any] = [:],
  completionHandler completion: (@escaping (Bool) -> Swift.Void
)? = nil)

它有三個引數:
* 要開啟的URL。
* 一個可選字典(可參考下面的例項)。傳一個空字典時,該方法的效果與 openURL:一致。
* 一個帶有 成功與否 引數的 completion handler(可認為是閉包或block)。如果你對這個狀態不感興趣可以傳Null。

iOS 10 下開啟一個URL

這意味著如果你有一個只需要支援iOS 10以上的App,也不關心options 引數和 完成的狀態,又不想 Xcode 報警告,你可以這樣寫:

// Objective-C
UIApplication *application = [UIApplication sharedApplication];
[application openURL:URL options:@{} completionHandler:nil];

// Swift
UIApplication.shared.open(url, options: [:], completionHandler: nil)

實際上,只要你仍需要支援iOS 9或者更早的版本,那麼你就很可能要用回 openURL:老方法。
我們來看一個 使用 completion handler 來檢查 連結開啟狀態的例子。

顯示 Objective-C程式碼:

- (void)openScheme:(NSString *)scheme {
  UIApplication *application = [UIApplication sharedApplication];
  NSURL *URL = [NSURL URLWithString:scheme];

  if ([application respondsToSelector:@selector(openURL:options:completionHandler:)]) {
    [application openURL:URL options:@{}
       completionHandler:^(BOOL success) {
      NSLog(@"Open %@: %d",scheme,success);
    }];
  } else {
    BOOL success = [application openURL:URL];
    NSLog(@"Open %@: %d",scheme,success);
  }
}

// Typical usage
[self openScheme:@"tweetbot://timeline"];

我傳了一個空字典作為options引數,我在 completion handler 中就列印了一下 success 值,也沒做啥有用的事。 下面是 Swift 版程式碼:

func open(scheme: String) {
  if let url = URL(string: scheme) {
    if #available(iOS 10, *) {
      UIApplication.shared.open(url, options: [:],
        completionHandler: {
          (success) in
           print("Open \(scheme): \(success)")
       })
    } else {
      let success = UIApplication.shared.openURL(url)
      print("Open \(scheme): \(success)")
    }
  }
}

// Typical usage
open(scheme: "tweetbot://timeline")

Options 引數

UIApplication 的標頭檔案中列了一個可用在 options字典中的key:
* UIApplicationOpenURLOptionUniversalLinksOnly:可以設定布林值,如果設定為true(YES),則只能開啟應用裡配置好的有效通用連結。如果應用程式沒有配置,或者用於禁止開啟這個連結,則 completion handler 回撥裡的success為false(NO)。

為了覆寫程式的預設動作(預設這個key的值是NO),我們需要建立一個字典,將對應的key 設定為true(YES),然後將字典傳給 options 引數:

// Objective-C
NSDictionary *options = @{UIApplicationOpenURLOptionUniversalLinksOnly : @YES};
[application openURL:URL options:options completionHandler:nil];

// Swift
let options = [UIApplicationOpenURLOptionUniversalLinksOnly : true]
UIApplication.shared.open(url, options: options, completionHandler: nil)

舉個例子,我把這個值設定為 true 並嘗試開啟https://twitter.com/kharrison, 如果我沒有安裝 Twitter 應用,它將會執行失敗,而不是在Safari中開啟這個連結。
(譯者注:在iOS 9 使用 openURL:方法開啟這個連結時,會在首先調起Safari,然後在Safari中開啟這個連結)

更多閱讀

如有翻譯錯誤,請批評指正,謝謝!