amplify flutter

Amplificar Flutter

AWS Amplify proporciona una interfaz declarativa y fácil de usar en diferentes categorías de operaciones en la nube. Nuestra implementación predeterminada funciona con Amazon Web Services (AWS), pero AWS Amplify está diseñada para ser abierta y enchufable para cualquier backend o servicio personalizado. Consulte AWS Amplify para obtener más detalles sobre el marco de Amplify.

Estamos iterando y buscando comentarios y colaboración, así que háganos saber sus comentarios sobre nuestra dirección y hoja de ruta.

Guía de inicio

️ Amplify Flutter V1 ahora está en modo de mantenimiento hasta el 30 de abril de 2025. Esto significa que continuaremos incluyendo actualizaciones para garantizar la compatibilidad con los servicios de backend y la seguridad. No se introducirán nuevas características en V1.

Utilice la última versión (V2) de Amplify Flutter. Si actualmente está usando V1, siga estas instrucciones para actualizar a V2.

Bibliotecas de amplificación compatibles

Biblioteca	paquete de pub.dev	Descripción
Autenticación		API y bloques de construcción para desarrolladores que desean crear experiencias de autenticación de usuarios con Amazon Cognito.
Analítica		Recopile fácilmente datos de análisis para su aplicación con Pinpoint. Los datos de análisis incluyen sesiones de usuario y otros eventos personalizados que desea rastrear en su aplicación.
Almacenamiento		Proporciona un mecanismo simple para administrar contenido de usuario para su aplicación en cubos de almacenamiento público, protegido o privado con Amazon S3.
Almacén de datos		Un modelo de programación para aprovechar los datos compartidos y distribuidos sin escribir código adicional para escenarios fuera de línea y en línea, lo que hace que trabajar con datos distribuidos de usuario cruzado sea tan simple como trabajar con datos solo locales.
API (descanso)		Proporciona una solución simple al hacer solicitudes HTTP. Proporciona un proceso de firma automático y liviano que cumple con AWS Signature versión 4.
API (GraphQL)		Interactúe con su API GraphQL Server o AWS AppSync con un cliente GRAPHQL fácil de usar y configurado.
Notificaciones		Activar notificaciones push a su aplicación y registrar métricas en Pinpoint cuando los usuarios reciben o abren notificaciones.
Autenticador		El autenticador de Flutter Amplify simplifica el proceso de autenticar a los usuarios al proporcionar un flujo totalmente personalizable que simplemente funciona. Simplemente envuelva la ruta autenticada de su aplicación en un componente de autenticador y el proceso de autenticar a los usuarios y administrar sesiones de inicio de sesión se maneja para usted.

Versiones semánticas

Seguimos versiones semánticas para nuestros lanzamientos.

Casos de versiones semánticas y enumeración

Cuando Amplify agrega una nueva entrada de enumeración o subtipo de clase sellado, publicaremos una nueva versión menor de la biblioteca.

Las aplicaciones que usan una declaración de switch para evaluar a todos los miembros de un tipo enumerado pueden agregar una cláusula default para evitar que los nuevos casos causen advertencias o errores compilen.

Actualización de versiones y dependencias semánticas

Seguimos los versiones semánticas para actualizar nuestras dependencias. Esto incluye actualizar la versión DART y Flutter SDK.

Soporte de categoría / plataforma

Categoría	Androide	iOS	Web	Windows	Macosa	Linux
Analítica	✅	✅	✅	✅	✅	✅
API (descanso)	✅	✅	✅	✅	✅	✅
API (GraphQL)	✅	✅	✅	✅	✅	✅
Autenticación	✅	✅	✅	✅	✅	✅
Almacén de datos	✅	✅	?	?	?	?
Almacenamiento	✅	✅	✅	✅	✅	✅
Notificaciones	✅	✅	?	?	?	?

Documentación

• Comenzando con Amplify Flutter
• Amplificar marco
• Instale la cli de Amplify
• Contribuyendo a Amplify Flutter

Guía de desarrollo de Flutter

Amplify for Flutter es un proyecto de código abierto y da la bienvenida a las contribuciones de la comunidad Flutter, ver contribución.

Requisitos previos

• Aleteo
• Amplificar CLI

Comenzar Amplify Flutter

1. Abre tu proyecto de Flutter. Si no tiene un proyecto Flutter activo, puede crear uno después de instalar las herramientas de desarrollo de Flutter y ejecutar flutter create <project-name> en su terminal.

2. Usando la CLI Amplify, ejecute amplify init desde la raíz de su proyecto:

Si no ha configurado la CLI Amplify, consulte nuestra documentación en la instalación de 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. Agregar categorías de amplificación (elija valores predeterminados para este ejemplo):

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

5. Empuje los cambios en la nube para aprovisionar los recursos de backend:

   $ amplify push

6. En su archivo pubspec.yaml, agregue lo siguiente a dependencies :

Nota: No incluya dependencias en su archivo pubspec que no esté utilizando en su aplicación. Esto puede causar un error de configuración en el SDK subyacente.

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

7. De la ejecución de la terminal

flutter pub get

8. En su archivo Main.Dart, agregue:

 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. Dado que Amplify Flutter admite 6 plataformas con Flutter, incluidos iOS, Android, Web y Desktop, se puede requerir alguna configuración adicional para cada plataforma. Consulte la guía de configuración de la plataforma para asegurarse de que ha completado los pasos necesarios.

10. Ejecute flutter run para iniciar su aplicación en el dispositivo conectado.

11. Una vez que se carga la aplicación, toque Configurar Amplify , luego en el evento registrado varias veces.

12. Para ver los eventos que recodó, ejecute amplify console analytics . Esto abrirá la consola Pinpoint de Amazon para su proyecto en su navegador web predeterminado. En aproximadamente un minuto, debe comenzar a ver los eventos que se poblan en la sección de eventos de la consola determinada.

Felicitaciones, ¡ha creado su primera aplicación de amplificación! ?

Para obtener más documentación y amplificar el uso de la categoría, consulte la documentación.

---

Flutter y el logotipo relacionado son marcas comerciales de Google LLC. No estamos respaldados o afiliados a Google LLC.