L'SDKAWS Mobile per Xamarin è ora incluso inAWS SDK for .NET. Questa guida fa riferimento alla versione archiviata di Mobile SDK per Xamarin.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Sincronizza dati utente con Cognito Sync

Amazon Cognito Sync agevola il salvataggio di dati utente dei dispositivi mobili, come preferenze delle app o stato dei giochi nel cloud AWS senza scrivere codice di back-end o gestire infrastrutture. Puoi salvare i dati localmente sui dispositivi degli utenti, affinché le applicazioni funzionino anche se i dispositivi sono offline. L'utente potrà inoltre sincronizzare i dati tra i diversi dispositivi, in modo da mantenere la stessa esperienza sull'applicazione, indipendentemente dal tipo di dispositivo utilizzato.

Il tutorial che segue illustra come integrare Synchronics con l'app.

Configurazione progetto

Prerequisiti

È necessario seguire le istruzioni riportate alConfigurazione dell'SDK AWS Mobile per.NET e Xamarinprima di iniziare questo tutorial.

Concedere l'accesso alle risorse di Cognito Sync

I criteri predefiniti associati ai ruoli non autenticati e autenticati creati durante l'installazione garantiscono all'applicazione l'accesso a Cognito Sync. Non è richiesta alcuna configurazione aggiuntiva.

InserisciNuGetPacchetto per Cognito Sync al tuo progetto

Seguire il passaggio 4 delle istruzioni riportate inConfigurazione dell'SDK AWS Mobile per.NET e Xamarinper aggiungere il CognitoSyncManager NuGetpacchetto per il progetto.

InizializzazioneCognitoSyncManager

Bisogna passare il provider di credenziali Amazon Cognito inizializzato al costruttore CognitoSyncManager:

CognitoSyncManager syncManager = new CognitoSyncManager (
    credentials,
    new AmazonCognitoSyncConfig {
        RegionEndpoint = RegionEndpoint.USEast1 // Region
    }
);

Sincronizzazione dei dati utente

Per sincronizzare i dati utente non autenticati:

Creare un set di dati

Creare un'istanza di Dataset. LaopenOrCreateIl metodo del set di dati viene utilizzato per creare un nuovo set di dati o aprire un'istanza esistente di un set di dati memorizzato localmente sul dispositivo:

Dataset dataset = syncManager.OpenOrCreateDataset("myDataset");

Aggiunta di dati utente al set di dati

I dati utente vengono aggiunti sotto forma di coppie chiave/valore:

dataset.OnSyncSuccess += SyncSuccessCallback;
dataset.Put("myKey", "myValue");

Funzione di set di dati di Cognito come dizionari, con i valori accessibili tramite chiave:

string myValue = dataset.Get("myKey");

Sincronizzazione set di dati

Per sincronizzare il set di dati, chiama il suo metodo di sincronizzazione:

dataset.SynchronizeAsync();

void SyncSuccessCallback(object sender, SyncSuccessEventArgs e) {
  // Your handler code here
}

Tutti i dati scritti sui set di dati verranno memorizzati localmente fino alla sincronizzazione del set di dati. Il codice in questa sezione presuppone che tu stia utilizzando un'identità Cognito non autenticata, quindi quando i dati dell'utente vengono sincronizzati con il cloud verranno memorizzati per dispositivo. Al dispositivo è associato un ID dispositivo. Quando i dati utente vengono sincronizzati con il cloud, verranno associati all'ID del dispositivo.

Per ulteriori informazioni su Cognito Sync, vediAmazon Cognito Sync.