Siapkan contoh aplikasi Android dengan Flutter - Amazon Cognito
Membuat aplikasi

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

Siapkan contoh aplikasi Android dengan Flutter

Dalam tutorial ini, Anda akan membuat aplikasi seluler di Android Studio tempat Anda dapat meniru perangkat dan menguji pendaftaran, konfirmasi, dan masuk pengguna. Aplikasi contoh ini membuat klien seluler kumpulan pengguna Amazon Cognito dasar untuk Android di Flutter. Jika Anda sudah berpengalaman dalam pengembangan aplikasi seluler dengan Flutter, unduh aplikasi contoh dari GitHub.

Tangkapan layar berikut menunjukkan aplikasi yang berjalan di perangkat Android virtual.

Tangkapan layar halaman pendaftaran untuk aplikasi contoh Android tervirtualisasi.

Prosedur Create a user pool menyiapkan Anda dengan kumpulan pengguna yang bekerja dengan aplikasi contoh. Anda dapat melewati langkah ini jika Anda memiliki kumpulan pengguna yang memenuhi persyaratan berikut:

  • Pengguna dapat masuk dengan alamat email mereka. Opsi masuk kumpulan pengguna Cognito: Email.

  • Nama pengguna tidak peka huruf besar/kecil. Persyaratan nama pengguna: Membuat nama pengguna sensitif huruf besar/kecil tidak dipilih.

  • Otentikasi multi-faktor (MFA) tidak diperlukan. Penegakan MFA: MFA opsional.

  • Kumpulan pengguna Anda memverifikasi atribut untuk konfirmasi profil pengguna dengan pesan email. Atribut untuk memverifikasi: Kirim pesan email, verifikasi alamat email.

  • Email adalah satu-satunya atribut yang diperlukan. Atribut yang diperlukan: email.

  • Pengguna dapat mendaftar sendiri di kumpulan pengguna Anda. Registrasi mandiri: Aktifkan pendaftaran mandiri dipilih.

  • Klien aplikasi awal Anda adalah klien publik yang mengizinkan login dengan nama pengguna dan kata sandi. Jenis aplikasi: Klien publik, Alur otentikasi:ALLOW_USER_PASSWORD_AUTH.

Buat kumpulan pengguna baru

  1. Masuk ke Konsol Amazon Cognito. Jika diminta, masukkan AWS kredensional Anda.

  2. Pilih tombol Buat kumpulan pengguna. Anda mungkin diminta untuk memilih Kumpulan Pengguna dari panel navigasi kiri untuk menampilkan opsi ini.

  3. Di sudut kanan atas halaman, pilih Buat kumpulan pengguna untuk memulai panduan pembuatan kumpulan pengguna.

  4. Di Mengonfigurasi pengalaman masuk, Anda dapat memilih penyedia identitas (IdPs) yang akan Anda gunakan dengan kumpulan pengguna ini. Untuk informasi selengkapnya, lihat Menambahkan login kumpulan pengguna melalui pihak ketiga.

    1. Di bawah Penyedia otentikasi, untuk jenis Penyedia, pastikan bahwa hanya kumpulan pengguna Cognito yang dipilih.

    2. Untuk opsi masuk kumpulan pengguna Cognito, pilih Nama pengguna. Jangan memilih persyaratan nama pengguna tambahan.

    3. Simpan semua opsi lain sebagai default dan pilih Berikutnya.

  5. Di Konfigurasi persyaratan keamanan, Anda dapat memilih kebijakan kata sandi, persyaratan otentikasi multi-faktor (MFA), dan opsi pemulihan akun pengguna. Untuk informasi selengkapnya, lihat Menggunakan fitur keamanan kumpulan pengguna Amazon Cognito.

    1. Untuk kebijakan Kata Sandi, konfirmasikan bahwa mode kebijakan Kata Sandi disetel ke default Cognito.

    2. Di bawah otentikasi multi-faktor, untuk penegakan MFA, pilih MFA opsional.

    3. Untuk metode MFA, pilih Aplikasi Authenticator dan pesan SMS.

    4. Untuk pemulihan akun Pengguna, konfirmasikan bahwa Aktifkan pemulihan akun swalayan dipilih, dan bahwa metode pengiriman pesan pemulihan akun pengguna disetel ke Email saja.

    5. Simpan semua opsi lain sebagai default dan pilih Berikutnya.

  6. Di Mengonfigurasi pengalaman pendaftaran, Anda dapat menentukan bagaimana pengguna baru akan memverifikasi identitas mereka saat mendaftar sebagai pengguna baru, dan atribut mana yang harus diperlukan atau opsional selama alur pendaftaran pengguna. Untuk informasi selengkapnya, lihat Mengelola pengguna di kumpulan pengguna Anda.

    1. Konfirmasikan bahwa Aktifkan pendaftaran mandiri dipilih. Pengaturan ini membuka kumpulan pengguna Anda untuk mendaftar dari siapa pun di internet. Ini dimaksudkan untuk keperluan aplikasi contoh, tetapi terapkan pengaturan ini dengan hati-hati di lingkungan produksi.

    2. Di bawah Verifikasi dan konfirmasi yang dibantu Cognito, verifikasi bahwa kotak centang Izinkan Cognito mengirim pesan secara otomatis untuk memverifikasi dan mengonfirmasi dipilih.

    3. Konfirmasikan bahwa Atribut yang akan diverifikasi diatur ke Kirim pesan email, verifikasi alamat email.

    4. Di bawah Memverifikasi perubahan atribut, konfirmasikan bahwa opsi default dipilih: Simpan nilai atribut asli saat pembaruan tertunda dipilih, dan Nilai atribut Aktif saat pembaruan tertunda disetel ke Alamat email.

    5. Di bawah atribut Diperlukan, konfirmasikan bahwa atribut Diperlukan berdasarkan pilihan sebelumnya menampilkan email.

      penting

      Untuk contoh aplikasi ini, kumpulan pengguna Anda tidak boleh menetapkan phone_number sebagai atribut wajib. Jika phone_number ditampilkan sebagai atribut wajib, tinjau dan perbarui pilihan Anda sebelumnya:

      • MFA opsional, Email hanya untuk metode Pengiriman untuk pesan pemulihan akun pengguna

      • Kirim pesan email, verifikasi alamat email untuk Atribut untuk memverifikasi

    6. Simpan semua opsi lain sebagai default dan pilih Berikutnya.

  7. Di Konfigurasi pengiriman pesan, Anda dapat mengonfigurasi integrasi dengan Amazon Simple Email Service dan Amazon Simple Notification Service untuk mengirim email dan pesan SMS ke pengguna Anda untuk pendaftaran, konfirmasi akun, MFA, dan pemulihan akun. Untuk informasi selengkapnya, lihat Pengaturan email untuk kumpulan pengguna Amazon Cognito dan SMSpengaturan pesan untuk kumpulan pengguna Amazon Cognito.

    1. Untuk penyedia Email, pilih Kirim email dengan Cognito, dan gunakan pengirim email default yang disediakan oleh Amazon Cognito. Pengaturan untuk volume email rendah ini cukup untuk pengujian aplikasi. Anda dapat kembali setelah memverifikasi alamat email dengan Amazon Simple Email Service (Amazon SES) dan memilih Kirim email dengan Amazon SES.

    2. Untuk SMS, pilih Buat peran IAM baru dan masukkan nama peran IAM. Ini menciptakan peran yang memberikan izin ke Amazon Cognito untuk mengirim pesan SMS.

    3. Simpan semua opsi lain sebagai default dan pilih Berikutnya.

  8. Di Integrasikan aplikasi, Anda dapat memberi nama kumpulan pengguna, mengonfigurasi UI yang dihosting, dan membuat klien aplikasi. Untuk informasi selengkapnya, lihat Tambahkan klien aplikasi dengan UI yang dihosting. Contoh aplikasi tidak menggunakan UI yang dihosting.

    1. Di bawah Nama kumpulan pengguna, masukkan nama kumpulan Pengguna.

    2. Jangan pilih Gunakan UI yang dihosting Cognito.

    3. Di bawah Klien aplikasi awal, konfirmasikan bahwa jenis Aplikasi disetel ke Klien publik.

    4. Di bawah rahasia Klien, konfirmasikan bahwa Jangan buat rahasia klien dipilih.

    5. Masukkan nama klien App.

    6. Perluas pengaturan klien aplikasi lanjutan. Tambahkan ALLOW_USER_PASSWORD_AUTH ke daftar alur Otentikasi.

    7. Simpan semua opsi lain sebagai default dan pilih Berikutnya.

  9. Tinjau pilihan Anda di Tinjau dan buat layar dan ubah pilihan apa pun sesuai kebutuhan. Jika Anda puas dengan konfigurasi kumpulan pengguna, pilih Buat kumpulan pengguna untuk melanjutkan.

  10. Dari halaman kumpulan Pengguna, pilih kumpulan pengguna baru Anda.

  11. Di bawah ikhtisar kumpulan pengguna, catat ID kumpulan Pengguna Anda. Anda akan memberikan string ini ketika Anda membuat aplikasi contoh Anda.

  12. Pilih tab Integrasi aplikasi dan temukan bagian Klien aplikasi dan analitik. Pilih klien aplikasi baru Anda. Catat ID Klien Anda.

Membuat aplikasi

Untuk membuat contoh aplikasi Android

  1. Instal Android studio dan alat baris perintah.

  2. Di Android Studio, instal plugin Flutter.

  3. Buat project Android Studio baru dari isi cognito_flutter_mobile_app direktori di aplikasi contoh ini.

    1. Edit assets/config.json <<YOUR USER POOL ID>> dan ganti dan << YOUR CLIENT ID>> dengan ID kumpulan pengguna dan klien aplikasi yang Anda buat sebelumnya.

  4. Instal Flutter.

    1. Tambahkan Flutter ke variabel PATH Anda.

    2. Terima lisensi dengan perintah berikut.

      flutter doctor --android-licenses

    3. Verifikasi lingkungan Flutter Anda dan instal komponen yang hilang.

      flutter doctor

      1. Jika ada komponen yang hilang, jalankan flutter doctor -v untuk mempelajari cara memperbaiki masalah.

    4. Ubah ke direktori proyek Flutter baru Anda dan instal dependensi.

      1. Jalankan flutter pub add amazon_cognito_identity_dart_2.

    5. Jalankan flutter pub add flutter_secure_storage.

  5. Buat perangkat Android virtual.

    1. Di GUI studio Android, buat perangkat baru dengan pengelola perangkat.

    2. Di CLI, jalankan. flutter emulators --create --name android-device

  6. Luncurkan perangkat Android virtual Anda.

    1. Di Android Studio GUI, pilih ikon mulai di sebelah perangkat virtual Anda.

    2. Di CLI, jalankan. flutter emulators --launch android-device

  7. Luncurkan aplikasi Anda di perangkat virtual Anda.

    1. Di GUI Android Studio, pilih ikon deploy .

    2. Di CLI, jalankan. flutter run

  8. Arahkan ke perangkat virtual yang sedang berjalan di Android Studio.

  9. Daftarkan pengguna baru dengan alamat email yang valid.

  10. Ambil kode konfirmasi dari pesan email Anda. Masukkan kode konfirmasi ke dalam aplikasi.

  11. Masuk dengan nama pengguna dan kata sandi Anda.