آشنایی با پروژه‌های Firebase

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

رابطه بین پروژه‌ها، برنامه‌ها، و محصولات Firebase

پروژه Firebase نهاد سطح بالا برای Firebase است. در پروژه، می‌توانید برنامه‌های Apple،‏ Android، یا وب خود را ثبت کنید. پس‌از ثبت برنامه‌هایتان در Firebase، می‌توانید کیت‌های توسعه نرم‌افزار Firebase را برای هر تعداد از محصولات Firebase، مانند Analytics، Cloud Firestore، Performance Monitoring، یا Remote Config اضافه کنید.

اطلاعات دقیق‌تر درباره این فرایند را در راهنمای «شروع به کار» برای پلاتفرم خودتان ببینید:
iOS+ | Android | وب | Unity | C++ | Flutter.

درک سلسله‌مراتب پروژه‌های Firebase

نموداری که سلسله‌مراتب پایه پروژه Firebase را نشان می‌دهد، ازجمله
          پروژه، برنامه‌های ثبت‌شده آن، و منابع و سرویس‌های
          تأمین‌شده آن این نمودار سلسله‌مراتب اصلی پروژه Firebase را نشان می‌دهد. رابطه‌های کلیدی در اینجا آمده است:

  • پروژه Firebase مانند ظرفی برای همه برنامه‌ها و منابع و سرویس‌های ارائه‌شده برای پروژه است.

  • یک پروژه Firebase می‌تواند یک یا چند برنامه Firebase ثبت‌شده داشته باشد (برای مثال، هم نسخه iOS و هم نسخه Android یک برنامه، یا هم نسخه رایگان و هم نسخه پولی یک برنامه).

  • همه برنامه‌های Firebase که در یک پروژه Firebase ثبت شده‌اند هم‌رسانی می‌کنند و به همه منابع و سرویس‌های یکسانی که برای پروژه فراهم شده است دسترسی دارند. چند نمونه در زیر آمده است:

    • همه «برنامه‌های Firebase» ثبت‌شده در یک پروژه Firebase از همان بخش‌های پشتیبان، مانند Firebase Hosting، Authentication، Realtime Database، Cloud Firestore، Cloud Storage، و Cloud Functions استفاده می‌کنند.

    • همه «برنامه‌های Firebase» ثبت‌شده در یک پروژه Firebase با یک دارایی Google Analytics مرتبط هستند، که در آن هر «برنامه Firebase» یک جاری‌سازی داده جداگانه در آن دارایی است.

رابطه بین پروژه‌های Firebase و Google Cloud

وقتی پروژه Firebase جدیدی ایجاد می‌کنید، درواقع درحال ایجاد Google Cloud پروژه در پشت صحنه هستید. حتی می‌توانید ابتدا پروژه Google Cloud ایجاد کنید، سپس Firebase را بعداً به پروژه اضافه کنید. می‌توانید پروژه Google Cloud را به‌عنوان محفظه‌ای مجازی برای داده‌ها، کد، پیکربندی، و سرویس‌ها درنظر بگیرید.

توجه داشته باشید که برای همه پروژه‌های Firebase،‏ Firebase به‌طور خودکار برچسب firebase:enabled را در صفحه IAM و سرپرست > برچسب‌ها در کنسول Google Cloud به پروژه شما اضافه می‌کند. در پرسشگان ما درباره این برچسب بیشتر بدانید.

