پروژه های Firebase را درک کنید

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

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

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

اطلاعات دقیق‌تری درباره این فرآیند در راهنمای شروع برای پلتفرم خود بیاموزید:
iOS+ | اندروید | وب | وحدت | C++ | بال زدن .

آشنایی با سلسله مراتب پروژه های 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 در صفحه Labels برای پروژه شما در کنسول Google Cloud اضافه می‌کند. در سؤالات متداول ما درباره این برچسب بیشتر بیاموزید.

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

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

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

  • می‌توانید از محصولات و APIهای 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

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

کنسول Firebase

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

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

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

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

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

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

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

Firebase Management REST API

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

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

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

نام پروژه

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

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

شماره پروژه

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

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

شناسه پروژه

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

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

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

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

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

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

  • کلید API : یک رشته رمزگذاری شده ساده که هنگام فراخوانی API های خاصی که نیازی به دسترسی به داده های کاربر خصوصی ندارند استفاده می شود (مقدار مثال: AIzaSyDOCAbC123dEf456GhI789jKl012-MnO )

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

  • شناسه برنامه ("AppID") : شناسه منحصر به فرد برای برنامه Firebase در تمام Firebase با یک قالب خاص پلت فرم:

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

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

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

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

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

  • تعداد پروژه ها در هر حساب Google (آدرس ایمیل)

    • طرح قیمت گذاری جرقه : سهمیه ایجاد پروژه به تعداد کمی از پروژه ها (معمولاً حدود 5-10) محدود می شود.
    • طرح قیمت گذاری Blaze : سهمیه ایجاد پروژه هنوز محدود است، اما ممکن است با پیوند دادن یک حساب Cloud Billing در وضعیت خوب، افزایش یابد.

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

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

    درباره بهترین روش های کلی توصیه شده Firebase برای راه اندازی پروژه های Firebase اطلاعات کسب کنید.

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

    Firebase تعداد کل برنامه های Firebase را در پروژه Firebase به 30 محدود می کند.

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

    در بخش سؤالات متداول درباره محدودیت برنامه‌ها در هر پروژه بیشتر بدانید.

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

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

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

،

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

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

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

اطلاعات دقیق‌تری درباره این فرآیند در راهنمای شروع برای پلتفرم خود بیاموزید:
iOS+ | اندروید | وب | وحدت | C++ | بال زدن .

آشنایی با سلسله مراتب پروژه های 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 در صفحه Labels برای پروژه شما در کنسول Google Cloud اضافه می‌کند. در سؤالات متداول ما درباره این برچسب بیشتر بیاموزید.

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

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

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

  • می‌توانید از محصولات و APIهای 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

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

کنسول Firebase

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

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

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

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

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

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

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

Firebase Management REST API

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

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

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

نام پروژه

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

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

شماره پروژه

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

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

شناسه پروژه

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

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

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

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

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

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

  • کلید API : یک رشته رمزگذاری شده ساده که هنگام فراخوانی API های خاصی که نیازی به دسترسی به داده های کاربر خصوصی ندارند استفاده می شود (مقدار مثال: AIzaSyDOCAbC123dEf456GhI789jKl012-MnO )

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

  • شناسه برنامه ("AppID") : شناسه منحصر به فرد برای برنامه Firebase در تمام Firebase با یک قالب خاص پلت فرم:

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

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

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

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

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

  • تعداد پروژه ها در هر حساب Google (آدرس ایمیل)

    • برنامه قیمت گذاری جرقه : سهمیه ایجاد پروژه به تعداد کمی از پروژه ها محدود می شود (معمولاً حدود 5-10).
    • برنامه قیمت گذاری Blaze : سهمیه ایجاد پروژه هنوز محدود است ، اما ممکن است با پیوند یک حساب Cloud Billing در وضعیت خوبی افزایش یابد.

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

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

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

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

    Firebase تعداد کل برنامه های Firebase را در یک پروژه Firebase به 30 محدود می کند.

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

    در مورد محدودیت برنامه ها در هر پروژه در سؤالات متداول بیشتر بدانید.

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

    ویژگی Multisite Firebase Hosting از حداکثر 36 سایت در هر پروژه پشتیبانی می کند.

راه اندازی برنامه خود

،

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

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

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

اطلاعات دقیق تر در مورد این فرآیند را در راهنمای شروع کار برای سیستم عامل خود بیاموزید:
iOS+ | اندروید | وب | وحدت | C++ | بال زدن .

درک سلسله مراتب پروژه های 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 در صفحه برچسب ها برای پروژه خود در کنسول Google Cloud فعال می شود. در مورد این برچسب در سؤالات متداول ما بیشتر بدانید.

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

  • شما می توانید در کنسول Firebase و همچنین در کنسول Google Cloud و کنسول Google APIS با پروژه دسترسی داشته و با آن ارتباط برقرار کنید.

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

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

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

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

  • شناسه های منحصر به فرد برای این پروژه (مانند شماره پروژه و شناسه پروژه ) در Firebase و Google Cloud به اشتراک گذاشته می شوند.

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

  • حذف پروژه آن را در Firebase و Google Cloud حذف می کند.

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

تنظیم یک پروژه Firebase و ثبت نام برنامه ها

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

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

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

علاوه بر SDK های محصول ، می توانید با استفاده از چندین ابزار و رابط مختلف ، مستقیماً با یک پروژه 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 ارائه می دهد.

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

API Management Firebase Management

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

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

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

نام پروژه

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

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

شماره پروژه

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

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

شناسه پروژه

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

پرونده ها و اشیاء پیکربندی Firebase

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

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

در هر زمان ، می توانید پرونده پیکربندی Firebase یا شیء یک برنامه را بدست آورید .

یک پرونده پیکربندی Firebase یا Object یک برنامه را با یک پروژه خاص Firebase و منابع آن (پایگاه داده ها ، سطل های ذخیره سازی و غیره) مرتبط می کند. پیکربندی شامل "گزینه های Firebase" است که پارامترهای مورد نیاز Firebase و Google Services برای برقراری ارتباط با API های سرور Firebase و ارتباط داده های مشتری با پروژه Firebase و برنامه Firebase هستند. در اینجا حداقل "گزینه های Firebase" مورد نیاز است:

  • API Key : یک رشته رمزگذاری شده ساده هنگام تماس با API های خاص که نیازی به دسترسی به داده های کاربر خصوصی ندارند (مثال: AIzaSyDOCAbC123dEf456GhI789jKl012-MnO )

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

  • شناسه برنامه ("AppID") : شناسه منحصر به فرد برای برنامه Firebase در تمام Firebase با فرمت خاص سیستم عامل:

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

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

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

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

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

  • تعداد پروژه ها در هر حساب Google (آدرس ایمیل)

    • برنامه قیمت گذاری جرقه : سهمیه ایجاد پروژه به تعداد کمی از پروژه ها محدود می شود (معمولاً حدود 5-10).
    • برنامه قیمت گذاری Blaze : سهمیه ایجاد پروژه هنوز محدود است ، اما ممکن است با پیوند یک حساب Cloud Billing در وضعیت خوبی افزایش یابد.

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

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

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

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

    Firebase تعداد کل برنامه های Firebase را در یک پروژه Firebase به 30 محدود می کند.

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

    در مورد محدودیت برنامه ها در هر پروژه در سؤالات متداول بیشتر بدانید.

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

    ویژگی Multisite Firebase Hosting از حداکثر 36 سایت در هر پروژه پشتیبانی می کند.

راه اندازی برنامه خود

،

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

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

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

اطلاعات دقیق تر در مورد این فرآیند را در راهنمای شروع کار برای سیستم عامل خود بیاموزید:
iOS+ | اندروید | وب | وحدت | C++ | بال زدن .

درک سلسله مراتب پروژه های 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 در صفحه برچسب ها برای پروژه خود در کنسول Google Cloud فعال می شود. در مورد این برچسب در سؤالات متداول ما بیشتر بدانید.

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

  • شما می توانید در کنسول Firebase و همچنین در کنسول Google Cloud و کنسول Google APIS با پروژه دسترسی داشته و با آن ارتباط برقرار کنید.

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

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

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

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

  • شناسه های منحصر به فرد برای این پروژه (مانند شماره پروژه و شناسه پروژه ) در Firebase و Google Cloud به اشتراک گذاشته می شوند.

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

  • حذف پروژه آن را در Firebase و Google Cloud حذف می کند.

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

تنظیم یک پروژه Firebase و ثبت نام برنامه ها

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

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

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

علاوه بر SDK های محصول ، می توانید با استفاده از چندین ابزار و رابط مختلف ، مستقیماً با یک پروژه 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 ارائه می دهد.

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

API Management Firebase Management

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

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

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

نام پروژه

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

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

شماره پروژه

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

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

شناسه پروژه

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

پرونده ها و اشیاء پیکربندی Firebase

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

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

در هر زمان ، می توانید پرونده پیکربندی Firebase یا شیء یک برنامه را بدست آورید .

یک پرونده پیکربندی Firebase یا Object یک برنامه را با یک پروژه خاص Firebase و منابع آن (پایگاه داده ها ، سطل های ذخیره سازی و غیره) مرتبط می کند. پیکربندی شامل "گزینه های Firebase" است که پارامترهای مورد نیاز Firebase و Google Services برای برقراری ارتباط با API های سرور Firebase و ارتباط داده های مشتری با پروژه Firebase و برنامه Firebase هستند. در اینجا حداقل "گزینه های Firebase" مورد نیاز است:

  • API Key : یک رشته رمزگذاری شده ساده هنگام تماس با API های خاص که نیازی به دسترسی به داده های کاربر خصوصی ندارند (مثال: AIzaSyDOCAbC123dEf456GhI789jKl012-MnO )

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

  • شناسه برنامه ("AppID") : شناسه منحصر به فرد برای برنامه Firebase در تمام Firebase با فرمت خاص سیستم عامل:

    • برنامه های Apple Firebase: GOOGLE_APP_ID (مقدار مثال: 1:1234567890:ios:321abc456def7890 )
      این یک شناسه بسته نرم افزاری نیست .
    • Firebase Android apps: mobilesdk_app_id (example value: 1:1234567890:android:321abc456def7890 )
      This is not an Android package name or Android application ID.
    • Firebase Web apps: appId (example value: 1:65211879909:web:3ae38ef1cdcb2e01fe5f0c )

The content of the Firebase config file or object is considered public, including the app's platform-specific ID (Apple bundle ID or Android package name) and the Firebase project-specific values, like the API Key, project ID, Realtime Database URL, and Cloud Storage bucket name. Given this, use Firebase Security Rules to protect your data and files in Realtime Database , Cloud Firestore , and Cloud Storage .

For open source projects, we generally do not recommend including the app's Firebase config file or object in source control because, in most cases, your users should create their own Firebase projects and point their apps to their own Firebase resources (via their own Firebase config file or object).

General limits for Firebase projects, apps, and sites

Here are some general limits for Firebase projects, apps, and sites:

  • Number of projects per Google Account (email address)

    • Spark pricing plan : Project-creation quota is limited to a small number of projects (usually around 5-10).
    • Blaze pricing plan : Project-creation quota is still limited, but it may increase with the linking of a Cloud Billing account in good standing.

    Note the following about the limit on project-creation quota:

    • This limit is not specific to Firebase. Firebase's limits on project quota are the same as those for Google Cloud .
    • In the rare case that's it's needed, you can request an increase in project quota .
    • The complete deletion of a project requires 30 days and counts toward project quota until the project is fully deleted.

    Learn about Firebase's recommended general best practices for setting up Firebase projects .

  • Number of apps per project

    Firebase restricts the total number of Firebase Apps within a Firebase project to 30.

    You should ensure that all Firebase Apps within a single Firebase project are platform variants of the same application from an end-user perspective. Read more about multi-tenancy in our best practices docs.

    Learn more about the limit on apps per project in the FAQ.

  • Number of Hosting sites per project

    The Firebase Hosting multisite feature supports a maximum of 36 sites per project.

Launching your app