Android قم بتوصيل Debug Bridge (ADB) بالجهاز عبر USB وWiFi

⚡ ملخص ذكي

Android يقوم جسر التصحيح بتوصيل محطة عمل بجهاز محاكاة أو جهاز محمول فعلي، ويفتح واجهة سطر الأوامر، ويقوم بتثبيت الإصدارات، ويعرض الجهاز لأدوات التشغيل الآلي عبر كابل USB أو رابط لاسلكي.

  • 🔴 ثلاثة أجزاء: ADB هو عميل، وخادم يعمل في الخلفية على منفذ TCP 5037، وبرنامج يعمل على الجهاز.
  • ☑️ الشرط الأول: يجب تفعيل تصحيح أخطاء USB ضمن خيارات المطور قبل ظهور أي جهاز.
  • تحقق من الرابط: يعرض برنامج adb devices قائمة بجميع أجهزة المحاكاة والهواتف المتصلة مع رقمها التسلسلي.
  • 🧪 Target جهاز واحد: adb -s يرسل أمرًا إلى جهاز واحد عند توصيل عدة أجهزة.
  • 🛠️ خيار الاتصال اللاسلكي: يؤدي الأمر adb tcpip 5555 متبوعًا بالأمر adb connect إلى نقل جلسة موجودة إلى شبكة Wi-Fi.
  • 📊 الأجهزة الحديثة: Android يتم الاقتران عبر Wi-Fi باستخدام adb pair، لذا لا حاجة إلى كابل على الإطلاق.

Android جسر تصحيح الأخطاء الذي يربط جهازًا عبر USB وWi-Fi

ما هي تفاصيل Android جسر التصحيح (ADB)؟

Android جسر التصحيح (ADB) هو أداة سطر أوامر تتيح لك التواصل مع جهاز. وهو يربط مثيل المحاكي (Android الجهاز) وعملية الخادم الخلفية (الخادم)، حتى تتمكن من تثبيت الإصدارات وتصحيح أخطاء الجهاز وتشغيل الأوامر من خلال واجهة سطر أوامر يونكس.

استخدام جهاز حقيقي لأتمتة الأجهزة المحمولة تجريب لطالما كان ذلك يمثل تحدياً. Android يقدم حلولاً لتوصيل جهاز واحد عبر منفذ USB (الناقل التسلسلي العالمي) - أي Android جسر تصحيح الأخطاء.

تصحيح أخطاء USB وتكوين ADB

Appium يمكن إجراء الاختبارات على أجهزة حقيقية، ولكن يجب إعداد المتطلبات الأساسية التالية أولاً.

  • يجب تمكين تصحيح أخطاء USB
  • تكوين بنك التنمية الآسيوي
  • إعداد القدرة المطلوبة حسب تغييرات الأجهزة.

سنتناول كلاً من المحاكي والجهاز الحقيقي. وسنبدأ بخطوات المحاكي.

كيفية الاتصال بالمحاكي

المتطلبات الأساسية: يجب تثبيت حزمة تطوير البرمجيات (SDK) على الجهاز. ADB في Android معبأة بـ Googleالصورة Android SDKs.

خطوات لتمكين ADB من مدير SDK.

الخطوة 1) ساعات العمل Android مجلد SDK

الخطوة 2) Double انقر على مدير SDK

الخطوة 3) من قائمة جميع الحزم، حدد الأدوات وقم بتحديد مربع الاختيار

  • Android أدوات SDK و
  • Android أدوات منصة SDK.

تظهر أدناه قائمة حزم مدير SDK مع تحديد كلا الخيارين.

Android قائمة حزم مدير SDK مع Android أدوات SDK وأدوات المنصة المختارة

⚠️ ملاحظة حول الإصدار: تم إيقاف استخدام مدير SDK المستقل المذكور أعلاه في أدوات SDK 25.2.3، وتمت إزالة مشغله في الإصدار 25.3.0. افتح قائمة الحزم نفسها من Android Studio (الأدوات > مدير SDK) أو sdkmanager واجهة سطر الأوامر. لا تزال الحزمة Android أدوات منصة SDKالذي يحتوي adb.

كيفية الاتصال Android الجهاز مع ADB (Android جسر التصحيح)

الخطوة 1) قم بتمكين تصحيح أخطاء USB على جهازك

قم بتمكين خيار تصحيح أخطاء USB من "خيارات المطور" على Android قم بتوصيل الهاتف، ثم قم بتوصيل الجهاز بالكمبيوتر باستخدام كابل USB، كما هو موضح هنا.

