تصحيح أخطاء أجهزة Android عن بُعد

تصحيح أخطاء المحتوى المباشر عن بُعد على جهاز Android من جهاز كمبيوتر يعمل بنظام التشغيل Windows أو Mac أو Linux. هذا النمط يعلمك البرنامج التعليمي كيفية:

  • يمكنك إعداد جهاز Android لتصحيح الأخطاء عن بُعد واكتشافه من خلال جهاز التطوير.
  • يمكنك فحص المحتوى المباشر وتصحيح الأخطاء على جهاز Android من جهاز التطوير.
  • تسجيل محتوى Screencast من جهاز Android في مثيل "أدوات مطوري البرامج" في جهاز التطوير

رسم تخطيطي لتصحيح الأخطاء عن بُعد

الخطوة 1: اكتشاف جهاز Android

يناسب سير العمل أدناه معظم المستخدمين. راجع تحديد المشاكل وحلّها: لم ترصد "أدوات مطوري البرامج" لنظام التشغيل Android الجهاز للحصول على مزيد من المساعدة.

  1. افتح شاشة خيارات المطوّرين على جهاز Android. يُرجى الاطّلاع على إعداد المطوِّر على الجهاز فقط. الخيارات.
  2. اختَر تفعيل تصحيح أخطاء USB.
  3. على جهاز التطوير، افتح Chrome.
  4. الانتقال إلى chrome://inspect#devices
  5. تأكَّد من تفعيل مربّع اختيار اكتشاف أجهزة USB.

    تم تفعيل مربّع الاختيار "اكتشاف أجهزة USB".

  6. وصِّل جهاز Android بجهاز التطوير مباشرةً باستخدام كابل USB.

  7. إذا كنت توصل جهازك لأول مرة، فسيظهر الجهاز في وضع "غير متصل" وفي انتظار المصادقة.

    الجهاز بلا إنترنت في انتظار المصادقة.

    في هذه الحالة، اقبل مطالبة جلسة تصحيح الأخطاء على شاشة جهازك.

  8. إذا رأيت اسم طراز جهاز Android، يعني هذا أنّ "أدوات مطوري البرامج" تكون قد أنشأت الاتصال بجهازك بنجاح.

    يشير ذلك إلى جهاز متصل بنجاح ويكون له اسم طراز.

  9. ويمكنك المتابعة إلى الخطوة 2.

تحديد المشاكل وحلّها: عدم رصد "أدوات مطوري البرامج" لجهاز Android

تأكد من إعداد جهازك بشكل صحيح:

  • إذا كنت تستخدم موزّع USB، جرِّب توصيل جهاز Android بجهاز التطوير مباشرةً. بدلاً من ذلك.
  • يُرجى محاولة فصل كابل USB بين جهاز Android وجهاز التطوير، ثم وتوصيله مرة أخرى. ويمكنك إجراء ذلك عندما تكون شاشات أجهزة Android وأجهزة التطوير مفتوحة.
  • تأكَّد من أنّ كابل USB يعمل. من المفترض أن تتمكّن من فحص الملفات على جهاز Android. من جهاز التطوير.

تأكَّد من إعداد برنامجك بشكلٍ صحيح:

إذا لم يظهر لك الطلب السماح بتصحيح أخطاء الجهاز عبر USB على جهاز Android، جرِّب ما يلي:

  • فصل كابل USB ثم إعادة توصيله أثناء تركيز أدوات مطوّري البرامج على تطوير التطبيق جهازك والشاشة الرئيسية لجهاز Android. بمعنى آخر، لا تظهر المطالبة في بعض الأحيان عندما تكون شاشات أجهزة Android أو أجهزة التطوير مقفلة.
  • تحديث إعدادات العرض في جهاز Android وجهاز التطوير حتى لا يحدث تغيير النوم.
  • جارٍ ضبط وضع USB في جهاز Android على PTP. راجِع القسم لا يعرض Galaxy S4 مربّع الحوار "السماح بتصحيح أخطاء الجهاز عبر USB". .
  • اختَر إبطال تفويضات تصحيح أخطاء USB من شاشة خيارات المطوّرين على جهاز Android لإعادة ضبطه على الحالة الجديدة.

