CloudKit 名前空間

CloudKit 名前空間は、iCloud へのアクセスを提供します。

クラス

Name 説明
CKAcceptSharesOperation

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKAllowedSharingOptions

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKAsset

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKContainer

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKContainer.Notifications

CKContainer クラスによって投稿された通知。

CKDatabase

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKDatabaseNotification

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKDatabaseOperation

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKDatabaseSubscription

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKDiscoverAllUserIdentitiesOperation

システムのアドレス帳で検出可能なすべてのユーザーを取得する操作。

CKDiscoverUserIdentitiesOperation

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKErrorCodeExtensions

CKErrorCode列挙体の拡張メソッド。

CKErrorFields

CloudKit で使用されるエラー定数を保持します。

CKFetchDatabaseChangesOperation

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKFetchNotificationChangesOperation

通知の変更を取得する CKOperation 。

CKFetchRecordChangesOperation

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKFetchRecordsOperation

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKFetchRecordZoneChangesConfiguration

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKFetchRecordZoneChangesOperation

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKFetchRecordZoneChangesOptions

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKFetchRecordZonesOperation

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKFetchShareMetadataOperation

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKFetchShareParticipantsOperation

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKFetchSubscriptionsOperation

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKFetchWebAuthTokenOperation

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKLocationSortDescriptor

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKMarkNotificationsReadOperation

プッシュ通知を読み取りとしてマークします。 通常、プッシュ通知を使用してレコードの変更を追跡するアプリで使用されます。

CKModifyBadgeOperation

現在のデバイスまたはすべてのユーザーのデバイスで、アプリのアイコンのバッジを変更する CKOperation 。

CKModifyRecordsOperation

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKModifyRecordZonesOperation

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKModifySubscriptionsOperation

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKNotification

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKNotificationID

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKNotificationInfo

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKOperation

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKOperationConfiguration

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKOperationGroup

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKQuery

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKQueryCursor

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKQueryNotification

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKQueryOperation

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKQuerySubscription

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKRecord

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKRecordID

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKRecordValue

これは、(プロトコル ICKRecordValueの) インターフェイス CKRecordValueを実装するクラスです。

プロトコルを実装する型を簡単に作成するには、このクラスをサブクラス化します。

別の方法として、 NSObject のサブクラスを作成し、インターフェイス ICKRecordValueを実装します。

CKRecordZone

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKRecordZoneID

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKRecordZoneNotification

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKRecordZoneSubscription

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKReference

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKServerChangeToken

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKShare

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKShareAccessRequester

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKShareBlockedIdentity

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKShareKeys

さまざまな CloudKit クラスで使用される定数。

CKShareMetadata

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKShareParticipant

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKShareRequestAccessOperation

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSubscription

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSyncEngine

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSyncEngineAccountChangeEvent

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSyncEngineConfiguration

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSyncEngineDelegate

これは、(プロトコル ICKSyncEngineDelegateの) インターフェイス CKSyncEngineDelegateを実装するクラスです。

プロトコルを実装する型を簡単に作成するには、このクラスをサブクラス化します。

別の方法として、 NSObject のサブクラスを作成し、インターフェイス ICKSyncEngineDelegateを実装します。

CKSyncEngineDelegate_Extensions

CKSyncEngineDelegate プロトコルからのすべてのメソッドをサポートする ICKSyncEngineDelegate インターフェイスへの拡張メソッド。

