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

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

Firebase Studio عام

كيف يمكنني تنزيل ملفاتي من Firebase Studio؟

لتنزيل ملفاتك كملف ZIP، اتّبِع الخطوات التالية:

• انقر بزر الماوس الأيمن على أي دليل في لوحة "المستكشف" (Explorer) واختَر ضغط وتنزيل (Zip and Download).

لتنزيل كل المحتوى في دليل مشروعك، اتّبِع الخطوات التالية:

1. انقر على ملف > فتح مجلد.

2. قبول دليل /home/user التلقائي

3. بعد تحميل الملفات، انقر بزر الماوس الأيمن على دليل العمل واختَر ضغط الملفات وتنزيلها. في حال استخدام App Prototyping agent، سيكون دليل العمل هو studio. إذا كنت تستخدم نموذجًا أو مشروعًا تم تحميله، سيكون هذا هو اسم مشروعك.

4. عندما يُطلب منك إعادة إنشاء البيئة، انقر على إلغاء.

5. بعد اكتمال عملية التنزيل، أعِد فتح دليل العمل من قائمة ملف (File) للعودة إلى مساحة عملك.

ملاحظة: يمكنك أيضًا التصدير إلى GitHub.

ملفات تعريف الارتباط التابعة لجهات خارجية غير مفعّلة.

قبل البدء، قد تحتاج إلى تفعيل ملفات تعريف الارتباط التابعة لجهات خارجية في متصفحك، لأنّ Firebase Studio يتطلبها في معظم المتصفحات للمصادقة على مساحات العمل.

Chrome

على الكمبيوتر المكتبي:

1. افتح الإعدادات.
2. افتح علامة التبويب الخصوصية والأمان.
3. تأكَّد من تفعيل خيار السماح بجميع ملفات تعريف الارتباط.
4. افتح Firebase Studio.
5. انقر على رمز إذن الوصول في شريط العناوين لفتح لوحة الحماية من التتبّع. فعِّل الإعداد ملفات تعريف الارتباط التابعة لجهات خارجية للسماح مؤقتًا بملفات تعريف الارتباط التابعة لجهات خارجية. يتيح ذلك ملفات تعريف الارتباط على Firebase Studio لمدة 90 يومًا.

على هواتف Android وأجهزة Android اللوحية:

1. انقر على () المزيد > الإعدادات.
2. افتح إعدادات الموقع الإلكتروني > ملفات تعريف الارتباط التابعة لجهات خارجية.
3. تأكَّد من تفعيل خيار السماح بجميع ملفات تعريف الارتباط.
4. افتح Firebase Studio.
5. انقر على رمز إذن الوصول في شريط العناوين لفتح لوحة الحماية من التتبّع. فعِّل الإعداد ملفات تعريف الارتباط التابعة لجهات خارجية للسماح مؤقتًا بملفات تعريف الارتباط التابعة لجهات خارجية. يتيح ذلك ملفات تعريف الارتباط على Firebase Studio لمدة 90 يومًا.

على أجهزة iPhone وiPad:

1. افتح تطبيق الإعدادات > التطبيقات > Chrome.
2. فعِّل السماح للمواقع الإلكترونية الخارجية بتتبّع النشاط على المتصفّح.
3. افتح Firebase Studio.

Safari

على الكمبيوتر المكتبي:

1. افتح Safari > الإعدادات....
2. أوقِف الإعدادات التالية:
   • الإعدادات المتقدّمة > حظر كل ملفات تعريف الارتباط
   • الخصوصية > منع تتبُّع إجراءات المستخدم على مواقع إلكترونية متعددة
3. افتح Firebase Studio.

على أجهزة iPhone وiPad:

1. افتح تطبيق الإعدادات > التطبيقات > Safari.
2. أوقِف الإعدادات التالية:
   • منع تتبُّع إجراءات المستخدم على مواقع إلكترونية متعددة
   • الإعدادات المتقدّمة > حظر جميع ملفات تعريف الارتباط
3. افتح Firebase Studio.

Firefox

لست بحاجة إلى تفعيل ملفات تعريف الارتباط التابعة لجهات خارجية في Firefox. افتح Firebase Studio.

برنامج المتصفح Opera

1. افتح متصفّح Opera.
2. افتح القائمة وانقر على الإعدادات.
3. انتقِل إلى قسم الخصوصية والأمان (Privacy & Security) ووسِّع خيار ملفات تعريف الارتباط الخارجية (Third-party cookies).
4. اختَر حظر ملفات تعريف الارتباط الخارجية في وضع التصفّح المتخفي أو السماح بملفات تعريف الارتباط الخارجية.
5. افتح Firebase Studio.

