این صفحه مروری مختصر بر چندین مفهوم مهم در مورد پروژههای Firebase ارائه میدهد. در صورت وجود، برای یافتن اطلاعات دقیقتر در مورد ویژگیها، سرویسها، ابزارها و بهترین شیوهها، پیوندها را دنبال کنید.
رابطه بین پروژهها، برنامهها و محصولات فایربیس
یک پروژه Firebase، نهاد سطح بالای Firebase است. در یک پروژه، میتوانید برنامههای Apple، Android یا وب خود را ثبت کنید. پس از ثبت برنامههای خود در Firebase، میتوانید SDK های Firebase را برای هر تعداد از محصولات Firebase ، مانند Analytics ، Cloud Firestore ، Performance Monitoring یا Remote Config اضافه کنید.
برای کسب اطلاعات بیشتر در مورد این فرآیند، به راهنمای شروع به کار برای پلتفرم خود مراجعه کنید:
آیاواس+ | اندروید | وب | یونیتی | سیپلاسپلاس | فلاتر
درک سلسله مراتب پروژههای Firebase
این نمودار سلسله مراتب اساسی یک پروژه Firebase را نشان میدهد. در اینجا روابط کلیدی آمده است:
یک پروژه Firebase مانند یک ظرف برای تمام برنامههای شما و هرگونه منابع و خدماتی است که برای پروژه فراهم شده است.
یک پروژه Firebase میتواند یک یا چند برنامه Firebase ثبت شده در آن داشته باشد (برای مثال، هر دو نسخه iOS و اندروید یک برنامه، یا هر دو نسخه رایگان و پولی یک برنامه).
همه برنامههای Firebase که در یک پروژه Firebase ثبت شدهاند، به تمام منابع و سرویسهای ارائه شده برای پروژه دسترسی دارند و آنها را به اشتراک میگذارند . در اینجا چند مثال آورده شده است:
تمام برنامههای Firebase که در یک پروژه Firebase ثبت شدهاند، backend های یکسانی مانند Firebase Hosting ، Authentication ، Realtime Database ، Cloud Firestore ، Cloud Storage و Cloud Functions را به اشتراک میگذارند.
تمام برنامههای Firebase که در یک پروژه Firebase ثبت شدهاند، با یک ویژگی Google Analytics مرتبط هستند، که در آن هر برنامه Firebase یک جریان داده جداگانه در آن ویژگی است.
رابطه بین پروژههای فایربیس و Google Cloud
وقتی یک پروژه جدید Firebase ایجاد میکنید، در واقع در پشت صحنه یک پروژه Google Cloud ایجاد میکنید. حتی میتوانید ابتدا یک پروژه Google Cloud ایجاد کنید، سپس بعداً Firebase را به پروژه اضافه کنید. میتوانید یک پروژه Google Cloud را به عنوان یک ظرف مجازی برای دادهها، کدها، پیکربندیها و سرویسها در نظر بگیرید.
توجه داشته باشید که برای همه پروژههای Firebase، Firebase به طور خودکار برچسب firebase:enabled در صفحه IAM & Admin > Labels کنسول Google Cloud به پروژه شما اضافه میکند. برای اطلاعات بیشتر در مورد این برچسب به سوالات متداول ما مراجعه کنید.
از آنجا که یک پروژه Firebase یک پروژه Google Cloud است :
شما میتوانید در کنسول Firebase و همچنین در کنسول Google Cloud و کنسول Google APIs به پروژه دسترسی داشته باشید و با آن تعامل داشته باشید.
شما میتوانید با استفاده از Firebase CLI ، gcloud CLI و هر منبع Terraform از گوگل با پروژه تعامل داشته باشید.
شما میتوانید از محصولات و APIهای هر دو سرویس Firebase و Google Cloud در این پروژه استفاده کنید.
مجوزها و نقشهای IAM برای پروژه بین Firebase و Google Cloud به اشتراک گذاشته شده است. هرگونه دسترسی که یک عضو پروژه (یعنی یک مدیر) به پروژه Google Cloud شما داشته باشد، برای پروژه Firebase شما نیز اعمال خواهد شد (و برعکس).
هزینهی پروژه بین Firebase و Google Cloud مشترک است. اگر هزینهی پروژه در پروژهی Google Cloud شما فعال باشد، پروژهی Firebase شما در طرح قیمتگذاری Blaze فایربیس که به صورت پرداخت در حین استفاده است، قرار خواهد گرفت.
شناسههای منحصر به فرد برای پروژه (مانند شماره پروژه و شناسه پروژه ) در 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 یک پروژه Google Cloud نیز هست، ممکن است متوجه شوید که وظایف یا محصولات مختلف شما را ملزم به استفاده از کنسول Google Cloud به جای کنسول Firebase میکنند.
Firebase CLI (یک ابزار خط فرمان)
فایربیس همچنین رابط خط فرمان Firebase را برای پیکربندی و مدیریت محصولات خاص فایربیس، مانند Firebase Hosting ، Cloud Functions for Firebase و Firebase Extensions ، ارائه میدهد.
پس از نصب رابط خط فرمان Firebase ، به دستور سراسری firebase دسترسی خواهید داشت. از رابط خط فرمان Firebase برای پیوند دادن دایرکتوری برنامه محلی خود به یک پروژه فایربیس استفاده کنید، سپس نسخههای جدیدی از محتوای میزبانیشده توسط فایربیس یا بهروزرسانیهای توابع را مستقر کنید .
مدیریت فایربیس REST API
با استفاده از Firebase Management REST API ، میتوانید یک پروژه Firebase را به صورت برنامهنویسی مدیریت کنید. برای مثال، میتوانید یک برنامه را به صورت برنامهنویسی در یک پروژه ثبت کنید یا برنامههایی را که قبلاً ثبت شدهاند ( iOS+ | Android | web ) فهرست کنید.
شناسههای پروژه فایربیس
یک پروژه Firebase را میتوان در backend Firebase و در رابطهای توسعهدهنده مختلف با استفاده از شناسههای مختلف، از جمله نام پروژه ، شماره پروژه و شناسه پروژه ، شناسایی کرد.
نام پروژه
وقتی یک پروژه ایجاد میکنید، یک نام برای پروژه ارائه میدهید. این شناسه ، نام داخلی یک پروژه در کنسول Firebase ، کنسول Google Cloud و رابط خط فرمان Firebase است. نام پروژه در هیچ یک از محصولات، خدمات یا منابع Firebase یا Google Cloud که به صورت عمومی قابل مشاهده هستند، نمایش داده نمیشود. این نام صرفاً به شما کمک میکند تا راحتتر بین چندین پروژه تمایز قائل شوید.
شما میتوانید نام پروژه را در هر زمانی در پنل بالای صفحه ویرایش کنید.
شماره پروژه
یک پروژه Firebase (و پروژه Google Cloud مرتبط با آن) دارای یک شماره پروژه است. این شناسه استاندارد منحصر به فرد جهانی است که توسط گوگل برای پروژه تعیین شده است. هنگام پیکربندی ادغامها و/یا برقراری تماسهای API به Firebase، Google یا سرویسهای شخص ثالث، از این شناسه استفاده کنید.
شما نمیتوانید شماره پروژه را ویرایش کنید. اگر یک پروژه را حذف کنید، شماره پروژه نیز حذف میشود و دیگر هرگز توسط هیچ پروژه دیگری قابل استفاده نخواهد بود.
با استفاده از یکی از این گزینهها ، شماره پروژه Firebase خود را پیدا کنید:
استفاده از کنسول Firebase : به
> برگه عمومی . شماره پروژه در پنل بالا نمایش داده میشود. استفاده از رابط خط فرمان Firebase : دستور
firebase projects:listرا اجرا کنید. شماره پروژه به همراه تمام پروژههای فایربیس مرتبط با حساب شما نمایش داده میشود.استفاده از API مدیریت REST فایربیس : فراخوانی
projects.list. بدنه پاسخ شامل شماره پروژه در شیءFirebaseProjectاست.