CKSyncEngineDidFetchChangesEvent

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSyncEngineDidFetchRecordZoneChangesEvent

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSyncEngineDidSendChangesEvent

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSyncEngineEvent

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSyncEngineFailedRecordSave

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSyncEngineFailedZoneSave

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSyncEngineFetchChangesContext

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSyncEngineFetchChangesOptions

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSyncEngineFetchChangesScope

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSyncEngineFetchedDatabaseChangesEvent

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSyncEngineFetchedRecordDeletion

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSyncEngineFetchedRecordZoneChangesEvent

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSyncEngineFetchedZoneDeletion

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSyncEnginePendingDatabaseChange

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSyncEnginePendingRecordZoneChange

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSyncEnginePendingZoneDelete

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSyncEnginePendingZoneSave

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSyncEngineRecordZoneChangeBatch

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSyncEngineSendChangesContext

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSyncEngineSendChangesOptions

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSyncEngineSendChangesScope

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSyncEngineSentDatabaseChangesEvent

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSyncEngineSentRecordZoneChangesEvent

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSyncEngineState

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSyncEngineStateSerialization

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSyncEngineStateUpdateEvent

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSyncEngineWillFetchChangesEvent

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSyncEngineWillFetchRecordZoneChangesEvent

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSyncEngineWillSendChangesEvent

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSystemSharingUIObserver

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKUserIdentity

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKUserIdentityLookupInfo

CloudKit 名前空間は、iCloud へのアクセスを提供します。

インターフェイス

Name 説明
ICKRecordValue

このインターフェイスは、Objective-C プロトコル CKRecordValueを表します。

ICKSyncEngineDelegate

このインターフェイスは、Objective-C プロトコル CKSyncEngineDelegateを表します。

列挙型

Name 説明
CKAccountStatus

ユーザーの iCloud アカウントが使用可能かどうかを示す値を列挙します。

CKApplicationPermissions

他のアプリ ユーザーが電子メール アドレスで現在のユーザーを検出できることを示す値を列挙します。

CKApplicationPermissionStatus

アプリケーションがアクセス許可を取得しようとしたときに得ることができる状態を列挙します。

CKDatabaseScope

データベースがプライベート、共有、パブリックのいずれであるかを示す値を列挙します。

CKErrorCode

CloudKit エラー条件を列挙します。

CKNotificationType

プッシュ通知を生成できるイベントを列挙します。

CKOperationGroupTransferSize

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKQueryNotificationReason

データ ライフサイクル通知をトリガーできる永続的なストレージ イベントを列挙します。

CKQuerySubscriptionOptions

CKSubscriptionが通知を発生した時刻を列挙します。

CKRecordSavePolicy

レコードを保存するタイミングとタイミングを制御するポリシーを列挙します。

CKRecordZoneCapabilities

ゾーンで実行できる特殊な操作を列挙します。

CKRecordZoneEncryptionScope

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKReferenceAction

ターゲット レコードが削除されたときに参照自体を削除するかどうかを制御する値を列挙します。

CKShareParticipantAcceptanceStatus

参加要求を共有するための応答を列挙します。

CKShareParticipantPermission

ユーザー共有のアクセス許可を列挙します。

CKShareParticipantRole

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKShareParticipantType

共有参加要素の種類を列挙します。

CKSharingParticipantAccessOption

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSharingParticipantPermissionOption

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSubscriptionType

サブスクリプションの種類を列挙します。

CKSyncEngineAccountChangeType

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSyncEngineEventType

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSyncEnginePendingDatabaseChangeType

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSyncEnginePendingRecordZoneChangeType

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSyncEngineSyncReason

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKSyncEngineZoneDeletionReason

CloudKit 名前空間は、iCloud へのアクセスを提供します。

代理人

Name 説明
CKAcceptPerShareCompletionHandler

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKDatabaseDeleteSubscriptionHandler

DeleteSubscription(String, CKDatabaseDeleteSubscriptionHandler) メソッドの完了ハンドラー。

CKFetchDatabaseChangesCompletionHandler

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKFetchPerShareMetadataHandler

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKFetchRecordChangesHandler

AllChangesReported プロパティのデリゲート。

CKFetchRecordsCompletedHandler

Completed プロパティのデリゲート。

CKFetchRecordZoneChangesFetchCompletedHandler

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKFetchRecordZoneChangesRecordWasChangedHandler

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKFetchRecordZoneChangesTokensUpdatedHandler

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKFetchRecordZoneChangesWithIDWasDeletedHandler

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKFetchShareParticipantsOperationPerShareParticipantCompletionHandler

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKFetchSubscriptionsCompleteHandler

Completed プロパティのデリゲート。

CKFetchSubscriptionsPerSubscriptionCompletionHandler

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKFetchWebAuthTokenOperationHandler

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKMarkNotificationsReadHandler

Completed プロパティのデリゲート。

CKModifyRecordsOperationHandler

Completed プロパティのデリゲート。

CKModifyRecordsOperationPerRecordDeleteHandler

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKModifyRecordsOperationPerRecordSaveHandler

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKModifyRecordZonesHandler

Completed プロパティのデリゲート。

CKModifyRecordZonesPerRecordZoneDeleteHandler

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKModifyRecordZonesPerRecordZoneSaveHandler

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKModifySubscriptionsHandler

Completed プロパティのデリゲート。

CKModifySubscriptionsPerSubscriptionDeleteHandler

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKModifySubscriptionsPerSubscriptionSaveHandler

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKQueryOperationRecordMatchedHandler

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKRecordZoneCompleteHandler

Completed プロパティのデリゲート。

CKRecordZonePerRecordZoneCompletionHandler

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKShareRequestAccessOperationPerShareAccessRequestCompletionHandler

CloudKit 名前空間は、iCloud へのアクセスを提供します。

CKShareRequestAccessOperationShareRequestAccessCompletionHandler

CloudKit 名前空間は、iCloud へのアクセスを提供します。

注釈

CloudKit 名前空間を使用すると、アプリケーション開発者はアプリケーションと iCloud の間のデータ フローを制御できます。 iCloud は、アプリケーションまたは特定のアプリケーションのすべてのインスタンス間で共有される "パブリック" と、1 人のユーザーに固有の "プライベート" の両方のサーバー側データ ストレージを提供します。 iCloud のストレージとトランスポートは、Apple デバイス間で暗号化および同期されます。 CloudKit では、クライアント側の永続化やデータ キャッシュは提供されません。CloudKit 機能は、ユーザーがアクティブなインターネット接続を持っている間にのみ使用できます。

CloudKit の最上位クラスは CKContainer。 CloudKit コンテナー (Apple ドキュメントでは "Ubiquity コンテナー" とも呼ばれます) は、特定の名前で識別される情報ストアです。 Apple では、"iCloud" という形式の名前を使用することをお勧めします。{逆引き DNS}。{appName}"、たとえば"iCloud.com.mycompany.MyApp"。 開発者は、Apple 開発者ポータルを使用して利用できる iCloud ダッシュボードを使用して、コンテナーを作成して構成する必要があります。

1 つの CKContainer には、アプリのすべてのインスタンス間で共有されるパブリック データ ( PublicCloudDatabase を参照) と、ユーザー固有のデータを含むプライベート データの両方が含まれる場合があります ( PrivateCloudDatabaseを参照)。 iCloud 内では、パブリック データはアプリの iCloud ストレージに格納され、プライベート データはユーザーのプライベート iCloud ストレージに格納されます。 パブリック CKDatabase は、iCloud にログインしているかどうかに関係なく、アプリのすべての接続ユーザーが使用できます。 プライベート CKDatabase は、ユーザーが iCloud にログインしている場合にのみ使用できます。 開発者は、ユーザーのログインまたは接続状態の変更に適切に対応するようにコードを記述する必要があります。

これらのパブリック オブジェクトとプライベート CKDatabase オブジェクトには、構造化レコードが格納されます。 これらは、 CKRecord オブジェクトによって表されます。 これらのレコードは、フィールドに似たキー値データに加えて、大きなオブジェクト CKAsset 直接 (含まれている CKRecordで取得) または参照 (大きなデータの遅延取得を可能にする) として保持できます。

