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

لماذا يجب تفعيل ملفات تعريف الارتباط التابعة لجهات خارجية (3P) في Firebase Studio؟

يحتاج Firebase Studio إلى تفعيل ملفات تعريف الارتباط التابعة لجهات خارجية لأنّنا نعرض إطار iframe من نطاق واحد (نطاق فرعي من cloudworkstations.dev) على نطاق آخر (studio.firebase.google.com)، وتتيح ملفات تعريف الارتباط التابعة لجهات خارجية إمكانية التواصل الآمن بين المصادر المختلفة.

عند فتح مساحة عمل، تظهر الرسالة تعذّر إعادة توجيه طلبك إلى الخلفية. يظهر الخطأ "تعذّر الاتصال بخادم على المنفذ 80".

انتظِر خمس ثوانٍ تقريبًا وأعِد تحميل الصفحة.

لا يتم تحميل المعاينة، ولكن لا يمكنني العثور على أي مشاكل في الرمز. كيف يمكنني إعادة تشغيل Firebase Studio؟

إذا لم يتم إعادة تحميل Firebase Studio بشكل سليم (عادةً نتيجة إعادة هيكلة رئيسية أو تغييرات في ملف dev.nix الخاص ببيئتك)، افتح لوحة الأوامر (Cmd+Shift+P على جهاز Mac أو Ctrl+Shift+P على جهاز ChromeOS أو Windows أو Linux) ونفِّذ الأمر إعادة التشغيل الإجبارية. إذا لم ينجح ذلك، جرِّب تنفيذ الأمر إعادة إنشاء البيئة.

مساحة العمل غير متجاوبة، ولا يظهر لي سوى شاشة فارغة عند تحميلها

إذا لم يستجب مساحة العمل، يمكنك محاولة إعادة ضبط الجهاز الظاهري. ولإجراء ذلك:

1. من Firebase Studio، انقر على قائمة المزيد ( more_horiz )، ثم انقر على إعادة الضبط.

2. انقر مرة أخرى على إعادة الضبط عندما يُطلب منك ذلك.

3. أعِد فتح مساحة عملك.

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

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

[Errno 28] No space left on device

قد تظهر لك هذه الرسالة إذا كان القرص ممتلئًا. توفّر مساحة عمل Firebase Studio ما يلي:

• مساحة القرص الإجمالية المتاحة لحِزم Nix و/tmp تبلغ 100 غيغابايت
• ‫10 غيبي بايت لدليل /home

عند إنشاء مساحة عمل، تظهر لي رسالة الخطأ حدث خطأ داخلي.

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

كم عدد مساحات العمل التي يمكنني إنشاؤها؟

تقتصر خطة Firebase Studio بدون تكلفة على ثلاث مساحات عمل لكل مستخدم. يمكنك زيادة عدد مساحات العمل التي يمكنك إنشاؤها إلى 10 من خلال الانضمام إلى برنامج المطوّرين من Google. لترقية حسابك إلى 30 مساحة عمل، عليك الاشتراك في برنامج Google Developer Premium.

كيف يمكنني إرسال طلب للحصول على ميزة أو ملاحظات حول مشكلة واجهتني؟

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

كنت أستخدم ميزة معيّنة في Firebase Studio، ولكن لم أعُد أجدها. لماذا تمّت إزالته؟

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

يتم تحميل مساحة العمل، ولكن المحاكي يظهر فارغًا.

نعمل بنشاط على تحسين موثوقية المحاكيات المستندة إلى السحابة الإلكترونية. إذا لم يؤدِّ إعادة تحميل الصفحة إلى حلّ المشكلة، يُرجى الإبلاغ عن المشكلة إلى فريق دعم Firebase.

تحتوي مساحات عمل Firebase Studio على إصدار Flutter غير متوافق مع مشروعي.

يمكنك ترقية إصدار جميع البرامج المثبّتة مسبقًا أو الرجوع إلى إصدار سابق منها داخل مساحة عمل، تمامًا كما تفعل على جهازك المحلي (باستخدام apt-get أو brew). يمكنك ترقية البرامج أو الرجوع إلى إصدارات سابقة في مساحة عملك، ولكن لا يتم الاحتفاظ بالبرامج المثبَّتة بين الجلسات. ننصحك بتضمين جميع الحِزم المطلوبة في ملف dev.nix.

نعمل حاليًا على تحسين إدارة إصدارات Flutter في Firebase Studio.

شاركتُ عنوان URL الخاص بمحطة العمل مع شخص، ولكن لا يمكنه رؤيته.

يمكنك مشاركة عنوان URL لمساحة عمل مع المستخدمين الذين لديهم إذن الوصول إلى مساحة العمل فقط. عندما يحاول المستخدمون الذين ليس لديهم إذن زيارة عنوان URL، تظهر لهم رسالة خطأ. احرص على مشاركة مساحة العمل معهم بشكل صريح.

عند مشاركة محطة العمل، ما الذي يمكن أن يراه المتعاون؟

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

شاركتُ مساحة عملي، لماذا لا يمكن للمتعاون معي نشر تطبيقي أو مراقبته؟

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

هل يمكنني استخدام أُطر لا يتوفّر لها نموذج في Firebase Studio لإنشاء تطبيقي؟

نعم. يمكنك تخصيص بيئتك للعمل مع أي إطار عمل أو لغة في Firebase Studio.

ما هو دليل الاستهداف الذي يجب اختياره عند نشر تطبيق Flutter على Firebase Hosting؟

اختَر دليل build/web. يجب أن يحتوي هذا الدليل على index.html وجميع مواد العرض الثابتة اللازمة لعرض تطبيق الويب بعد إنشاء التطبيق بنجاح (من خلال flutter build web).

كيف يمكنني إعداد الخلفية لتطبيقي في مساحة العمل الخاصة بي حتى تتمكّن الواجهة الأمامية من التواصل معها؟

يمكنك فتح منفذ TCP الذي يعمل عليه خادم الخلفية بشكل مؤقت للجميع لتسهيل تطوير الواجهة الأمامية والخلفية بشكل منفصل، وذلك في مساحات عمل مختلفة، باتّباع الخطوات التالية:

1. ابدأ تشغيل الخادم الخلفي أو خادم واجهة برمجة التطبيقات إما يدويًا في نافذة طرفية أو كجزء من إعدادات المعاينة في ملف dev.nix أو خطاف دورة حياة onStart.

2. انقر على الرمز Firebase Studio في شريط الأنشطة (على اليمين تلقائيًا) لفتح اللوحة Firebase Studio.

3. 

   وسِّع قسم منافذ الخلفية للاطّلاع على قائمة بالخوادم التي تعمل، بما في ذلك رقم المنفذ ومعرّف العملية (PID).

4. انقر على رمز إتاحة الوصول للجميع (قفل) على يمين رقم المنفذ.

5. انقر على رمز نسخ عنوان URL على يسار رقم المنفذ لنسخ عنوان URL المؤهّل بالكامل.

6. يمكنك الآن الرجوع إلى عنوان URL هذا مباشرةً (على سبيل المثال، باستخدام طلب fetch) من الواجهة الأمامية.

أغلقتُ علامة تبويب المعاينة. كيف يمكنني استعادة هذه البيانات؟

افتح لوحة الأوامر باستخدام Ctrl+Shift+P (أو Cmd-Shift-P على نظام التشغيل MacOS)، ثم اختَر Firebase Studio: عرض معاينة Android أو Firebase Studio: عرض معاينة الويب.

ما هو Code OSS؟

‫Code-Open Source Software (Code-OSS) هو مشروع مفتوح المصدر يشكّل الطبقة الأساسية من VS Code. يتوفّر Code-OSS على GitHub بموجب ترخيص MIT العادي، وهو المكان الذي تطوّر فيه Microsoft منتج VS Code.

كيف يمكنني منع استخدام عمليات إكمال الرموز البرمجية وطلبات الدردشة Gemini كبيانات تدريب؟

يخضع استخدامك لـ "Firebase Studio" لبنود خدمة Google.

يُرجى العِلم أنّ استخدامك لميزات الذكاء الاصطناعي التوليدي ضمن Firebase Studio يخضع لسياسة الاستخدام المحظور للذكاء الاصطناعي التوليدي وبنود الخدمة الإضافية الخاصة بـ "Gemini API" (تحديدًا بنود الخدمة الإضافية الخاصة بـ "Gemini API": الخدمات غير المدفوعة).

لحظر استخدام طلباتك وردودك في تدريب النماذج، لا تستخدم App Prototyping agent، ولا تستخدم Gemini في Firebase ضمن Firebase Studio. لحظر استخدام الرمز في تدريب النماذج، أوقِف ميزة إكمال الرمز وفهرسة الرمز في إعدادات Firebase Studio.

كيف يمكنني الاطّلاع على حصة الطلبات في الدقيقة لمفتاح Gemini API الذي تم إنشاؤه تلقائيًا؟

يمكنك الاطّلاع على الحصص المرتبطة بمفتاح واجهة برمجة التطبيقات الذي تم إنشاؤه تلقائيًا في صفحة حصص واجهة Generative Language API وحدود النظام في وحدة تحكّم Google Cloud.

تلقّيت رسالة خطأ بشأن تجاوز الحد الأقصى المسموح به لعدد الرموز المميزة

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

1. في مساحة العمل، انتقِل إلى طريقة العرض Code.

2. أنشئ ملف .aiexclude.

3. يجب أن تتجاهل "تضمين الملفات أو الدلائل" Gemini لتقليل مقدار البيانات في مشروعك. على سبيل المثال، قد تريد إضافة .next/ وجميع الأدلة الفرعية. يجب أن يكون المسار مرتبطًا بالدليل الذي يحتوي على ملف .aiexclude:

    .next/
   

4. يُرجى إعادة المحاولة لاستخدام Gemini. إذا استمر ظهور خطأ بشأن تجاوز الحد الأقصى لعدد الرموز المميزة، جرِّب إضافة ملفات أو أدلة كبيرة أخرى إلى ملف .aiexclude.

تعذّر عليّ إنشاء مشروع

عند توفير موارد مثل مفتاح Gemini API أو النشر إلى Firebase App Hosting، يتم توفير مشروع لك تلقائيًا استنادًا إلى اسم مساحة عمل Firebase Studio.

إذا تلقّيت رسالة الخطأ "تعذّر إنشاء مشروع"، اتّبِع الخطوات التالية:

• إذا كان حسابك على Google جزءًا من مؤسسة، من المحتمل أنّه ليس لديك إذن بإنشاء مشاريع Google Cloud أو أنّك بلغت الحد الأقصى المسموح به من حصة المشاريع. يُرجى التواصل مع المشرف للحصول على المساعدة أو الاطّلاع على مقالة إنشاء المشاريع وإدارتها.

• إذا لم يكن حسابك على Google جزءًا من مؤسسة، قد تكون قد بلغت الحد الأقصى المسموح به Google Cloud لحصة المشروع. طلب زيادة الحصة

  اطّلِع على إدارة حصص المشاريع لمعرفة المزيد عن حصص المشاريع.

يمكنك الاطّلاع على مزيد من المعلومات حول مشاريع Firebase وGoogle Cloud على الرابط التعرّف على مشاريع Firebase.

تعذّر إنشاء حساب Cloud Billing

عند توفير موارد، مثل النشر إلى Firebase App Hosting، يمكنك اختيار حساب Cloud Billing أو إنشاؤه.

إذا تلقّيت رسالة الخطأ "تعذّر إنشاء حساب Cloud Billing"، اتّبِع الخطوات التالية:

• تأكَّد من حصولك على الإذن لإنشاء Cloud Billing حسابات. يُرجى التحقّق من أذوناتك أو التواصل مع المشرف للحصول على المساعدة.

إذا تلقّيت رسالة الخطأ "عدد كبير جدًا من المشاريع باستخدام حساب الفوترة هذا"، اتّبِع الخطوات التالية:

• ربما بلغت الحد الأقصى للمشاريع في حسابك على Cloud Billing. يمكنك طلب زيادة الحصة. مزيد من المعلومات حول حصص حساب Cloud Billing

