تصحيح الأخطاء باستخدام "أدوات مطوّري البرامج في Chrome"

يمكنك استخدام "أدوات المطوّرين" المضمّنة في متصفّح Chrome الذي يعمل على جهاز التطوير لفحص وتصحيح أخطاء مكوّنات WebView التي تعمل في تطبيقك عن بُعد. للحصول على دليل تفصيلي حول تصحيح أخطاء مكوّنات WebView عن بُعد، يمكنك الاطّلاع على تصحيح أخطاء مكوّنات WebView عن بُعد.

لمزيد من المعلومات عن "أدوات مطوّري البرامج"، اطّلِع على نظرة عامة على "أدوات مطوّري البرامج في Chrome".

تفعيل الاتصال من "أدوات مطوّري البرامج في Chrome"

لن يفعّل WebView في تطبيقك تلقائيًا عمليات الربط من "أدوات مطوّري البرامج في Chrome". يجب تفعيل تصحيح أخطاء WebView في الرمز البرمجي لتطبيقك.

  1. تأكَّد من أنّك أعددت تشغيل تطبيقك على جهاز أو جهاز افتراضي.
  2. فعِّل تصحيح أخطاء WebView في الرمز البرمجي لتطبيقك من خلال استدعاء setWebContentsDebuggingEnabled. يتم ذلك عادةً في الفئة Activity أو Application التي يتم فيها تهيئة WebView.

ننصحك بتضمين setWebContentsDebuggingEnabled في عملية تحقّق شرطية حتى لا يتم تفعيل تصحيح الأخطاء إلا في إصدارات التطوير، وليس في الإصدارات العلنية. ينطبق هذا الإعداد على جميع عناصر WebView في تطبيقك.

لا تتأثر عملية تصحيح أخطاء WebView بحالة العلامة debuggable في ملف بيان التطبيق. إذا أردت تفعيل تصحيح أخطاء WebView فقط عندما تكون قيمة العلامة debuggable هي true، اختبِر هذه العلامة في وقت التشغيل كما هو موضّح في المثال التالي:

Kotlin

if (applicationInfo.flags and ApplicationInfo.FLAG_DEBUGGABLE != 0) {
     WebView.setWebContentsDebuggingEnabled(true)
}

Java

if (0 != (getApplicationInfo().flags & ApplicationInfo.FLAG_DEBUGGABLE)) {
     WebView.setWebContentsDebuggingEnabled(true);
}

بدء تصحيح أخطاء WebView

بعد تفعيل تصحيح أخطاء WebView في رمز تطبيقك وتشغيل تطبيقك على جهاز فعلي أو محاكي Android، اربط Chrome DevTools بـ WebView باتّباع الخطوات التالية:

  1. افتح Chrome على جهاز التطوير.
  2. الانتقال إلى chrome://inspect.

  3. في صفحة chrome://inspect، تأكَّد من وضع علامة في المربّع بجانب اكتشاف أجهزة USB. ابحث عن جهازك في قسم الجهاز المستهدف البعيد.

    فحص صفحة "أدوات مطوّري البرامج في Chrome" التي تعرض الأهداف البعيدة المتاحة لتصحيح الأخطاء
    الشكل 1. تعرض صفحة "فحص العناصر" في "أدوات مطوّري البرامج في Chrome" الأهداف البعيدة المتاحة لتصحيح الأخطاء.

  4. ضمن اسم جهازك، يسرد Chrome جميع عناصر WebView التي تم تفعيل تصحيح الأخطاء فيها والتي تعمل على هذا الجهاز، ويتم عادةً تحديدها من خلال WebView في متبوعًا باسم حزمة التطبيق. ابحث عن WebView الذي تريد تصحيح أخطائه، وانقر على رابط الفحص.

سيتم فتح نسخة جديدة من "أدوات مطوّري البرامج" يمكنك استخدامها لفحص WebView.

إذا كنت تعرض المحتوى من خادم ويب محلي على جهاز التطوير، يمكنك الاطّلاع على الوصول إلى خادم تطوير محلي من WebView للتعرّف على كيفية الاتصال به من جهازك أو المحاكي. لتحديد المشاكل وحلّها، يُرجى الاطّلاع على تصحيح الأخطاء عن بُعد على أجهزة Android وتصحيح الأخطاء عن بُعد في WebViews.