يمكنك تصحيح أخطاء المحتوى المباشر عن بُعد على جهاز Android من جهاز كمبيوتر يعمل بنظام التشغيل Windows أو Mac أو Linux. يعلمك هذا البرنامج التعليمي كيفية:
- يمكنك إعداد جهاز Android لتصحيح الأخطاء عن بُعد واكتشافه من جهاز التطوير.
- يمكنك فحص المحتوى المباشر على جهاز Android وتصحيح الأخطاء فيه من جهاز التطوير.
- محتوى التسجيل الرقمي للشاشة من جهاز Android على مثيل "أدوات مطوّري البرامج" في جهاز التطوير
الخطوة 1: اكتشاف جهاز Android
يناسب سير العمل أدناه معظم المستخدمين. للحصول على مزيد من المساعدة، يُرجى الاطّلاع على القسم تحديد المشاكل وحلّها: عدم رصد "أدوات مطوري البرامج" لجهاز Android.
- افتح شاشة خيارات المطوّرين على Android. راجِع ضبط خيارات المطوّرين على الجهاز.
- اختَر تفعيل تصحيح أخطاء USB.
- على جهاز التطوير، افتح Chrome.
- الانتقال إلى
chrome://inspect#devices. تأكَّد من تفعيل ميزة
اكتشاف أجهزة USB.
وصِّل جهاز Android مباشرةً بجهاز التطوير باستخدام كابل USB.
في حال توصيل جهازك لأول مرة، سيظهر الجهاز كـ "بلا اتصال بالإنترنت" وفي انتظار المصادقة.
في هذه الحالة، اقبل مطالبة جلسة تصحيح الأخطاء على شاشة جهازك.
إذا رأيت اسم طراز جهاز Android، يعني ذلك أنّ "أدوات مطوّري البرامج" قد أنشأ الاتصال بجهازك بنجاح.
يمكنك المتابعة إلى الخطوة 2.
تحديد المشاكل وحلّها: عدم رصد "أدوات مطوري البرامج" لجهاز Android
تأكَّد من إعداد جهازك بشكل صحيح:
- إذا كنت تستخدم موزع USB، فحاول توصيل جهاز Android مباشرةً بجهاز التطوير بدلاً من ذلك.
- جرِّب فصل كابل USB بين جهاز Android وجهاز التطوير، ثم إعادة توصيله. يمكنك تنفيذ ذلك أثناء فتح قفل شاشات Android وأجهزة التطوير.
- تأكَّد من أنّ كابل USB يعمل. من المفترض أن تتمكن من فحص الملفات على جهاز Android من جهاز التطوير الذي تستخدمه.
تأكَّد من إعداد البرنامج بشكلٍ صحيح:
- إذا كان جهاز التطوير يعمل بنظام التشغيل Windows، فجرب تثبيت برامج تشغيل USB يدويًا لجهاز Android. راجِع تثبيت برامج تشغيل USB للمصنّعين الأصليين للأجهزة.
- تتطلب بعض مجموعات أجهزة Windows وAndroid (خاصةً Samsung) إعدادًا إضافيًا. يُرجى الاطّلاع على لا ترصد أجهزة Chrome DevTools الجهاز عند توصيله بمصدر الطاقة.
إذا لم تظهر لك رسالة المطالبة السماح بتصحيح أخطاء USB على جهاز Android، جرِّب ما يلي:
- يتم فصل كابل USB ثم إعادة توصيله أثناء التركيز على جهاز التطوير وظهور الشاشة الرئيسية لجهاز Android. بمعنى آخر، أحيانًا لا تظهر المطالبة عندما تكون شاشات Android أو جهاز التطوير مقفلة.
- تحديث إعدادات العرض لجهاز Android وجهاز التطوير بحيث لا تدخل في وضع السكون مطلقًا.
- جارٍ ضبط وضع USB في جهاز Android على PTP. اطلع على لا يعرض Galaxy S4 مربع الحوار "اعتماد تصحيح أخطاء USB".
- اختَر إبطال تفويضات تصحيح أخطاء USB من شاشة خيارات المطوّرين على جهاز Android لإعادة ضبطه على الحالة الجديدة.
إذا عثرت على حل غير مذكور في هذا القسم أو في القسم لم تكتشف أجهزة Chrome DevTools الجهاز عند توصيله، يُرجى إضافة إجابة على سؤال Stack Overflow هذا، أو فتح مشكلة في مستودع developer.chrome.com.
الخطوة 2: تصحيح الأخطاء في المحتوى على جهاز Android من جهاز التطوير
- افتح Chrome على جهاز Android.
في
chrome://inspect/#devicesعلى جهاز التطوير، سيظهر لك اسم طراز جهاز Android متبوعًا برقمه التسلسلي. وأسفل ذلك، يمكنك رؤية إصدار Chrome الذي يعمل على الجهاز، مع رقم الإصدار بين قوسين.
في مربّع النص فتح علامة التبويب باستخدام عنوان URL، أدخِل عنوان URL، ثم انقر على فتح. تفتح الصفحة في علامة تبويب جديدة على جهاز Android.
تحصل كل علامة تبويب عن بُعد في Chrome على قسم خاص بها في
chrome://inspect/#devices. يمكنك التفاعل باستخدام علامة التبويب هذه من هذا القسم. إذا كانت هناك أي تطبيقات تستخدم WebView، سترى قسمًا لكل تطبيق من هذه التطبيقات أيضًا. في هذا المثال، هناك علامة تبويب واحدة فقط مفتوحة.انقر على فحص بجانب عنوان URL الذي فتحته للتو. يتم فتح مثيل جديد من "أدوات مطوري البرامج".
يحدِّد إصدار Chrome الذي يعمل على جهاز Android إصدار "أدوات مطوّري البرامج" الذي يفتح على جهاز التطوير. لذلك، إذا كان جهاز Android يشغّل إصدارًا قديمًا جدًا من Chrome، قد يبدو إصدار "أدوات مطوري البرامج" مختلفًا تمامًا عما اعتدت عليه.
إجراءات إضافية: إيقاف علامة تبويب مؤقتًا أو التركيز عليها أو إعادة تحميلها أو إغلاقها
تظهر أسفل عنوان URL قائمة لإيقاف علامة تبويب مؤقتًا أو التركيز عليها أو إعادة تحميلها أو إغلاقها.
عناصر الفحص
انتقِل إلى لوحة العناصر في مثيل أدوات مطوّري البرامج ومرِّر مؤشر الماوس فوق عنصر لتمييزه في إطار العرض على جهاز Android.
يمكنك أيضًا النقر على عنصر على شاشة جهاز Android لتحديده في لوحة العناصر.
انقر على رمز اختيار عنصر 
في مثيل أدوات مطوّري البرامج، ثم انقر على العنصر على شاشة جهاز Android. يُرجى العِلم أنّه يتم إيقاف ميزة اختيار عنصر بعد اللمسة الأولى، لذا يجب إعادة تفعيلها في كل مرة تريد فيها استخدام هذه الميزة.
التسجيل الرقمي للشاشة في Android على جهاز التطوير
انقر على تبديل Screencast
لعرض
محتوى جهاز Android في مثيل "أدوات مطوري البرامج".
يمكنك التفاعل مع التسجيل الرقمي للشاشة بعدة طرق:
- وتتم ترجمة النقرات إلى نقرات، مما يؤدي إلى تنشيط أحداث اللمس المناسبة على الجهاز.
- يتم إرسال ضغطات المفاتيح على جهاز الكمبيوتر إلى هذا الجهاز.
- لمحاكاة إيماءة التصغير أو التكبير بإصبعين، اضغط مع الاستمرار على مفتاح Shift أثناء السحب.
- للتمرير، استخدم لوحة اللمس أو عجلة الماوس أو استخدم مؤشر الماوس.
بعض الملاحظات حول التسجيلات الرقمية للشاشة:
- لا تعرض التسجيلات الرقمية للشاشة إلا محتوى الصفحة. تمثّل الأجزاء الشفافة من التسجيل الرقمي للشاشة واجهات الأجهزة، مثل شريط عناوين Chrome أو شريط حالة Android أو لوحة مفاتيح Android.
- تؤثر التسجيلات الرقمية للشاشة سلبًا في عدد اللقطات في الثانية. يمكنك إيقاف التسجيل الرقمي للشاشة أثناء قياس عمليات التمرير أو الرسوم المتحركة للحصول على صورة أكثر دقة لأداء صفحتك.
- إذا تم قفل شاشة جهاز Android، سيختفي محتوى التسجيل الرقمي للشاشة. افتح قفل شاشة جهاز Android لاستئناف التسجيل الرقمي للشاشة تلقائيًا.
تصحيح الأخطاء يدويًا من خلال Android Debug Bridge (adb)
في بعض الحالات النادرة، قد يكون من المفيد استخدام طريقة بديلة لتصحيح الأخطاء عن بُعد. على سبيل المثال، يمكنك الاتصال مباشرةً ببروتوكول أدوات مطوّري البرامج في Chrome (CDP) في Chrome على نظام التشغيل Android.
ولإجراء ذلك، يمكنك استخدام Android Debug Bridge (adb):
- تأكَّد من تفعيل خيارات المطوّرين وتصحيح أخطاء USB على جهاز Android.
- افتح Chrome على جهاز Android.
اربط جهاز Android بجهاز التطوير من خلال:
- كابل USB (مباشرة).
- يمكنك بدلاً من ذلك الاتصال بشبكة adb Wi-Fi.
في سطر الأوامر الخاص بجهاز التطوير، شغِّل
adb devices -lوتحقّق من وجود جهازك في القائمة.عليك إعادة توجيه مقبس بروتوكول CDP على الجهاز إلى المنفذ المحلي لجهازك، مثل
9222. للقيام بذلك، قم بتشغيل:adb forward tcp:9222 localabstract:chrome_devtools_remoteبعد اكتمال عملية الربط، يمكنك معرفة ما يلي:
- يسرد
http://localhost:9222/jsonاستهدافاتكpage. - تعرض السمة
http://localhost:9222/json/versionنقطة النهاية المستهدَفةbrowser، كما هو موضّح في مستندات بروتوكول التحكم في الوصول (CDP). - تتم تعبئة
chrome://inspect/#devices، حتى بدون وضع علامة في المربّع بجانب اكتشاف أجهزة USB.
- يسرد
لتحديد المشاكل وحلّها، يُرجى الاطّلاع على:
- مستندات
adb يمكنك اختياريًا قراءة الأدلة الأقدم: