amplify flutter

Memperkuat flutter

AWS Amplify menyediakan antarmuka deklaratif dan mudah digunakan di berbagai kategori operasi cloud. Implementasi default kami berfungsi dengan Amazon Web Services (AWS), tetapi AWS Amplify dirancang untuk terbuka dan dapat dicolokkan untuk setiap backend atau layanan khusus. Lihat AWS Amplify untuk perincian lebih lanjut tentang kerangka kerja Amplify.

Kami berulang dan mencari umpan balik dan kolaborasi, jadi beri tahu kami umpan balik Anda tentang arah dan peta jalan kami.

Memulai Panduan

️ Amplify Flutter V1 sekarang dalam mode pemeliharaan hingga 30 April 2025. Ini berarti bahwa kami akan terus memasukkan pembaruan untuk memastikan kompatibilitas dengan layanan backend dan keamanan. Tidak ada fitur baru yang akan diperkenalkan di V1.

Silakan gunakan versi terbaru (v2) dari Amplify Flutter. Jika Anda saat ini menggunakan V1, ikuti instruksi ini untuk meningkatkan ke V2.

Pustaka Amplify yang Didukung

Perpustakaan	Paket pub.dev	Keterangan
Otentikasi		API dan blok bangunan untuk pengembang yang ingin membuat pengalaman otentikasi pengguna dengan Amazon Cognito.
Analitik		Dengan mudah mengumpulkan data analitik untuk aplikasi Anda dengan Pinpoint. Data analitik mencakup sesi pengguna dan acara khusus lainnya yang ingin Anda lacak di aplikasi Anda.
Penyimpanan		Memberikan mekanisme sederhana untuk mengelola konten pengguna untuk aplikasi Anda di bucket penyimpanan publik, terlindungi atau pribadi dengan Amazon S3.
Datastore		Model pemrograman untuk memanfaatkan data bersama dan didistribusikan tanpa menulis kode tambahan untuk skenario offline dan online, yang membuat bekerja dengan data yang terdistribusi dan silang sesederhana bekerja dengan data khusus lokal.
API (istirahat)		Memberikan solusi sederhana saat membuat permintaan HTTP. Ini menyediakan proses penandatanganan otomatis dan ringan yang sesuai dengan AWS Signature Version 4.
API (GraphQL)		Berinteraksi dengan API GraphQL Server atau AWS AppSync Anda dengan klien GraphQL yang mudah digunakan & dikonfigurasi.
Pemberitahuan		Trigger Push Pemberitahuan ke Aplikasi Anda dan Catat Metrik di Pinpoint Ketika pengguna menerima atau membuka pemberitahuan.
Authenticator		Amplify Flutter Authenticator menyederhanakan proses autentikasi pengguna dengan memberikan aliran yang sepenuhnya dapat disesuaikan yang hanya berfungsi. Cukup bungkus rute yang terotentikasi aplikasi Anda dalam komponen authenticator dan proses autentikasi pengguna dan mengelola sesi login ditangani untuk Anda.

Versi semantik

Kami mengikuti versi semantik untuk rilis kami.

Kasus versi semantik dan enumerasi

Saat Amplify menambahkan entri enumerasi baru atau subtipe kelas tertutup, kami akan menerbitkan versi minor baru perpustakaan.

Aplikasi yang menggunakan pernyataan switch untuk mengevaluasi semua anggota jenis yang disebutkan dapat menambahkan klausa default untuk mencegah kasus baru menyebabkan peringatan atau kesalahan kompilasi.

Pembaruan versi semantik dan dependensi

Kami mengikuti versi semantik untuk memperbarui dependensi kami. Ini termasuk memperbarui versi Dart dan Flutter SDK.

Dukungan Kategori / Platform

Kategori	Android	iOS	Web	Windows	MacOS	Linux
Analitik	✅	✅	✅	✅	✅	✅
API (istirahat)	✅	✅	✅	✅	✅	✅
API (GraphQL)	✅	✅	✅	✅	✅	✅
Otentikasi	✅	✅	✅	✅	✅	✅
Datastore	✅	✅	?	?	?	?
Penyimpanan	✅	✅	✅	✅	✅	✅
Pemberitahuan	✅	✅	?	?	?	?

Dokumentasi

• Memulai dengan amplify flutter
• Memperkuat kerangka kerja
• Instal CLI Amplify
• Berkontribusi untuk memperkuat flutter

Panduan Pengembangan Flutter

