‫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 نسخه ۷.۰ یا بالاتر استفاده می‌کند

وب

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

اگر ازقبل برنامه 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.1.0/firebase-firestore.js");
    window.firebase_analytics = await import("https://www.gstatic.com/firebasejs/13.1.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 را مرور کنید.