تحديد المشاكل وحلّها في 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 واختَر الفرع الذي تريد استخدامه.

أواجه مشكلة في مطالبة App Prototyping agent بدمج خدمات Firebase.

نعمل على تحسين عملية دمج خدمات Firebase باستخدام App Prototyping agent. في الوقت الحالي، إليك بعض التحديات الشائعة والنصائح.

• لم يتم تعديل ملف الإعداد: في طلبك، أدرِج القيمة المحدّدة التي تريد تعديلها. يمكنك العثور على القيم في صفحة إعدادات المشروع في وحدة تحكّم Firebase. على سبيل المثال، يمكنك إدخال الطلب التالي: "Update the measurementId in my config with G-1234567890."
• لا تعمل المصادقة عند معاينة تطبيقي: قد تحتاج إلى تضمين عنوان URL الخاص بالمعاينة كنطاق معتمَد:
  1. في وضع Prototyper، انقر على open_in_new فتح في نافذة جديدة.
  2. في نافذة المعاينة الجديدة التي تفتح، انسخ عنوان URL. يُرجى العِلم أنّ عنوان URL يجب أن يبدأ بـ 6000. إذا كان يبدأ بـ 9000، عليك تعديله قبل المتابعة إلى الخطوة التالية.
  3. في صفحة إعدادات المصادقة في وحدة تحكّم Firebase، أضِف عنوان URL الذي نسخته في الخطوة السابقة إلى النطاقات المعتمَدة. ملاحظة: لا تفعّل هذه الطريقة سوى المعاينة التلقائية المعروضة في Prototyper mode. The preview within Code view and the preview pop-out might not allow you to authenticate.
• لم يتم إنشاء "قواعد الأمان" في Firebase: يمكن أن يساعدك Gemini في كتابة قواعد الأمان، ولكن لا يمكنه حتى الآن إضافتها تلقائيًا إلى مشروعك على Firebase. عليك نسخ قواعد Firebase إلى وحدة تحكّم Firebase لنشرها.
• تفاعل غير متوقّع مع خادم "التحكّم في الخصوصية" من Firebase: في حال إعداد خادم "التحكّم في الخصوصية" من Firebase، قد تواجه سلوكًا غير متوقّع عند استخدام Prototyper for Firebase integrations. If this occurs, switch to Code view and prompt Gemini in Firebase to integrate Firebase services.