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

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

على نظام التشغيل Android 4.4 (KitKat) أو إصدار أحدث، يمكنك استخدام "أدوات مطوري البرامج" لتصحيح أخطاء محتوى WebView في تطبيقات Android الأصلية.

ملخّص

  • فعِّل خيار "تصحيح أخطاء WebView" في تطبيق Android الأصلي وتصحيح أخطاء WebView في "أدوات مطوري البرامج في Chrome".
  • يمكنك الوصول إلى قائمة بمكوّنات WebView التي تم تفعيل تصحيح الأخطاء لها من خلال chrome://inspect.
  • يشبه تصحيح أخطاء WebViews تصحيح أخطاء صفحة الويب من خلال تصحيح الأخطاء عن بُعد.

إعداد WebView لتصحيح الأخطاء

يجب تفعيل تصحيح أخطاء WebView من داخل تطبيقك. لتفعيل تصحيح أخطاء WebView، عليك استدعاء الطريقة الثابتة setWebContentsDebuggingEnabled في فئة WebView.

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
    WebView.setWebContentsDebuggingEnabled(true);
}

وينطبق هذا الإعداد على كل مكوّنات WebView في التطبيق.

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

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
    if (0 != (getApplicationInfo().flags & ApplicationInfo.FLAG_DEBUGGABLE))
    { WebView.setWebContentsDebuggingEnabled(true); }
}

فتح WebView في "أدوات مطوري البرامج"

تعرض صفحة chrome://inspect قائمة بمكوّنات WebView التي تم تفعيل تصحيح الأخطاء فيها على جهازك.

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

فحص العناصر في WebView

تمثل الرسومات الرمادية المُدرَجة مع WebView حجم وموضعه مقارنةً بشاشة الجهاز. في حال تم ضبط عناوين في مكوّنات WebView، سيتم إدراج العناوين أيضًا.

تحديد المشاكل وحلّها

ألا يمكنك رؤية مكوّنات WebView على صفحة chrome://inspect؟

  • تأكَّد من تفعيل خيار "تصحيح الأخطاء في WebView" لتطبيقك.
  • على جهازك، افتح التطبيق الذي يتضمّن WebView تريد تصحيح أخطائه. بعد ذلك، يمكنك إعادة تحميل صفحة chrome://inspect.