URLForUbiquityContainerIdentifier:

- (NSURL *)URLForUbiquityContainerIdentifier:(NSString *)containerIdentifier;

Return Value 戻り値

A URL pointing to the specified ubiquity container, or nil if the container could not be located or if iCloud storage is unavailable for the current user or device. 指定される偏在コンテナを指しているURL、もしくはコンテナが位置を突き止められないならばまたはiCloudストレージが現在のユーザまたはデバイスに利用可能でないならばnil。

Discussion 議論

You use this method to determine the location of your app’s ubiquity container directories and to configure your app’s initial iCloud access. The first time you call this method for a given ubiquity container, the system extends your app’s sandbox to include that container. In iOS, you must call this method at least once before trying to search for cloud-based files in the ubiquity container. If your app accesses multiple ubiquity containers, call this method once for each container. In macOS, you do not need to call this method if you use NSDocument-based objects, because the system then calls this method automatically. あなたはこのメソッドを使ってあなたのアプリの偏在コンテナディレクトリの位置を決定して、あなたのアプリの最初のiCloudアクセスを構成設定します。このメソッドをある与えられた偏在コンテナに対して呼び出す最初の時、システムは、あなたのアプリのサンドボックスをそのコンテナを含むように拡張します。iOSでは、あなたはこのメソッドを少なくとも一度は偏在コンテナにおいてクラウド基盤のファイルの検索を試みる前に呼び出さなければなりません。あなたのアプリが複数の偏在コンテナにアクセスするならば、このメソッドを各コンテナに対して一回呼び出してください。macOSでは、あなたはこのメソッドを呼び出す必要はありません、あなたがNSDocumentに基づくオブジェクトを使うならば、なぜならシステムはその時このメソッドを自動的に呼び出すからです。

You can use the URL returned by this method to build paths to files and directories within your app’s ubiquity container. Each app that syncs documents to the cloud must have at least one associated ubiquity container in which to put those files. This container can be unique to the app or shared by multiple apps. あなたは、このメソッドによって返されるURLを使って、あなたのアプリの持つ偏在コンテナ内部のファイルやディレクトリに対するパスを組み立てることができます。いろいろな書類をクラウドに同期する各アプリは、それらファイルをその中に置くところの、結び付けられた偏在コンテナを少なくとも１つ持たなければなりません。このコンテナは、そのアプリに特有であるまたは複数のアプリで共有されることが可能です。

In addition to writing to its own ubiquity container, an app can write to any container directory for which it has the appropriate permission. Each additional ubiquity container should be listed as an additional value in the com.apple.developer.ubiquity-container-identifiers entitlement array. それ独自の偏在コンテナに書き出すことに加えて、アプリはそれが適切な権限を持つどんなコンテナディレクトリに対しても書き出せます。各追加的な偏在コンテナは、追加的な値としてcom.apple.developer.ubiquity-container-identifiers資格配列において一覧にされるべきです。

To learn how to view your development team’s unique <TEAM_ID> value, read To view the team ID in Tools Workflow Guide for Mac. あなたの開発チームの特有<TEAM_ID>値を眺める方法を学ぶために、To view the team ID を Tools Workflow Guide for Mac で見てください。