شروع به کار با Firebase با پروژه Google Cloud موجود

پروژه Firebase پروژه Google Cloud است که برخی پیکربندی‌ها و سرویس‌های اضافی مختص Firebase در آن فعال شده است. این کار معمولاً «افزودن Firebase» به پروژه Google Cloud نامیده می‌شود. این صفحه نحوه «افزودن Firebase» را به‌همراه برخی پرسشگان (پرسش‌های متداول) شرح می‌دهد.

وقتی Firebase را به پروژه Google Cloud اضافه می‌کنید، Firebase به‌طور خودکار چندین API را فعال می‌کند و حساب‌های سرویس ایجاد می‌کند تا استفاده از همه سرویس‌ها و میاناهای Firebase را ساده کند. Firebase همچنین برچسب firebase:enabled را به پروژه شما در صفحه IAM و سرپرست > برچسب‌ها در کنسول Google Cloud اضافه می‌کند. جزئیات بیشتر درباره آنچه هنگام «افزودن Firebase» اتفاق می‌افتد را کسب کنید.

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

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

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

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

  • می‌توانید از محصولات و میاناهای برنامه‌سازی کاربردی 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 به پروژه Google Cloud موجود

می‌توانید بااستفاده از هرکدام از گزینه‌های زیر، «Firebase را به پروژه Google Cloud موجود اضافه کنید». مطمئن شوید که اجازه‌های لازم برای افزودن Firebase به پروژه Google Cloud را دارید.

توجه داشته باشید که وقتی Firebase را به پروژه Google Cloud موجودی «اضافه می‌کنید»، نمی‌توانید آن را واگرد کنید (یعنی نمی‌توانید Firebase را به‌طور کامل از پروژه Google Cloud «بردارید»). در این پرسشگان بیشتر بدانید.

کنسول Firebase

  1. با حسابی که به شما اجازه دسترسی به پروژه Google Cloud موجود را می‌دهد، به سیستم کنسول Firebase وارد شوید.

  2. برای ایجاد پروژه Firebase جدید، روی دکمه کلیک کنید.

  3. در پایین صفحه، روی افزودن Firebase به پروژه Google Cloud کلیک کنید.

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

  5. روی باز کردن پروژه کلیک کنید.

  6. درصورت درخواست، شرایط Firebase را بپذیرید.

  7. دستورالعمل‌های روی صفحه را برای «افزودن Firebase» و راه‌اندازی پروژه Firebase دنبال کنید.

    توجه داشته باشید که فعال کردن کمک هوشواره‌ای در کنسول Firebase و Google Analytics هر دو اختیاری هستند.

Firebase CLI

  1. اگر قبلاً این کار را نکرده‌اید، Firebase CLI را نصب کنید.

  2. با همان «حساب Google» که به شما امکان دسترسی به پروژه Google Cloud موجود را می‌دهد به سیستم وارد شوید.

  3. فرمان زیر را اجرا کنید:

    firebase projects:addfirebase
  4. وقتی از شما خواسته شد، پروژه Google Cloud موجود را از فهرست نمایش‌داده‌شده انتخاب کنید.

REST API

  1. Firebase Management API را در پروژه Google Cloud موجود فعال کنید.

  2. کد دسترسی میانای برنامه‌سازی کاربردی خود را تولید کنید.

  3. با فراخوانی projects.addFirebase، سرویس‌های Firebase را برای پروژه فعال کنید.

    توجه داشته باشید که برای برقراری این تماس به نام منبع پروژه‌تان نیاز دارید.

برای دستورالعمل‌های دقیق، افزودن سرویس‌های Firebase به پروژه را در راهنمای Firebase ببینید: «راه‌اندازی و مدیریت پروژه Firebase بااستفاده از Management REST API». حتماً همه دستورالعمل‌های بخش پیش‌از شروع آن راهنما را دنبال کنید.

Terraform

  1. Firebase Management API (firebase.googleapis.com) را در پروژه Google Cloud موجود فعال کنید.

  2. بااستفاده از منبع google_firebase_project، سرویس‌های Firebase را برای پروژه فعال کنید.

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

پرسشگان و عیب‌یابی

مراحل بعدی

  • برای کسب اطلاعات بیشتر درباره پروژه‌های Firebase، منابع زیر را بررسی کنید:

    • آشنایی با پروژه‌های Firebase — مرورهای کوتاهی از چندین مفهوم مهم درباره پروژه‌های Firebase ارائه می‌دهد، ازجمله رابطه آن‌ها با Google Cloud و سلسله‌مراتب پایه یک پروژه و برنامه‌ها و منابع آن.

    • روال‌های مطلوب کلی برای راه‌اندازی پروژه‌های Firebase — روال‌های مطلوب کلی و سطح بالا را برای راه‌اندازی پروژه‌های Firebase و ثبت برنامه‌هایتان در پروژه ارائه می‌دهد تا گردش کار توسعه واضحی داشته باشید که از محیط‌های متمایز استفاده می‌کند.

  • با ثبت برنامه‌هایتان در پروژه Firebase و متصل کردن آن‌ها به Firebase، استفاده از Firebase را در برنامه‌های وب و تلفن همراهتان شروع کنید: iOS+ | Android | وب | Flutter | Unity | C++‎.