‫Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.

شروع به کار با Firebase در پروژه Flutter

پیش‌نیازها

ویرایشگر یا IDE موردنظرتان را نصب کنید.
Flutter را برای سیستم‌عامل خاص خودتان نصب کنید، ازجمله موارد زیر:
- Flutter SDK
- کتابخانه‌های پشتیبانی
- نرم‌افزار و کیت توسعه نرم‌افزار مختص پلاتفرم

پیش‌نیازهای مختص پلاتفرم:

Apple

یک دستگاه Apple فیزیکی راه‌اندازی کنید یا از شبیه‌ساز برای اجرای برنامه‌تان استفاده کنید.
مطمئن شوید که برنامه Flutter شما نسخه‌های پلاتفرم زیر یا جدیدتر را هدف قرار می‌دهد:
- iOS 15
- ‫macOS 11

آیا می‌خواهید از Cloud Messaging استفاده کنید؟

برای Cloud Messaging در پلاتفرم‌های Apple، پیش‌نیازها به این شرح است:

دستگاه Apple فیزیکی راه‌اندازی کنید.

«کلید اصالت‌سنجی اعلان لحظه‌ای Apple» را برای حساب توسعه‌دهنده Apple خود دریافت کنید.

«اعلان‌های لحظه‌ای» را در Xcode در بخش برنامه > قابلیت‌ها فعال کنید.

Android

دستگاه یا شبیه‌سازی را برای اجرای برنامه‌تان راه‌اندازی کنید. شبیه‌سازها باید از تصویر شبیه‌ساز با Google Play استفاده کنند.
مطمئن شوید برنامه‌تان الزامات زیر را برآورده می‌کند:
- سطح میانای برنامه‌سازی کاربردی ۲۴ (Nougat) یا بالاتر را هدف‌یابی می‌کند
- از Android 7.0 یا بالاتر استفاده می‌کند

وب

بدون پیش‌نیازهای مختص پلاتفرم

اگر ازقبل برنامه Flutter ندارید، می‌توانید شروع به کار: رانندگی آزمایشی را تکمیل کنید تا بااستفاده از ویرایشگر یا IDE دلخواهتان برنامه Flutter جدیدی ایجاد کنید.

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

اگر قبلاً این کار را نکرده‌اید، Firebase CLI را نصب کنید.
با اجرای فرمان زیر، بااستفاده از «حساب Google» خود به سیستم Firebase وارد شوید:
```
firebase login
```
FlutterFire CLI را با اجرای فرمان زیر از هر فهرست راهنمایی نصب کنید:
```
dart pub global activate flutterfire_cli
```

مرحله ۲: پیکربندی برنامه‌ها برای استفاده از Firebase

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

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

flutterfire configure

این گردش کار flutterfire configure چه کاری انجام می‌دهد؟

گردش کار flutterfire configure موارد زیر را انجام می‌دهد:

از شما می‌خواهد پلاتفرم‌های (iOS،‏ Android، وب) پشتیبانی‌شده در برنامه Flutter خود را انتخاب کنید. برای هر پلاتفرم انتخاب‌شده، FlutterFire CLI یک برنامه Firebase جدید در پروژه Firebase شما ایجاد می‌کند.

می‌توانید انتخاب کنید که از پروژه Firebase موجود استفاده کنید یا پروژه Firebase جدیدی ایجاد کنید. اگر ازقبل برنامه‌هایی در پروژه Firebase موجود ثبت کرده‌اید، FlutterFire CLI تلاش می‌کند آن‌ها را براساس پیکربندی پروژه Flutter فعلی‌تان مطابقت دهد.

توجه: در اینجا چند نکته درباره راه‌اندازی و مدیریت پروژه Firebase آورده شده است:

روال‌های مطلوب ما را برای افزودن برنامه‌ها به پروژه Firebase، ازجمله نحوه مدیریت چندین گونه، بررسی کنید.

Google Analytics را در پروژه‌تان فعال کنید، که تجربه بهینه‌ای را بااستفاده از بسیاری از محصولات Firebase، مانند Crashlytics و Remote Config، ارائه می‌دهد.

فایل پیکربندی Firebase (firebase_options.dart) را ایجاد می‌کند و آن را به دایرکتوری lib/ اضافه می‌کند.

