amplify flutter

Amplifique o fleto

O AWS Amplify fornece uma interface declarativa e fácil de usar em diferentes categorias de operações em nuvem. Nossa implementação padrão funciona com a Amazon Web Services (AWS), mas a AWS Amplify foi projetada para ser aberta e flugable para qualquer back -end ou serviço personalizado. Consulte AWS Amplify para obter mais detalhes sobre a estrutura Amplify.

Estamos iterando e procurando feedback e colaboração, por isso, informe -nos seus comentários sobre nossa direção e roteiro.

Guia de início

️ O Amplify Flutter V1 está agora no modo de manutenção até 30 de abril de 2025. Isso significa que continuaremos incluindo atualizações para garantir a compatibilidade com serviços de back -end e segurança. Nenhum novo recurso será introduzido no V1.

Use a versão mais recente (v2) do Amplify Flutter. Se você estiver usando o V1 atualmente, siga estas instruções para atualizar para V2.

Bibliotecas amplificadas com suporte suportado

Biblioteca	pacote pub.dev	Descrição
Autenticação		APIs e blocos de construção para desenvolvedores que desejam criar experiências de autenticação de usuário com o Amazon Cognito.
Análise		Colete facilmente dados de análise para o seu aplicativo com Pinpoint. Os dados do Analytics incluem sessões de usuário e outros eventos personalizados que você deseja rastrear em seu aplicativo.
Armazenar		Fornece um mecanismo simples para gerenciar o conteúdo do usuário para seu aplicativo em baldes de armazenamento público, protegido ou privado com a Amazon S3.
Datastore		Um modelo de programação para alavancar dados compartilhados e distribuídos sem gravar código adicional para cenários offline e on-line, o que torna o trabalho com dados distribuídos e entre usuários, tão simples quanto trabalhar com dados somente local.
API (REST)		Fornece uma solução simples ao fazer solicitações HTTP. Ele fornece um processo automático de assinatura leve que cumpre a versão 4 da AWS Signature.
API (GraphQL)		Interaja com o seu servidor grafql ou a API APPSYNC com um cliente GraphQL fácil de usar e configurado.
Notificações		Trigger Notificações de Push no seu aplicativo e registre métricas no ponto de identificação quando os usuários recebem ou abrem notificações.
Autenticador		O Amplify Flutter Authenticator simplifica o processo de autenticação de usuários, fornecendo um fluxo totalmente gasto que apenas funciona. Simplesmente envolva a rota autenticada do seu aplicativo em um componente autenticador e o processo de autenticação de usuários e gerenciamento de sessões de login é tratado para você.

Versão semântica

Seguimos a versão semântica para nossos lançamentos.

Casos de versão semântica e enumeração

Quando a Amplify adiciona uma nova entrada de enumeração ou subtipo de classe selada, publicaremos uma nova versão menor da biblioteca.

Os aplicativos que usam uma instrução switch para avaliar todos os membros de um tipo enumerado podem adicionar uma cláusula default para impedir que novos casos causassem avisos ou erros de compilação.

Atualização de versão semântica e dependências

Seguimos a versão semântica para atualizar nossas dependências. Isso inclui a atualização da versão SDK Dart e Flutter.

Suporte de categoria / plataforma

Categoria	Android	iOS	Web	Windows	Macos	Linux
Análise	✅	✅	✅	✅	✅	✅
API (REST)	✅	✅	✅	✅	✅	✅
API (GraphQL)	✅	✅	✅	✅	✅	✅
Autenticação	✅	✅	✅	✅	✅	✅
Datastore	✅	✅	?	?	?	?
Armazenar	✅	✅	✅	✅	✅	✅
Notificações	✅	✅	?	?	?	?

Documentação

• Introdução com Amplify Flutter
• Amplify Framework
• Instale a CLI amplificada
• Contribuindo para amplificar a vibração

Guia de Desenvolvimento de Flutter

O Amplify for Flutter é um projeto de código aberto e recebe contribuições da comunidade Flutter, consulte contribuindo.

Pré -requisitos

• Vibrar
• Amplifique a CLI

Introdução ao Amplify Flutter

1. Abra seu projeto de vibração. Se você não possui um projeto ativo de fleta, poderá criar um depois de instalar o FLUTTER DE DESENVOLVIMENTO FERRAMENTO E RANGER flutter create <project-name> no seu terminal.

2. Usando a CLI Amplify, execute amplify init da raiz do seu projeto:

Se você não configurou a CLI da Amplify, consulte nossa documentação na Amplify CLI Installation.

== > 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. Adicione categorias Amplify (escolha os padrões para este exemplo):

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

5. Empurre mudanças na nuvem para provisionar os recursos de back -end:

   $ amplify push

6. No seu arquivo pubSpec.yaml, adicione o seguinte às dependencies :

Nota: Não inclua dependências no seu arquivo pubspec que você não está usando no seu aplicativo. Isso pode causar um erro de configuração no SDK subjacente.

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

7. Da execução do terminal

flutter pub get

8. No seu arquivo main.Dart, adicione:

 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. Como o Amplify Flutter suporta 6 plataformas com fleta, incluindo iOS, Android, Web e Desktop, pode ser necessária alguma configuração extra para cada plataforma. Confira o Guia de Configuração da Plataforma para garantir que você tenha concluído as etapas necessárias.

10. Execute flutter run para iniciar seu aplicativo no dispositivo conectado.

11. Depois que o aplicativo for carregado, toque em configurar amplificar e depois no evento de registro algumas vezes.

12. Para ver os eventos que você recodificou, execute amplify console analytics . Isso abrirá o console do Amazon Pinpoint para o seu projeto no seu navegador padrão. Dentro de um minuto, você deve começar a ver os eventos que se prejudicam na seção de eventos do Console do Console.

Parabéns, você criou seu primeiro aplicativo Amplify! ?

Para mais documentação e amplificar o uso da categoria, consulte a documentação.

---

Flutter e o logotipo relacionado são marcas comerciais do Google LLC. Não somos endossados ​​ou afiliados ao Google LLC.