إيقاف 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 إذا استوفيت أيًا من المعايير التالية:

  • تفضيل العمل في بيئة سطح مكتب تستند إلى الذكاء الاصطناعي الوكيل مع تحكّم أكبر في قاعدة الرموز باستخدام Antigravity IDE أو الوحدة الطرفية
  • أنشأت تطبيقك باستخدام نموذج مضمّن أو مستودع مستورد في 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.

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

    4. اختَر تجهيز كل التغييرات وتنفيذها.

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

    1. في وحدة تحكّم Firebase، انتقِل إلى صفحة App Hosting.
    2. ابحث عن الخلفية الحالية (عادةً ما يكون اسمها studio) وانقر على عرض.
    3. في علامة التبويب الإعدادات، اختَر النشر > الربط بـ GitHub.
    4. سجِّل الدخول إلى GitHub وثبِّت Firebase App Hosting تطبيق GitHub.
    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 هي منصة محلية تستند إلى الذكاء الاصطناعي الوكيل ومركز وكلاء يتيح لك الاستفادة من قوة مهام سير العمل المستقلة التي تستخدم وكلاء متعددين في بيئة التطوير المحلية.

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

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

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

نقل البيانات تلقائيًا

يستخدم سير العمل هذا وكيل Antigravity للتعامل بشكل مستقل مع عملية تحويل المشاريع.

  1. في Firebase Studio، انقر على الزر نقل الآن في أعلى مساحة العمل.

  2. اتّبِع طريقة التصدير استنادًا إلى النافذة التي تظهر:

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

  3. استخرِج المجلد محليًا وافتحه في Antigravity بيئة التطوير المتكاملة.

  4. في لوحة الوكيل ضِمن واجهة Antigravity IDE، أدخِل الطلب التالي. لتحسين سير العمل والحفاظ على الرموز المميزة، ننصحك باختيار نموذج Gemini Flash. وهو مصمَّم للسرعة والكفاءة في مهام التحويل التي تتطلّب معالجة كميات كبيرة من البيانات، مثل تحويل الملفات.

    @fbs-to-agy-export

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

التصدير اليدوي

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

افتح الوحدة الطرفية ونفِّذ الأمر التالي، مع استبدال PATH بمسار مجلد المشروع الذي تم استخراجه أو ملف zip الأصلي (استخدِم . إذا كنت في الدليل المستهدف):

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 في لوحة المحادثة.

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

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

الخطوة 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. سنواصل توفير رموز تصحيح الأمان المهمة وتحديثات Gemini للنماذج لضمان بقاء مشاريعك الحالية ثابتة. يُرجى العِلم أنّه سيتم إيقاف إنشاء مساحات عمل جديدة اعتبارًا من 22 يونيو 2026.

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

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

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

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

بالنسبة إلى جلسات 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 والمشاريع التي نقلتها.

لا تعمل ميزة "تسجيل الدخول باستخدام حساب Google" في Firebase Authentication بعد نقل البيانات إلى 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، حتى إذا كانت تعمل في وحدة التحكّم العادية في نظامك، فمن المحتمل أن يكون ذلك بسبب طريقة تهيئة بيئة الصدفة.

تبحث بيئة المحطة الطرفية في 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.

موارد أخرى

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

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