قوس

1. انتقِل إلى arc://settings.
2. انتقِل إلى قسم الخصوصية والأمان، ثم وسِّع خيار ملفات تعريف الارتباط الخارجية.
3. اختَر حظر ملفات تعريف الارتباط الخارجية في وضع التصفّح المتخفي أو السماح بملفات تعريف الارتباط الخارجية.
4. افتح Firebase Studio.

شجاع

لست بحاجة إلى تفعيل ملفات تعريف الارتباط التابعة لجهات خارجية في Brave. افتح Firebase Studio.

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

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

كيف يمكنني التحديث إلى أحدث إصدار من React أو Next.js؟

تؤثّر ثغرة أمنية خطيرة في تنفيذ الرموز البرمجية عن بُعد (RCE) في التطبيقات التي تم إنشاؤها باستخدام Next.js وReact Server Components. لحماية تطبيقك وبياناتك، عليك تثبيت أحدث إصدار ثابت.

1. افتح مشروعك في Firebase Studio، وانتقِل إلى العرض Code.
2. افتح الوحدة الطرفية (Shift+Ctrl+C)، ونفِّذ الأمر npx fix-react2shell-next.
3. اتّبِع التعليمات التي تظهر في الوحدة الطرفية للمتابعة وتطبيق أي إصلاحات.
4. عند اكتمال العملية، انشر تطبيقك المُعدَّل.

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

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

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

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

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

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

1. من Firebase Studio، انقر على قائمة المزيد ()، ثم اختَر إعادة التشغيل.

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

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

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

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

[Errno 28] No space left on device

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

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

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

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

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

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

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

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

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

بعض الميزات في Firebase Studio تجريبية، ونزيل بشكل دوري الميزات التي لا ترقى إلى مستوى توقعاتك أو توقعاتنا.

Firebase Studio مساحات عمل Code

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

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

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

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

شاركتُ عنوان 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) من الواجهة الأمامية.

   ملاحظة: إذا كانت الواجهة الأمامية عبارة عن متصفّح ويب، قد تحتاج إلى تفعيل مشاركة الموارد المتعدّدة المصادر (CORS) في الخادم الخلفي أو خادم واجهة برمجة التطبيقات (على سبيل المثال، باستخدام حزمة cors NPM لتطبيقات Node.js أو flask-cors لتطبيقات Python Flask).

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

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

Gemini

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

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

كيف يمكنني تغيير مفتاح Gemini API؟

لتغيير مفتاح Gemini API المستخدَم في مشروع Firebase Studio، أنشئ مفتاحًا جديدًا في Google AI Studio وعدِّله في مساحة عمل Firebase Studio.

1. إنشاء مفتاح واجهة برمجة تطبيقات جديد

   1. انتقِل إلى صفحة مفاتيح واجهة برمجة التطبيقات.Google AI Studio
   2. انقر على إنشاء مفتاح واجهة برمجة تطبيقات.
   3. حدِّد اسمًا لمفتاح واجهة برمجة التطبيقات واختَر مشروع Google Cloud الصحيح. قد تحتاج إلى استيراد مشروعك إذا لم يكن مدرَجًا.
   4. انقر على إنشاء مفتاح.
   5. انسخ مفتاح واجهة برمجة التطبيقات الذي تم إنشاؤه حديثًا.

2. تعديل مفتاح واجهة برمجة التطبيقات في مشروع Firebase Studio

   1. افتح مساحة عمل Firebase Studio.
   2. انتقِل إلى طريقة العرض Code.
   3. افتح ملف .env (الموجود في /home/user/studio/.env).
   4. استبدِل قيمة GEMINI_API_KEY القديمة بالمفتاح الجديد الذي نسخته.

3. إعادة النشر أو إعادة التشغيل (إذا لزم الأمر)

   قد تحتاج إلى إعادة نشر تطبيقك أو إعادة تشغيل خادم التطوير لتطبيق التغييرات.

4. إبطال مفتاح واجهة برمجة التطبيقات القديم

   • بالنسبة إلى المفاتيح التي يتم إنشاؤها تلقائيًا بواسطة Firebase Studio:
     1. انتقِل إلى Google AI Studio.
     2. استورِد مشروع Firebase من مساحة عمل Firebase Studio إلى Google AI Studio.
     3. ابحث عن مفتاح واجهة برمجة التطبيقات الذي تم إنشاؤه تلقائيًا من هذا المشروع واحذفه.
   • بالنسبة إلى المفاتيح التي تم إنشاؤها في Google AI Studio أو وحدة تحكّم Google Cloud:
     1. انتقِل إلى صفحة Google AI Studio مفاتيح واجهة برمجة التطبيقات أو إلى Google Cloud صفحة بيانات الاعتماد في وحدة التحكّم.
     2. ابحث عن مفتاح واجهة برمجة التطبيقات القديم الذي استبدلته واحذفه.

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

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

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

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

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

    .next/
   

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

