NKAssetDownload

An instance of the NKAssetDownload class represents an asset that is being downloaded (or has downloaded) for an issue of a Newsstand application.
More...

An asset can be either a component of an issue—for example, an HTML file, a plain-text file, an image, or a video—or the entire issue compressed in a ZIP or other archive. The latter approach is recommended.

You create an NKAssetDownload instance using the NKIssue method addAssetWithRequest:; you pass into this method an NSURLRequest object that contains the URL locating the asset on the application’s server. To begin downloading the asset, call downloadWithDelegate: on the NKAssetDownload object. The delegate specified as the parameter of this message must adopt the NSURLConnectionDownloadDelegate protocol. It should implement the three methods specific to handling downloads of issue assets:

Parameters

Return Value

An object representing the URL connection.

Discussion

Upon receipt of this message, the Newsstand Kit framework creates a NSURLConnection object from the NSURLRequest object encapsulated by the receiver, returns the connection object, and typically begins downloading the issue asset. (If the download is already underway, it simply returns the associated connection object.) It sends messages to the connection-download delegate at the appropriate junctures until the download concludes.

Declaration

Discussion

This dictionary is for storing arbitrary key-value pairs associated with the asset download. The keys and values must be valid property-list types; if any are not, an exception is raised. Examples of download-related information you might store in the dictionary are the file (issue) name, the download URL, the encoding mechanisms, and custom identifiers. However, for performance reasons the dictionary content should be as minimal as possible. You can also assign nil to this property.