
原文:openURL Deprecated in iOS 10
作者:@kharrison
譯者:deqiutseng
蘋果在 iOS 2 中引入了 openURL: 方法來進行 App 間跳轉。不過在 iOS 9 中,基於隱私考量,蘋果已禁止開發者透過 openURL: 查詢裝置上安裝了哪些 App。到了 iOS 10,蘋果正式棄用了 openURL,改用 openURL:options:completionHandler: 替代。本文簡單介紹如何在 iOS 10 中進行 App 間跳轉。
iOS 10 中的新功能
蘋果在 What's New in iOS 文件的 UIKit 部分指出:
新的 UIApplication 方法 openURL:options:completionHandler: 可以異步執行,並在主隊列中執行完成後進行回調(此方法取代原來的 openURL:)。
現在被廢棄的方法必須傳入要啟動 App 的 URL,並返回布林值來標識成功或失敗。
// Objective-C - (BOOL)openURL:(NSURL*)url // Swift open func canOpenURL(_ url: URL) -> Bool
iOS 10 中的新方法:
// Objective-C - (void)openURL:(NSURL*)url options:(NSDictionary *)options completionHandler:(void (^ __nullable)(BOOL success))completion // Swift open func open(_ url: URL, options: [String : Any] = [:], completionHandler completion: (@escaping (Bool) -> Swift.Void)? = nil)
現在變為三個參數:
要打開 App 的 URL;
可選字典參數(請參見下方有效條目),傳入空字典可達到與 openURL: 一樣的行為;
執行成功後,completion handler 會在主隊列中回調,若你不關心返回狀態也可以傳空。
在 iOS 10 中打開 URL
如果你的 App 只需支援 iOS 10,那就意味著不必理會那些可選參數與完成回調的返回狀態,也就能停止對 Xcode 的抱怨了。
// Objective-C UIApplication *application = [UIApplication sharedApplication]; [application openURL:URL options:@{} completionHandler:nil]; // Swift UIApplication.shared.open(url, options: [:], completionHandler: nil)在實際專案中,如果你仍需相容 iOS 9 及更早版本,那肯定還是想沿用舊的 openURL 方法。下面看看一段程式碼如何透過 completionHandler 檢查 App 是否打開成功。先上 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"];我為 option 參數傳入一個空字典,除了在成功回調裡打印了一下日誌外,並沒有寫什麼有用邏輯。以下是 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:若這個要開啟的 URL 有效,並且在 App 中把它的布林值配置為 true(YES)時才能打開,否則打不開。
為了覆蓋默認行為,建立一個把該 key 設為 True 的字典作為參數傳入:
// 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 並打開 URL:https://twitter.com/kharrison,而我又沒安裝 Twitter App,那它就會失敗,同時會調用 Safari 打開這個連結。(特別感謝 Kamil 對本文的建議。)
進一步閱讀:
What's New in iOS——查看 UIKit 部分。
Querying URL Schemes with canOpenURL