amplify flutter

تضخيم الرفرفة

يوفر AWS Amplify واجهة إعلانية وسهلة الاستخدام عبر فئات مختلفة من العمليات السحابية. يعمل التنفيذ الافتراضي الخاص بنا مع Amazon Web Services (AWS) ، ولكن تم تصميم AWS Amplify ليكون مفتوحًا وقابل للتطوير لأي واجهات أو خدمة مخصصة. انظر AWS Amplify لمزيد من التفاصيل حول إطار Amplify.

نحن نتكرر ونبحث عن التعليقات والتعاون ، لذا يرجى إخبارنا بملاحظاتك حول اتجاهنا وخريطة الطريق.

دليل البدء

️ Amplify Flutter V1 موجود الآن في وضع الصيانة حتى 30 أبريل 2025. وهذا يعني أننا سنستمر في تضمين تحديثات لضمان التوافق مع خدمات الواجهة الخلفية والأمان. لن يتم تقديم ميزات جديدة في V1.

يرجى استخدام أحدث إصدار (V2) من Amplify Flutter. إذا كنت تستخدم حاليًا V1 ، فاتبع هذه التعليمات للترقية إلى V2.

تدعم المكتبات تضخيم

مكتبة	حزمة Pub.Dev	وصف
المصادقة		واجهات برمجة التطبيقات والبلاط البناء للمطورين الذين يرغبون في إنشاء تجارب مصادقة المستخدم مع Amazon Cognito.
التحليلات		قم بجمع بيانات التحليلات بسهولة لتطبيقك باستخدام Pinpoint. تتضمن بيانات التحليلات جلسات المستخدم والأحداث المخصصة الأخرى التي تريد تتبعها في تطبيقك.
تخزين		يوفر آلية بسيطة لإدارة محتوى المستخدم لتطبيقك في دلاء التخزين العامة أو المحمية أو الخاصة مع Amazon S3.
مخزن البيانات		نموذج برمجة للاستفادة من البيانات المشتركة والموزعة دون كتابة رمز إضافي للسيناريوهات غير المتصلة بالإنترنت والاتصال عبر الإنترنت ، مما يجعل العمل مع بيانات مستخدم موزعة بنفس القدر مثل العمل مع البيانات المحلية فقط.
API (REST)		يوفر حلاً بسيطًا عند تقديم طلبات HTTP. يوفر عملية توقيع تلقائية وخفيفة الوزن تتوافق مع إصدار AWS Signature 4.
API (GraphQL)		تفاعل مع خادم GraphQL أو AWS AppSync API مع عميل GraphQL سهل الاستخدام وتكوينه.
إشعارات		تحفيز الإخطارات إلى تطبيقك وتسجيل مقاييس في Pinpoint عندما يتلقى المستخدمون الإخطارات أو فتحها.
المصادقة		يقوم Amplify Flutter Authenticator بتبسيط عملية مصادقة المستخدمين من خلال توفير تدفق قابل للتكامل بالكامل يعمل فقط. ما عليك سوى لف مسار التطبيق المصادق في مكون المصادقة وعملية مصادقة المستخدمين وإدارة جلسات تسجيل الدخول لك.

النسخة الدلالية

نحن نتبع الإصدار الدلالي لإصداراتنا.

حالات الإصدار الدلالي والتعداد

عندما يضيف Amplify إدخال تعداد جديد أو نوع فرعي فئة مختومة ، سننشر نسخة ثانوية جديدة من المكتبة.

يمكن للتطبيقات التي تستخدم بيان switch لتقييم جميع أعضاء النوع المذكور إضافة جملة default لمنع الحالات الجديدة من التسبب في تحذيرات أو أخطاء تجميع.

تحديث الإصدار الدلالي وتبعيات

نتبع الإصدار الدلالي لتحديث تبعياتنا. يتضمن ذلك تحديث إصدار SDK Dart و Flutter.

دعم الفئة / النظام الأساسي

فئة	Android	iOS	الويب	النوافذ	ماكوس	Linux
التحليلات	✅	✅	✅	✅	✅	✅
API (REST)	✅	✅	✅	✅	✅	✅
API (GraphQL)	✅	✅	✅	✅	✅	✅
المصادقة	✅	✅	✅	✅	✅	✅
مخزن البيانات	✅	✅	؟	؟	؟	؟
تخزين	✅	✅	✅	✅	✅	✅
إشعارات	✅	✅	؟	؟	؟	؟

الوثائق

• البدء مع تضخيم الرفرفة
• تضخيم الإطار
• تثبيت Amplify CLI
• المساهمة في تضخيم الرفرفة

دليل تطوير الرفرفة

Amplify for Flutter هو مشروع مفتوح المصدر ويرحب بالمساهمات من مجتمع Flutter ، انظر المساهمة.

المتطلبات الأساسية

• رفرفة
• تضخيم CLI

الشروع في بدء التضخيم رفرفة

1. افتح مشروع الرفرفة الخاص بك. إذا لم يكن لديك مشروع رفرفة نشط ، فيمكنك إنشاء واحد بعد تثبيت أدوات تطوير Flutter وتشغيل flutter create <project-name> في المحطة الخاصة بك.

2. باستخدام Amplify CLI ، قم بتشغيل amplify init من جذر مشروعك:

إذا لم تكن قد قمت بتكوين Amplify CLI ، فتحقق من وثائقنا في 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. إضافة فئات تضخيم (اختر الافتراضات لهذا المثال):

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

5. دفع التغييرات إلى السحابة لتوفير موارد الواجهة الخلفية:

   $ amplify push

6. في ملف pubspec.yaml الخاص بك ، أضف ما يلي إلى dependencies :

ملاحظة: لا تقم بتضمين التبعيات في ملف pubspec الذي لا تستخدمه في تطبيقك. يمكن أن يسبب هذا خطأ في التكوين في SDK الأساسي.

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

7. من الجري الطرفي

flutter pub get

8. في ملف main.dart الخاص بك ، أضف:

 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. نظرًا لأن Amplify Flutter يدعم 6 منصات مع رفرفة بما في ذلك iOS و Android و Web و Desktop ، فقد تكون هناك حاجة إلى بعض التكوين الإضافي لكل منصة. تحقق من دليل إعداد النظام الأساسي للتأكد من أنك أكملت الخطوات اللازمة.

10. قم بتشغيل flutter run لبدء تطبيقك على الجهاز المتصل.

11. بمجرد تحميل التطبيق ، اضغط على تكوين Amplify ، ثم في الحدث السجل عدة مرات.

12. لمشاهدة الأحداث التي قمت بإعادة ترميزها ، قم بتشغيل amplify console analytics . سيؤدي ذلك إلى فتح وحدة التحكم Amazon Pinpoint لمشروعك في متصفح الويب الافتراضي. في غضون دقيقة واحدة تقريبًا ، يجب أن تبدأ في رؤية الأحداث التي تملأ في قسم الأحداث في وحدة التحكم التي تحددها.

تهانينا ، لقد قمت ببناء تطبيق Amplify الأول! ؟

لمزيد من الوثائق وتضخيم استخدام الفئة ، راجع الوثائق.

---

الرفرفة والشعار ذي الصلة هي علامات تجارية لشركة Google LLC. لا يتم اعتمادنا من قبل أو التابعة لـ Google LLC.