Condividi tramite


CloudKit Spazio dei nomi

Lo spazio dei nomi CloudKit consente l'accesso a iCloud.

Classi

CKAcceptSharesOperation

Implementa un'operazione che accetta record condivisi.

CKAsset

File di grandi dimensioni associato a un CKRecord oggetto .

CKContainer

Incapsula il contenuto associato a un'app, inclusi i dati privati condivisi e per utente.

CKContainer.Notifications

Notifica inviata dalla CKContainer classe .

CKDatabase

Contiene dati all'interno di un oggetto CKContainer. Un database pubblico CKDatabase fornisce dati condivisi, un database privato contiene i dati dell'utente corrente.

CKDatabaseNotification

Notifica sull'attività del database.

CKDatabaseOperation

Classe astratta per le operazioni su un oggetto CKDatabase.

CKDatabaseSubscription

Una sottoscrizione di database.

CKDiscoverAllContactsOperation

Oggetto CKOperation che recupera gli ID di tutti i contatti individuabili dell'utente dell'app.

CKDiscoverAllUserIdentitiesOperation

Operazione che ottiene tutti gli utenti individuabili nella rubrica del sistema.

CKDiscoveredUserInfo

Informazioni su un utente. Restituito da un oggetto CKDiscoverAllContactsOperation.

CKDiscoverUserIdentitiesOperation

Operazione che trova gli utenti che corrispondono a un criterio.

CKDiscoverUserInfosOperation

Oggetto CKOperation che recupera gli ID degli utenti individuabili i cui indirizzi di posta elettronica o ID record sono già noti allo sviluppatore dell'app.

CKErrorCodeExtensions

Metodi di estensione per l'enumerazione CloudKit.CKErrorCode.

CKErrorFields

Contiene le costanti di errore usate da CloudKit.

CKFetchDatabaseChangesOperation

Operazione che recupera le modifiche apportate al database.

CKFetchNotificationChangesOperation

Oggetto CKOperation che ret.. /.. /summary_set.sh CKFetchNotificationChangesOperation A

CKFetchRecordChangesOperation

Oggetto CKDatabaseOperation che recupera i dati sugli oggetti modificati o eliminati CKRecord .

CKFetchRecordsOperation

Oggetto CKDatabaseOperation che recupera oggetti specifici CKRecord .

CKFetchRecordZoneChangesConfiguration

Lo spazio dei nomi CloudKit consente l'accesso a iCloud.

CKFetchRecordZoneChangesOperation

Lo spazio dei nomi CloudKit consente l'accesso a iCloud.

CKFetchRecordZoneChangesOptions

Contiene opzioni che controllano la modalità di recupero delle modifiche della zona dei record.

CKFetchRecordZonesOperation

Oggetto CKDatabaseOperation che recupera oggetti CKRecordZone da iCloud.

CKFetchShareMetadataOperation

Operazione che recupera i metadati condivisi per più condivisioni.

CKFetchShareParticipantsOperation

Operazione che recupera i partecipanti condivisi per i record condivisi.

CKFetchSubscriptionsOperation

Oggetto CKDatabaseOperation che recupera oggetti CKSubscription da iCloud.

CKFetchWebAuthTokenOperation

Operazione che restituisce un token di autenticazione Web per un token API specificato dal dashboard di CloudKit.

CKLocationSortDescriptor

Ordina i record in base alla distanza dalla posizione specificata.

CKMarkNotificationsReadOperation

Contrassegna le notifiche push come lette. In genere usato dalle app che usano notifiche push per tenere traccia delle modifiche.

CKModifyBadgeOperation

Oggetto CKOperation che modifica la notifica dell'icona dell'app, nel dispositivo corrente o in tutti i dispositivi dell'utente.

CKModifyRecordsOperation

Oggetto CKDatabaseOperation che esegue il commit delle modifiche apportate a uno o più CKRecord oggetti.

CKModifyRecordZonesOperation

Oggetto CKDatabaseOperation che esegue il commit delle modifiche apportate alle zone di record.

CKModifySubscriptionsOperation

Oggetto CKDatabaseOperation che esegue il commit delle modifiche apportate a uno o più CKSubscription oggetti.

CKNotification

Notifica push inviata all'app.

CKNotificationID

Identifica in modo univoco una notifica push inviata da un contenitore.

CKNotificationInfo

Specifica il tipo di notifiche push generate quando viene soddisfatta la condizione del trigger.

CKOperation

Classe base astratta per le operazioni eseguite sul database CloudKit.

CKOperationConfiguration

Configura il comportamento di un'operazione CloudKit.

CKOperationGroup

Rappresenta un gruppo in batch di operazioni CloudKit.

CKQuery

Specifica una query sul database CloudKit.

CKQueryCursor

Contiene il punto di arresto corrente nel set di risultati di un oggetto CKQuery.

CKQueryNotification

Notifica push generata da un CKSubscription oggetto .

CKQueryOperation

