Class

NSBundleResourceRequest

A resource manager you use to download content hosted on the App Store at the time your app needs it. あるリソースマネージャ、あなたがApp Store上にホストされるコンテンツをあなたのアプリがそれを必要とする時にダウンロードするのに使います。

Declaration 宣言

class NSBundleResourceRequest : NSObject

Overview 概要

You identify on-demand resources during development by creating string identifiers known as tags and assigning one or more tags to each resource. An NSBundleResourceRequest object manages the resources marked by one or more tags. あなたは、オンデマンドリソースを開発の間に、タグとして知られる文字列識別子を作成して１つ以上のタグを各リソースに割り当てることによって識別します。NSBundleResourceRequestオブジェクトは、１つ以上のタグによって印されるリソースを管理します。

You use the resource request to inform the system when the managed tags are needed and when you have finished accessing them. The resource request manages the downloading of any resources marked with the managed tags that are not already on the device and informs your app when the resources are ready for use. あなたは、リソースリクエストを使って、管理タグが必要とされる時そしてあなたがそれらへのアクセスを終えた時に、システムに知らせます。リソースリクエストは、管理タグで印される何らかリソースでまだデバイス上にないもののダウンロードを管理します、そしてあなたのアプリにリソースが使用する準備ができた時に知らせます。

The system will not attempt to purge the resources marked with a tag from on-device storage as long as at least one NSBundleResourceRequest object is managing the tag. Apps can access resources after the completion handler of either beginAccessingResources(completionHandler:) or conditionallyBeginAccessingResources(completionHandler:) is called successfully. Management ends after a call to endAccessingResources() or after the resource request object is deallocated. システムは、あるタグで印されたリソースそれらをデバイス上のストレージから除去しません、少なくとも１つのNSBundleResourceRequestオブジェクトがそのタグを管理している限りは。アプリは、beginAccessingResources(completionHandler:)またはconditionallyBeginAccessingResources(completionHandler:)どちらかの完了ハンドラがうまく呼び出された後にリソースにアクセスできます。管理は、endAccessingResources()への呼び出しの後またはリソースリクエストオブジェクトがデアロケートされた後に終わります。

Other properties and methods let you track the progress of a download, change the priority of a download, and check whether the resources marked by a set of tags are already on the device. Methods in Bundle indicate to the system the relative importance of preserving a tag in memory after it is no longer in use. For more information, see setPreservationPriority(_:forTags:) and preservationPriority(forTag:). 他のプロパティおよびメソッドは、あなたにあるダウンロードの進捗を追跡させ、あるダウンロードの優先度を変更させ、そして一揃いのタグによって印されるリソースがすでにデバイス上にあるかどうかを調べさせます。Bundleの中のメソッドは、あるタグをメモリ中に保全することの相対的重要度を、それがもう使われなくなった後に、システムに指し示します。さらなる情報として、setPreservationPriority(_:forTags:)とpreservationPriority(forTag:)を見てください。

Topics 話題

Initializing a Resource Request リソースリクエストを初期化する

init(tags: Set<String>)

Initializes a resource request for managing the on-demand resources marked with any of the set of specified tags. The managed resources are loaded into the main bundle. 何らかの一揃いの指定されたタグで印されたオンデマンドリソースの管理に対するリソースリクエストを初期化します。管理されたリソースは、メインバンドルにロードされます。

init(tags: Set<String>, bundle: Bundle)

Initializes a resource request for managing the on-demand resources marked with any of the set of specified tags. The managed resources are loaded into the specified bundle. 何らかの一揃いの指定されたタグで印されたオンデマンドリソースの管理に対するリソースリクエストを初期化します。管理されたリソースは、指定されたバンドルにロードされます。

Accessing the Configuration 構成設定にアクセスする

var bundle: Bundle

A reference to the bundle used for storing the downloaded resources. (read-only) ダウンロードされたリソースを格納するために使われるバンドルに対する参照。（読み出しのみ）

var tags: Set<String>

A set of strings, with each string specifying a tag used to mark on-demand resources managed by the request. (read-only) ひとそろいの文字列、リクエストによって管理されるオンデマンドリソースを印するために使われるタグを各文字列で指定しています。（読み出しのみ）

Requesting Resources リソースをリクエストする

func beginAccessingResources(completionHandler: (Error?) -> Void)

Requests access to the resources marked with the managed tags. If any of the resources are not on the device, they are requested from the App Store. 管理タグで印されるリソースに対するアクセスをリクエストする。何らかのリソースがデバイス上にないならば、それらはApp Storeにリクエストされます。

func conditionallyBeginAccessingResources(completionHandler: (Bool) -> Void)

Checks whether the resources marked with the tags managed by the request are already on the device. If all of the resources are on the device, you can begin accessing those resources. リクエストによって管理されるタグで印されるリソースがすでにデバイス上かどうか調べます。それらのリソースの全てがデバイス上ならば、あなたはそれらリソースにアクセスを開始できます。

func endAccessingResources()

Informs the system that you have finished accessing the resources marked with the tags managed by the request. リクエストによって管理されるタグで印されるリソースにアクセスすることをあなたがやり終えたことをシステムに知らせます。

Setting the Download Priority ダウンロード優先度を設定する

var loadingPriority: Double

A hint to the system of the relative priority of the resource request. リソースリクエストの相対優先度のシステムに対するヒント。

let NSBundleResourceRequestLoadingPriorityUrgent: Double

Tracking Progress 進捗を追跡する

var progress: Progress

A reference to the progress object associated with the specified resource request. (read-only) 指定されたリソースリクエストと結びつけられた進捗オブジェクトに対する参照。（読み出しのみ）

Errors エラー

var NSBundleErrorMaximum: Int

The end of the range of error codes reserved for bundle errors. バンドルエラーのために予約されるエラーコードの範囲の終わり。

var NSBundleErrorMinimum: Int

The start of the range of error codes reserved for bundle errors. バンドルエラーのために予約されたエラーコードの範囲の始まり。

var NSBundleOnDemandResourceExceededMaximumSizeError: Int

The application exceeded the amount of on-demand resources content in use at one time. アプリケーションは、一度に使用するオンデマンドリソースの内容量を超過しました。

var NSBundleOnDemandResourceInvalidTagError: Int

The application specified a tag that the system couldn’t find in the application tag manifest. アプリケーションは、アプリケーションタグ目録においてシステムが見つけられなかったタグを指定しました。

var NSBundleOnDemandResourceOutOfSpaceError: Int

Insufficient space available to download the requested on-demand resources. 要請されたオンデマンドリソースをダウンロードするのに利用可能な空きの不足。

Notifications 通知

static let NSBundleResourceRequestLowDiskSpace: NSNotification.Name

Posted after the system detects that the amount of available disk space is getting low. The notification is posted to the default notification center. 利用可能なディスクの空きが少なくなることをシステムが検出した後に投函されます。通知は、省略時の通知センターに投函されます。