Le SDKAWS mobile pour Xamarin est désormais inclus dans leAWS SDK for .NET. Ce guide fait référence à la version archivée du SDK mobile pour Xamarin.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Synchroniser les données utilisateur avec Cognito Sync

Avec Amazon Cognito Sync, vous pouvez enregistrer facilement dans le cloud AWS les données relatives aux utilisateurs mobiles, telles que les préférences d'une application ou le statut d'un jeu, sans avoir à écrire un code en backend ni à gérer d'infrastructure. Les données peuvent être enregistrées en local sur les périphériques des utilisateurs, afin de permettre aux applications de fonctionner même lorsque ces appareils sont hors ligne. Vous pouvez aussi synchroniser ces données sur les différents périphériques d'un utilisateur pour lui offrir une expérience homogène, quel que soit l'appareil utilisé.

Le didacticiel ci-dessous explique comment intégrer le service Sync à votre application.

Configuration du projet

Prérequis

Avant de commencer ce didacticiel, vous devez suivre toutes les instructions de la section Configurer un kit SDK AWS Mobile pour .NET et Xamarin.

Accorder l'accès à vos ressources Cognito Sync

La stratégie par défaut associée aux rôles non authentifiés et authentifiés que vous avez créés au cours de l'installation accordent à votre application un droit d'accès à Cognito Sync. Aucune autre configuration n'est requise.

AdditionNuGetPackage pour Cognito Sync pour votre projet

Suivez l'étape 4 des instructions deConfigurer le kit SDK AWS Mobile pour .NET et Xamarinpour ajouter le CognitoSyncManager NuGetpour votre projet.

Initialisez leCognitoSyncmanager

Communiquez votre fournisseur d'informations d'identification Amazon Cognito initialisé au constructeur CognitoSyncManager :

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

Synchronisation des données utilisateur

Pour synchroniser les données utilisateur non authentifiées :

Créer un ensemble de données

Créez une instance de Dataset. LeopenOrCreateLa méthode dataset est utilisée pour créer un nouvel ensemble de données ou pour ouvrir une instance d'un ensemble de données stocké localement sur l'appareil :

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

Ajouter des données utilisateur à l'ensemble de données

Les données utilisateur sont ajoutées sous la forme de paires clé/valeur :

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

Les ensembles de données Cognito fonctionnent comme des dictionnaires, avec des valeurs accessibles par clé :

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

Synchroniser l'ensemble de données

Pour synchroniser un ensemble de données, appelez sa méthode synchronize :

dataset.SynchronizeAsync();

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

Toutes les données écrites dans des ensembles de données sont stockées localement jusqu'à ce que l'ensemble de données ait été synchronisé. Le code de cette section suppose que vous utilisez une identité Cognito non authentifiée. Ainsi, lorsque les données utilisateur sont synchronisées avec le cloud, elles sont stockées par appareil. L'appareil est associé à un ID. Lorsque les données utilisateur sont synchronisées sur le cloud, elles sont associées à cet ID d'appareil.

Pour plus d'informations sur Cognito Sync, consultez la page Amazon Cognito Sync.