Returns a URL that can be emailed to users to allow them to download a copy of a flat file item from iCloud.
- iOS 5.0+
- macOS 10.7+
- Mac Catalyst 13.0+
- tvOS 9.0+
- watchOS 2.0+
The URL of the item in the cloud that you want to share. The URL must be prefixed with the base URL returned from the
URLFormethod that corresponds to the item’s location. The file must be a flat file, not a bundle. The file at the specified URL must already be uploaded to iCloud when you call this method.
Ubiquity Container Identifier:
On input, a pointer to a variable for a date object. On output, this parameter contains the date after which the item is no longer available at the returned URL. You may specify
nilfor this parameter if you are not interested in the date.
On input, a pointer to variable for an
NSErrorobject. If an error occurs, this pointer is set to an
NSErrorobject containing information about the error. You may specify
nilfor this parameter if you do not want the error information.
A URL with which users can download a copy of the item at
nil if the URL could not be created for any reason.
This method creates a snapshot of the specified flat file and places that copy in a temporary iCloud location where it can be accessed by other users using the returned URL. The snapshot reflects the contents of the file at the time the URL was generated and is not updated when subsequent changes are made to the original file in the user’s iCloud storage. The snapshot file remains available at the specified URL until the date specified in the
out parameter, after which it is automatically deleted. Explicitly deleting the item by calling the
remove method also deletes all old versions of the item, invalidating URLs to those versions returned by this method.
Your app must have access to the network for this call to succeed. If the specified file is in the process of being uploaded to iCloud, you must not call this method until the upload has finished.