[iOS 10] UIApplication の openURL: が Deprecated になりました

iOS 10

#iPhone

#ミレニアム・ファルコン製作日記

#iOS

田中圭介

2016.09.23

この記事は公開されてから1年以上経過しています。情報が古い可能性がありますので、ご注意ください。

openURL が変わった

iOS 10 から UIApplication の openURL: メソッドが Deprecated になりました。
代わりに利用することが推奨されたのは openURL:options:completionHandler: というメソッドです。

openURL:options:completionHandler:

旧メソッドに比べて 2 つ引数が増えています。
このメソッド、何が変わったのか実はよくわかりません。
なぜなら 公式のリファレンスに説明が書かれていない からです。（2016/09 現在）

API Reference

UIApplication のヘッダーには以下のように書かれています。

// Options are specified in the section below for openURL options. An empty options dictionary will result in the same
// behavior as the older openURL call, aside from the fact that this is asynchronous and calls the completion handler rather
// than returning a result.
// The completion handler is called on the main queue.
- (void)openURL:(NSURL*)url options:(NSDictionary<NSString *, id> *)options completionHandler:(void (^ __nullable)(BOOL success))completion NS_AVAILABLE_IOS(10_0) NS_EXTENSION_UNAVAILABLE_IOS("");

section below for openURL options に該当する部分はこちら。

#pragma mark -- openURL options --

// Option for openURL:options:CompletionHandler: only open URL if it is a valid universal link with an application configured to open it
// If there is no application configured, or the user disabled using it to open the link, completion handler called with NO
UIKIT_EXTERN NSString *const UIApplicationOpenURLOptionUniversalLinksOnly NS_AVAILABLE_IOS(10_0);

この定数もリファレンスでは 説明無し となっています。

API Reference

どうやら iOS 9 から利用できる ユニバーサルリンク に関係しているようです。
ただ、この定数はあくまで キー値 なので、どのような値をセットすればよいのかは不明です。
Apple からの続報を期待しましょう。

旧メソッドからのリファクタリング

An empty options dictionary will result in the same behavior as the older openURL call

ヘッダーに書かれているとおり、第二引数の options に 空の辞書 を設定すれば、古い openURL と同等の振る舞いとなるようです。

あくまで 空の辞書 です。
第二引数は nullable ではないので nil を設定すると警告が出ます。ご注意ください。

[[UIApplication sharedApplication] openURL:[NSURL URLWithString:@"https://www.apple.com"]
                                   options:@{}
                         completionHandler:nil];

追記

Swift の場合、このメソッドは以下のように定義されています。

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

新メソッドは open, 旧メソッドは openURL というメソッド名になっているため、取り扱いに注意しましょう。