إذا عثرت على حلّ غير مذكور في هذا القسم أو في أجهزة Chrome DevTools لا رصد الجهاز عند توصيله بمصدر طاقة، يُرجى إضافة إجابة عن سؤال Stack Overflow أو فتح مشكلة في مستودع developer.chrome.com.

الخطوة 2: تصحيح أخطاء المحتوى في جهاز Android من جهاز التطوير

  1. افتح Chrome على جهاز Android.
  2. في chrome://inspect/#devices على جهاز التطوير، سيظهر لك اسم طراز جهاز Android متبوعًا رقمه التسلسلي. أسفل ذلك، يمكنك مشاهدة إصدار Chrome الذي يعمل على الجهاز، مع وجود رقم الإصدار بين قوسين.

    إصدار Chrome الذي يعمل على الجهاز.

  3. في مربّع النص فتح علامة التبويب باستخدام عنوان URL، أدخِل عنوان URL، ثم انقر على فتح. تفتح الصفحة في علامة تبويب جديدة على جهاز Android.

    علامة تبويب عن بُعد مدرجة في قسم.

    تحصل كل علامة تبويب بعيدة في Chrome على قسم خاص بها في chrome://inspect/#devices. يمكنك التفاعل باستخدام علامة التبويب تلك من هذا القسم. إذا كانت هناك أي تطبيقات تستخدم WebView، سيظهر لك قسم لكل تطبيق من هذه التطبيقات أيضًا. في هذا المثال، هناك علامة تبويب واحدة فقط مفتوحة.

  4. انقر على فحص بجانب عنوان URL الذي فتحته للتو. يتم فتح نسخة جديدة من "أدوات مطوري البرامج".

مثيل جديد لـ "أدوات مطوري البرامج" لعلامة التبويب "وحدة تحكّم عن بُعد"

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

مزيد من الإجراءات: إيقاف علامة تبويب مؤقتًا أو التركيز عليها أو إعادة تحميلها أو إغلاقها

يمكنك العثور أسفل عنوان URL على قائمة لإيقاف علامة تبويب مؤقتًا أو التركيز عليها أو إعادة تحميلها أو إغلاقها.

قائمة إيقاف علامة تبويب مؤقتًا أو إعادة تحميلها أو التركيز عليها أو إغلاقها

فحص العناصر

انتقِل إلى لوحة Elements في النسخة الافتراضية من "أدوات مطوري البرامج"، ومرِّر مؤشر الماوس فوق أحد العناصر لتمييزه. إطار العرض لجهاز Android.

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

تسجيل فيديو رقمي للشاشة على شاشة Android لجهاز التطوير

انقر على إيقاف التسجيل الرقمي للشاشة أو تفعيلها. إيقاف/تفعيل التسجيل الرقمي للشاشة للعرض محتوى جهاز Android في مثيل "أدوات مطوري البرامج".

يمكنك التفاعل مع التسجيل الرقمي للشاشة بعدة طرق:

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

بعض الملاحظات حول التسجيلات الرقمية للشاشة:

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

تصحيح الأخطاء يدويًا من خلال Android Debug Bridge (adb)

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

لإجراء ذلك، يمكنك استخدام Android Debug Bridge (adb):

  1. احرص على تفعيل خيارات المطوّرين وتصحيح أخطاء الجهاز عبر USB على جهاز Android.
  2. افتح Chrome على جهاز Android.
  3. يمكنك توصيل جهاز Android بجهاز التطوير من خلال:

  4. في سطر الأوامر بجهاز التطوير، شغِّل adb devices -l وتحقَّق مما إذا كان جهازك مُدرجًا في القائمة.

  5. أعِد توجيه مقبس CDP الموجود على الجهاز إلى المنفذ المحلي لجهازك، مثل 9222. للقيام بذلك، قم بتشغيل:

    adb forward tcp:9222 localabstract:chrome_devtools_remote
    
  6. بعد اكتمال عملية الربط بنجاح، يمكنك الاطّلاع على ما يلي:

    • يسرد http://localhost:9222/json أهداف page.
    • تعرض الدالة http://localhost:9222/json/version نقطة النهاية browser المستهدَفة، كما تشير مستندات CDP.
    • تتم تعبئة chrome://inspect/#devices، حتى إذا لم يتم وضع علامة في المربّع بجانب اكتشاف أجهزة USB.

لتحديد المشاكل وحلّها، يُرجى الاطّلاع على: