Das AWS Mobile SDK für Xamarin ist jetzt in der enthalten. AWS SDK für .NET Dieses Handbuch bezieht sich auf die archivierte Version des Mobile SDK für Xamarin.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Synchronisieren von Benutzerdaten mit Cognito Sync

Mit Amazon Cognito Sync können Sie mobile Benutzerdaten (wie App-Benutzereinstellungen oder Spielstände) einfach in der AWS Cloud speichern, ohne dafür Backend-Code zu schreiben oder eine Infrastruktur zu verwalten. Sie können Daten lokal auf den Geräten der Benutzer speichern. So funktionieren Ihre Anwendungen auch dann, wenn die Geräte offline sind. Außerdem können Sie die Daten über die Geräte eines Benutzers synchronisieren und ein konsistentes App-Erlebnis schaffen – unabhängig vom verwendeten Gerät.

Das Tutorial unten erläutert, wie Sync in die App integriert werden kann.

Projekteinrichtung

Voraussetzungen

Befolgen Sie alle Anweisungen unter Einrichten von AWS Mobile SDK for .NET and Xamarin, bevor Sie mit diesem Tutorial beginnen.

Gewähren des Zugriffs auf Cognito Sync-Ressourcen

Die Standardrichtlinie, die den im Rahmen der Einrichtung erstellten Rollen für nicht authentifizierte und authentifizierte Benutzer zugeordnet ist, gewährt der Anwendung Zugriff auf Cognito Sync. Weitere Konfigurationseinstellungen sind nicht erforderlich.

NuGet Package für Cognito Sync zu Ihrem Projekt hinzufügen

Folgen Sie Schritt 4 der Anweisungen unter Einrichten des AWS Mobile SDK for .NET and Xamarin, um das SyncManager NuGet Cognito-Paket zu Ihrem Projekt hinzuzufügen.

Initialisieren Sie das CognitoSyncManager

Übergeben Sie den initialisierten Amazon Cognito-Anmeldeinformationsanbieter an den CognitoSyncManager-Konstruktor:

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

Synchronisieren von Benutzerdaten

Synchronisieren Sie die Daten nicht authentifizierter Benutzer wie folgt:

Erstellen eines Dataset

Erstellen Sie eine Instance von Dataset. Die openOrCreate Dataset-Methode wird verwendet, um einen neuen Datensatz zu erstellen oder eine bestehende Instanz eines lokal auf dem Gerät gespeicherten Datensatzes zu öffnen:

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

Hinzufügen von Benutzerdaten zum Dataset

Benutzerdaten werden in Form von key/value Paaren hinzugefügt:

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

Cognito-Datasets fungieren als Wörterbücher, auf deren Werte mit einem Schlüssel zugegriffen werden kann:

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

Synchronisieren von Datasets

Rufen Sie zum Synchronisieren eines Dataset die Synchronisierungsmethode auf:

dataset.SynchronizeAsync();

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

Alle in Datasets geschriebenen Daten werden lokal gespeichert, bis das Dataset synchronisiert wird. Beim Code in diesem Abschnitt ist unterstellt, dass Sie eine nicht authentifizierte Cognito-Identität verwenden, damit die mit der Cloud synchronisierten Benutzerdaten auf jedem Gerät gespeichert werden. Dem Gerät ist eine Geräte-ID zugeordnet. Wenn die Benutzerdaten in die Cloud synchronisiert werden, werden sie mit dieser Geräte-ID verknüpft.

Weitere Informationen zu Cognito Sync erhalten Sie unter Amazon Cognito Sync.