توجه: این فایل پیکربندی Firebase حاوی شناسه‌های یکتا اما غیرمحرمانه برای هر پلاتفرمی است که انتخاب کرده‌اید.
برای کسب اطلاعات بیشتر درباره این فایل پیکربندی، به آشنایی با پروژه‌های Firebase مراجعه کنید.

(برای Crashlytics یا Performance Monitoring در Android) افزایه‌های Gradle موردنیاز مختص محصول را به برنامه Flutter شما اضافه می‌کند.

توجه: برای اینکه FlutterFire CLI بتواند افزونه Gradle مناسب را اضافه کند، افزونه Flutter محصول باید ازقبل به برنامه Flutter شما وارد شده باشد.

پس‌از این اجرای اولیه flutterfire configure، هرزمان که کارهای زیر را انجام دهید باید فرمان را دوباره اجرا کنید:

پشتیبانی از پلاتفرم جدیدی را در برنامه Flutter خود شروع کنید.
استفاده از سرویس یا محصول جدید Firebase را در برنامه Flutter خود شروع کنید، به‌ویژه اگر استفاده از ورود به سیستم با Google،‏ Crashlytics، Performance Monitoring، یا Realtime Database را شروع می‌کنید.

اجرای مجدد دستور تضمین می‌کند که پیکربندی Firebase برنامه Flutter شما به‌روز است و (برای Android) هر افزایه Gradle موردنیاز را به‌طور خودکار به برنامه شما اضافه می‌کند.

مرحله ۳: مقداردهی اولیه 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 صادرشده توسط فایل پیکربندی مقداردهی اولیه کنید:
```
WidgetsFlutterBinding.ensureInitialized();
await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);
runApp(const MyApp());
```
برنامه Flutter خود را بازسازی کنید:
```
flutter run
```

اگر ترجیح می‌دهید از پروژه نمایشی استفاده کنید، می‌توانید شبیه‌ساز Firebase را شروع کنید و در فایل lib/main.dart بااستفاده از demoProjectId، Firebase را مقداردهی اولیه کنید (باید با demo- شروع شود):

await Firebase.initializeApp(
  demoProjectId: "demo-project-id",
);

مرحله ۴: افزودن افزایه‌های Firebase

در برنامه Flutter خود ازطریق افزایه‌های Firebase Flutter مختلف به Firebase دسترسی پیدا می‌کنید، یکی برای هر محصول Firebase (برای مثال: Cloud Firestore، Authentication، Analytics، و غیره).

ازآنجایی‌که Flutter یک چارچوب چندپلاتفرمی است، هر افزایه Firebase برای پلاتفرم‌های Apple،‏ Android، و وب قابل‌اعمال است. بنابراین، اگر افزایه Firebase به برنامه Flutter خود اضافه کنید، در نسخه‌های Apple،‏ Android، و وب برنامه‌تان استفاده خواهد شد.

در اینجا نحوه افزودن افزایه Firebase Flutter آمده است:

از فهرست راهنمای پروژه Flutter، فرمان زیر را اجرا کنید:
```
flutter pub add PLUGIN_NAME
```
از فهرست راهنمای پروژه Flutter، فرمان زیر را اجرا کنید:
```
flutterfire configure
```
اجرای این فرمان تضمین می‌کند که پیکربندی Firebase برنامه Flutter شما به‌روز است و برای Crashlytics و Performance Monitoring در Android، افزایه‌های Gradle موردنیاز را به برنامه‌تان اضافه می‌کند.
پس‌از تکمیل، پروژه Flutter خود را بازسازی کنید:
```
flutter run
```

آماده‌اید! برنامه‌های Flutter شما ثبت و پیکربندی شده‌اند تا از Firebase استفاده کنند.

ملاحظات ویژه برای ساختن برنامه‌های وب

هنگام هدف‌یابی پلاتفرم وب، گزینه‌های پیکربندی زیر را مرور کنید.

پشتیبانی از Trusted Types

