amplify flutter

Amplifier le battement

AWS Amplify fournit une interface déclarative et facile à utiliser entre différentes catégories d'opérations cloud. Notre implémentation par défaut fonctionne avec Amazon Web Services (AWS), mais AWS Amplify est conçu pour être ouvert et enfichable pour tout backend ou service personnalisé. Voir AWS Amplify pour plus de détails sur le cadre Amplify.

Nous itérons et recherchons des commentaires et de la collaboration, alors faites- nous part de vos commentaires sur notre direction et notre feuille de route.

Guide de démarrage

️ Amplify Flutter V1 est maintenant en mode de maintenance jusqu'au 30 avril 2025. Cela signifie que nous continuerons d'inclure des mises à jour pour assurer la compatibilité avec les services backend et la sécurité. Aucune nouvelle fonctionnalité ne sera introduite dans V1.

Veuillez utiliser la dernière version (v2) d'Amplify Flutter. Si vous utilisez actuellement V1, suivez ces instructions pour passer à V2.

Bibliothèques Amplify

Bibliothèque	package pub.dev	Description
Authentification		API et blocs de construction pour les développeurs qui souhaitent créer des expériences d'authentification des utilisateurs avec Amazon Cognito.
Analytique		Collectez facilement les données d'analyse pour votre application avec PINPOINT. Les données d'analyse incluent des séances utilisateur et d'autres événements personnalisés que vous souhaitez suivre dans votre application.
Stockage		Fournit un mécanisme simple pour gérer le contenu des utilisateurs pour votre application dans des seaux de stockage publics, protégés ou privés avec Amazon S3.
Banc de données		Un modèle de programmation pour tirer parti des données partagées et distribuées sans écrire de code supplémentaire pour les scénarios hors ligne et en ligne, ce qui facilite le travail avec des données réparties et transversales aussi simples que de travailler avec des données locales uniquement.
API (REST)		Fournit une solution simple lors de la création de demandes HTTP. Il fournit un processus de signature automatique et léger qui est conforme à la version 4 de la signature AWS.
API (GraphQL)		Interagissez avec votre API GraphQL Server ou AWS AppSync avec un client GraphQL facile à utiliser et configuré.
Notifications		Déclenchez les notifications push à votre application et enregistrez des mesures dans PINPPOINT lorsque les utilisateurs reçoivent ou ouvrent des notifications.
Authentificateur		L'Amplify Flutter Authenticator simplifie le processus d'authentification des utilisateurs en fournissant un flux entièrement personnalisable qui fonctionne simplement. Enveloppez simplement l'itinéraire authentifié de votre application dans un composant Authenticator et le processus d'authentification des utilisateurs et de gestion des sessions de connexion est géré pour vous.

Version sémantique

Nous suivons le versioning sémantique pour nos sorties.

Cas de version sémantique et d'énumération

Lorsque Amplify ajoute une nouvelle entrée d'énumération ou un sous-type de classe scellée, nous publierons une nouvelle version mineure de la bibliothèque.

Les applications qui utilisent une instruction switch pour évaluer tous les membres d'un type énuméré peuvent ajouter une clause default pour empêcher de nouveaux cas de provoquer des avertissements ou des erreurs de compilation.

Mise à jour du versioning sémantique et des dépendances

Nous suivons le versioning sémantique pour la mise à jour de nos dépendances. Cela comprend la mise à jour de la version Dart et Flutter SDK.

Prise en charge de la catégorie / de la plate-forme

Catégorie	Androïde	ios	Web	Fenêtre	Macos	Linux
Analytique	✅	✅	✅	✅	✅	✅
API (REST)	✅	✅	✅	✅	✅	✅
API (GraphQL)	✅	✅	✅	✅	✅	✅
Authentification	✅	✅	✅	✅	✅	✅
Banc de données	✅	✅	?	?	?	?
Stockage	✅	✅	✅	✅	✅	✅
Notifications	✅	✅	?	?	?	?

Documentation

• Début avec Amplify Flutter
• Amplifier le cadre
• Installer l'amplify CLI
• Contribuant à amplifier le flottement

Guide de développement de Flutter

Amplify for Flutter est un projet open-source et accueille les contributions de la communauté Flutter, voir Contribution.

Condition préalable

• Battement
• Amplifier CLI

Commencer l'amplification de Flutter

1. Ouvrez votre projet Flutter. Si vous n'avez pas de projet Flutter actif, vous pouvez en créer un après l'installation de l'outillage de développement de Flutter et l'exécution flutter create <project-name> dans votre terminal.

2. En utilisant l'amplify CLI, exécutez amplify init à partir de la racine de votre projet:

Si vous n'avez pas configuré le CLI Amplify, consultez notre documentation lors de l'installation CLI Amplify.

== > 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. Ajoutez des catégories Amplify (choisissez par défaut pour cet exemple):

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

5. Poussez les modifications du cloud pour provisionner les ressources backend:

   $ amplify push

6. Dans votre fichier pubspe.yaml, ajoutez ce qui suit aux dependencies :

Remarque: n'incluez pas les dépendances dans votre fichier pubspec que vous n'utilisez pas dans votre application. Cela peut entraîner une erreur de configuration dans le SDK sous-jacent.

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

7. À partir du terminal

flutter pub get

8. Dans votre fichier main.dart, ajouter:

 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. Étant donné qu'Amplify Flutter prend en charge 6 plates-formes avec Flutter, y compris iOS, Android, Web et Desktop, une configuration supplémentaire peut être nécessaire pour chaque plate-forme. Consultez le guide de configuration de la plate-forme pour vous assurer que vous avez terminé les étapes nécessaires.

10. Exécutez flutter run pour lancer votre application sur l'appareil connecté.

11. Une fois l'application chargée, appuyez sur Configurer Amplify , puis sur l'événement enregistré plusieurs fois.

12. Pour voir les événements que vous avez recodés, exécutez amplify console analytics . Cela ouvrira la console Pinpoint Amazon pour votre projet dans votre navigateur Web par défaut. En environ une minute, vous devriez commencer à voir les événements se remplir dans la section des événements de la console PINPOINT.

Félicitations, vous avez construit votre première application Amplify! ?

Pour plus de documentation et amplifiez l'utilisation de la catégorie, consultez la documentation.

---

Flutter et le logo connexe sont des marques de Google LLC. Nous ne sommes pas approuvés ou affiliés à Google LLC.