تصحيح أخطاء تطبيقك في 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: Web Dev Tools وفعِّله. إذا كنت تعدِّل ملف settings.json مباشرةً، يمكنك إضافة "IDX.webDevTools": true.
   3. أعِد تحميل نافذة المتصفّح لإعادة تحميل Firebase Studio مساحة العمل.

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

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

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

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

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

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

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

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 في حلقة أو لم يتمكّن من الإجابة عن سؤالك، حاوِل إعادة صياغة المطالبة أو تقديم سياق إضافي. في بعض الأحيان، يمكن أن تساعد إعادة صياغة سؤالك Gemini في فهم ما تسأله.

  إذا لم تؤدِّ إعادة صياغة المطالبة إلى حلّ الحلقة، جرِّب التقنيات التالية:

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

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