تصحيح أخطاء المحتوى المباشر عن بُعد على جهاز Android من جهاز كمبيوتر يعمل بنظام التشغيل Windows أو Mac أو Linux. يعلّمك هذا البرنامج التعليمي كيفية:
- يمكنك إعداد جهاز Android لتصحيح الأخطاء عن بُعد واكتشافه من خلال جهاز التطوير.
- يمكنك فحص المحتوى المباشر وتصحيح الأخطاء على جهاز Android من جهاز التطوير.
- تسجيل محتوى Screencast من جهاز 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" الجهاز عند توصيله بمصدر طاقة.
إذا لم يظهر لك الطلب السماح بتصحيح أخطاء الجهاز عبر 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 (مستقيم)
- يمكنك بدلاً من ذلك استخدام اتصال Wi-Fi باستخدام adb.
في سطر الأوامر بجهاز التطوير، شغِّل
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 يمكنك اختياريًا قراءة الأدلة القديمة: