اگرچه برای شروع کار در Firebase Studio نیازی به یک پروژه Firebase ندارید، اما اتصال به آن برای استفاده از محصولات Firebase ضروری است. در مراحل خاصی از فرآیند توسعه، Firebase Studio ممکن است به طور خودکار یک پروژه برای شما ایجاد کند، یا می‌توانید به صورت دستی آن را متصل کنید. این راهنما هدف یک پروژه Firebase و نحوه اتصال آن به فضای کاری شما در Firebase Studio را توضیح می‌دهد.
درک پروژه‌های فایربیس
یک پروژه Firebase را به عنوان ظرفی برای تمام سرویس‌های backend برنامه خود، از جمله احراز هویت کاربر، ذخیره‌سازی داده‌ها، میزبانی وب، تجزیه و تحلیل و موارد دیگر در نظر بگیرید. با اتصال فضای کاری Firebase Studio خود به یک پروژه Firebase، می‌توانید مجموعه‌ای از محصولات Firebase را در برنامه خود ادغام کنید.
یک پروژه Firebase می‌تواند یک یا چند برنامه Firebase ثبت شده در آن داشته باشد (برای مثال، نسخه‌های رایگان و پولی یک برنامه)، اما موارد زیر را در نظر داشته باشید:
- همه برنامه‌های Firebase که در یک پروژه Firebase ثبت شده‌اند، به تمام منابع و سرویس‌های یکسانی که برای آن پروژه فراهم شده است، دسترسی دارند و از آنها استفاده می‌کنند.
- اگر Firebase Studio به طور خودکار یک پروژه Firebase برای شما ایجاد کند ، یک پروژه جدید ایجاد می‌کند و آن را به فضای کاری Firebase Studio شما پیوند می‌دهد.
- اگر یک فضای کاری Firebase Studio را که به یک پروژه Firebase مرتبط است، کپی کنید ، فضای کاری کپی شده به همان پروژه مرتبط می‌شود.
اتصال فضاهای کاری مختلف Firebase Studio را برای پروژه‌های جداگانه Firebase در نظر بگیرید. این کار از اشتراک‌گذاری (و احتمالاً رونویسی) داده‌ها و منابع بک‌اند یکسان توسط چندین فضای کاری جلوگیری می‌کند.
پس از اتصال فضای کاری خود به یک پروژه Firebase، برای انجام وظایف مدیریتی و پیکربندی به کنسول Firebase مراجعه کنید. این شامل مشاهده قوانین امنیتی، مدیریت حساب‌های کاربری، مشاهده گزارش‌های خرابی دقیق، ویرایش مستقیم داده‌های ذخیره شده و بررسی نتایج تست A/B می‌شود.
اتصال یک برنامه Firebase Studio به یک پروژه Firebase
برای استفاده از سرویس‌های Firebase در برنامه خود، باید برنامه خود را به یک پروژه Firebase متصل کنید. به عنوان مثال، اگر می‌خواهید از Firebase Authentication استفاده کنید، باید به یک پروژه Firebase متصل شوید تا بتوانید حساب‌های کاربری ایجاد و مدیریت کنید. در مراحل خاصی از فرآیند توسعه، Firebase Studio یک پروژه Firebase برای شما ایجاد می‌کند، یا می‌توانید این کار را به صورت دستی انجام دهید.
اتصال خودکار به یک پروژه Firebase
هنگام استفاده از App Prototyping agent ، Firebase Studio یک پروژه Firebase را از طرف شما در موارد زیر ارائه می‌دهد:
- تولید خودکار کلید API جمینی
- درخواست اتصال برنامه شما به یک پروژه Firebase
- برای اتصال برنامه خود به سرویس‌های Firebase، مانند Cloud Firestore یا Firebase Authentication درخواست کمک کنید.
- روی دکمه انتشار کلیک کنید و Firebase App Hosting تنظیم کنید
هنگام استفاده از چت تعاملی یا Gemini CLI ، Gemini می‌تواند از دستورات ترمینال یا سرور Firebase MCP برای اتصال به یک پروژه Firebase استفاده کند، زمانی که شما:
- درخواست اتصال برنامه شما به یک پروژه Firebase
- برای اتصال برنامه خود به سرویس‌های Firebase، مانند Cloud Firestore یا Firebase Authentication درخواست کمک کنید.
اتصال دستی به یک پروژه Firebase
برای اتصال دستی برنامه Firebase Studio خود به یک پروژه Firebase:
در کنسول Firebase یک پروژه جدید ایجاد کنید یا یک پروژه موجود را باز کنید:
- ایجاد یک پروژه جدید : روی ایجاد یک پروژه جدید Firebase کلیک کنید و دستورالعمل‌ها را برای ایجاد یک پروژه جدید دنبال کنید.
- باز کردن یک پروژه موجود : روی پروژه‌ای که می‌خواهید استفاده کنید کلیک کنید.
شناسه پروژه خود را یادداشت کنید. در کنسول Firebase، روی > تنظیمات پروژه کلیک کنید. شناسه پروژه در پنل بالا نمایش داده می‌شود.
برنامه خود را در Firebase Studio باز کنید. اگر از App Prototyping agent در Prototyper view, click
Switch to Code to open Code view.پروژه Firebase خود را متصل کنید. در ترمینال (
Shift+Ctrl+C)، دستورات زیر را اجرا کنید:-
touch firebase.jsonاین تضمین می‌کند که یک فایل پیکربندی Firebase در دایرکتوری شما وجود دارد. -
firebase login --reauthبرای تأیید حساب کاربری خود، دستورالعمل‌ها را دنبال کنید. -
firebase use <your project ID>را با<your-project-ID>پروژه‌ای که قبلاً یادداشت کرده‌اید جایگزین کنید.
-
پروژه Firebase متصل به برنامه خود را تغییر دهید
برای تغییر پروژه Firebase مرتبط با فضای کاری Firebase Studio خود، دستورالعمل‌های موجود در بخش «اتصال دستی به یک پروژه Firebase با استفاده از شناسه پروژه جدید» را دنبال کنید.
پروژه Firebase متصل به برنامه خود را شناسایی کنید
برای تأیید اینکه آیا یک پروژه Firebase از قبل متصل شده است، بالای فضای کاری Firebase Studio خود را بررسی کنید. شناسه پروژه متصل، در صورت وجود، در کنار نام فضای کاری شما نشان داده شده است. می‌توانید روی شناسه پروژه کلیک کنید تا آن پروژه مستقیماً در کنسول Firebase باز شود.