تصحيح أخطاء تطبيقك في Firebase Studio

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

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

معاينة تطبيقك

يتضمّن Firebase Studio معاينات للتطبيقات في مساحة العمل لتطبيقات الويب (Chrome) وتطبيقات Flutter (على Android وChrome). تتيح النسخ الحصرية من Android وChrome إعادة التحميل السريع وإعادة التحميل السريع، وتوفّر إمكانات المحاكاة الكاملة.

لمزيد من المعلومات حول معاينات Firebase Studio، يُرجى الاطّلاع على مقالة معاينة تطبيقك.

استخدام وحدة تحكّم الويب المدمجة لمعاينات الويب

تساعدك وحدة التحكّم المدمجة على الويب في تشخيص المشاكل في تطبيقك مباشرةً من المعاينة على الويب. يمكنك الوصول إلى وحدة تحكّم الويب في لوحة معاينة الويب في Firebase Studio من خلال توسيع الشريط في أسفل الصفحة.

يُرجى العِلم أنّ هذه الميزة تجريبية وغير مفعَّلة تلقائيًا. لتفعيلها، يُرجى اتّباع الخطوات التالية ومشاركة ملاحظاتك بعد تجربتها:

1. أضِف وحدة تحكّم الويب إلى مساحة عمل Firebase Studio:

   1. افتح الإعدادات بالنقر على أو الضغط على Ctrl + , (على نظام التشغيل Windows أو Linux أو ChromeOS) أو Cmd + , (على نظام التشغيل MacOS).
   2. ابحث عن الإعداد Firebase Studio: أدوات مطوّري الويب وفعِّله. إذا كنت تعدّل ملف settings.json مباشرةً، يمكنك إضافة "IDX.webDevTools": true.
   3. أعِد تحميل نافذة المتصفّح لإعادة تحميل مساحة عمل Firebase Studio.

2. افتح معاينة الويب في Firebase Studio: افتح لوحة الأوامر (Cmd+Shift+P على أجهزة Mac أو Ctrl+Shift+P على أجهزة ChromeOS أو Windows أو Linux) واختَر Firebase Studio: عرض معاينة الويب.

3. يتم تصغير لوحة وحدة تحكّم الويب ضمن لوحة معاينة الويب تلقائيًا. انقر على الشريط أو اسحبه للأعلى لتوسيعه.

تعمل لوحة وحدة التحكّم على الويب في معاينة الويب في Firebase Studio بشكل مشابه لوحدات التحكّم الأخرى، مثل تلك المتوفّرة في أدوات مطوري البرامج في Chrome:

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

تشغيل Lighthouse لمعاينات الويب

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

1. افتح معاينة الويب في Firebase Studio: افتح لوحة الأوامر (Cmd+Shift+P على أجهزة Mac أو Ctrl+Shift+P على أجهزة ChromeOS أو Windows أو Linux) واختَر Firebase Studio: عرض معاينة الويب.

2. انقر على رمز تشغيل Lighthouse من شريط أدوات معاينة الويب.

3. في لوحة Lighthouse، اختَر فئات التدقيق التي تريدها. يمكنك الاختيار من بين تقارير تدقيق الأداء وتسهيل الاستخدام والتوافق مع أفضل الممارسات وتحسين محركات البحث وأداء تطبيقات الويب التقدّمية. انقر على تحليل الصفحة لإنشاء التقارير.

   قد يستغرق إنشاء التقارير بضع دقائق.

4. بعد ظهور التقارير في لوحة Lighthouse، يمكنك مراجعة النتائج لكل فئة تدقيق، أو التبديل بين فئات التدقيق من خلال النقر على النتيجة واسم الفئة.

استخدام وحدة تحكّم تصحيح الأخطاء

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

لتخصيص تجربة تصحيح الأخطاء، يمكنك أيضًا إضافة ملف .vscode/launch.json إلى مساحة العمل وتحديد إعدادات تشغيل مخصّصة. يمكنك الاطّلاع على مزيد من المعلومات حول استخدام ملفات إعدادات التشغيل لتخصيص تصحيح الأخطاء في إعدادات تصحيح الأخطاء في Visual Studio Code.

تصحيح الأخطاء باستخدام "Gemini"

يمكنك استخدام Gemini لمساعدتك في تصحيح أخطاء الرمز البرمجي من خلال المحادثة في مساحة عمل Code أو App Prototyping agent.

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

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

• طرح أسئلة محدّدة: لا تتردّد في طرح Gemini أسئلة مباشرة حول الرمز البرمجي. على سبيل المثال، "ما الذي قد يسبّب استثناء المؤشر الفارغ في هذه الدالة؟" أو "كيف يمكنني منع حالة السباق هذه؟"

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

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

• التكرار والتحسين: قد لا يقدّم Gemini دائمًا الحلّ المثالي من المحاولة الأولى. راجع الردود، واطرح أسئلة توضيحية، وقدم معلومات إضافية حسب الحاجة.

• تجنُّب تكرار الطلبات: إذا علق Gemini في حلقة تكرار أو لم يتمكّن من الإجابة عن سؤالك، حاوِل إعادة صياغة طلبك أو تقديم سياق إضافي. في بعض الأحيان، يمكن أن تساعد إعادة صياغة سؤالك في فهم Gemini لما تطلبه.

  إذا لم تنجح إعادة صياغة الطلب في حلّ مشكلة التكرار، جرِّب الأساليب التالية:

  • بدء محادثة جديدة: إذا كنت تستخدم محادثة Gemini في مساحة عمل Code ، ابدأ جلسة محادثة جديدة لإعادة ضبط سياق Gemini. يمكن أن يساعد ذلك في التحرّر من أي مفاهيم خاطئة أو افتراضات قد يكون "Gemini" قد وضعها في المحادثة السابقة.

  • تقديم أمثلة مضادة: إذا كان "Gemini" يضع افتراضات غير صحيحة، يمكنك تقديم أمثلة مضادة لمساعدته في فهم السلوك الصحيح.