Asks the delegate to open a resource identified by a URL.
- iOS 4.2–9.0Deprecated
- Mac Catalyst 13.0–13.0Deprecated
Your singleton app object.
The URL resource to open. This resource can be a network resource or a file. For information about the Apple-registered URL schemes, see Apple URL Scheme Reference.
The bundle ID of the app that is requesting your app to open the URL (
A Property list supplied by the source app to communicate information to the receiving app.
YES if the delegate successfully handled the request or
NO if the attempt to open the URL resource failed.
Your implementation of this method should open the specified URL and update its user interface accordingly. If your app had to be launched to open the URL, the app calls the
application: methods first, followed by this method. The return values of those methods can be used to prevent this method from being called. (If the app is already running, only this method is called.)
If the URL refers to a file that was opened through a document interaction controller, the
annotation parameter may contain additional data that the source app wanted to send along with the URL. The format of this data is defined by the app that sent it but the data must consist of objects that can be put into a property list.
Files sent to your app through AirDrop or a document interaction controller are placed in the
Documents/Inbox directory of your app’s home directory. Your app has permission to read and delete files in this directory but does not have permission to write to them. If you want to modify a file, you must move it to a different directory first. In addition, files in that directory are usually encrypted using data protection. If the file is protected and the user locks the device before this method is called, you will be unable to read the file’s contents immediately. In that case, you should save the URL and try to open the file later rather than return
NO from this method. Use the
protected property of the app object to determine if data protection is currently enabled.
There is no matching notification for this method.