إيقاف Firebase Studio نهائيًا ونقل المشاريع

سيتم إيقاف Firebase Studio نهائيًا في ‎22 مارس 2027. نعمل على تبسيط عروضنا للمطوّرين الذين يستخدمون الذكاء الاصطناعي من خلال نقل الدروس المستفادة من المعاينة في Firebase Studio إلى أدواتنا الرئيسية: Google AI Studio وGoogle Antigravity.

على الرغم من أنّ واجهة إنشاء التطبيقات تتطوّر، يظل التزامنا بنظام Firebase الإيكولوجي أقوى من أي وقت مضى. من خلال دمج الإمكانات القائمة على الوكلاء مباشرةً في منصات الذكاء الاصطناعي الرئيسية، نضمن استمرار Firebase في توفير واجهة خلفية سلسة وموثوقة للتطوير المستند إلى الذكاء الاصطناعي. ستستمر خدمات Firebase الأساسية، مثل Cloud Firestore Authentication وApp Hosting، في العمل خارج Firebase Studio.

سبب إجراء هذا التغيير

Firebase Studio تم إطلاقه كمعاينة لاستكشاف مستقبل التطوير الكامل المستند إلى الذكاء الاصطناعي، استنادًا إلى ملاحظاتك، نعمل على تبسيط أدواتنا لتوفير مسارات أكثر وضوحًا وفعالية للمضي قدمًا:

• بالنسبة إلى التطوير القائم على الرموز البرمجية والمستند إلى الوكلاء: نركّز على Antigravity، وهي بيئة تطوير متكاملة من الجيل التالي مصمّمة لسير العمل المحلي المستقل عالي السرعة.

• بالنسبة إلى النماذج الأولية السريعة المستندة إلى المتصفّح: لقد دمجنا Cloud Firestore و Firebase Authentication مباشرةً في Google AI Studio لتوفير أسرع مسار من الطلب إلى تطبيق الإنتاج.

لن تتأثر خدمات Firebase الأساسية (Cloud Firestore, Authentication, App Hosting, إلخ). سيستمر عمل قواعد البيانات وبيانات المستخدمين بشكل طبيعي. لا ينطبق هذا الإيقاف النهائي إلا على بيئة تطوير Firebase Studio.

الجدول الزمني للإيقاف النهائي

نوفّر فترة نقل مدتها عام واحد لضمان حصولك على وقت كافٍ لنقل مشاريعك:

• ‫19 مارس 2026: إعلان الإيقاف النهائي وبدء طرح أدوات نقل البيانات في Firebase Studio
• ‫22 يونيو 2026: إيقاف إنشاء مساحات عمل جديدة يمكنك مواصلة العمل في مساحات العمل الحالية ونقلها.
• ‫22 مارس 2027: Firebase Studio تم إيقافه نهائيًا، وحذف جميع البيانات المتبقية نهائيًا ولا يمكن استردادها

اختيار مسار نقل البيانات

استنادًا إلى طريقة استخدامك لـ Firebase Studio، اختَر مسار نقل البيانات الذي يناسب سير عملك على أفضل وجه.

نقل البيانات إلى Google Antigravity

للحصول على تجربة تطوير قائمة على الرموز البرمجية ومستندة إلى الوكلاء، ننصحك بنقل البيانات إلى Antigravity. وهي بيئة تطوير متكاملة من الجيل التالي مصمّمة لسير العمل المحلي المستقل عالي السرعة. عليك اختيار Antigravity إذا كنت تستوفي أيًا من المعايير التالية:

