AWS Amplify provides a declarative and easy-to-use interface across different categories of cloud operations. Our default implementation works with Amazon Web Services (AWS), but AWS Amplify is designed to be open and pluggable for any custom backend or service. See AWS Amplify for further details about the Amplify Framework.
We are iterating and looking for feedback and collaboration, so please let us know your feedback on our direction and roadmap.
⚠️ Amplify Flutter v1 is now in Maintenance Mode until April 30th, 2025. This means that we will continue to include updates to ensure compatibility with backend services and security. No new features will be introduced in v1.
Please use the latest version (Gen 2) of Amplify Flutter. If you are currently using v1, follow these instructions to upgrade to v2.
Library | pub.dev package | Description |
---|---|---|
Authentication | |
APIs and building blocks for developers who want to create user authentication experiences with Amazon Cognito. |
Analytics | |
Easily collect analytics data for your app with Pinpoint. Analytics data includes user sessions and other custom events that you want to track in your app. |
Storage | |
Provides a simple mechanism for managing user content for your app in public, protected or private storage buckets with Amazon S3. |
DataStore | |
A programming model for leveraging shared and distributed data without writing additional code for offline and online scenarios, which makes working with distributed, cross-user data just as simple as working with local-only data. |
API (REST) | |
Provides a simple solution when making HTTP requests. It provides an automatic, lightweight signing process which complies with AWS Signature Version 4. |
API (GraphQL) | |
Interact with your GraphQL server or AWS AppSync API with an easy-to-use & configured GraphQL client. |
Notifications | |
Trigger push notifications to your app and record metrics in Pinpoint when users receive or open notifications. |
Authenticator | |
The Amplify Flutter Authenticator simplifies the process of authenticating users by providing a fully-customizable flow which just works. Simply wrap your app's authenticated route in an Authenticator component and the process of authenticating users and managing login sessions is handled for you. |
We follow semantic versioning for our releases.
When Amplify adds a new enumeration entry or sealed class subtype, we will publish a new minor version of the library.
Applications that use a switch
statement to evaluate all members of an enumerated type can add a default
clause to prevent
new cases from causing compile warnings or errors.
We follow semantic versioning for updating our dependencies. This includes updating the dart and flutter SDK version.
Category | Android | iOS | Web | Windows | MacOS | Linux |
---|---|---|---|---|---|---|
Analytics | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
API (REST) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
API (GraphQL) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
Authentication | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
DataStore | ✅ | ✅ | 🔴 | 🔴 | 🔴 | 🔴 |
Storage | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
Notifications | ✅ | ✅ | 🔴 | 🔴 | 🔴 | 🔴 |
Amplify for Flutter is an open-source project and welcomes contributions from the Flutter community, see Contributing.
Open your Flutter project. If you do not have an active Flutter project, you can create one after installing the Flutter development tooling and running flutter create <project-name>
in your terminal.
Run the following to create an amplify project:
npm create amplify@latest -y
To use the Authenticator, you need to add the following dependencies to your project:
dependencies:
amplify_auth_cognito: ^2.0.0
amplify_authenticator: ^2.0.0
amplify_flutter: ^2.0.0
flutter:
sdk: flutter
run flutter pub get
Update your main.dart file to the following:
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 'amplify_outputs.dart';
Future<void> main() async {
try {
WidgetsFlutterBinding.ensureInitialized();
await _configureAmplify();
runApp(const MyApp());
} on AmplifyException catch (e) {
runApp(Text("Error configuring Amplify: ${e.message}"));
}
}
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');
}
}
class MyApp extends StatelessWidget {
const MyApp({super.key});
@override
Widget build(BuildContext context) {
return Authenticator(
child: MaterialApp(
builder: Authenticator.builder(),
home: const Scaffold(
body: Center(
child: Column(
mainAxisAlignment: MainAxisAlignment.center,
children: [
SignOutButton(),
Text('TODO Application'),
],
),
),
),
),
);
}
}
Deploy your backend use Amplify's per-developer cloud sandbox. This feature provides a separate backend environment for every developer on a team, ideal for local development and testing. To run your application with a sandbox environment, you can run the following command:
npx ampx sandbox --outputs-format dart --outputs-out-dir lib
Since Amplify Flutter supports 6 platforms with Flutter including iOS, Android, Web, and Desktop, some extra configuration may be required for each platform. Check out the Platform Setup guide to make sure you've completed the necessary steps.
Run flutter run
to launch your app on the connected device.
Congratulations, you've built your first Amplify app! 🎉
For further documentation and Amplify Category usage, see the documentation.
Flutter and the related logo are trademarks of Google LLC. We are not endorsed by or affiliated with Google LLC.
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。