Amplify for Flutter adalah proyek open-source dan menyambut kontribusi dari komunitas Flutter, lihat Kontribusi.

Prasyarat

• Berdebar
• Memperkuat CLI

Memulai Amplify Flutter

1. Buka proyek Flutter Anda. Jika Anda tidak memiliki proyek flutter aktif, Anda dapat membuatnya setelah menginstal perkakas pengembangan flutter dan menjalankan flutter create <project-name> di terminal Anda.

2. Menggunakan CLI Amplify, jalankan amplify init dari akar proyek Anda:

Jika Anda belum mengonfigurasi CLI Amplify, lihat dokumentasi kami di Instalasi Amplify CLI.

== > amplify init
Note: It is recommended to run this command from the root of your app directory
? Enter a name for the project < project-name >
The following configuration will be applied:

Project information
| Name: < project-name >
| Environment: dev
| Default editor: Visual Studio Code
| App type: flutter
| Configuration file location: ./lib/

? Initialize the project with the above configuration ? Yes
Using default provider  awscloudformation
? Select the authentication method you want to use: AWS profile

For more information on AWS Profiles, see:
https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html

? Please choose the profile you want to use default

4. Tambahkan Kategori Amplify (pilih default untuk contoh ini):

   $ amplify add auth  # Choose default configuration after entering this command in your terminal.

5. Dorong perubahan ke cloud untuk menyediakan sumber daya backend:

   $ amplify push

6. Dalam file pubspec.yaml Anda, tambahkan yang berikut ini ke dependencies :

Catatan: Jangan termasuk dependensi dalam file pubspec Anda yang tidak Anda gunakan di aplikasi Anda. Ini dapat menyebabkan kesalahan konfigurasi di SDK yang mendasarinya.

 dependencies :
  amplify_auth_cognito : ^2.0.0
  amplify_authenticator : ^2.0.0
  amplify_flutter : ^2.0.0
  flutter :
    sdk : flutter

7. Dari Terminal Run

flutter pub get

8. Di file Main.dart Anda, tambahkan:

 import 'package:amplify_auth_cognito/amplify_auth_cognito.dart' ;
import 'package:amplify_authenticator/amplify_authenticator.dart' ;
import 'package:amplify_flutter/amplify_flutter.dart' ;
import 'package:flutter/material.dart' ;

import 'amplifyconfiguration.dart' ;

void main () {
  runApp ( const MyApp ());
}

class MyApp extends StatefulWidget {
  const MyApp ({ super .key});

  @override
  State < MyApp > createState () => _MyAppState ();
}

class _MyAppState extends State < MyApp > {
  @override
  void initState () {
    super . initState ();
    _configureAmplify ();
  }

  Future < void > _configureAmplify () async {
    try {
      await Amplify . addPlugin ( AmplifyAuthCognito ());
      await Amplify . configure (amplifyconfig);
      safePrint ( 'Successfully configured' );
    } on Exception catch (e) {
      safePrint ( 'Error configuring Amplify: $ e ' );
    }
  }

  @override
  Widget build ( BuildContext context) {
    return Authenticator (
      child : MaterialApp (
        builder : Authenticator . builder (),
        home : const Scaffold (
          body : Center (
            child : Text ( 'You are logged in!' ),
          ),
        ),
      ),
    );
  }
}

9. Karena Amplify Flutter mendukung 6 platform dengan flutter termasuk iOS, android, web, dan desktop, beberapa konfigurasi tambahan mungkin diperlukan untuk setiap platform. Lihatlah Panduan Pengaturan Platform untuk memastikan Anda telah menyelesaikan langkah -langkah yang diperlukan.

10. Jalankan flutter run untuk meluncurkan aplikasi Anda di perangkat yang terhubung.

11. Setelah aplikasi dimuat, ketuk Configure Amplify , lalu pada acara Record beberapa kali.

12. Untuk melihat peristiwa yang Anda kembalikan, jalankan amplify console analytics . Ini akan membuka konsol Amazon Pinpoint untuk proyek Anda di browser web default Anda. Dalam waktu sekitar satu menit Anda harus mulai melihat peristiwa yang populasi di bagian acara kemudian Pinpoint Console.

Selamat, Anda telah membangun aplikasi Amplify pertama Anda! ?

Untuk dokumentasi lebih lanjut dan memperkuat penggunaan kategori, lihat dokumentasi.

---

Flutter dan logo terkait adalah merek dagang dari Google LLC. Kami tidak didukung oleh atau berafiliasi dengan Google LLC.