• تفضّل العمل في بيئة تطوير محلية قائمة على الرموز البرمجية مع تحكّم أكبر في قاعدة الرموز البرمجية
• أنشأت تطبيقك باستخدام نموذج مضمّن أو مستودع مستورَد في Firebase Studio
• تستخدم بشكل أساسي بيئة "عرض الرموز البرمجية" في Firebase Studio
• تريد الوصول المباشر إلى أحدث إمكانات تطوير الذكاء الاصطناعي الوكيل ضمن بيئة تطوير متكاملة فعّالة، مع إمكانية استخدام نماذج مختلفة مثل Claude وGPT-OSS، بالإضافة إلى Gemini
• بدأت في وضع Prototyper، ولكنك أضفت ميزات مهمة أو نصوصًا برمجية للتنفيذ تتطلب بيئة محلية بدون قيود سحابية

نقل البيانات إلى Google AI Studio

للحصول على بيئة إنشاء نماذج أولية مستندة إلى الويب تتيح لك الاستفادة من قوة الذكاء الاصطناعي في متصفّحك، ننصحك بنقل البيانات إلى Google AI Studio. يوفر هذا الخيار أسرع مسار من الطلب إلى تطبيق إنتاج كامل الميزات. عليك اختيار Google AI Studio إذا كنت تستوفي أيًا من المعايير التالية:

• تفضّل تجربة مستندة إلى الويب، وهي مثالية لسير العمل على أجهزة متعددة أو البيئات التي لا يمكنك فيها تثبيت برامج محلية
• أنشأت تطبيقك باستخدام App Prototyping agent في Firebase Studio وتُقدّر قيمة النماذج الأولية السريعة وإنشاء التطبيقات المستند إلى الطلبات
• تريد أسرع مسار من الطلب إلى تطبيق إنتاج كامل الميزات

نقل التطبيقات إلى Google AI Studio

Google AI Studio يوفر أسرع مسار من الطلب إلى تطبيق إنتاج كامل الميزات.

الخطوة 1: نقل مساحة العمل

1. انقر على الزر نقل البيانات الآن في أعلى مساحة العمل، ثم انقر على الإعداد لاستخدام AI Studio.
2. بعد اكتمال خطوة الإعداد، انقر على نقل البيانات إلى Google AI Studio.
3. راجِع بنود الخدمة ووافِق عليها إذا طُلب منك ذلك. سيتم فتح الرمز البرمجي تلقائيًا في مساحة عمل جديدة على Google AI Studio

قد يستغرق Google AI Studio عدة دقائق لتحويل تطبيقك وتحميله. وسيُعلمك عند اكتمال العملية. عند الانتهاء، يمكنك مواصلة تكرار تطبيقك بمساعدة وكيل Google AI Studio. مزيد من المعلومات عن إنشاء التطبيقات في Google AI Studio

الخطوة 2: اختيار طريقة النشر

استنادًا إلى احتياجاتك المتعلقة بالنشر وما إذا كنت تريد الاحتفاظ بعنوان URL الحالي لتطبيقك، اختَر إحدى طرق النشر التالية.

الخيار (أ): النشر على App Hosting والاحتفاظ بعنوان URL الحالي

إذا سبق لك نشر تطبيقك من خلال Firebase Studio وأردت الاحتفاظ بعنوان URL *.hosted.app أو النطاق المخصّص، عليك تأمين مفتاح Gemini API واستخدام ميزة "المزامنة مع GitHub":

1. تأمين مفتاح Gemini API:

   1. في وحدة تحكّم Firebase، انتقِل إلى صفحة App Hosting.
   2. ابحث عن الواجهة الخلفية الحالية (عادةً ما يكون اسمها studio) وانقر على عرض.
   3. في علامة التبويب الإعدادات ، انتقِل إلى البيئة.

   4. انقر على إضافة جديد والصق محتويات ملفك .env في الحقل المفتاح لتخزين مفتاح Gemini API بشكل آمن كمتغيّر بيئة.

2. المزامنة مع GitHub من Google AI Studio

   1. في Google AI Studio، انقر على رمز الإعدادات وانتقِل إلى لوحة GitHub.
   2. انقر على تسجيل الدخول إلى GitHub وثبِّت تطبيق Google AI Studio GitHub App.

   3. انقر على إنشاء مستودع GitHub.

   4. انقر على تجهيز جميع التغييرات وإضافتها إلى سجلّ التعديلات.

