برای دانلود فایل های خود به صورت فایل فشرده:
- روی هر دایرکتوری در پنجره Explorer کلیک راست کرده و Zip and Download را انتخاب کنید.
برای دانلود همه چیز در فهرست پروژه خود:
File > Open Folder را انتخاب کنید.
پوشه پیش فرض
/home/userبپذیرید.پس از بارگیری فایل ها، روی پوشه کاری خود کلیک راست کرده و Zip and Download را انتخاب کنید. اگر از App Prototyping agent استفاده می کنید، دایرکتوری کاری شما
studioخواهد بود. اگر از یک الگو یا پروژه آپلود شده استفاده می کنید، این نام پروژه شما خواهد بود.هنگامی که از شما برای بازسازی محیط خواسته شد، روی لغو کلیک کنید.
پس از اتمام دانلود، دایرکتوری کاری خود را از منوی File دوباره باز کنید تا به فضای کاری خود برگردید.
قبل از شروع، ممکن است لازم باشد کوکی های شخص ثالث را برای مرورگر خود فعال کنید. Firebase Studio به کوکی های شخص ثالث در اکثر مرورگرها برای احراز هویت فضاهای کاری نیاز دارد.
روی دسکتاپ:
- تنظیمات را باز کنید.
- تب Privacy and Security را باز کنید.
- مطمئن شوید که Allow all cookies فعال باشد.
- Firebase Studio باز کنید.
- روی نماد نمایان بودن در نوار آدرس visibility_off کلیک کنید تا پانل حفاظت از ردیابی باز شود. تنظیم کوکی های شخص ثالث را روشن کنید تا به طور موقت کوکی های شخص ثالث مجاز شوند. این کار کوکی ها را در Firebase Studio به مدت 90 روز فعال می کند.
در گوشی ها و تبلت های اندرویدی:
- روی ( more_vert ) More > Settings ضربه بزنید.
- تنظیمات سایت > کوکی های شخص ثالث را باز کنید.
- مطمئن شوید که Allow all cookies فعال باشد.
- Firebase Studio باز کنید.
- روی نماد نمایان بودن در نوار آدرس visibility_off کلیک کنید تا پانل حفاظت از ردیابی باز شود. تنظیم کوکی های شخص ثالث را روشن کنید تا به طور موقت کوکی های شخص ثالث مجاز شوند. این کار کوکی ها را در Firebase Studio به مدت 90 روز فعال می کند.
در آیفون و آیپد:
- برنامه تنظیمات > برنامه‌ها > Chrome را باز کنید.
- Allow Cross-Website Tracking را روشن کنید.
- Firebase Studio باز کنید.
روی دسکتاپ:
- Safari > Settings... را باز کنید.
- تنظیمات زیر را خاموش کنید:
- پیشرفته > مسدود کردن همه کوکی ها
- حریم خصوصی > جلوگیری از ردیابی بین سایتی
- Firebase Studio باز کنید.
در آیفون و آیپد:
- برنامه تنظیمات > برنامه‌ها > سافاری را باز کنید.
- تنظیمات زیر را خاموش کنید:
- جلوگیری از ردیابی بین سایتی
- پیشرفته > مسدود کردن همه کوکی ها
- Firebase Studio باز کنید.
شما نیازی به فعال کردن کوکی های شخص ثالث برای فایرفاکس ندارید. Firebase Studio باز کنید.
- Opera را باز کنید.
- منو را باز کنید و روی تنظیمات کلیک کنید.
- به بخش Privacy & Security بروید و گزینه Third-party cookies را گسترش دهید.
- مسدود کردن کوکی‌های شخص ثالث در حالت ناشناس یا مجاز به کوکی‌های شخص ثالث را انتخاب کنید.
- Firebase Studio باز کنید.
- به arc://settings بروید.
- به بخش Privacy and Security بروید و گزینه Third-party cookies را گسترش دهید.
- مسدود کردن کوکی‌های شخص ثالث در حالت ناشناس یا مجاز به کوکی‌های شخص ثالث را انتخاب کنید.
- Firebase Studio باز کنید.
نیازی نیست کوکی های شخص ثالث را برای Brave فعال کنید. Firebase Studio باز کنید.
Firebase Studio به کوکی‌های 3P فعال نیاز دارد زیرا ما یک iframe را از یک دامنه (یک زیر دامنه از cloudworkstations.dev ) در دامنه دیگر ( studio.firebase.google.com ) ارائه می‌کنیم و کوکی‌های 3P ارتباط بین منبع امن را فعال می‌کنند.
تقریباً پنج ثانیه صبر کنید و صفحه را رفرش کنید.
اگر Firebase Studio به درستی تازه‌سازی نمی‌شود (معمولاً در نتیجه اصلاح‌کننده‌های اصلی یا تغییرات در فایل dev.nix محیط شما)، پالت فرمان ( Cmd+Shift+P در Mac یا Ctrl+Shift+P در ChromeOS، Windows یا Linux) را باز کنید و دستور Hard Restart را اجرا کنید. اگر جواب نداد، دستور Rebuild Environment را اجرا کنید.
اگر فضای کاری شما پاسخ نمی دهد، می توانید VM را مجددا راه اندازی کنید. برای انجام این کار:
از Firebase Studio ، روی منوی More ( more_horiz ) کلیک کنید، سپس Restart را انتخاب کنید.
وقتی از شما خواسته شد، دوباره روی Restart کلیک کنید.
فضای کاری خود را دوباره باز کنید
Firebase Studio مجموعه ای گرم از ماشین های مجازی دارد که برای تهیه فضاهای کاری در صورت تقاضا استفاده می شود. هنگامی که استخر کم می شود، پس از راه اندازی یک ماشین مجازی جدید، فضاهای کاری فراهم می شود. این فرآیند ممکن است زمان ببرد (گاهی اوقات تا پنج دقیقه) اما در نهایت موفق می شود.
در صورت پر بودن دیسک ممکن است با این پیام مواجه شوید. فضای کاری Firebase Studio فراهم می کند:
- 100 گیگابایت فضای دیسک کل برای بسته های Nix و
/tmp - 10 گیگابایت برای دایرکتوری
/homeشما
در بیشتر موارد خطاهای داخلی در حین تهیه فضای کاری، بازخوانی صفحه بعد از یک دقیقه یا بیشتر باید شما را از خطا عبور دهد و وارد فضای کاری شود.
طرح بدون هزینه Firebase Studio به سه فضای کاری برای هر کاربر محدود شده است. با پیوستن به برنامه برنامه‌نویس Google، می‌توانید تعداد فضاهای کاری را که می‌توانید ایجاد کنید تا 10 افزایش دهید. برای ارتقا به 30 فضای کاری، در برنامه Google Developer Premium مشترک شوید.
اگر هنگام استفاده از Firebase Studio با مشکلی مواجه شدید یا درخواست ویژگی دارید، با پشتیبانی Firebase تماس بگیرید .
برخی از ویژگی های Firebase Studio آزمایشی هستند. ما برای بازخورد شما ارزش قائل هستیم و فعالانه از آن برای اطلاع رسانی به مجموعه ویژگی های فعلی و برنامه ریزی شده خود استفاده می کنیم و به طور دوره ای ویژگی هایی را حذف می کنیم که مطابق انتظارات شما یا انتظارات ما نیستند. اگر ویژگی هایی وجود دارد که می خواهید در نسخه ایده آل Firebase Studio خود مشاهده کنید، بازخورد خود را برای ما ارسال کنید . ما می خواهیم از شما بشنویم!
ما به طور فعال در حال بهبود قابلیت اطمینان شبیه سازهای مبتنی بر ابر خود هستیم. اگر بازخوانی صفحه مشکل را برطرف نکرد، مشکل را به پشتیبانی Firebase گزارش دهید .
می‌توانید نسخه تقریباً همه نرم‌افزارهای از پیش نصب شده را در داخل یک فضای کاری ارتقا یا کاهش دهید، درست همانطور که در دستگاه محلی خود انجام می‌دهید (با استفاده از apt-get یا brew). می‌توانید نرم‌افزار را در فضای کاری خود ارتقا یا کاهش دهید، اما نرم‌افزار نصب‌شده در تمام جلسات ثابت نیست. توصیه می کنیم تمام بسته های مورد نیاز را در فایل dev.nix خود قرار دهید.
ما فعالانه در حال کار برای بهبود مدیریت نسخه Flutter در Firebase Studio هستیم.
شما فقط می توانید URL فضای کاری را با کاربرانی که به فضای کاری دسترسی دارند به اشتراک بگذارید. کاربران بدون اجازه هنگام تلاش برای بازدید از URL خطایی می بینند. مطمئن شوید که فضای کاری را به صراحت با آنها به اشتراک بگذارید .
کاربرانی که به فضای کاری شما اضافه می شوند به کل سیستم فایل ماشین مجازی دسترسی کامل دارند، که ممکن است حاوی فایل های حساسی مانند کلیدهای خصوصی و نشانه های دسترسی ذخیره شده در دیسک باشد. فضای کاری خود را فقط با افرادی که به آنها اعتماد دارید به اشتراک بگذارید. در حالی که این رویکرد به سایر کاربران کمک می کند تا وضعیت دقیق فضای کاری شما را مشاهده کنند، به این معنی است که آنها همه چیز را در فضای کاری شما می بینند.
کاربرانی که به فضای کاری شما اضافه میشوند ممکن است مجوز پروژه Firebase زیربنایی آن را نداشته باشند که ویژگی‌های انتشار و نظارت "نمای کلی برنامه" را تامین می‌کند. برای اعطای مجوز به پروژه Firebase خود، به مجوزها و دسترسی به پروژه‌های Firebase مراجعه کنید
بله! می توانید محیط خود را برای کار با تقریباً هر فریمورک یا زبانی در Firebase Studio سفارشی کنید.
دایرکتوری build/web انتخاب کنید. این فهرست باید حاوی index.html و تمام دارایی های ثابت مورد نیاز برای ارائه برنامه وب شما پس از ساخت موفقیت آمیز برنامه باشد (از طریق flutter build web ).
می‌توانید به‌طور موقت پورت TCP را که سرور باطن شما روی آن اجرا می‌شود، باز کنید تا توسعه ظاهر و باطن خود را به‌طور جداگانه در فضاهای کاری مختلف آسان‌تر کنید:
سرور پشتیبان یا API خود را به صورت دستی در ترمینال یا به عنوان بخشی از پیکربندی پیش نمایش فایل
dev.nixیا قلاب چرخه حیاتonStartخود راه اندازی کنید.روی نماد Firebase Studio در نوار فعالیت (به طور پیش فرض در سمت چپ) کلیک کنید تا پانل Firebase Studio باز شود.
بخش پورت‌های Backend را گسترش دهید تا لیستی از سرورهای در حال اجرا، از جمله شماره پورت و شناسه پردازش (PID) آنها را ببینید.
را کلیک کنید
نماد عمومی (یک قفل) در سمت چپ شماره پورت ایجاد کنید .
را کلیک کنید
نماد URL را در سمت راست شماره پورت کپی کنید تا URL کاملا واجد شرایط آن کپی شود.
اکنون می‌توانید مستقیماً (مثلاً با یک تماس
fetch) از ظاهر خود به این نشانی اینترنتی ارجاع دهید.
پالت فرمان را با استفاده از Ctrl+Shift+P (یا Cmd-Shift-P در MacOS) باز کنید، سپس Firebase Studio : Show preview Android یا Firebase Studio : Show web preview را انتخاب کنید.
نرم افزار کد منبع باز (Code-OSS) یک پروژه متن باز است که لایه اصلی VS Code است. Code-OSS تحت مجوز استاندارد MIT در GitHub در دسترس است و مایکروسافت در آنجا محصول VS Code را توسعه می دهد.
استفاده شما از Firebase Studio تحت شرایط خدمات Google است.
با این حال، توجه داشته باشید که استفاده شما از ویژگی‌های هوش مصنوعی مولد در Firebase Studio توسط خط‌مشی استفاده ممنوعه از هوش مصنوعی تولیدی و شرایط خدمات اضافی Gemini API (به طور خاص توسط شرایط خدمات اضافی Gemini API : خدمات بدون پرداخت کنترل می‌شود) کنترل می‌شود.
برای جلوگیری از استفاده از اعلان ها و پاسخ های خود برای آموزش مدل، از App Prototyping agent استفاده نکنید، و از Gemini در Firebase در Firebase Studio استفاده نکنید. برای جلوگیری از استفاده از کد خود برای آموزش مدل، تکمیل کد و نمایه سازی کد را در تنظیمات Firebase Studio خود خاموش کنید .
می‌توانید سهمیه‌های مرتبط با کلید API تولید شده خودکار خود را در صفحه سهمیه‌ها و محدودیت‌های سیستم API زبان تولیدی در کنسول Google Cloud مشاهده کنید.
مقدار داده (که به عنوان "توکن" نشان داده می شود) در پروژه شما بزرگتر از حداکثر محدودیتی است که مدل می تواند بپذیرد. برای رفع این خطا، تنظیم کنید کدام فایل در پایگاه کد شما باید از Gemini مخفی شود:
در فضای کاری خود، به
نمای Code .
شامل فایل‌ها یا دایرکتوری‌هایی که Gemini باید نادیده بگیرد تا حجم داده در پروژه شما کاهش یابد. برای مثال، ممکن است بخواهید
.next/و همه زیر شاخه ها را اضافه کنید. مسیر باید نسبت به دایرکتوری حاوی فایل.aiexcludeباشد:.next/دوباره سعی کنید از Gemini استفاده کنید. اگر همچنان خطایی در مورد تجاوز از حداکثر تعداد نشانه‌ها دریافت می‌کنید، فایل‌ها یا فهرست‌های بزرگ دیگری را به فایل
.aiexcludeاضافه کنید.
هنگام تهیه منابعی مانند کلید Gemini API یا استقرار در Firebase App Hosting ، یک پروژه به طور خودکار بر اساس نام فضای کاری Firebase Studio برای شما ارائه می شود.
اگر خطای «ساخت پروژه ناموفق» را دریافت کردید:
اگر حساب Google شما بخشی از یک سازمان است، ممکن است مجوز ایجاد پروژه های Google Cloud را نداشته باشید یا محدودیت سهمیه پروژه خود را رعایت کرده باشید. برای کمک با سرپرست خود تماس بگیرید یا به ایجاد و مدیریت پروژه ها مراجعه کنید.
اگر حساب Google شما بخشی از یک سازمان نیست، ممکن است محدودیت سهمیه پروژه Google Cloud خود را رعایت کرده باشید. درخواست افزایش سهمیه
برای کسب اطلاعات بیشتر در مورد سهمیه پروژه به مدیریت سهمیه پروژه مراجعه کنید.
در مورد پروژه های Firebase و Google Cloud در درک پروژه های Firebase بیشتر بیاموزید.
هنگام تهیه منابعی مانند استقرار در Firebase App Hosting ، می‌توانید یک حساب Cloud Billing انتخاب یا ایجاد کنید.
اگر خطای «ساخت یک حساب Cloud Billing انجام نشد» دریافت کردید:
- مطمئن شوید که مجوز ایجاد حساب‌های Cloud Billing را دارید. مجوزهای خود را بررسی کنید یا برای راهنمایی با سرپرست خود تماس بگیرید.
اگر خطای «پروژه‌های زیادی با این حساب صورت‌حساب» دریافت کردید:
- ممکن است محدودیت پروژه را برای حساب Cloud Billing خود رعایت کرده باشید. می توانید درخواست افزایش سهمیه بدهید . درباره سهمیه های حساب Cloud Billing بیشتر بیاموزید .
درباره ایجاد یک حساب Cloud Billing در ایجاد یک حساب صورت‌حساب جدید خود-سرویس اطلاعات بیشتری کسب کنید.
اگر هیچ یک از این گزینه‌ها مشکل شما را حل نکرد، با پشتیبانی Cloud Billing تماس بگیرید.
از App Prototyping agent بخواهید هنگام کار بر روی یک برنامه موجود، یک پایگاه داده یا احراز هویت اضافه کند. هنگامی که از شما درخواست اضافه کردن یک پایگاه داده یا احراز هویت می کنید، App Prototyping agent درخواست تأیید می کند. اگر موافق باشید، App Prototyping agent یک پروژه Firebase را با خدمات پشتیبانی درخواستی برای شما راه‌اندازی می‌کند.
عامل App Prototyping خطاهای Next.js را شناسایی می کند و پیشنهاد می کند آنها را برطرف کند. اگر خطایی دریافت کردید و پیشنهاد رفع آن را نداد، متن مشکل را کپی کرده و در چت جای‌گذاری کنید.
برای بهترین نتایج، در صورت وجود، اطلاعات بیشتری در مورد ماهیت موضوع ارائه دهید.
به عنوان مثال، اگر خطای Firebase را مشاهده کردید، مانند Property access is undefined on object. for 'list' @ L6 ، که نشان‌دهنده مشکلی در قوانین Cloud Firestore است، پیش‌گفتار این خطا را با «آیا می‌توانید به من کمک کنید این مشکل قوانین Cloud Firestore را برطرف کنم؟»
خرابی‌های انتشار معمولاً خطاهای قابل اجرا را در گزارش‌های Cloud Build ثبت می‌کند. برای رفع اشکال و رفع اشکالات انتشار:
در صفحه جزئیات برنامه (در صورت کوچک شدن، روی انتشار کلیک کنید تا نمایش داده شود)، روی مشاهده جزئیات کلیک کنید. با این کار App Hosting در کنسول Firebase باز می شود.
از صفحه App Hosting کنسول Firebase ، روی View Cloud Build logs کلیک کنید.
با این کار کنسول Firebase باز می شود که در آن می توانید لاگ های ساخت را ببینید و خطا را پیدا کنید.
خطا را کپی کنید و آن را در App Prototyping agent یا Gemini در چت Firebase در فضای کاری خود قرار دهید و Gemini بخواهید آن را برطرف کند.
برای تأیید رفع مشکل، به نمای Code بروید، Terminal را باز کنید و
npm run buildاجرا کنید. اگر خطای دیگری مشاهده کردید، دوباره امتحان کنید. اگرFirebaseErrorمی‌بینید، ببینید چرا App Prototyping agent پیشنهادی برای رفع مشکل من نمی‌دهد؟ .هنگامی که ساخت با موفقیت انجام شد، روی
npm run startکلیک کنید و پیوند localhost ارائه شده را باز کنید و عملکرد برنامه خود را آزمایش کنید. می توانید ترمینال را برای هر گونه خطای زمان اجرا بررسی کنید.اگر همه چیز موفقیت آمیز بود،
Ctrl-Cدر ترمینال متوقف کنید تا ساخت بسته بندی شده تولید در فضای کاری شما اجرا نشود، سپس جریان انتشار App Hosting را دوباره امتحان کنید.
اگر App Prototyping agent تغییرات کد درخواستی را تکمیل نکند، به مرحله App Blueprint برمی‌گردد یا به طور مکرر خطایی نشان می‌دهد که به مشکل برخورد کرده است:
اگر با باز کردن مجدد فضای کاری خود مشکل همچنان ادامه داشت، در گپ App Prototyping agent
/clearرا وارد کنید.اگر مشکل ادامه داشت، می توانید یک شعبه از نسخه قبلی برنامه خود ایجاد کنید:
تغییر به
تب Source Control را باز کنید.
در نمودار کنترل منبع، روی نسخه قبلی > ایجاد شعبه کلیک راست کنید. یک نام برای شعبه خود وارد کنید.
به Prototyper mode. If the agent still doesn't respond or returns an error, try branching from an even earlier version of your app.
برای جابه‌جایی بین شاخه‌هایی که ایجاد می‌کنید (یا به شاخه اصلی بازگردید)، روی نام شعبه واقع در گوشه سمت چپ پایین نمای Code کلیک کنید و شاخه‌ای را که می‌خواهید استفاده کنید انتخاب کنید.
ما در حال کار بر روی بهبود فرآیند ادغام خدمات Firebase با استفاده از App Prototyping agent هستیم. در این میان، در اینجا چند چالش و نکات رایج وجود دارد.
- فایل پیکربندی به‌روزرسانی نشد : در درخواست خود، مقدار خاصی را که می‌خواهید به‌روزرسانی کنید، وارد کنید. مقادیر را می توان در صفحه تنظیمات پروژه کنسول Firebase پیدا کرد. به عنوان مثال، می‌توانید از شما درخواست کنید: «MestureId را در پیکربندی من با G-1234567890 به‌روزرسانی کنید».
- هنگام پیش‌نمایش برنامه من، احراز هویت کار نمی‌کند : ممکن است لازم باشد URL پیش‌نمایش را به‌عنوان یک دامنه مجاز اضافه کنید:
- در حالت نمونه اولیه، روی open_in_new Open in New Window کلیک کنید.
- در پنجره پیش‌نمایش جدیدی که باز می‌شود، URL را کپی کنید. توجه داشته باشید که URL باید با
6000شروع شود. اگر با9000شروع می شود، قبل از رفتن به مرحله بعدی آن را به روز کنید. - در صفحه تنظیمات احراز هویت کنسول Firebase، URL را که در مرحله قبل کپی کرده‌اید به دامنه‌های مجاز اضافه کنید. توجه: این روش فقط پیش نمایش پیش فرض نشان داده شده در Prototyper mode. The preview within Code view and the preview pop-out might not allow you to authenticate.
- قوانین امنیتی Firebase ایجاد نشدند : Gemini می تواند به شما در نوشتن قوانین امنیتی کمک کند، اما هنوز نمی تواند به طور خودکار آنها را به پروژه Firebase شما اضافه کند. شما باید قوانین Firebase خود را در کنسول Firebase کپی کنید تا آنها را منتشر کنید.
- تعامل غیرمنتظره با سرور Firebase MCP : اگر سرور Firebase MCP را راه‌اندازی کنید، ممکن است هنگام استفاده از Prototyper for Firebase integrations. If this occurs, switch to Code view and prompt Gemini in Firebase to integrate Firebase services.