ازآنجایی‌که پروژه Firebase یک پروژه Google Cloud است:

  • می‌توانید در کنسول Firebase و همچنین در کنسول Google Cloud و کنسول Google APIs به پروژه دسترسی داشته باشید و با آن تعامل کنید.

  • می‌توانید بااستفاده از Firebase CLI، gcloud CLI، و هر منبع Terraform از Google با پروژه تعامل داشته باشید.

  • می‌توانید از محصولات و میاناهای برنامه‌سازی کاربردی Firebase و Google Cloud در پروژه استفاده کنید.

  • اجازه‌ها و نقش‌های IAM برای پروژه در Firebase و Google Cloud هم‌رسانی می‌شود. هرگونه دسترسی که عضو پروژه (یعنی اصلی) به پروژه Google Cloud شما دارد، به پروژه Firebase شما نیز اعمال خواهد شد (و بالعکس).

  • صدور صورت‌حساب برای پروژه بین Firebase و Google Cloud مشترک است. اگر صدور صورت‌حساب در پروژه Google Cloud شما فعال باشد، پروژه Firebase شما در طرح قیمت‌گذاری Blaze پرداخت به اندازه استفاده Firebase قرار خواهد گرفت.

  • شناسه‌های یکتای پروژه (مثل شماره پروژه و شناسه پروژه) در Firebase و Google Cloud هم‌رسانی می‌شود.

  • هرگونه سلسله‌مراتب منابع اعمال‌شده بر پروژه Google Cloud (برای مثال، سازمان، پوشه‌ها، غیره) بر پروژه Firebase شما نیز اعمال خواهد شد.

  • با حذف پروژه، آن پروژه در Firebase و Google Cloud حذف می‌شود.

  • حذف یا اصلاح منبع یا داده در پروژه در سراسر Firebase و Google Cloud اعمال می‌شود.

راه‌اندازی پروژه Firebase و ثبت برنامه‌ها

می‌توانید پروژه Firebase راه‌اندازی کنید و برنامه‌ها را در کنسول Firebase ثبت کنید (یا برای موارد استفاده پیشرفته، از Firebase Management REST API یا Firebase CLI استفاده کنید). وقتی پروژه‌ای را راه‌اندازی می‌کنید و برنامه‌هایی را ثبت می‌کنید، باید تصمیمات سازمانی بگیرید و اطلاعات پیکربندی مختص Firebase را به پروژه‌های محلی‌تان اضافه کنید.

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

تعامل با پروژه Firebase

علاوه‌بر کیت‌های توسعه نرم‌افزار محصول، می‌توانید مستقیماً با پروژه Firebase بااستفاده از چندین ابزار و میانای مختلف تعامل داشته باشید.

کنسول Firebase

کنسول Firebase غنی‌ترین محیط را برای مدیریت محصولات، برنامه‌ها، و تنظیمات سطح پروژه Firebase ارائه می‌دهد.

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

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

توجه داشته باشید که چون پروژه Firebase پروژه Google Cloud نیز هست، ممکن است متوجه شوید که برای تکالیف یا محصولات مختلف باید به‌جای کنسول Firebase از کنسول Google Cloud استفاده کنید.

Firebase CLI (ابزار خط فرمان)

Firebase همچنین Firebase CLI را برای پیکربندی و مدیریت محصولات خاص Firebase، مانند Firebase Hosting، Cloud Functions for Firebase، و Firebase Extensions ارائه می‌دهد.

پس‌از نصب Firebase CLI، به فرمان سراسری firebase دسترسی دارید. از Firebase CLI برای پیوند دادن دایرکتوری برنامه محلی خود به پروژه Firebase، سپس استقرار نسخه‌های جدید محتوای میزبانی‌شده Firebase یا به‌روزرسانی توابع استفاده کنید.

Firebase Management REST API

بااستفاده از Firebase Management REST API، می‌توانید پروژه Firebase را به‌صورت برنامه‌نویسی‌شده مدیریت کنید. برای مثال، می‌توانید برنامه‌ای را به‌صورت برنامه‌نویسی‌شده در پروژه‌ای ثبت کنید یا برنامه‌هایی را که قبلاً ثبت شده‌اند فهرست کنید (iOS+ | Android | وب).

شناسه‌های پروژه Firebase

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

نام پروژه

وقتی پروژه‌ای ایجاد می‌کنید، نام پروژه را ارائه می‌دهید. این شناسه نام فقط داخلی برای پروژه‌ای در کنسول Firebase، کنسول Google Cloud، و رابط خط فرمان Firebase است. نام پروژه در هیچ محصول، سرویس، یا منبع Firebase یا Google Cloud که برای عموم قابل‌مشاهده باشد نشان داده نمی‌شود؛ این نام صرفاً برای کمک به شما در تشخیص راحت‌تر پروژه‌های متعدد است.

