Google is committed to advancing racial equity for Black communities. See how.
این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.
Switch to English

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

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

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

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

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

ارتباط بین پروژه های Firebase و Google Cloud Platform (GCP)

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

از آنجا که یک پروژه فایربیس یک پروژه GCP است:

  • پروژه هایی که در کنسول Firebase ظاهر می شوند ، در کنسول GCP و کنسول Google API نیز ظاهر می شوند.

  • صورتحساب و مجوزهای پروژه ها در Firebase و GCP به اشتراک گذاشته می شود.

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

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

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

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

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

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

نام پروژه

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

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

شماره پروژه

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

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

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

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

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

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

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

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

شناسه پروژه

یک پروژه Firebase (و پروژه GCP مربوط به آن) دارای شناسه پروژه است . این یک شناسه منحصر به فرد تعریف شده توسط کاربر برای پروژه در کل Firebase و GCP است. هنگام ایجاد یک پروژه 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
  • نام سطل ذخیره سازی Cloud پیش فرض - PROJECT_ID .appspot.com

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

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

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

همچنین می توانید برای هر پروژه Firebase یک نام مستعار پروژه تنظیم کنید تا مجبور نشوید شناسه های پروژه را به خاطر بسپارید.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

کنسول Firebase

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

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

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

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

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

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

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

Firebase Management REST API

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

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

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

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

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

در حالی که هیچ محدودیتی در تعداد برنامه ها در یک پروژه وجود ندارد ، ثبت یک برنامه می تواند یک یا چند شناسه مشتری OAuth 2.0 اساسی ایجاد کند. حدود 30 شناسه مشتری وجود دارد که می تواند در یک پروژه ایجاد شود.

چند اجاره ای

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

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

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

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

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

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

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

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

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

    در حالی که محدودیتی در تعداد برنامه ها در یک پروژه وجود ندارد ، ثبت یک برنامه می تواند یک یا چند شناسه مشتری OAuth 2.0 اساسی ایجاد کند. حدود 30 شناسه مشتری وجود دارد که می تواند در یک پروژه ایجاد شود.

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

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

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