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

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 دوباره بررسی کنید!

انتقال برنامه‌ها به 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 را اجرا کنید.

اگر عملیات 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 پست بگذارید.