«کیت توسعه نرم‌افزار Firebase» برای Flutter از «انواع مطمئن» برای کمک به جلوگیری از حملات XSS مبتنی‌بر DOM (سمت کارخواه) پشتیبانی می‌کند. وقتی اجرای «نوع مطمئن» را فعال می‌کنید برای برنامه‌تان، «کیت توسعه نرم‌افزار Firebase» بااستفاده از خط‌مشی‌های «نوع مطمئن» سفارشی، که flutterfire-firebase_core، flutterfire-firebase_auth، و غیره نام‌گذاری شده‌اند، برنامه‌های خود را به DOM تزریق می‌کند.

غیرفعال کردن تزریق خودکار کیت توسعه نرم‌افزار جاوا اسکریپت در Firebase

به‌طور پیش‌فرض، کیت توسعه نرم‌افزار Firebase Flutter به‌طور خودکار کیت توسعه نرم‌افزار Firebase JavaScript را هنگام ساخت برای وب تزریق می‌کند. اگر نمی‌خواهید «کیت توسعه نرم‌افزار جاوا اسکریپت Firebase» به‌طور خودکار تزریق شود، می‌توانید کارهای زیر را انجام دهید:

با افزودن دارایی زیر در برچسب <script> در فایل web/index.html در پروژه Flutter خود، از تزریق خودکار نوشتار چشم‌پوشی کنید:

<!-- Add this property inside a <script> tag within your "web/index.html" file in your Flutter project -->
<!-- Put in the names of all the plugins you wish to ignore: -->
window.flutterfire_ignore_scripts = ['analytics', 'firestore'];

دستورگان را به‌صورت دستی بااستفاده از یکی از گزینه‌های زیر بار کنید:

گزینه ۱: کیت توسعه نرم‌افزار را به‌طور صریح به فایل web/index.html خود اضافه کنید، درون callback window.addEventListener:

  window.addEventListener('load', async function (ev) {
    window.firebase_firestore = await import("https://www.gstatic.com/firebasejs/13.0.0/firebase-firestore.js");
    window.firebase_analytics = await import("https://www.gstatic.com/firebasejs/13.0.0/firebase-analytics.js");

    _flutter.loader.loadEntrypoint().then(function (engineInitializer) {
      // rest of the code

گزینه ۲: کد Firebase JavaScript SDK افزونه را از دامنه gstatic بارگیری کنید و آن را در فایل JavaScript ذخیره کنید تا در پروژه‌تان نگهداری شود و به‌صورت دستی بار شود:

  // "web/my-analytics.js" & "web/my-firestore.js" file loaded as a script into your "web/index.html" file:
  window.addEventListener('load', async function (ev) {
    window.firebase_analytics = await import("./my-analytics.js");
    window.firebase_firestore = await import("./my-firestore.js");

    _flutter.loader.loadEntrypoint().then(function (engineInitializer) {
      // rest of the code

افزایه‌های دردسترس

محصول	نام افزایه	سایر دستگاه‌های Apple (macOS، و غیره)	پنجره
Firebase AI Logic ^۱	`firebase_ai`	بتا
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`	بتا
In-App Messaging	`firebase_in_app_messaging`
Firebase نصب	`firebase_app_installations`	بتا
Performance Monitoring	`firebase_performance`
Realtime Database	`firebase_database`	بتا
Remote Config	`firebase_remote_config`	بتا
SQL Connect ^۲	`firebase_data_connect`
کتابخانه‌های منسوخ‌شده یا پشتیبانی‌نشده
Dynamic Links	`firebase_dynamic_links`
بارگیری مدل یادگیری ماشین	`firebase_ml_model_downloader`	بتا

^{۱ Firebase AI Logic قبلاً
«Vertex AI in Firebase» با افزایه
firebase_vertexai نامیده می‌شد.}

^{۲ Firebase SQL Connect قبلاً
«Firebase Data Connect» نامیده می‌شد.}

مراحل بعدی

با Firebase Flutter Codelab تجربه عملی کسب کنید.
آماده‌سازی برای راه‌اندازی برنامه:
- هشدار بودجه را برای پروژه خود در کنسول Google Cloud تنظیم کنید.
- داشبورد استفاده و صورت‌حساب را در کنسول Firebase پایش کنید تا تصویری کلی از استفاده پروژه‌تان در چندین سرویس Firebase به‌دست آورید.
- بازبینه راه‌اندازی Firebase را مرور کنید.