Catch up on everthing we announced at this year's Firebase Summit. Learn more

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

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

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

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

بدانید اطلاعات بیشتر در مورد این فرآیند را در گرفتن راهنماهای آغاز شده ( سیستم عامل اپل | آندروید | وب | وحدت | 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 ) دارای تعداد پروژه. این شناسه متعارف جهانی منحصربفرد گوگل برای پروژه است. هنگام پیکربندی یکپارچه‌سازی‌ها و/یا برقراری تماس‌های 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 و شناسه پروژه

ID پروژه در منابع 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 (برنامه های Apple/Android) یا یک شی پیکربندی (برنامه های وب) را ارائه می دهد که مستقیماً به فهرست برنامه محلی خود اضافه می کنید.

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

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

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

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

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

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

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

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

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

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

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

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

کنسول Firebase

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

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

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

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

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

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

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

Firebase Management REST API

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

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

افزودن اپلیکیشن به پروژه

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

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

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

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

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

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

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

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

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

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

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

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

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

چند اجاره ای

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

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

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

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