پایان کار فایربیس استودیو و انتقال پروژه

Firebase Studio در ۲۲ مارس ۲۰۲۷ به کار خود پایان می‌دهد. ما با انتقال درس‌های آموخته‌شده از پیش‌نمایش فایربیس استودیو به ابزارهای شاخص خود یعنی گوگل هوش مصنوعی استودیو و گوگل آنتی‌گراویتی ، پیشنهادات خود برای توسعه‌دهندگان هوش مصنوعی را ساده‌سازی می‌کنیم.

در حالی که رابط کاربری برای ساخت برنامه‌ها در حال تکامل است، تعهد ما به اکوسیستم Firebase قوی‌تر از همیشه است. با ادغام قابلیت‌های agentic به طور مستقیم در پلتفرم‌های هوش مصنوعی پرچمدار خود، تضمین می‌کنیم که Firebase همچنان یک backend یکپارچه و قابل اعتماد برای توسعه مبتنی بر هوش مصنوعی ارائه می‌دهد. سرویس‌های اصلی Firebase، مانند Cloud Firestore ، Authentication و App Hosting ، همچنان در خارج از Firebase Studio به کار خود ادامه خواهند داد.

چرا ما این تغییر را ایجاد می‌کنیم؟

Firebase Studio به عنوان پیش‌نمایشی برای بررسی آینده توسعه فول‌استک مبتنی بر هوش مصنوعی راه‌اندازی شد. بر اساس بازخورد شما، ما در حال ساده‌سازی ابزارهای خود هستیم تا مسیرهای واضح‌تر و قدرتمندتری را پیش رو قرار دهیم:

• برای توسعه‌ی عامل‌محور و کدمحور : ما روی Antigravity ، IDE نسل بعدی خود که برای گردش‌های کاری محلی با سرعت بالا و خودکار طراحی شده است، تمرکز داریم.

• برای نمونه‌سازی سریع و مبتنی بر مرورگر : ما Cloud Firestore و Firebase Authentication را مستقیماً در Google AI Studio ادغام کرده‌ایم تا سریع‌ترین مسیر را از اعلان تا تولید فراهم کنیم.

سرویس‌های اصلی فایربیس شما ( Cloud Firestore ، Authentication ، App Hosting و غیره) تحت تأثیر قرار نمی‌گیرند. پایگاه‌های داده و داده‌های کاربر شما به طور عادی به کار خود ادامه خواهند داد. این تعطیلی فقط برای محیط توسعه Firebase Studio اعمال می‌شود.

جدول زمانی غروب آفتاب

ما یک دوره گذار یک ساله ارائه می‌دهیم تا مطمئن شویم که شما زمان کافی برای انتقال پروژه‌های خود دارید:

• ۱۹ مارس ۲۰۲۶ : اعلام پایان کار و شروع انتشار ابزارهای مهاجرت به Firebase Studio .
• ۲۲ ژوئن ۲۰۲۶ : ایجاد فضای کاری جدید غیرفعال است. می‌توانید به کار خود در فضاهای کاری موجود ادامه دهید و آنها را منتقل کنید.
• ۲۲ مارس ۲۰۲۷ : Firebase Studio خاموش شد و تمام داده‌های باقی‌مانده به‌طور دائم حذف شدند و قابل بازیابی نبودند.

مسیر مهاجرت خود را انتخاب کنید

بسته به نحوه استفاده از Firebase Studio ، مسیر مهاجرتی را انتخاب کنید که به بهترین وجه با گردش کار شما مطابقت داشته باشد.

به گوگل آنتی گراویتی مهاجرت کنید

برای یک تجربه توسعه عامل‌گرا و کدمحور، توصیه می‌کنیم به Antigravity مهاجرت کنید . این IDE نسل بعدی ما است که برای گردش‌های کاری محلی با سرعت بالا و مستقل طراحی شده است. اگر هر یک از معیارهای زیر را دارید، باید Antigravity را انتخاب کنید:

• ترجیح می‌دهید در یک محیط توسعه محلی و کدمحور با کنترل عمیق‌تر بر کدبیس خود کار کنید
• برنامه خود را با استفاده از یک الگوی داخلی یا مخزن وارد شده در Firebase Studio ایجاد کنید
• در درجه اول از محیط Code View در Firebase Studio استفاده کنید
• آیا می‌خواهید به قابلیت‌های پیشرفته توسعه هوش مصنوعی عامل‌گرا در یک IDE قدرتمند، با پشتیبانی از استفاده از مدل‌های مختلف مانند Claude و GPT-OSS، علاوه بر Gemini، دسترسی مستقیم داشته باشید؟
• در Prototyper mode, but added significant features or execution scripts that require a local environment without cloud limitations

به استودیوی هوش مصنوعی گوگل مهاجرت کنید

برای یک محیط نمونه‌سازی اولیه مبتنی بر وب که قدرت هوش مصنوعی را به مرورگر شما می‌آورد، توصیه می‌کنیم به Google AI Studio مهاجرت کنید . این سریعترین مسیر از حالت آماده به کار به یک برنامه تولیدی کامل را ارائه می‌دهد. اگر هر یک از معیارهای زیر را دارید، باید Google AI Studio را انتخاب کنید:

• یک تجربه مبتنی بر وب را ترجیح می‌دهید، که برای گردش‌های کاری چند دستگاهی یا محیط‌هایی که نمی‌توانید نرم‌افزار محلی نصب کنید، ایده‌آل است.
• برنامه خود را با استفاده از App Prototyping agent در Firebase Studio ایجاد کنید و از نمونه‌سازی سریع و تولید برنامه مبتنی بر اعلان قدردانی کنید.
• سریع‌ترین مسیر را از اعلان به برنامه‌ی تولیدی فول‌استک می‌خواهید؟

انتقال برنامه‌ها به Google AI Studio

گوگل هوش مصنوعی استودیو سریع‌ترین مسیر را از تولید سریع به تولید کامل اپلیکیشن ارائه می‌دهد.

مرحله ۱: فضای کاری خود را منتقل کنید

1. روی دکمه‌ی «حرکت کن» در بالای فضای کاری خود کلیک کنید، سپس «آماده‌سازی برای استودیوی هوش مصنوعی» را انتخاب کنید.
2. پس از اتمام مرحله آماده‌سازی، روی «انتقال به Google AI Studio» کلیک کنید.
3. در صورت درخواست، شرایط خدمات را بررسی و بپذیرید. کد شما به طور خودکار در یک فضای کاری جدید Google AI Studio باز خواهد شد.

ممکن است تبدیل و بارگذاری برنامه شما توسط Google AI Studio چند دقیقه طول بکشد. پس از اتمام، به شما اطلاع می‌دهد. پس از اتمام، می‌توانید با کمک نماینده Google AI Studio به تکرار برنامه خود ادامه دهید. درباره ساخت برنامه‌ها در Google AI Studio بیشتر بدانید.

مرحله ۲: روش انتشار خود را انتخاب کنید

بسته به نیازهای استقرار شما و اینکه آیا می‌خواهید URL برنامه موجود خود را حفظ کنید، یکی از روش‌های انتشار زیر را انتخاب کنید.

گزینه الف: انتشار در App Hosting و حفظ URL فعلی

اگر قبلاً برنامه خود را از طریق Firebase Studio منتشر کرده‌اید و می‌خواهید URL *.hosted.app یا دامنه سفارشی خود را حفظ کنید، کلید API Gemini خود را ایمن کنید و از GitHub Sync استفاده کنید:

1. کلید API Gemini خود را ایمن کنید:
   1. در کنسول Firebase ، به صفحه App Hosting بروید.
   2. بک‌اند فعلی خود (که معمولاً با نام studio شناخته می‌شود) را پیدا کنید و روی مشاهده کلیک کنید.
   3. در برگه تنظیمات ، به بخش محیط (Environment) بروید.
   4. روی «افزودن مورد جدید» کلیک کنید و محتویات فایل .env خود را در فیلد Key قرار دهید تا کلید API Gemini شما به صورت ایمن به عنوان یک متغیر محیطی ذخیره شود.

2. همگام‌سازی با گیت‌هاب از استودیوی هوش مصنوعی گوگل :

   1. در Google AI Studio ، روی آیکون تنظیمات کلیک کنید و به پنل GitHub بروید.
   2. روی ورود به گیت‌هاب کلیک کنید و برنامه‌ی گوگل هوش مصنوعی استودیو گیت‌هاب را نصب کنید.

   3. روی ایجاد مخزن GitHub کلیک کنید.

   4. مرحله را انتخاب کنید و تمام تغییرات را اعمال کنید .

3. مخزن را به App Hosting متصل کنید:

   1. در کنسول Firebase ، به صفحه App Hosting بروید.
   2. بک‌اند فعلی خود (که معمولاً با نام studio شناخته می‌شود) را پیدا کنید و روی مشاهده کلیک کنید.
   3. در برگه تنظیمات ، گزینه Deployment > Connect to GitHub را انتخاب کنید.
   4. وارد گیت‌هاب شوید و Firebase App Hosting GitHub App را نصب کنید.
   5. مخزن خود را انتخاب کنید، شاخه را روی main و دایرکتوری ریشه را روی / تنظیم کنید.
   6. روی ذخیره و استقرار کلیک کنید.

4. تغییرات خود را با گیت‌هاب همگام‌سازی کنید و مستقر کنید:

   1. در Google AI Studio ، به پنل GitHub بروید.
   2. تغییراتی که قرار است منتشر شوند را بررسی کنید.
   3. روی Stage کلیک کنید و تمام تغییرات را اعمال کنید .
   4. برای نظارت بر پیشرفت استقرار App Hosting ، به کنسول Firebase بروید.

گزینه ب: به Cloud Run بروید و برنامه خود را در یک URL جدید منتشر کنید

اگر تجربه‌ی تک‌کلیکی را ترجیح می‌دهید و قبلاً برنامه‌ی خود را منتشر نکرده‌اید، یا با URL جدید ( *.run.app ) مشکلی ندارید، از دکمه‌ی Publish در Google AI Studio استفاده کنید:

1. برنامه خود را در Google AI Studio باز کنید و روی انتشار کلیک کنید.
2. در انتخابگر پروژه، روی «وارد کردن پروژه» کلیک کنید.
3. نام پروژه مورد استفاده توسط Firebase Studio را جستجو و انتخاب کنید (در نوار ناوبری بالای فضای کاری Firebase Studio شما یافت می‌شود).
4. روی وارد کردن کلیک کنید و سپس روی انتشار کلیک کنید.

انتقال برنامه‌ها به Antigravity

Antigravity یک IDE محلی و مبتنی بر عامل است که قدرت هوش مصنوعی را به محیط توسعه محلی شما می‌آورد.

پیش‌نیازها

مطمئن شوید که موارد زیر را به صورت محلی نصب کرده و کاملاً به‌روز کرده‌اید:

• محیط برنامه‌نویسی آنتی‌گراویتی گوگل
• Node.js (نسخه ۲۰ یا بالاتر)
• رابط خط فرمان Firebase (نسخه ۱۵.۱۰.۰ یا بالاتر)

مرحله ۱: برنامه خود را صادر و مقداردهی اولیه کنید

npx firebase-tools@latest studio:export PATH

مرحله ۲: پیش‌نمایش برنامه خود را ببینید

وقتی پروژه خود را استخراج و در Antigravity باز کردید، می‌توانید برنامه خود را به صورت محلی مشاهده کنید:

1. در Antigravity، به منوی Run and Debug واقع در نوار کناری سمت چپ بروید.
2. برای شروع سرور توسعه محلی خود، روی دکمه پخش کلیک کنید.
3. برای پیش‌نمایش برنامه، دستورالعمل‌های موجود در ترمینال را دنبال کنید.

مرحله ۳: برنامه خود را منتشر کنید

آنتی‌گراویتی از مهارت‌های عامل (agent) برای انتشار برنامه شما با استفاده از بهترین شیوه‌های فایربیس (Firebase) استفاده می‌کند.

1. در پنل چت، عبارت زیر را وارد کنید:

   Publish my app
   

2. وقتی از شما خواسته شد که firebase deploy اجرا کنید، بله را انتخاب کنید. اگر قبلاً در Firebase App Hosting منتشر کرده باشید، agent آن را در URL موجود شما منتشر خواهد کرد. اگر این اولین بار است که در App Hosting منتشر می‌کنید، agent شما را در این فرآیند راهنمایی خواهد کرد.

3. برای به‌روزرسانی‌های آینده، به نماینده دستور دهید که publish my app .

انتقال برنامه‌ها به پلتفرم‌های دیگر

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

مرحله ۱: سورس پروژه خود را اکسپورت کنید

قبل از تاریخ غروب آفتاب، باید یک کپی محلی از فایل‌های پروژه خود را دانلود کنید:

1. روی دکمه‌ی «همین حالا منتقل کن» در بالای فضای کاری خود > «فشرده‌سازی و دانلود» کلیک کنید.
2. بایگانی را در دستگاه محلی خود استخراج کنید.

مرحله ۲: روش انتشار خود را انتخاب کنید

وقتی کد شما محلی شد، می‌توانید با استفاده از روش‌های زیر به ارائه برنامه خود ادامه دهید:

• رابط خط فرمان Firebase (آدرس اینترنتی فعلی شما را نگه می‌دارد)

  1. با اجرای دستور زیر، Firebase CLI را با استفاده از npm نصب کنید:

     npm install -g firebase-tools
     

  2. در ترمینال خود به دایرکتوری پروژه خود بروید.

  3. برای تنظیم استقرارهای App Hosting برای پروژه محلی خود، این دستور را اجرا کنید:

     firebase init apphosting
     

  4. وقتی از شما خواسته شد، گزینه‌ی «پیوند به یک بک‌اند موجود» را انتخاب کنید و بک‌اندی با نام «استودیو» را انتخاب کنید. این کار تضمین می‌کند که آدرس اینترنتی برنامه‌ی شما ثابت می‌ماند.

  5. برای تکمیل تنظیمات، دستورالعمل‌ها را دنبال کنید. پیکربندی App Hosting شما به firebase.json اضافه خواهد شد.

  6. استقرار برنامه:

     firebase deploy
     

• میزبانی خارجی: از آنجایی که کد خروجی شما یک برنامه وب استاندارد است، می‌توانید آن را با هر ارائه‌دهنده میزبانی راه‌اندازی کنید. توجه داشته باشید که انتقال به یک ارائه‌دهنده خارجی منجر به یک URL جدید خواهد شد.

• فقط توسعه محلی: شما می‌توانید با استفاده از Firebase Local Emulator Suite برای آزمایش سریع‌تر و آفلاین بدون نیاز به استقرار در یک محیط زنده، به توسعه و آزمایش برنامه خود به صورت محلی ادامه دهید.

عیب‌یابی و سوالات متداول

سوالات متداول و مراحل عیب‌یابی زیر را برای انتقال پروژه‌های Firebase Studio خود مرور کنید.

آیا می‌توانم تا زمان غروب آفتاب به استفاده از Firebase Studio ادامه دهم؟

بله، شما می‌توانید تا ۲۲ مارس ۲۰۲۷ به فضاهای کاری موجود دسترسی داشته باشید. ما همچنان به ارائه وصله‌های امنیتی حیاتی و به‌روزرسانی‌های مدل Gemini ادامه خواهیم داد تا از پایداری پروژه‌های فعلی شما اطمینان حاصل شود. توجه داشته باشید که ایجاد فضای کاری جدید از ۲۲ ژوئن ۲۰۲۶ غیرفعال خواهد شد.

آیا تاریخچه چت نماینده من منتقل خواهد شد؟

تاریخچه چت عامل شما بخشی از فایل زیپ خروجی فعلی نیست. با این حال، می‌توانید فایل‌های تاریخچه چت Gemini را برای App Prototyping agent و Gemini در عوامل Firebase در فضای کاری خود در دایرکتوری /home/user/.idx/ai فضای کاری Firebase Studio خود پیدا کنید. این شامل اعلان‌ها و پاسخ‌ها از همه حالت‌های چت Gemini است.

در اینجا نحوه ایجاد یک فایل زیپ که شامل تاریخچه شما باشد، آورده شده است:

1. فایل > باز کردن پوشه را انتخاب کنید.
2. دایرکتوری پیش‌فرض /home/user ‎ را بپذیرید.
3. پس از بارگذاری فایل‌ها، روی پوشه‌ی .idx/ai کلیک راست کرده و گزینه‌ی Zip and Download را انتخاب کنید.
4. وقتی از شما خواسته شد محیط را بازسازی کنید، روی لغو کلیک کنید.
5. پس از اتمام دانلود، دایرکتوری کاری خود را از منوی File دوباره باز کنید تا به فضای کاری خود برگردید.

برای Prototyper sessions, you can also view your prompts as part of the git log. Here's how to locate them:

1. نمای کد را باز کنید ( ).

2. هر یک از موارد زیر را انجام دهید:

   • یک بخش ترمینال ( Cmd-Shift-C در مک یا Ctrl-Shift-C در کروم او اس، ویندوز یا لینوکس) باز کنید و git log تایپ کنید.
   • کنترل منبع را باز کنید ( Cmd+Shift+G در مک یا Ctrl-Shift+G در ChromeOS، ویندوز یا لینوکس) و تاریخچه منبع را مشاهده کنید.

من سعی کردم فایل‌هایم را در Firebase Studio زیپ و دانلود کنم، اما هیچ اتفاقی نیفتاد.

این معمولاً توسط مسدودکننده‌ی پاپ‌آپ مرورگر ایجاد می‌شود. از آنجا که جریان مهاجرت، رابط کاربری جدیدی را برای پردازش درخواست شما باز می‌کند، برخی از مرورگرها ممکن است آن را به عنوان یک پاپ‌آپ ناخواسته علامت‌گذاری کنند.

برای رفع این مشکل، در نوار آدرس مرورگر خود (معمولاً در سمت راست) به دنبال اعلان «Pop-up blocked» بگردید. روی نماد کلیک کنید و گزینه اجازه دادن به پنجره‌های بازشو را انتخاب کنید و سپس دوباره روی دکمه کلیک کنید.

اگر این روش جواب نداد، از دستورالعمل‌های موجود در بخش «چگونه فایل‌هایم را از Firebase Studio دانلود کنم؟» برای اجرای دستی دستور Zip and Download استفاده کنید.

آیا می‌توانم فضاهای کاری Firebase Studio را که با من به اشتراک گذاشته شده است، منتقل کنم؟

فقط شخصی که فضای کاری Firebase Studio را ایجاد کرده است می‌تواند از دکمه Move now استفاده کند. اگر می‌خواهید یک کپی از پروژه داشته باشید، می‌توانید یکی از موارد زیر را انجام دهید:

• کپی کردن فضای کاری : یک کپی از پروژه را تحت حساب کاربری خودتان ایجاد کنید، که به شما امکان می‌دهد آن را به پروژه Firebase خود پیوند دهید و از ابزارهای مهاجرت استفاده کنید.
• کد خود را به صورت دستی صادر کنید: از نمای کد ، می‌توانید پالت فرمان ( Cmd + Shift + P در مک یا Ctrl + Shift + P در ChromeOS، ویندوز یا لینوکس) را باز کنید و دستور Firebase Studio : Zip & Download را اجرا کنید.

از کجا می‌توانم برنامه‌هایی را که به Google AI Studio منتقل کرده‌ام پیدا کنم؟

صفحه «برنامه‌های شما» فهرستی یکپارچه از تمام پروژه‌های شما، از جمله پروژه‌هایی که از ابتدا در Google AI Studio ایجاد شده‌اند و هر پروژه‌ای که منتقل کرده‌اید، ارائه می‌دهد.

Firebase Authentication با ورود به سیستم گوگل پس از مهاجرت به Google AI Studio کار نمی‌کند.

اگر برنامه شما از ورود به سیستم گوگل (Google Sign-In) استفاده می‌کند، باید دامنه پروژه جدید خود را تأیید کنید.

1. در کنسول Firebase ، به صفحه تنظیمات Authentication settings) بروید.
2. روی دامنه‌های مجاز کلیک کنید.
3. روی افزودن دامنه کلیک کنید و دامنه برنامه Google AI Studio خود را اضافه کنید.

اگر بعد از مهاجرت، عامل Google AI Studio از کار بیفتد یا در Google AI Studio خطایی مشاهده کنم، چه کاری باید انجام دهم؟

از آنجا که عامل Google AI Studio وظایف پیچیده پس‌زمینه را هنگام انتقال برنامه شما مدیریت می‌کند، این عامل گاهی اوقات می‌تواند با مشکلاتی مانند "لغو وظیفه"، تکرار پیام‌ها یا عدم پاسخگویی نخ‌ها مواجه شود.

• اگر عامل در اواسط کار بدون خطای واضحی متوقف شود، دادن پیامی مانند «از جایی که متوقف شدید ادامه دهید» یا «مرحله قبل را دوباره امتحان کنید» اغلب روند کار را دوباره شروع می‌کند.
• اگر پیامی مبنی بر وجود خطا در اجرای کد مشاهده کردید، روی دکمه رفع خطا کلیک کنید تا از عامل بخواهید که آنها را به طور خودکار برطرف کند.

اگر عملیات export متوقف شود یا timeout شود، چه می‌شود؟

اگر فرآیند مهاجرت هنگام آماده‌سازی فایل‌های شما متوقف شود، اغلب به دلیل حجم زیاد پوشه پروژه است.

برای هموار کردن مسیر برای یک مهاجرت موفق:

• حذف node_modules : به عنوان بخشی از فرآیند مهاجرت، این پوشه معمولاً حذف می‌شود. با این حال، اگر آن را تغییر نام داده یا منتقل کرده‌اید، یا قصد دارید کد خود را به صورت دستی فشرده و دانلود کنید، قبل از شروع مهاجرت آن را حذف کنید. نیازی به مهاجرت این پوشه نیست زیرا می‌توانید پس از انتقال به محیط جدید، npm install اجرا کنید.
• حذف مصنوعات بزرگ: هرگونه فایل رسانه‌ای بزرگ، خروجی‌های پایگاه داده یا پوشه‌های ساخت که برای کد منبع کاملاً ضروری نیستند را حذف کنید.
• بررسی وجود «حاشیه پنهان»: مطمئن شوید که به طور تصادفی یک تاریخچه حجیم .git یا گزارش‌های محلی را فشرده نمی‌کنید.

پس از حذف فایل‌های بزرگ، دوباره سعی کنید پروژه خود را منتقل کنید.

چرا دستورات Firebase CLI یا npx من در ترمینال Antigravity از کار می‌افتند؟

اگر با خطاهای «دستور یافت نشد» یا مشکلاتی در اجرای دستورات npx در Antigravity مواجه شدید - حتی اگر در ترمینال سیستم استاندارد شما کار کنند - احتمالاً به دلیل نحوه مقداردهی اولیه محیط پوسته شما است.

محیط ترمینال Antigravity تنظیمات پیکربندی را در ~/.bash_profile شما جستجو می‌کند. بسیاری از توسعه‌دهندگان، پیکربندی‌های npx و مسیر خود را در ~/.bashrc ذخیره می‌کنند. اگر این تنظیمات به اشتراک گذاشته نشوند، Antigravity نمی‌داند ابزارهای شما را کجا پیدا کند.

شما می‌توانید این مشکل را با سورس کردن فایل .bashrc خود در داخل .bash_profile خود برطرف کنید. این کار تضمین می‌کند که تمام پیکربندی‌های موجود شما هر زمان که Antigravity شروع می‌شود، بارگذاری می‌شوند.

1. فایل ~/.bash_profile خود را در Antigravity باز کنید.

2. بلوک کد زیر را به فایل اضافه کنید:

   if [ -f ~/.bashrc ]; then
       source ~/.bashrc
   fi
   

3. فایل را ذخیره کنید.

4. آنتی گراویتی را دوباره راه اندازی کنید.

منابع دیگر

• کدلب مهاجرت Firebase Studio به Antigravity را امتحان کنید .
• مستندات ضد جاذبه را بررسی کنید .
• مستندات استودیوی هوش مصنوعی گوگل را بررسی کنید .

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

اگر سؤالی، بازخوردی دارید یا در انتقال پروژه‌های خود با مشکلی مواجه شدید، از طریق یکی از روش‌های زیر با ما تماس بگیرید:

• با پشتیبانی فایربیس تماس بگیرید.
• در انجمن انجمن Firebase Studio پست بگذارید.