Firebase را به برنامه Flutter خود اضافه کنید


پیش نیازها

اگر قبلاً یک برنامه Flutter ندارید، می‌توانید Get Started: Test Drive را برای ایجاد یک برنامه Flutter جدید با استفاده از ویرایشگر یا IDE دلخواه خود تکمیل کنید.

مرحله 1 : ابزارهای خط فرمان مورد نیاز را نصب کنید

  1. اگر قبلاً این کار را نکرده‌اید، Firebase CLI را نصب کنید .

  2. با اجرای دستور زیر با استفاده از حساب Google خود وارد Firebase شوید:

    firebase login

  3. FlutterFire CLI را با اجرای دستور زیر از هر دایرکتوری نصب کنید:

    dart pub global activate flutterfire_cli

مرحله 2 : برنامه های خود را برای استفاده از Firebase پیکربندی کنید

از FlutterFire CLI برای پیکربندی برنامه های Flutter خود برای اتصال به Firebase استفاده کنید.

از دایرکتوری پروژه Flutter خود، دستور زیر را برای شروع گردش کار پیکربندی برنامه اجرا کنید:

flutterfire configure


مرحله 3 : Firebase را در برنامه خود راه اندازی کنید

  1. از دایرکتوری پروژه Flutter خود، دستور زیر را برای نصب افزونه اصلی اجرا کنید:

    flutter pub add firebase_core

  2. از دایرکتوری پروژه Flutter خود، دستور زیر را اجرا کنید تا مطمئن شوید که پیکربندی Firebase برنامه Flutter شما به روز است:

    flutterfire configure

  3. در فایل lib/main.dart خود، افزونه هسته Firebase و فایل پیکربندی را که قبلا ایجاد کردید وارد کنید:

    import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';

  4. همچنین در فایل lib/main.dart خود، Firebase را با استفاده از شی DefaultFirebaseOptions صادر شده توسط فایل پیکربندی مقداردهی اولیه کنید:

    WidgetsFlutterBinding.ensureInitialized();
await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);
runApp(const MyApp());

  5. برنامه 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 آورده شده است:

  1. از دایرکتوری پروژه Flutter خود، دستور زیر را اجرا کنید: 

    flutter pub add PLUGIN_NAME

  2. از دایرکتوری پروژه Flutter خود، دستور زیر را اجرا کنید: 

    flutterfire configure

    اجرای این دستور تضمین می کند که پیکربندی Firebase برنامه Flutter شما به روز است و برای Crashlytics و Performance Monitoring در اندروید، افزونه های Gradle مورد نیاز را به برنامه شما اضافه می کند.

  3. پس از تکمیل، پروژه 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
بتا
Data Connect firebase_data_connect
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 با یک برنامه نمونه ارائه می شود.

  1. یک برنامه Flutter را که قبلاً برای استفاده از Firebase پیکربندی کرده اید باز کنید (دستورالعمل های این صفحه را ببینید).

  2. به دایرکتوری lib برنامه دسترسی پیدا کنید، سپس فایل main.dart موجود را حذف کنید.

  3. از مخزن نمونه برنامه Google Analytics ، دو فایل زیر را در فهرست lib برنامه خود کپی-پیست کنید:

    • main.dart
    • tabs_page.dart

  4. برنامه Flutter خود را اجرا کنید.

  5. به پروژه Firebase برنامه خود در کنسول Firebase بروید، سپس روی Analytics در سمت چپ کلیک کنید.

    1. روی داشبورد کلیک کنید. اگر Analytics به درستی کار می‌کند، داشبورد یک کاربر فعال را در پانل «کاربران فعال در 30 دقیقه گذشته» نشان می‌دهد (پر کردن این پانل ممکن است زمان ببرد).

    2. روی DebugView کلیک کنید. این ویژگی را فعال کنید تا همه رویدادهای ایجاد شده توسط برنامه نمونه را مشاهده کنید.

برای اطلاعات بیشتر درباره راه‌اندازی Analytics ، از راهنمای شروع برای iOS+ ، Android و وب دیدن کنید.

مراحل بعدی