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

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

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

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

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

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

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

شريط وحدة التحكّم المصغّر في معاينة الويب
لتطبيق 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 في Firebase
Studio في لوحة Lighthouse، اختَر فئات التدقيق التي تريدها. يمكنك الاختيار من بين تقارير تتحقّق من الأداء وتسهيل الاستخدام الامتثال لأفضل الممارسات وتحسين محركات البحث وأداء تطبيقات الويب التقدّمية. انقر على تحليل الصفحة لإنشاء التقارير.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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