تم تفعيل مفتاح تصحيح أخطاء USB داخل خيارات المطور على Android للهواتف

الخطوة 2) انتقل إلى Android مجلد SDK

افتح المجلد الذي يحتوي على Android تم حفظ ملفات SDK،Android SDK >> أدوات المنصة — على سبيل المثال C:\android-sdk\platform-tools، ظاهر أدناه.

Windows افتح مستكشف الملفات في مجلد platform-tools داخل Android SDK

الخطوة 3) افتح نافذة الأوامر

داخل المجلد، احتفظ Shift استخدم قائمة النقر بزر الماوس الأيمن >> ثم اختر "فتح نافذة الأوامر هنا"، كما هو موضح أدناه. يمكنك أيضًا الوصول إلى مسار المجلد من خلال أمر التشغيل.

Shift بالإضافة إلى قائمة السياق التي تظهر عند النقر بزر الماوس الأيمن "فتح نافذة الأوامر هنا".

ثم يفتح موجه الأوامر وهو يشير بالفعل إلى مجلد platform-tools.

تم فتح نافذة موجه الأوامر مباشرة في دليل أدوات النظام الأساسي

الخطوة 4) قم بتوصيل جهاز خارجي Android جهاز

قم بتوصيل جهاز خارجي Android قم بتوصيل الجهاز (الهاتف المحمول) بكابل USB الخاص به. ثم، في موجه الأوامر أعلاه، اكتب:

'adb devices' & press Enter

سيعرض قائمة بجميع الأجهزة المتصلة، كما هو موضح أدناه.

مخرجات موجه الأوامر لعرض قائمة الأجهزة المتصلة عبر منفذ التسلسلي (adb devices).

تحقق أولاً مما إذا كان خادم ADB يعمل كعملية في الخلفية: اكتب 'adb' في موجه الأوامر نفسه واضغط على مفتاح الإدخال. سيظهر لك قائمة بعمليات ADB قيد التشغيل.

عند بدء تشغيل الخادم، يقوم بربط منفذ TCP المحلي 5037. تستخدم جميع عملاء ADB المنفذ 5037 للوصول إلى الخادم، الذي يقوم بدوره بمسح المنافذ للعثور على كل محاكي أو مثيل جهاز متصل.

يعمل برنامج ADB daemon على منفذ ذي رقم فردي، وتأخذ وحدة تحكم المحاكي المطابقة المنفذ ذي الرقم الزوجي بجانبه. Androidالصورة وثائق ADB يضع نطاق المسح الضوئي في المنافذ الفردية من 5555 إلى 5585، ويغطي أول 16 محاكيًا.

إذا كان هناك جهاز واحد متصل، فسيعثر عليه الخادم ويتصل به تلقائيًا. أما عند تشغيل عدة أجهزة أو محاكيات، فيجب عليك تحديد الهدف في سطر الأوامر. على سبيل المثال، الجهاز الموجود على المنفذ الفردي 5557 لديه وحدة تحكم على المنفذ الزوجي 5556 - منفذ فردي ومنفذ زوجي لكل منهما.

emulator 1: console 5556
emulator 1: adb 5557
emulator 2: console 5554
emulator 2: adb 5555

أمر للكشف عن جميع الأجهزة المتصلة:

<$ adb devices>
emulator-5554 device
emulator-5556 device
emulator-5558 device

أمر لاكتشاف جهاز واحد من بين عدة أجهزة متصلة:

<$ adb -s emulator-5554 install Guru99.apk>

يستهدف اتصال adb للجهاز 5554 ويقوم بتثبيت التطبيق - هذه هي الطريقة التي تتعامل بها مع مثيل ADB واحد من سطر الأوامر.

Syntax used to access ADB instances from the command line:
adb -d — An adb command when a single USB device is connected
adb -e — An adb command when only a single emulator is running
adb devices — This will print the list of emulators / devices attached.
adb version — List the adb version number.
adb help — Print the list of supported commands.

كيفية تهيئة ADB لدعم Wi-Fi

يمكن أيضًا تهيئة ADB عبر Wi-Fi، مما يحرر الهاتف من الكابل أثناء الاستخدام الطويل Appium يركض.

المتطلبات المسبقة

  • كلا ال Android يجب أن يكون الجهاز والكمبيوتر المضيف متصلين بنفس الشبكة اللاسلكية، و
  • يجب تعطيل خيار البلوتوث في الجهاز.

خطوات الاتصال:

  1. قم بتوصيل الجهاز بالكمبيوتر المضيف باستخدام كابل USB. تأكد من تفعيل خاصية تصحيح أخطاء USB على الجهاز.
  2. قم بضبط الجهاز المستهدف للاستماع إلى اتصال TCP/IP على المنفذ 5555.
    $ adb tcpip 5555

يؤكد موجه الأوامر التبديل إلى وضع TCP/IP، كما هو موضح أدناه.

موجه الأوامر يعرض أمر adb tcpip 5555 لإعادة تشغيل الخدمة في وضع TCP

  1. الآن افصل كابل USB عن الجهاز.
  2. على الجهاز، ابحث عن عنوان IP ضمن الإعدادات >> إعدادات Wi-Fi >> خيارات متقدمة >> عنوان IP. اتصل به، ثم أكد الجلسة.
    $ adb connect 148.100.1.17:5555
    $ adb devices
    List of devices attached
    148.100.1.17:5555 device

اكتملت عملية التهيئة الآن ويعمل برنامج "adb" عبر الشبكة اللاسلكية.

⚠️ ملاحظة حول الإصدار: يبقى التسلسل المذكور أعلاه، والذي يبدأ بالكابل، هو المسار الوحيد على Android 10 وأقل. Android الإصدار 11 (API 30) والإصدارات الأحدث تضيف ميزة تصحيح الأخطاء اللاسلكية: قم بتمكينها في خيارات المطور، ثم اختر إقران باستخدام رمز الاقتران، ثم اركض adb pair ipaddr:port أدخل الرمز. لا حاجة إلى كابل.

ملاحظة: في حالة حدوث خطأ في الاتصال، قم بإنهاء اتصال مضيف adb أدناه، ثم أعد الاتصال من الخطوة الأولى.

$ adb kill-server

إذا كنت تبحث عن برنامج محاكاة، فراجع هذا قائمة الأفضل Android محاكاة لـ Windows.

الأسئلة الشائعة

لم يتم قبول طلب مفتاح RSA على الهاتف. افتح قفل الشاشة، وأعد توصيل الكابل، ثم انقر على "السماح بتصحيح أخطاء USB". إذا لم يظهر أي طلب، فقم بإلغاء أذونات تصحيح أخطاء USB في "خيارات المطور" وحاول مرة أخرى.

مجموعات التعلم الآلي ذات بنية متطابقة تقريبًا tracيقوم برنامج es من logcat بترتيب الأعطال حسب الجلسات المتأثرة ويشير إلى أول عملية إيداع من المحتمل أن تكون قد تسببت في حدوث تراجع، لذلك يقرأ المختبر عددًا قليلاً من المجموعات بدلاً من آلاف الأسطر.

يُكمل برنامج Copilot عمليات التحقق الروتينية على أجهزة adb، ويُثبّت الأوامر ويسحبها من تعليق. تحقق من كل أمر مُنشأ على جهاز واحد أولاً، لأن أي خطأ في الإعدادات قد يؤدي إلى مسح بيانات التطبيق دون ظهور رسالة تأكيد.

استخدم الأمر adb install مع مسار ملف APK، وأضف الخيار -r لإعادة التثبيت فوق نسخة موجودة، واستخدم الأمر adb uninstall مع اسم الحزمة لإزالتها. أضف الخيار -s لاستهداف جهاز واحد.

تأكد من تفعيل تصحيح أخطاء USB، وجرّب استخدام كابل بيانات بدلاً من كابل الشحن فقط، ثم ثبّت برنامج تشغيل USB الخاص بالشركة المصنّعة. Windowsوقم بتشغيل الأمر adb kill-server متبوعًا بالأمر adb devices لإعادة تشغيل البرنامج الخفي.

يقوم الأمر adb tcpip بتحويل جلسة USB الحالية إلى منفذ شبكة، ويعمل على جميع الإصدارات. أما الأمر adb pair فيستخدم شاشة تصحيح الأخطاء اللاسلكية المضافة في Android 11 ولا يحتاج إلى كابل في أي وقت.

لا. يتم تضمين ملف adb الثنائي داخل Android حزمة أدوات منصة SDK، والتي يمكن تنزيلها بشكل منفصل. أضف هذا المجلد إلى متغير PATH الخاص بك، وسيعمل الأمر من أي مجلد.

شغّل الأمر adb logcat لعرض سجل النظام، ثم استخدم الأمر adb logcat > log.txt لحفظه. أضف الأمر adb bugreport لإنشاء أرشيف تشخيصي كامل عند الحاجة إلى إرفاق أدلة على وجود خلل.

تلخيص هذه التدوينة بـ: