Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

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

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

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

پروژه Firebase موجودیت سطح بالا برای Firebase است. در یک پروژه ، با ثبت برنامه های iOS ، Android یا وب ، برنامه های Firebase را ایجاد می کنید. بعد از اینکه شما برنامه های خود را برای ثبت نام اینجا با Firebase، شما می توانید SDK ها فایربیس برای هر تعداد از اضافه محصولات فایربیس ، مانند تجزیه و تحلیل ترافیک، ابر Firestore، نظارت بر عملکرد، و یا از راه دور پیکربندی.

بدانید اطلاعات بیشتر در مورد این فرآیند در راهنماهای شروع ( در iOS | آندروید | وب | وحدت | C ++ ).

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

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

از آنجا که یک پروژه فایربیس یک پروژه در Google Cloud:

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

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

اطمینان حاصل کنید که به بررسی برخی از کلی پروژه در سطح بهترین شیوه (در پایین این صفحه) قبل از راه اندازی یک پروژه و ثبت برنامه های.

نام پروژه

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

شما می توانید یک نام پروژه در هر زمان در ویرایش تنظیمات پروژه از کنسول فایربیس. نام پروژه در پنجره بالا نمایش داده می شود.

شماره پروژه

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

تماس های API و شماره پروژه

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

اطلاعات بیشتر در مورد استفاده از شناسههای پروژه، به ویژه تعداد پروژه، در گوگل AIP 2510 استاندارد .

شماره پروژه را بیابید

  • کنسول فایربیس: کلیک کنید تنظیمات پروژه . شماره پروژه در پنجره بالا نمایش داده می شود.

  • فایربیس CLI: اجرای firebase projects:list . شماره پروژه همراه با تمام پروژه های Firebase مرتبط با حساب شما نمایش داده می شود.

  • فایربیس مدیریت REST API: تماس projects.list . بدن پاسخ شامل تعداد پروژه در FirebaseProject شی.

شناسه پروژه

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

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

منابع Firebase و شناسه پروژه

شناسه پروژه در منابع قابل مشاهده عموم Firebase نمایش داده می شود ، به عنوان مثال:

  • به طور پیش فرض میزبانی دامنه - PROJECT_ID .web.app و PROJECT_ID .firebaseapp.com
  • به طور پیش فرض بیدرنگ URL پایگاه داده - PROJECT_ID -default-rtdb.firebaseio.com یا PROJECT_ID -default-rtdb. REGION_CODE .firebasedatabase.app
  • به طور پیش فرض ذخیره سازی ابر نام سطل - PROJECT_ID .appspot.com

برای همه منابع فوق ، می توانید نمونه های غیر پیش فرض ایجاد کنید. نامهای قابل مشاهده عمومی برای موارد پیش فرض کاملاً قابل سفارشی سازی است. شما می توانید دامنههای سفارشی اتصال به یک سایت فایربیس میزبانی، سفال پایگاه داده بیدرنگ ، و ایجاد چند سطل ابر ذخیره سازی (بازدید از صفحه پلت فرم خاص شروع به کار).

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

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

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

تماس های API و شناسه پروژه

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

اطلاعات بیشتر در مورد استفاده از شناسههای پروژه، به ویژه تعداد پروژه، در گوگل AIP 2510 استاندارد .

شناسه پروژه را پیدا کنید

  • کنسول فایربیس: کلیک کنید تنظیمات پروژه . شناسه پروژه در پنجره بالا نمایش داده می شود.

  • فایربیس CLI: اجرای firebase projects:list . شناسه پروژه همراه با تمام پروژه های Firebase مرتبط با حساب شما نمایش داده می شود.

  • فایربیس مدیریت REST API: تماس projects.list . بدن پاسخ شامل شناسه پروژه در FirebaseProject شی.

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

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

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

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

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

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

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

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

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

محتوای فایل یا شیء پیکربندی Firebase عمومی محسوب می شود ، از جمله شناسه مخصوص پلت فرم برنامه (شناسه بسته iOS یا نام بسته Android) و مقادیر خاص پروژه Firebase ، مانند کلید API ، شناسه پروژه ، آدرس پایگاه داده در زمان واقعی و نام سطل ذخیره سازی ابری. با توجه به این، استفاده از قوانین فایربیس امنیتی برای محافظت از اطلاعات و فایل های خود را در پایگاه بیدرنگ ، ابر Firestore ، و ابر ذخیره سازی .

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

مدیریت پروژه Firebase

اطمینان حاصل کنید که به بررسی کلی پروژه در سطح بهترین شیوه (در پایین این صفحه) برای ملاحظات است که ممکن است تحت تاثیر قرار دهد چگونه شما را مدیریت یک پروژه فایربیس.

ابزارهای مدیریت یک پروژه

کنسول Firebase

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

کنسول Firebase - صفحه نمای کلی پروژه

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

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

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

فایربیس نیز ارائه می دهد فایربیس CLI برای پیکربندی و مدیریت خاص محصولات فایربیس، مانند فایربیس میزبانی و توابع Cloud برای فایربیس.

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

API REST Firebase Management

با استفاده از API REST فایربیس مدیریت ، شما می توانید از طریق برنامه نویسی مدیریت یک پروژه فایربیس. برای مثال، شما می توانید یک برنامه برنامه نویسی با یک پروژه ثبت نام کنید یا لیست برنامه های که قبلا ثبت نام ( در iOS | آندروید | وب ).

بهترین شیوه های عمومی

افزودن برنامه به پروژه

اطمینان حاصل شود که تمام برنامه های در یک پروژه انواع پلت فرم از همان نرم افزار از دیدگاه کاربر نهایی است. توصیه می شود نسخه های iOS ، Android و وب یک برنامه یا بازی مشابه را با پروژه Firebase یکسان ثبت کنید. همه برنامه های یک پروژه به طور کلی منابع Firebase یکسانی (پایگاه داده ، سطل های ذخیره سازی و غیره) را به اشتراک می گذارند.

اگر شما چند ساخت انواع با IOS های مختلف بسته نرم افزاری شناسه یا نام بسته آندروید تعریف شده است، شما می توانید هر نوع با یک پروژه فایربیس جداگانه ثبت نام کنید. با این حال، اگر شما انواع که سهم منابع فایربیس همان، ثبت نام آنها با پروژه فایربیس است.

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

  • تعداد پروژه ها در هر حساب

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

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

    توجه داشته باشید که حذف کامل یک پروژه به 30 روز زمان نیاز دارد و تا زمانی که پروژه به طور کامل حذف نشود ، شامل سهمیه پروژه می شود.

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

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

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

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

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

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

اجاره چندگانه

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

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

به عنوان مثال ، اگر یک برنامه برچسب سفید ایجاد کنید ، هر برنامه دارای برچسب مستقل باید پروژه Firebase خود را داشته باشد ، اما نسخه های iOS و Android آن برچسب می توانند در یک پروژه باشند. هر برنامه دارای برچسب مستقل نباید (به دلایل حفظ حریم خصوصی) داده ها را با دیگران به اشتراک بگذارد.

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