App Prototyping agent

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

عند توفير موارد مثل مفتاح 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 لإضافة Cloud Firestore وFirebase Authentication تلقائيًا إلى تطبيقي؟

اطلب من App Prototyping agent إضافة قاعدة بيانات أو مصادقة أثناء العمل على تطبيق حالي. عندما تطلب إضافة قاعدة بيانات أو مصادقة، يطلب منك App Prototyping agent تأكيد ذلك. وفي حال الموافقة، يُعدّ App Prototyping agent مشروع Firebase يتضمّن خدمات الخلفية المطلوبة.

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

يرصد 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 في مساحة عملك واطلب من Gemini إصلاحه.

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

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

6. في حال نجاح كل الخطوات، اكتب Ctrl-C في "الوحدة الطرفية" لإيقاف عملية إنشاء الحزمة المخصّصة للإنتاج التي يتم تنفيذها في مساحة العمل، ثم حاوِل تنفيذ عملية النشر 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 إذا لم يستجب الوكيل أو عرض خطأ، جرِّب إنشاء فرع من إصدار أقدم من تطبيقك.

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

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

في ما يلي بعض التحديات الشائعة والنصائح لدمج خدمات Firebase:

• لم يتم تعديل ملف الإعداد: في طلبك، أدرِج القيمة المحدّدة التي تريد تعديلها. يمكنك العثور على القيم في صفحة إعدادات المشروع في وحدة تحكّم Firebase. على سبيل المثال، يمكنك تقديم الطلب التالي: "عدِّل measurementId في إعداداتي باستخدام G-1234567890".
• لا تعمل المصادقة عند معاينة تطبيقي: قد تحتاج إلى تضمين عنوان URL الخاص بالمعاينة كنطاق معتمَد:
  1. في "وضع Prototyper"، انقر على فتح في نافذة جديدة.
  2. في نافذة المعاينة الجديدة التي تفتح، انسخ عنوان URL. يُرجى العِلم أنّ عنوان URL يجب أن يبدأ بـ 6000. إذا كان يبدأ بـ 9000، عليك تعديله قبل المتابعة إلى الخطوة التالية.
  3. في صفحة إعدادات المصادقة في وحدة تحكّم Firebase، أضِف عنوان URL الذي نسخته في الخطوة السابقة إلى النطاقات المعتمَدة. ملاحظة: لا تتيح هذه الطريقة سوى المعاينة التلقائية المعروضة في وضع Prototyper. قد لا تسمح لك المعاينة داخل Code العرض والمعاينة المنبثقة بالمصادقة.
• لم يتم إنشاء "قواعد الأمان" في Firebase: يمكن أن يساعدك Gemini في كتابة قواعد الأمان، ولكن لا يمكنه حتى الآن إضافتها تلقائيًا إلى مشروعك على Firebase. عليك نسخ قواعد Firebase إلى وحدة تحكّم Firebase لنشرها.
• تفاعل غير متوقّع مع خادم MCP لمنصة Firebase: في حال إعداد خادم MCP لمنصة Firebase، قد تواجه سلوكًا غير متوقّع عند استخدام Prototyper لعمليات الدمج مع Firebase. في حال حدوث ذلك، انتقِل إلى طريقة العرض Code واطلب من Gemini دمج خدمات Firebase.

كيف يمكنني تغيير رمز الموقع المفضّل لتطبيقي؟

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

يمكنك تغيير الرمز من داخل Firebase Studio:

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

2. إذا لم يكن نشطًا، انقر على المستكشف (Ctrl+Shift+E أو Cmd+Shift+E على جهاز Mac) لعرض جميع ملفاتك.

3. وسِّع src، وانقر بزر الماوس الأيمن على الدليل app، ثم اختَر تحميل...

4. عندما يُطلب منك ذلك، انتقِل إلى ملف favicon.ico واختَره من نظام الملفات المحلي.

5. عندما يُطلب منك استبدال ملف رمز الموقع الحالي، انقر على استبدال.

6. أعِد نشر تطبيقك أو امحُ ذاكرة التخزين المؤقت للمتصفّح لعرض التغيير.