‫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 استفاده کنند.
مطمئن شوید که برنامه شما الزامات زیر را برآورده می‌کند:
- سطح میانای برنامه‌سازی کاربردی ۲۳ (مارشمالو) یا بالاتر را هدف‌گیری می‌کند
- از Android 6.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 کارهای زیر را انجام می‌دهد:

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

می‌توانید انتخاب کنید که از پروژه Firebase موجود استفاده کنید یا پروژه Firebase جدیدی ایجاد کنید. اگر ازقبل برنامه‌هایی در پروژه Firebase موجود ثبت کرده‌اید، «واسط خط فرمان FlutterFire» تلاش می‌کند آن‌ها را براساس پیکربندی پروژه 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

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

ازآنجایی‌که 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 ثبت و پیکربندی شده‌اند.

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

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

پشتیبانی از «انواع مطمئن»

«کیت توسعه نرم‌افزار 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 خود اضافه کنید، درون window.addEventListener برگشت تماس:

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

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

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

  // "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`
بارگیری‌کننده مدل ML	`firebase_ml_model_downloader`	بتا

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

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

مراحل بعدی

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