هرزمان بخواهید می‌توانید نام پروژه را در قاب بالایی تنظیمات > برگه عمومی در کنسول Firebase ویرایش کنید.

شماره پروژه

پروژه Firebase (و پروژه Google Cloud مرتبط با آن) شماره پروژه دارد. این شناسه متعارف جهانی یکتا است که Google برای پروژه اختصاص داده است. از این شناسه هنگام پیکربندی ادغام‌ها و/یا برقراری تماس‌های API با Firebase،‏ Google، یا سرویس‌های طرف سوم استفاده کنید.

نمی‌توانید شماره پروژه را ویرایش کنید. اگر پروژه‌ای را حذف کنید، شماره پروژه نیز حذف می‌شود و هیچ پروژه دیگری نمی‌تواند دوباره از آن استفاده کند.

شناسه پروژه

پروژه Firebase (و پروژه Google Cloud مرتبط با آن) شناسه پروژه دارد. این شناسه یکتای تعریف‌شده توسط کاربر برای پروژه در سراسر Firebase و Google Cloud است. وقتی پروژه Firebase ایجاد می‌کنید، Firebase به‌طور خودکار شناسه یکتایی به پروژه اختصاص می‌دهد، اما می‌توانید آن را درطول راه‌اندازی پروژه ویرایش کنید. این شناسه معمولاً باید به‌عنوان نام مستعار راحتی برای ارجاع به پروژه درنظر گرفته شود.

فایل‌ها و اشیای پیکربندی Firebase

وقتی برنامه‌ای را در پروژه Firebase ثبت می‌کنید، کنسول Firebase یک فایل پیکربندی Firebase (برنامه‌های Apple/Android) یا یک شیء پیکربندی (برنامه‌های وب) ارائه می‌دهد که مستقیماً به دایرکتوری برنامه محلی‌تان اضافه می‌کنید.

  • برای برنامه‌های Apple، فایل پیکربندی GoogleService-Info.plist را اضافه می‌کنید.
  • برای برنامه‌های Android، فایل پیکربندی google-services.json را اضافه می‌کنید.
  • برای برنامه‌های وب، شیء پیکربندی Firebase را اضافه می‌کنید.

هرزمان بخواهید می‌توانید فایل یا شیء پیکربندی Firebase برنامه را دریافت کنید.

به‌دست آورید.

فایل یا شیء پیکربندی Firebase یک برنامه را با یک پروژه Firebase خاص و منابع آن (پایگاه‌های داده، باکت‌های ذخیره‌سازی، و غیره) مرتبط می‌کند. پیکربندی شامل «گزینه‌های Firebase» است که پارامترهای موردنیاز Firebase و سرویس‌های Google برای برقراری ارتباط با میاناهای برنامه‌سازی کاربردی سرور Firebase و مرتبط کردن داده‌های مشتری با پروژه Firebase و برنامه Firebase است.

حداقل «گزینه‌های Firebase» موردنیاز در اینجا آمده است:

  • کلید Firebase API: رشته‌ای یکتا که برای مسیریابی درخواست‌ها به پروژه Firebase شما استفاده می‌شود. این کلید میانای API باید فقط برای استفاده از میاناهای API مرتبط با Firebase محدود شود. (مقدار نمونه: AIzaSyDOCAbC123dEf456GhI789jKl012-MnO)

  • شناسه پروژه Firebase: شناسه منحصربه‌فرد جهانی تعریف‌شده توسط کاربر برای پروژه در سراسر Firebase و Google Cloud. این شناسه ممکن است در نشانی‌های وب یا نام‌های برخی‌از منابع Firebase نشان داده شود، اما به‌طور کلی باید به‌عنوان نام مستعار مناسبی برای ارجاع به پروژه درنظر گرفته شود. (مقدار نمونه: myapp-project-123)

  • شناسه برنامه Firebase («شناسه برنامه»): شناسه یکتای جهانی برای برنامه Firebase در سراسر Firebase و Google Cloud با قالب مختص پلاتفرم:

    • برنامه‌های Firebase Apple: GOOGLE_APP_ID (مقدار نمونه: 1:1234567890:ios:321abc456def7890)
      این شناسه بسته ترکیبی Apple نیست.
    • برنامه‌های Firebase Android: mobilesdk_app_id (مقدار نمونه: 1:1234567890:android:321abc456def7890)
      این نام بسته Android یا شناسه برنامه Android نیست.
    • برنامه‌های وب Firebase: appId (مقدار نمونه: 1:65211879909:web:3ae38ef1cdcb2e01fe5f0c)

محتوای فایل یا شیء پیکربندی Firebase عمومی درنظر گرفته می‌شود، ازجمله شناسه مختص پلاتفرم برنامه (شناسه بسته Apple یا نام بسته Android) و مقادیر مختص پروژه Firebase، مثل کلید میانای برنامه‌سازی کاربردی، شناسه پروژه، نشانی وب Realtime Database، و نام سطل Cloud Storage. با توجه به این موضوع، از Firebase Security Rules برای محافظت از داده‌ها و فایل‌هایتان در Realtime Database، Cloud Firestore، و Cloud Storage استفاده کنید.

برای پروژه‌های متن‌باز، معمولاً توصیه نمی‌کنیم که فایل یا شیء پیکربندی Firebase برنامه را در کنترل منبع بگنجانید، زیرا در بیشتر موارد، کاربران شما باید پروژه‌های Firebase خودشان را ایجاد کنند و برنامه‌هایشان را به منابع Firebase خودشان (ازطریق فایل یا شیء پیکربندی Firebase خودشان) هدایت کنند.

محدودیت‌های کلی برای پروژه‌ها، برنامه‌ها، و سایت‌های Firebase

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

  • تعداد پروژه‌ها به‌ازای هر «حساب Google» (نشانی ایمیل)

    • طرح قیمت‌گذاری Spark: سهمیه ایجاد پروژه به تعداد کمی پروژه (معمولاً حدود ۵ تا ۱۰) محدود است.
    • طرح قیمت‌گذاری Blaze: سهمیه ایجاد پروژه همچنان محدود است، اما ممکن است با پیوند دادن حساب Cloud Billing خوش‌حساب افزایش یابد.

    به موارد زیر درباره حد مجاز سهمیه ایجاد پروژه توجه کنید:

    • این محدودیت مختص Firebase نیست. محدودیت‌های Firebase در سهمیه پروژه همانند محدودیت‌های Google Cloud است.
    • در موارد نادری که به آن نیاز است، می‌توانید درخواست افزایش سهمیه پروژه کنید.
    • حذف کامل پروژه ۳۰ روز طول می‌کشد و تا زمانی که پروژه کاملاً حذف شود، جزو سهمیه پروژه محسوب می‌شود.

    با روال‌های مطلوب عمومی توصیه‌شده Firebase برای راه‌اندازی پروژه‌های Firebase آشنا شوید.

  • تعداد برنامه‌ها در هر پروژه

    Firebase تعداد کل «برنامه‌های Firebase» را در هر پروژه Firebase به ۳۰ عدد محدود می‌کند.

    باید مطمئن شوید که همه «برنامه‌های Firebase» در یک پروژه Firebase از دیدگاه کاربر نهایی، انواع پلاتفرم یک برنامه باشند. در اسناد روال‌های مطلوب ما، درباره چندمستأجری بیشتر بخوانید.

    در پرسشگان درباره محدودیت تعداد برنامه‌ها در هر پروژه بیشتر بدانید.

  • تعداد سایت‌های Hosting در هر پروژه

    Firebase Hosting ویژگی چندسایتی حداکثر از ۳۶ سایت در هر پروژه پشتیبانی می‌کند.

درحال راه‌اندازی برنامه