The downloadingAssets array holds any downloading assets for any issues. (A downloading asset is represented by a NKAssetDownload object.) A newsstand content application should, when it launches, iterate through this array and call downloadWithDelegate: on each item to have the downloaded assets completely processed.

An application can maintain as many back issues of the library as it wants, in addition to the most current issue. The Newsstand Kit framework uses the dates of issues and whatever issue is assigned to the currentlyReadingIssue property as hints in low disk space scenarios.

Declaration

Parameters

The name of the newsstand issue. This parameter is required and the name must be unique across all issues in the library.

date

The date the newsstand issue was released. This parameter is required.

Return Value

An instance of the NKIssue class or nil if the instance couldn’t be created.

Discussion

The created issue is automatically added to the newsstand content library. Issues are ordered by their release date. The release date of an issue can be a factor when Newsstand Kit must delete back issues because of low levels of available flash storage.

This method throws an exception if the name and date parameters are nil or are otherwise not valid objects. It also throws an exception if you pass in an issue name that is used by another issue.

Declaration

Discussion

When you ascertain what issue the user is currently reading, you should set this property to the corresponding NKIssue instance. Newsstand Kit takes this setting into consideration when it purges back issues because of low levels of available flash storage.

Declaration

Parameters

issue

An instance of NKIssue representing an issue in the newsstand content library.

Discussion

When an issue is removed, any data at the file-system location identified by the issue’s content URL (accessed through the contentURL property of NKIssue) is deleted from disk. If you have issue content elsewhere in the application sandbox, it’s your responsibility to clean it up. Calling this method also cancels any asset downloads for that issue that are underway.