Oggetto CKDatabaseOperation che esegue un oggetto CKQuery.

CKQuerySubscription

Consente agli sviluppatori di creare notifiche in base a una query.

CKRecord

Dizionario di coppie di Key-Value che strutturano i dati all'interno di CloudKit.

CKRecordID

Identifica in modo univoco un CKRecord oggetto all'interno di un database.

CKRecordValue

Gli sviluppatori di app non devono sottoclasse questa interfaccia, che fornisce una digitazione avanzata per gli oggetti archiviati in un database CloudKit. I tipi di dati personalizzati non sono supportati.

CKRecordZone

Consente di organizzare gli oggetti correlati CKRecord . Per impostazione predefinita, sia il database privato che quello pubblico hanno una singola zona.

CKRecordZoneID

Identifica in modo univoco un CKRecordZone oggetto all'interno di un database.

CKRecordZoneNotification

Notifica push risultante dalle modifiche all'interno di un oggetto CKRecordZone.

CKRecordZoneSubscription

Una sottoscrizione per registrare le modifiche apportate alla zona.

CKReference

Definisce una relazione 1:M tra CKRecord oggetti all'interno di un singolo CKRecordZoneoggetto .

CKServerChangeToken

Oggetto di sola lettura che identifica una versione di un oggetto CKRecord. Quando si recuperano dati aggiornati, il passaggio del token esistente consente al server di restituire solo le modifiche, aumentando l'efficienza.

CKShare

Rappresenta un record condiviso.

CKShareKeys

Costanti usate da varie classi CloudKit.

CKShareMetadata

Rappresenta i metadati condivisi dei record condivisi.

CKShareParticipant

Contiene i dati per un partecipante alla condivisione.

CKSubscription

Query persistente che tiene traccia delle modifiche nel server. Per informazioni, vedere CKQueryNotification.

CKUserIdentity

Contiene informazioni utilizzate per cercare un utente o un utente.

CKUserIdentityLookupInfo

Contiene dati che possono essere usati per cercare un utente.

Interfacce

ICKRecordValue

Interfaccia che rappresenta i metodi obbligatori (se presenti) del protocollo CKRecordValue.

Enumerazioni

CKAccountStatus

Enumera i valori che indicano se l'account iCloud di un utente è disponibile.

CKApplicationPermissions

Enumera un valore che indica che altri utenti dell'app possono individuare l'utente corrente in base all'indirizzo di posta elettronica.

CKApplicationPermissionStatus

Enumera gli stati che un'applicazione può avere durante il tentativo di ottenere un'autorizzazione.

CKDatabaseScope

Enumera i valori che indicano se un database è privato, condiviso o pubblico.

CKErrorCode

Enumera le condizioni di errore di CloudKit.

CKNotificationType

Enumera gli eventi che possono generare una notifica push.

CKOperationGroupTransferSize

Lo spazio dei nomi CloudKit consente l'accesso a iCloud.

CKQueryNotificationReason

Enumera gli eventi di archiviazione permanente che possono attivare le notifiche del ciclo di vita dei dati.

CKQuerySubscriptionOptions

Enumera l'ora o gli orari in cui viene CKSubscription attivata una notifica.

CKRecordSavePolicy

Enumera i criteri che controllano quando o se deve essere salvato un record.

CKRecordZoneCapabilities

Enumera le operazioni speciali di cui è in grado una zona.

CKReferenceAction

Enumera i valori che controllano se un riferimento deve essere eliminato quando viene eliminato il relativo record di destinazione.

CKShareParticipantAcceptanceStatus

Enumera le risposte per condividere le richieste di partecipazione.

CKShareParticipantPermission

Enumera le autorizzazioni di condivisione utente.

CKShareParticipantRole

Lo spazio dei nomi CloudKit consente l'accesso a iCloud.

CKShareParticipantType

Enumera i tipi di partecipanti di condivisione.

CKSubscriptionOptions

Enumera i flag per controllare il comportamento delle notifiche push per le sottoscrizioni basate su query.

CKSubscriptionType

Enumera i tipi di sottoscrizione.

Delegati

CKAcceptPerShareCompletionHandler

Lo spazio dei nomi CloudKit consente l'accesso a iCloud.

CKDatabaseDeleteSubscriptionHandler

Gestore di completamento per il DeleteSubscription(String, CKDatabaseDeleteSubscriptionHandler) metodo .

CKDiscoverUserInfosCompletionHandler

Gli sviluppatori di applicazioni possono implementare questo delgate e assegnarlo alla proprietà M:CloudKit.CKDiscoverUserInfosOperation.Complete* per elaborare le informazioni utente restituite.

CKFetchDatabaseChangesCompletionHandler

Lo spazio dei nomi CloudKit consente l'accesso a iCloud.

CKFetchPerShareMetadataHandler

Lo spazio dei nomi CloudKit consente l'accesso a iCloud.

CKFetchRecordChangesHandler

Delegato per la AllChangesReported proprietà .

