AWS Mobile SDK for Xamarin sekarang disertakan dalam AWS SDK for .NET. Panduan ini menjadi referensi versi yang diarsipkan dari Mobile SDK for Xamarin.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Sinkronkan Data Pengguna dengan Cognito Sync

Amazon Cognito Sync memudahkan kita untuk menyimpan data pengguna seluler, seperti preferensi aplikasi atau status game di AWS Cloud tanpa harus menulis kode backend atau mengelola infrastruktur apa pun. Anda dapat menyimpan data secara lokal di perangkat pengguna yang memungkinkan aplikasi Anda bekerja bahkan saat perangkat tersebut sedang offline. Anda juga dapat menyinkronkan data di seluruh perangkat pengguna sehingga pengalaman aplikasi mereka akan selalu konsisten terlepas dari perangkat yang mereka gunakan.

Tutorial di bawah ini menjelaskan cara mengintegrasikan Sync dengan aplikasi Anda.

Penyiapan Proyek

Prasyarat

Anda harus menyelesaikan semua instruksi yang ada di Menyiapkan AWS Mobile SDK for .NET and Xamarin sebelum memulai tutorial ini.

Memberikan Akses ke Sumber Daya Cognito Sync Anda

Kebijakan default yang terkait dengan peran yang tidak di-autentikasi dan yang di-autentikasi yang Anda buat selama penyiapan memberikan aplikasi Anda akses ke Cognito Sync. Tidak diperlukan konfigurasi lebih lanjut.

TambahkanNuGetPaket Cognito Sync ke Proyek Anda

Ikuti Langkah 4 dari petunjuk diMenyiapkan AWS Mobile SDK for .NET and Xamarinuntuk menambahkan CognitoSyncManager NuGetpaket untuk proyek Anda.

InisialisasiCognitoSyncpengelola

Berikan penyedia kredensial Amazon Cognito Anda yang telah di-inisialisasi ke konstruktor CognitoSyncManager:

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

Menyinkronkan Data pengguna

Untuk menyinkronkan data pengguna yang tidak diautentikasi:

Membuat Set Data

Buat instans Dataset. ParameteropenOrCreateMetode set data digunakan untuk membuat set data baru atau membuka instans yang ada dari set data yang disimpan secara lokal pada perangkat:

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

Menambahkan Data Pengguna ke Set Data

Data pengguna ditambahkan dalam bentuk pasangan kunci/nilai:

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

Set data Cognito berfungsi sebagai kamus, dengan nilai yang dapat diakses oleh kunci:

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

Sinkronisasi Set Data

Untuk menyinkronkan set data, panggil metode sinkronisasi-nya:

dataset.SynchronizeAsync();

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

Semua data yang ditulis ke set data akan disimpan secara lokal hingga set data disinkronkan. Kode yang ada di bagian ini mengasumsikan Anda menggunakan identitas Cognito yang tidak diautentikasi, sehingga ketika data pengguna disinkronkan dengan cloud, kode tersebut akan disimpan per perangkat. Perangkat ini memiliki ID perangkat yang terkait dengannya. Ketika data pengguna disinkronkan ke cloud, data tersebut akan dikaitkan dengan ID perangkat tersebut.

Untuk informasi selengkapnya tentang Cognito Sync, lihat Amazon Cognito Sync.