すべての CKRecord インスタンスは、 CKRecordZone内に格納されます。 CKRecordZoneは従来のデータベース インスタンスのようなものです。相互に参照できるが、他のCKRecordZone インスタンスには格納しない複数のCKRecord ストアを含めることができます。CKRecordZone オブジェクトを使用して、複数のCKRecord ストア間でアトミック操作を調整できます。 データベース インスタンスと似ているのは汎用ではありません。たとえば、開発者はFetchRecordAsyncを使用して、ゾーンを参照せずにCKDatabaseから直接CKRecordを取得できます。 既定の CKRecordZone は、 DefaultRecordZone経由で使用できます。 開発者は、CloudKit ダッシュボードを使用して追加のゾーンを作成し、それらを使用してデータを論理的にパーティション分割できます。

CloudKit アプリには、 com.apple.developer.icloud-services エンタイトルメントとアプリ固有のバンドル識別子 (例: "com.mycompany.CloudKitApp") を含むプロビジョニング プロファイルが必要です。 開発者は、このようなプロビジョニング プロファイルを作成して構成する必要があります。

次に、1 つのレコードで動作する CloudKit の一般的な使用方法を示します。

//Create
private async Task<CKRecord> StoreInCloudKit (string name, CLLocation loc, int stationId)
{
    string containerName = "iCloud.com.example.CKWork";
    var container = CKContainer.FromIdentifier (containerName);
    CKDatabase publicDatabase = container.PublicCloudDatabase;
    var zoneId = CKRecordZone.DefaultRecordZone ().ZoneId;
    var recordType = "StationReferences";

    var record = new CKRecord (recordType);
    record ["Name"] = new NSString (name);
    record ["Position"] = loc;
    record ["StationID"] = new NSNumber (stationId);

    var storedRecord = await publicDatabase.SaveRecordAsync (record);
    return storedRecord;
}

//Retrieve (via ID)
private async Task<CKRecord> AccessCloudKit ()
{
    string containerName = "iCloud.com.example.CKWork";
    var container = CKContainer.FromIdentifier (containerName);
    CKDatabase publicDatabase = container.PublicCloudDatabase;

    var recordNameIHappenToKnow = "7eaf0432-2fa4-475f-851a-c6a19b3f8587";
    var recordId = new CKRecordID (recordNameIHappenToKnow);
    var record = await publicDatabase.FetchRecordAsync (recordId);

    return record;
}

//Retrieve (query)
private async Task<CKRecord []> QueryCloudKit ()
{
    string containerName = "iCloud.com.example.CKWork";
    var container = CKContainer.FromIdentifier (containerName);
    CKDatabase publicDatabase = container.PublicCloudDatabase;

    var zoneId = CKRecordZone.DefaultRecordZone ().ZoneId;
    Console.WriteLine ($"Default zone name = '{zoneId.ZoneName}' owner = '{zoneId.OwnerName}'");
    /*
    var zoneName = "_defaultZone";
    var ownerName = "__defaultOwner__";
    var zoneId0 = new CKRecordZoneID (zoneName, ownerName);

    Console.WriteLine ($"Assert { zoneId0 == zoneId }");
    */

    var recordType = "StationReferences";

    var location = new CLLocation (19.7303, -155.056);
    var predicate = NSPredicate.FromFormat ("distanceToLocation:fromLocation:(Position, %@) < 100", location);

    var query = new CKQuery (recordType, predicate);

    var result = await publicDatabase.PerformQueryAsync (query, zoneId);
    return result;
}

//Update
private async Task<CKRecord> UpdateInCloudKit (CKDatabase database, CKRecord record, NSString key, NSObject newValue)
{
    record [key] = newValue;
    var modifiedRecord = await database.SaveRecordAsync (record);
    return modifiedRecord;
}

//Delete
private async Task<CKRecordID> DeleteRecord (CKDatabase database, CKRecord record)
{
    var id = record.Id;
    var deletedId = await database.DeleteRecordAsync (id);
    return deletedId;
}