3. ربط المستودع بـ App Hosting:

   1. في وحدة تحكّم Firebase، انتقِل إلى صفحة App Hosting.
   2. ابحث عن الواجهة الخلفية الحالية (عادةً ما يكون اسمها studio) وانقر على عرض.
   3. في علامة التبويب الإعدادات ، انقر على النشر > الربط بـ GitHub.
   4. سجِّل الدخول إلى GitHub وثبِّت تطبيق Firebase App Hosting GitHub App.
   5. اختَر المستودع واضبط الفرع على main ودليل الجذر على /.
   6. انقر على حفظ ونشر.

4. مزامنة التغييرات مع GitHub ونشرها:

   1. في Google AI Studio، انتقِل إلى لوحة GitHub.
   2. راجِع التغييرات التي سيتم نشرها.
   3. انقر على تجهيز جميع التغييرات وإضافتها إلى سجلّ التعديلات.
   4. انتقِل إلى وحدة تحكّم Firebase لتتبُّع مستوى تقدُّم عملية نشر App Hosting.

الخيار (ب): نقل البيانات إلى Cloud Run ونشر تطبيقك على عنوان URL جديد

إذا كنت تفضّل تجربة بنقرة واحدة ولم يسبق لك نشر تطبيقك أو لا يهمك الحصول على عنوان URL جديد (*.run.app)، استخدِم الزر نشر في Google AI Studio

1. افتح تطبيقك في Google AI Studio وانقر على نشر.
2. في أداة اختيار المشاريع، انقر على استيراد مشروع.
3. ابحث عن اسم المشروع الذي يستخدمه Firebase Studio واختَره (يمكنك العثور عليه في شريط التنقّل العلوي لمساحة عمل Firebase Studio).
4. انقر على استيراد، ثم انقر على نشر.

نقل التطبيقات إلى Antigravity

Antigravity هي بيئة تطوير متكاملة محلية ومستندة إلى الوكلاء تتيح لك الاستفادة من قوة الذكاء الاصطناعي في بيئة التطوير المحلية.

المتطلبات الأساسية

تأكَّد من تثبيت ما يلي على جهازك وأن يكون محدّثًا بالكامل:

• بيئة تطوير Google Antigravity المتكاملة
• Node.js (الإصدار 20 أو إصدار أحدث)
• Firebase واجهة سطر الأوامر (CLI) (الإصدار 15.10.0 أو إصدار أحدث)

الخطوة 1: تصدير تطبيقك وتهيئته

npx firebase-tools@latest studio:export PATH

الخطوة 2: معاينة تطبيقك

بعد استخراج مشروعك وفتحه في Antigravity، يمكنك عرض تطبيقك محليًا:

1. في Antigravity، انتقِل إلى قائمة التشغيل وتصحيح الأخطاء الموجودة في الشريط الجانبي الأيمن.
2. انقر على زر التشغيل لبدء خادم التطوير المحلي.
3. اتّبِع التعليمات في الوحدة الطرفية لمعاينة تطبيقك.

الخطوة 3: نشر تطبيقك

يستخدم Antigravity مهارات الوكيل لنشر تطبيقك باستخدام أفضل ممارسات Firebase.

1. في لوحة المحادثة، أدخِل الطلب التالي:

   Publish my app
   

2. عندما يُطلب منك تنفيذ firebase deploy، اختَر نعم. سينشر الوكيل على عنوان URL الحالي إذا سبق لك النشر على Firebase App Hosting. إذا كانت هذه هي المرة الأولى التي تنشر فيها على App Hosting، سيقدّم لك الوكيل إرشادات حول العملية.

3. للحصول على التحديثات المستقبلية، اطلب من الوكيل publish my app في لوحة محادثة Antigravity.

