amplify flutter
2.5.1
AWS Amplify предоставляет декларативный и простой в использовании интерфейс в различных категориях облачных операций. Наша реализация по умолчанию работает с Amazon Web Services (AWS), но AWS Amplify предназначен для того, чтобы быть открытым и подключаемым для любого пользовательского бэкэнда или услуг. См. AWS Amplify для получения более подробной информации о структуре Amplify.
Мы итерации и ищем обратную связь и сотрудничество, поэтому, пожалуйста, сообщите нам о вашей обратной связи о нашем направлении и дорожной карте.
Начало работы
Пожалуйста, используйте последнюю версию (v2) Amplify Flutter. Если вы в настоящее время используете V1, следуйте этим инструкциям, чтобы обновить до V2.
| Библиотека | Pub.DEV Пакет | Описание |
|---|---|---|
| Аутентификация | API и строительные блоки для разработчиков, которые хотят создать опыт аутентификации пользователей с Amazon Cognito. | |
| Аналитика | Легко собирать аналитические данные для вашего приложения с точки зрения. Аналитические данные включают в себя сеансы пользователей и другие пользовательские события, которые вы хотите отслеживать в своем приложении. | |
| Хранилище | Предоставляет простой механизм управления пользовательским контентом для вашего приложения на публичных, защищенных или частных ведрах для хранения с Amazon S3. | |
| Хранилище данных | Модель программирования для использования общих и распределенных данных без написания дополнительного кода для автономных и онлайн-сценариев, что делает работу с распределенными, кросс-пользовательскими данными столь же простой, как работа с данными только для локального. | |
| API (отдых) | Предоставляет простое решение при выполнении HTTP -запросов. Он обеспечивает автоматический, легкий процесс подписания, который соответствует версии AWS Signature версии 4. | |
| API (GraphQL) | Взаимодействуйте с вашим API API APS-API APS Server или AWS с простым в использовании и настроенным клиентом GraphQL. | |
| Уведомления | Запустите Push -уведомления к вашему приложению и запишите метрики в точечной точке, когда пользователи получают или открывают уведомления. | |
| Аутентикатор | Amplify Flutter Authenticator упрощает процесс аутентификации пользователей, предоставляя полностью заполненный поток, который работает. Просто завершите аутентифицированный маршрут вашего приложения в компонент аутентификатора, и процесс аутентификации пользователей и управление сеансами входа в систему обрабатывается для вас. |
Мы следуем семантическим версиям для наших выпусков.
Когда Amplify добавляет новую запись перечисления или подтип запечатанного класса, мы опубликуем новую вторую версию библиотеки.
Приложения, которые используют оператор switch для оценки всех членов перечисленного типа, могут добавить пункт default , чтобы предотвратить новые случаи, вызывая предупреждения или ошибки компиляции.
Мы следуем семантическим версиям для обновления наших зависимостей. Это включает в себя обновление версии DART и Flutter SDK.
| Категория | Android | ios | Веб - | Окна | MacOS | Linux |
|---|---|---|---|---|---|---|
| Аналитика | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| API (отдых) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| API (GraphQL) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Аутентификация | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Хранилище данных | ✅ | ✅ | ? | ? | ? | ? |
| Хранилище | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Уведомления | ✅ | ✅ | ? | ? | ? | ? |
Amplify for Flutter-это проект с открытым исходным кодом, который приветствует взносы сообщества Flutter, см. Вклад.
Откройте свой проект Flutter. Если у вас нет активного проекта Flutter, вы можете создать один после установки инструментов разработки Flutter и запуска flutter create <project-name> в вашем терминале.
Используя CLI Amplify, запустите amplify init из корня вашего проекта:
Если вы не настроили CLI Amplify, ознакомьтесь с нашей документацией при установке 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Добавьте категории Amplify (выберите по умолчанию для этого примера):
$ amplify add auth # Choose default configuration after entering this command in your terminal.Протолкнуть изменения в облако для предоставления бэкэнд -ресурсов:
$ amplify push В вашем файле pubspec.yaml добавьте следующее в dependencies :
ПРИМЕЧАНИЕ. Не включайте зависимости в вашем файле
pubspec, которые вы не используете в своем приложении. Это может вызвать ошибку конфигурации в базовом SDK.
dependencies :
amplify_auth_cognito : ^2.0.0
amplify_authenticator : ^2.0.0
amplify_flutter : ^2.0.0
flutter :
sdk : flutterflutter pub get 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!' ),
),
),
),
);
}
}Поскольку Amplify Flutter поддерживает 6 платформ с Flutter, включая iOS, Android, Web и Desktop, для каждой платформы может потребоваться дополнительная конфигурация. Проверьте руководство по настройке платформы, чтобы убедиться, что вы выполнили необходимые шаги.
Запустите flutter run , чтобы запустить ваше приложение на подключенном устройстве.
Как только приложение загружено, нажмите на настройку Amplify , затем на событие записи несколько раз.
Чтобы увидеть события, которые вы перекодировали, запустите amplify console analytics . Это откроет консоль Pinpoint Amazon для вашего проекта в вашем веб -браузере по умолчанию. Примерно через минуту вы должны начать видеть события, заполненные в разделе событий, то Pinpoint Console.
Поздравляю, вы построили свое первое приложение Amplify! ?
Для дальнейшей документации и усиления использования категории см. Документацию.
Flutter и связанный логотип являются товарными знаками Google LLC. Мы не одобрены или связаны с Google LLC.