يمكنك الاطّلاع على مزيد من المعلومات حول إنشاء حساب Cloud Billing على إنشاء حساب جديد للفوترة الذاتية.

إذا لم ينجح أي من هذه الخيارات في حلّ مشكلتك، يُرجى التواصل مع Cloud Billingفريق الدعم.

لماذا لا تقدّم App Prototyping agent عرضًا لحلّ مشكلتي؟

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

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

على سبيل المثال، إذا ظهر لك خطأ في Firebase مثل Property access is undefined on object. for 'list' @ L6، ما يشير إلى مشكلة في قواعد Cloud Firestore، ابدأ رسالتك بعبارة "هل يمكنك مساعدتي في حلّ مشكلة قواعد Cloud Firestore هذه؟".

تلقّيت رسالة الخطأ "تعذّر نشر التطبيق" بعد النشر

عادةً ما تسجّل حالات تعذُّر النشر أخطاء قابلة للتنفيذ في سجلّات Cloud Build. لتصحيح أخطاء النشر وحلّها، اتّبِع الخطوات التالية:

1. في صفحة تفاصيل التطبيق (إذا كانت مصغّرة، انقر على نشر لعرضها)، انقر على عرض التفاصيل. سيؤدي ذلك إلى فتح App Hosting في وحدة تحكّم Firebase.

2. من صفحة Firebase وحدة التحكّم App Hosting، انقر على عرض سجلّات Cloud Build.

   سيؤدي ذلك إلى فتح وحدة تحكّم Firebase حيث يمكنك الاطّلاع على سجلّات الإنشاء وتحديد موقع الخطأ.

3. انسخ الخطأ والصقه في App Prototyping agent أو في محادثة Gemini في Firebase في مساحة عملك واطلب من Gemini إصلاحه.

4. للتحقّق من الإصلاح، انتقِل إلى عرض الرمز، وافتح "الوحدة الطرفية"، وشغِّل npm run build. إذا ظهر لك خطأ آخر، يُرجى إعادة المحاولة. إذا ظهرت لك FirebaseError، يُرجى الاطّلاع على لماذا لا يقترح App Prototyping agent حلّ مشكلتي؟.

5. عند اكتمال عملية الإنشاء بنجاح، انقر على npm run start وافتح رابط localhost المقدَّم واختبِر وظائف تطبيقك. يمكنك التحقّق من الطرفية بحثًا عن أي أخطاء وقت التشغيل.

6. إذا نجحت العملية، اضغط على Ctrl-C في Terminal لإيقاف عملية إنشاء الحزمة المخصّصة للإنتاج التي يتم تنفيذها في مساحة العمل، ثم حاوِل تنفيذ عملية النشر App Hosting مرة أخرى.

لا يمكنني إجراء تغييرات باستخدام App Prototyping agent

إذا لم يكمل App Prototyping agent تغييرات الرمز المطلوبة، أو إذا عاد إلى خطوة "مخطط التطبيق"، أو إذا عرض بشكل متكرّر رسالة خطأ تفيد بحدوث مشكلة، اتّبِع الخطوات التالية:

1. أعِد ضبط الجهاز الافتراضي.

2. إذا استمرت المشكلة عند إعادة فتح مساحة العمل، أدخِل /clear في محادثة App Prototyping agent.

3. إذا استمرت المشكلة، يمكنك محاولة إنشاء فرع من إصدار سابق من تطبيقك باتّباع الخطوات التالية:

   1. انتقِل إلى طريقة عرض Code.

   2. افتح علامة التبويب التحكّم في المصدر.

   3. في "رسم بياني للتحكّم في المصدر" (Source Control Graph)، انقر بزر الماوس الأيمن على إصدار سابق > إنشاء فرع (Create Branch). أدخِل اسمًا للفرع.

   4. الرجوع إلى Prototyper mode. If the agent still doesn't respond or returns an error, try branching from an even earlier version of your app.

   5. للتبديل بين الفروع التي تنشئها (أو للعودة إلى الفرع الرئيسي)، انقر على اسم الفرع في أسفل يمين عرض Code واختَر الفرع الذي تريد استخدامه.