نقل التطبيقات إلى منصات أخرى

إذا كنت تفضّل نقل مشروعك إلى بيئة تطوير أو منصة استضافة مختلفة، يمكنك تصدير رمز المصدر وإدارة عمليات النشر يدويًا.

الخطوة 1: تصدير مصدر مشروعك

قبل تاريخ الإيقاف النهائي، عليك تنزيل نسخة محلية من ملفات مشروعك:

1. انقر على الزر نقل البيانات الآن في أعلى مساحة العمل > ضغط وتنزيل.
2. استخرِج الأرشيف على جهازك المحلي.

الخطوة 2: اختيار طريقة النشر

بعد أن يصبح الرمز البرمجي محليًا، يمكنك مواصلة عرض تطبيقك باستخدام الطرق التالية:

• Firebase واجهة سطر الأوامر (CLI) (تحتفظ بعنوان URL الحالي)

  1. ثبِّت Firebase واجهة سطر الأوامر (CLI) باستخدام npm عن طريق تنفيذ الأمر التالي:

     npm install -g firebase-tools
     

  2. انتقِل إلى دليل مشروعك في الوحدة الطرفية.

  3. نفِّذ هذا الأمر لإعداد عمليات نشر App Hosting لمشروعك المحلي:

     firebase init apphosting
     

  4. عندما يُطلب منك ذلك، اختَر الربط بواجهة خلفية حالية واختَر الواجهة الخلفية المسماة studio. يضمن ذلك بقاء عنوان URL لتطبيقك كما هو.

  5. اتّبِع التعليمات لإكمال الإعداد. ستتم إضافة إعدادات App Hosting إلى firebase.json.

  6. انشر التطبيق:

     firebase deploy
     

• الاستضافة الخارجية: بما أنّ الرمز البرمجي الذي تم تصديره هو تطبيق ويب عادي، يمكنك تهيئته باستخدام أي موفِّر استضافة. يُرجى العِلم أنّ الانتقال إلى موفِّر خارجي سيؤدي إلى إنشاء عنوان URL جديد.

• التطوير المحلي فقط: يمكنك مواصلة تطوير تطبيقك واختباره محليًا باستخدام Firebase Local Emulator Suite لإجراء اختبار أسرع بدون الاتصال بالإنترنت بدون النشر في بيئة نشطة.

تحديد المشاكل وحلّها والأسئلة الشائعة

راجِع الأسئلة الشائعة وخطوات تحديد المشاكل وحلّها التالية لنقل مشاريعك Firebase Studio.

هل يمكنني مواصلة استخدام Firebase Studio حتى تاريخ الإيقاف النهائي؟

نعم، يمكنك الوصول إلى مساحات العمل الحالية حتى ‎22 مارس 2027. سنواصل توفير رموز تصحيح الأمان المهمة وتحديثات نموذج Geminimodel لضمان بقاء مشاريعك الحالية مستقرة. يُرجى العِلم أنّه سيتم إيقاف إنشاء مساحات عمل جديدة اعتبارًا من ‎22 يونيو 2026.

هل سيتم نقل سجلّ محادثات الوكيل؟

لا يشكّل سجلّ محادثات الوكيل جزءًا من ملف ZIP الحالي الذي تم تصديره. ومع ذلك، يمكنك تحديد موقع ملفات سجلّ محادثات Gemini لوكيل الـ App Prototyping agent وGemini في Firebase ضمن مساحة العمل في الدليل /home/user/.idx/ai لمساحة عمل Firebase Studio. يحتوي هذا الدليل على الطلبات والردود من جميع Gemini أوضاع المحادثات.

إليك كيفية إنشاء ملف ZIP يحتوي على سجلّ المحادثات:

