Firebase را به برنامه Flutter خود اضافه کنید
پیش نیازها
ویرایشگر یا IDE دلخواه خود را نصب کنید.
Flutter را برای سیستم عامل خاص خود نصب کنید ، از جمله موارد زیر:
- فلوتر SDK
- حمایت از کتابخانه ها
- نرم افزارها و SDK های مخصوص پلتفرم
با استفاده از حساب Google خود وارد Firebase شوید .
اگر قبلاً یک برنامه Flutter ندارید، میتوانید Get Started: Test Drive را برای ایجاد یک برنامه Flutter جدید با استفاده از ویرایشگر یا IDE دلخواه خود تکمیل کنید.
مرحله 1 : ابزارهای خط فرمان مورد نیاز را نصب کنید
اگر قبلاً این کار را نکردهاید، Firebase CLI را نصب کنید .
با اجرای دستور زیر با استفاده از حساب Google خود وارد Firebase شوید:
firebase login
FlutterFire CLI را با اجرای دستور زیر از هر دایرکتوری نصب کنید:
dart pub global activate flutterfire_cli
مرحله 2 : برنامه های خود را برای استفاده از Firebase پیکربندی کنید
از FlutterFire CLI برای پیکربندی برنامه های Flutter خود برای اتصال به Firebase استفاده کنید.
از دایرکتوری پروژه Flutter خود، دستور زیر را برای شروع گردش کار پیکربندی برنامه اجرا کنید:
flutterfire configure
گردش کار
flutterfire configure
موارد زیر را انجام می دهد:
از شما میخواهد پلتفرمهای پشتیبانی شده (iOS، Android، Web) را در برنامه Flutter خود انتخاب کنید. برای هر پلتفرم انتخاب شده، FlutterFire CLI یک برنامه Firebase جدید در پروژه Firebase شما ایجاد می کند.
می توانید انتخاب کنید که از یک پروژه Firebase موجود استفاده کنید یا یک پروژه Firebase جدید ایجاد کنید. اگر قبلاً برنامههایی را در پروژه Firebase ثبت کردهاید، FlutterFire CLI سعی میکند آنها را بر اساس پیکربندی پروژه Flutter فعلی شما مطابقت دهد.
یک فایل پیکربندی Firebase (
firebase_options.dart
) ایجاد می کند و آن را به دایرکتوریlib/
شما اضافه می کند.(برای Crashlytics یا Performance Monitoring در Android) پلاگین های Gradle مخصوص محصول مورد نیاز را به برنامه Flutter شما اضافه می کند.
مرحله 3 : Firebase را در برنامه خود راه اندازی کنید
از دایرکتوری پروژه Flutter خود، دستور زیر را برای نصب افزونه اصلی اجرا کنید:
flutter pub add firebase_core
از دایرکتوری پروژه Flutter خود، دستور زیر را اجرا کنید تا مطمئن شوید که پیکربندی Firebase برنامه Flutter شما به روز است:
flutterfire configure
در فایل
lib/main.dart
خود، افزونه هسته Firebase و فایل پیکربندی را که قبلا ایجاد کردید وارد کنید:import 'package:firebase_core/firebase_core.dart'; import 'firebase_options.dart';
همچنین در فایل
lib/main.dart
خود، Firebase را با استفاده از شیDefaultFirebaseOptions
صادر شده توسط فایل پیکربندی مقداردهی اولیه کنید:await Firebase.initializeApp( options: DefaultFirebaseOptions.currentPlatform, );
برنامه Flutter خود را بازسازی کنید:
flutter run
اگر ترجیح می دهید از یک پروژه آزمایشی استفاده کنید، می توانید شبیه ساز Firebase را راه اندازی کنید و در فایل lib/main.dart
خود Firebase را با استفاده از demoProjectId
مقداردهی اولیه کنید (باید با demo-
شروع شود):
await Firebase.initializeApp(
demoProjectId: "demo-project-id",
);
مرحله 4 : افزونه های Firebase را اضافه کنید
شما از طریق پلاگین های مختلف Firebase Flutter ، یکی برای هر محصول Firebase (به عنوان مثال: Cloud Firestore ، Authentication ، Analytics و غیره) در برنامه Flutter خود به Firebase دسترسی دارید.
از آنجایی که Flutter یک چارچوب چند پلتفرمی است، هر افزونه Firebase برای پلتفرم های اپل، اندروید و وب قابل اجرا است. بنابراین، اگر هر افزونه Firebase را به برنامه Flutter خود اضافه کنید، توسط نسخه های اپل، اندروید و وب برنامه شما استفاده خواهد شد.
در اینجا نحوه افزودن افزونه Firebase Flutter آورده شده است:
از دایرکتوری پروژه Flutter خود، دستور زیر را اجرا کنید:
flutter pub add PLUGIN_NAME
از دایرکتوری پروژه Flutter خود، دستور زیر را اجرا کنید:
flutterfire configure
اجرای این دستور تضمین می کند که پیکربندی Firebase برنامه Flutter شما به روز است و برای Crashlytics و Performance Monitoring در اندروید، افزونه های Gradle مورد نیاز را به برنامه شما اضافه می کند.
پس از تکمیل، پروژه Flutter خود را بازسازی کنید:
flutter run
شما آماده اید! برنامههای Flutter شما برای استفاده از Firebase ثبت و پیکربندی شدهاند.
پلاگین های موجود
محصول | نام افزونه | iOS | اندروید | وب | اپل دیگر (macOS و غیره) | ویندوز |
---|---|---|---|---|---|---|
Analytics | firebase_analytics | بتا | ||||
App Check | firebase_app_check | بتا | ||||
Authentication | firebase_auth | بتا | بتا | |||
Cloud Firestore | cloud_firestore | بتا | بتا | |||
Cloud Functions | cloud_functions | بتا | ||||
Cloud Messaging | firebase_messaging | بتا | ||||
Cloud Storage | firebase_storage | بتا | بتا | |||
Crashlytics | firebase_crashlytics | بتا | ||||
Dynamic Links | firebase_dynamic_links | |||||
In-App Messaging | firebase_in_app_messaging | |||||
تاسیسات Firebase | firebase_app_installations | بتا | ||||
دانلود کننده مدل ML | firebase_ml_model_downloader | بتا | ||||
Performance Monitoring | firebase_performance | |||||
Realtime Database | firebase_database | بتا | ||||
Remote Config | firebase_remote_config | بتا | ||||
Vertex AI in Firebase | firebase_vertexai | بتا |
یک برنامه نمونه را با Analytics امتحان کنید
مانند همه بسته ها، افزونه firebase_analytics
با یک برنامه نمونه ارائه می شود.
یک برنامه Flutter را که قبلاً برای استفاده از Firebase پیکربندی کرده اید باز کنید (دستورالعمل های این صفحه را ببینید).
به دایرکتوری
lib
برنامه دسترسی پیدا کنید، سپس فایلmain.dart
موجود را حذف کنید.از مخزن نمونه برنامه Google Analytics ، دو فایل زیر را در فهرست
lib
برنامه خود کپی-پیست کنید:-
main.dart
-
tabs_page.dart
-
برنامه Flutter خود را اجرا کنید.
به پروژه Firebase برنامه خود در کنسول Firebase بروید، سپس روی Analytics در سمت چپ کلیک کنید.
برای اطلاعات بیشتر درباره راهاندازی Analytics ، از راهنمای شروع برای iOS+ ، Android و وب دیدن کنید.
مراحل بعدی
با Firebase Flutter Codelab تجربه عملی داشته باشید.
برای راه اندازی برنامه خود آماده شوید:
- هشدارهای بودجه را برای پروژه خود در کنسول Google Cloud تنظیم کنید.
- داشبورد استفاده و صورتحساب را در کنسول Firebase نظارت کنید تا تصویری کلی از استفاده از پروژه خود در چندین سرویس Firebase داشته باشید.
- چک لیست راه اندازی Firebase را مرور کنید.