CKFetchRecordsCompletedHandler

Delegato per la Completed proprietà .

CKFetchRecordZoneChangesFetchCompletedHandler

Lo spazio dei nomi CloudKit consente l'accesso a iCloud.

CKFetchRecordZoneChangesTokensUpdatedHandler

Lo spazio dei nomi CloudKit consente l'accesso a iCloud.

CKFetchRecordZoneChangesWithIDWasDeletedHandler

Lo spazio dei nomi CloudKit consente l'accesso a iCloud.

CKFetchSubscriptionsCompleteHandler

Delegato per la Completed proprietà .

CKFetchWebAuthTokenOperationHandler

Lo spazio dei nomi CloudKit consente l'accesso a iCloud.

CKMarkNotificationsReadHandler

Delegato per la Completed proprietà .

CKModifyRecordsOperationHandler

Delegato per la Completed proprietà .

CKModifyRecordZonesHandler

Delegato per la Completed proprietà .

CKModifySubscriptionsHandler

Delegato per la Completed proprietà .

CKRecordZoneCompleteHandler

Delegato per la Completed proprietà .

Commenti

Lo spazio dei nomi CloudKit consente agli sviluppatori di applicazioni di controllare il flusso di dati tra le applicazioni e iCloud. iCloud fornisce l'archiviazione dei dati sul lato server, sia "pubblica" condivisa tra tutte le istanze di un'applicazione o applicazioni specifiche e "private" univoca per un singolo utente. L'archiviazione e il trasporto iCloud vengono crittografati e sincronizzati tra i dispositivi Apple. CloudKit non fornisce la persistenza sul lato client o la memorizzazione nella cache dei dati. La funzionalità CloudKit è disponibile solo se l'utente ha una connessione Internet attiva.

La classe di livello più alto in CloudKit è CKContainer. Un contenitore CloudKit (talvolta indicato nella documentazione apple come "contenitore Ubiquity") è un archivio informazioni identificato con un nome specifico. Apple consiglia di usare un nome del formato "iCloud. {DNS inverso}. {appName}", ad esempio, "iCloud.com.mycompany.MyApp". Gli sviluppatori devono creare e configurare i propri contenitori usando il dashboard iCloud, disponibile tramite il portale per sviluppatori Apple.

Un singolo CKContainer può contenere entrambi i dati pubblici, condivisi tra tutte le istanze dell'app (vedere PublicCloudDatabase) e i dati privati, che contengono dati specifici dell'utente (vedere PrivateCloudDatabase). All'interno di iCloud, i dati pubblici vengono archiviati nell'archiviazione iCloud dell'app mentre i dati privati vengono archiviati nell'archiviazione iCloud privata dell'utente. Il pubblico CKDatabase è disponibile per tutti gli utenti connessi dell'app, indipendentemente dal fatto che siano connessi a iCloud. Il privato CKDatabase è solo se l'utente ha effettuato l'accesso a iCloud. Gli sviluppatori devono scrivere il codice in modo che reagisca normalmente alle modifiche apportate allo stato di accesso o connessione dell'utente.

Questi oggetti pubblici e privati CKDatabase archiviano record strutturati. Questi oggetti sono rappresentati da CKRecord oggetti . Oltre ai dati chiave-valore simili al campo, questi record possono contenere CKAsset oggetti di grandi dimensioni direttamente (recuperati con l'oggetto contenente CKRecord) o come riferimenti (consentendo il recupero differita dei dati di grandi dimensioni).

Tutte le CKRecord istanze vengono archiviate all'interno di un oggetto CKRecordZone. Un CKRecordZone oggetto è simile a un'istanza di database tradizionale: può contenere più CKRecord archivi che possono fare riferimento l'uno all'altro, ma non archiviare in altre CKRecordZone istanze e CKRecordZone oggetti possono essere usati per coordinare le operazioni atomiche tra più CKRecord archivi. La somiglianza con un'istanza di database non è universale; Ad esempio, uno sviluppatore può usare M:CKDatabase.FetchRecordAsync(CKRecordID) per recuperare un oggetto CKRecord direttamente da CKDatabase senza fare riferimento alla zona. Il valore predefinito CKRecordZone è disponibile tramite P:CloudKit.CKRecordZone.DefaultRecordZone(). Gli sviluppatori possono creare zone aggiuntive usando il dashboard di CloudKit e usarle per partizionare i dati in modo logico.

Le app CloudKit richiedono un profilo di provisioning con il com.apple.developer.icloud-services diritto e un identificatore bundle specifico dell'app,ad esempio "com.mycompany.CloudKitApp". Gli sviluppatori devono creare e configurare un profilo di provisioning di questo tipo.

Di seguito vengono illustrati alcuni usi tipici di CloudKit che funzionano su singoli record:

//Create 
private async Task<CKRecord> StoreInCloudKit (string name, CLLocation loc, int stationId)
{
    string containerName = "iCloud.com.xamarin.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.xamarin.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.xamarin.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;
}