1. انقر على ملف > فتح مجلد.
2. اقبَل الدليل التلقائي /home/user.
3. بعد تحميل الملفات، انقر بزر الماوس الأيمن على الدليل .idx/ai وانقر على ضغط وتنزيل.
4. عندما يُطلب منك إعادة إنشاء البيئة، انقر على إلغاء.
5. بعد اكتمال عملية التنزيل، أعِد فتح دليل العمل من قائمة ملف للرجوع إلى مساحة العمل.

بالنسبة إلى جلسات Prototyper، يمكنك أيضًا عرض طلباتك كجزء من سجلّ git. إليك كيفية العثور عليها:

1. افتح عرض الرمز ().

2. نفِّذ أحد الإجراءَين التاليَين:

   • افتح جلسة طرفية (Cmd-Shift-C على أجهزة Mac أو Ctrl-Shift-C على أجهزة ChromeOS أو Windows أو Linux) واكتب git log.
   • افتح التحكّم في المصدر (Cmd+Shift+G على أجهزة Mac أو Ctrl-Shift+G على أجهزة ChromeOS أو Windows أو Linux) واعرض سجلّ المصدر.

حاولت ضغط ملفاتي وتنزيلها في Firebase Studio، ولكن لم يحدث شيء.

يرجع ذلك عادةً إلى أداة حظر النوافذ المنبثقة في المتصفّح. بما أنّ عملية نقل البيانات تفتح واجهة جديدة لمعالجة طلبك، قد تصنّفها بعض المتصفّحات على أنّها نافذة منبثقة غير مرغوب فيها.

لحلّ هذه المشكلة، ابحث عن إشعار "تم حظر نافذة منبثقة" في شريط العناوين في متصفّحك (عادةً ما يكون على الجانب الأيمن). انقر على الرمز واختَر الخيار للسماح بالنوافذ المنبثقة، ثم حاوِل النقر على الزر مرة أخرى.

إذا لم ينجح ذلك، استخدِم التعليمات الواردة في كيف يمكنني تنزيل ملفاتي من Firebase Studio؟ لتنفيذ الأمر ضغط وتنزيل يدويًا.

هل يمكنني نقل Firebase Studio مساحات عمل تمت مشاركتها معي؟

يمكن فقط للشخص الذي أنشأ مساحة عمل Firebase Studio استخدام الزر نقل البيانات الآن. إذا كنت تريد الحصول على نسخة من المشروع، يمكنك تنفيذ أي من الإجراءَين التاليَين:

• تكرار مساحة العمل: أنشئ نسخة من المشروع ضمن حسابك، ما يتيح لك ربطها بمشروعك على Firebase واستخدام أدوات نقل البيانات.
• تصدير الرمز البرمجي يدويًا: من طريقة عرض الرمز، يمكنك فتح لوحة الأوامر (Cmd+Shift+P على أجهزة Mac أو Ctrl+Shift+P على أجهزة ChromeOS أو Windows أو Linux) وتنفيذ الأمر Firebase Studio: Zip & Download.

أين يمكنني العثور على التطبيقات التي نقلتها إلى Google AI Studio؟

توفر صفحة تطبيقاتك قائمة موحدة بجميع مشاريعك، بما في ذلك المشاريع التي تم إنشاؤها من البداية في Google AI Studio وأي مشاريع نقلتها.

لا تعمل ميزة Firebase Authentication مع "تسجيل الدخول باستخدام حساب Google" بعد نقل البيانات إلى Google AI Studio.

إذا كان تطبيقك يستخدم ميزة "تسجيل الدخول باستخدام حساب Google"، عليك منح الإذن لنطاق مشروعك الجديد.

1. في وحدة تحكّم Firebase، انتقِل إلى صفحة إعدادات Authentication.
2. انقر على النطاقات المسموح بها.
3. انقر على إضافة نطاق وأضِف نطاق تطبيقك Google AI Studio.

ماذا عليّ أن أفعل إذا توقّف وكيل Google AI Studio عن العمل أو إذا ظهرت لي أخطاء في Google AI Studio بعد نقل البيانات؟

بما أنّ وكيل Google AI Studio يدير مهامًا خلفية معقدة أثناء نقل تطبيقك، قد يواجه الوكيل أحيانًا مشاكل مثل "تم إلغاء المهمة" أو الرسائل المتكررة أو سلاسل المحادثات التي لا تستجيب.

• إذا توقّف الوكيل في منتصف المهمة بدون ظهور خطأ واضح، غالبًا ما يؤدي تقديم طلب إليه، مثل "مواصلة العمل من حيث توقّفت" أو "إعادة محاولة الخطوة الأخيرة"، إلى إعادة بدء العملية.
• إذا ظهرت لك رسالة تشير إلى حدوث أخطاء أثناء تشغيل الرمز البرمجي، انقر على الزر إصلاح لطلب حلّها تلقائيًا من الوكيل.

ماذا يحدث إذا توقّف التصدير أو انتهت مهلته؟

إذا توقّفت عملية نقل البيانات أثناء إعداد ملفاتك، يرجع ذلك غالبًا إلى مجلد مشروع كبير جدًا.

لإزالة العوائق أمام عملية نقل بيانات ناجحة:

• حذف node_modules: تتم إزالة هذا المجلد عادةً كجزء من عملية نقل البيانات. ومع ذلك، إذا أعدت تسميته أو نقلته، أو كنت تخطط لضغط الرمز البرمجي وتنزيله يدويًا، عليك حذفه قبل بدء عملية نقل البيانات. لست بحاجة إلى نقل هذا المجلد لأنّه يمكنك تشغيل npm install بعد الانتقال إلى بيئتك الجديدة.
• إزالة العناصر الكبيرة: احذف أي ملفات وسائط كبيرة أو عمليات تصدير قواعد البيانات أو مجلدات الإنشاء التي ليست ضرورية تمامًا لرمز المصدر.
• البحث عن التضخّم "المخفي": تأكَّد من أنّك لا تضغط عن طريق الخطأ سجلّ .git كبيرًا أو سجلّات محلية.

بعد حذف أي ملفات كبيرة، حاوِل نقل مشروعك مرة أخرى.

لماذا تفشل أوامر Firebase CLI أو أوامر npx في الوحدة الطرفية في Antigravity؟

إذا واجهتك أخطاء "لم يتم العثور على الأمر" أو مشاكل في تشغيل أوامر npx ضمن Antigravity، على الرغم من أنّها تعمل في الوحدة الطرفية العادية للنظام، فمن المحتمل أن يكون ذلك بسبب طريقة تهيئة بيئة shell.

تبحث بيئة الوحدة الطرفية في Antigravity عن إعدادات الضبط في ~/.bash_profile. يخزّن العديد من المطوّرين إعدادات npx والمسار في ~/.bashrc بدلاً من ذلك. إذا لم تتم مشاركة هذه الإعدادات، لن يعرف Antigravity مكان العثور على أدواتك.

يمكنك حلّ هذه المشكلة عن طريق استخراج ملف .bashrc داخل ملف `‎ .bash_profile`. يضمن ذلك تحميل جميع الإعدادات الحالية عند بدء تشغيل Antigravity.

1. افتح ملف ~/.bash_profile في Antigravity.

2. أضِف مجموعة الرموز التالية إلى الملف:

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

3. احفظ الملف.

4. أعِد تشغيل Antigravity.

موارد أخرى

• جرِّب الدرس التطبيقي حول نقل البيانات من Firebase Studio إلى Antigravity.
• استكشِف مستندات Antigravity.
• استكشِف مستندات Google AI Studio.

بحاجة إلى مساعدة؟

إذا كانت لديك أسئلة أو ملاحظات أو واجهتك أي مشاكل في نقل مشاريعك، تواصَل معنا في أحد الأماكن التالية:

• التواصل مع فريق دعم Firebase.
• النشر في Firebase Studio Community Forum.