تشغيل التطبيقات على جهاز

اختبِر تطبيق Android دائمًا على جهاز حقيقي قبل طرحه للمستخدمين. توضّح هذه الصفحة كيفية إعداد بيئة التطوير وجهاز Android للاختبار وتصحيح الأخطاء من خلال اتصال Android Debug Bridge (ADB).

إعداد جهاز للتطوير

قبل أن تتمكّن من بدء تصحيح الأخطاء على جهازك، عليك تحديد ما إذا كنت تريد الربط بالجهاز باستخدام كابل USB أو شبكة Wi-Fi. بعد ذلك، يُرجى اتّباع الخطوات التالية:

  1. على الجهاز، افتح تطبيق الإعدادات، واختَر خيارات المطوّرين، ثمَّ فعِّل تصحيح أخطاء USB (إن أمكن).

  2. اضبط إعدادات النظام لرصد جهازك.

    • ChromeOS: لا يلزم إجراء أي إعدادات إضافية.
    • macOS: لا يلزم إجراء أيّ إعدادات إضافية.
    • نظام التشغيل Windows: تثبيت برنامج تشغيل USB لواجهة ADB (إذا كان ذلك منطبقًا) للحصول على دليل التثبيت والروابط المؤدية إلى برامج تشغيل المصنّعين الأصليين للأجهزة، يُرجى الاطّلاع على مقالة تثبيت برامج تشغيل USB الخاصة بالمصنّعين الأصليين للأجهزة.

    • Ubuntu Linux: عليك إعداد ما يلي:

      • يجب أن يكون كل مستخدم يريد استخدام ADB في مجموعة plugdev. إذا ظهرت لك رسالة خطأ تفيد بأنّك لست في مجموعة plugdev، أضِف نفسك إليها باستخدام الأمر التالي:
      sudo usermod -aG plugdev $LOGNAME

      لا يتم تعديل المجموعات إلا عند تسجيل الدخول، لذا عليك تسجيل الخروج لكي يتم تطبيق هذا التغيير. عند إعادة تسجيل الدخول، يمكنك استخدام id للتأكّد من أنّك في مجموعة plugdev.

      • يجب أن يكون لدى النظام udev قاعدة مثبّتة تغطي الجهاز. تحتوي حزمة android-sdk-platform-tools-common على مجموعة تلقائية من قواعد udev تديرها المنتدى لأجهزة Android. لتثبيته، استخدِم الأمر التالي:
      apt-get install android-sdk-platform-tools-common

الاتصال بجهازك باستخدام USB

بعد الانتهاء من الإعداد وربط الجهاز عبر USB، انقر على تشغيل في Android Studio لإنشاء تطبيقك وتشغيله على الجهاز.

يمكنك أيضًا استخدام adb لإصدار الأوامر، على النحو التالي:

  • تأكَّد من اتصال جهازك بالجهاز الآخر من خلال تنفيذ الأمر adb devices من دليل android_sdk/platform-tools/. إذا كان الجهاز متصلاً، سيظهر في القائمة.
  • يمكنك إصدار أي adb أمر باستخدام علامة -d لاستهداف جهازك.

الاتصال بجهازك باستخدام شبكة Wi-Fi

يتيح الإصدار 11 من نظام التشغيل Android والإصدارات الأحدث نشر تطبيقك وتصحيح أخطاءه لاسلكيًا من محطة العمل عبر أداة Android Debug Bridge (ADB). على سبيل المثال، يمكنك نشر تطبيقك القابل لتصحيح الأخطاء على أجهزة عن بُعد متعددة بدون توصيل جهازك جسديًا عبر USB والتعامل مع المشاكل الشائعة في اتصال USB، مثل تثبيت برنامج التشغيل.

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

  1. تأكَّد من أنّ محطة العمل والجهاز متّصلان بالشبكة اللاسلكية نفسها.
  2. تأكَّد من أنّ جهازك يعمل بنظام التشغيل Android 11 أو إصدار أحدث. لمزيد من المعلومات، يُرجى الاطّلاع على المقالة التحقّق من إصدار Android وتحديثه.
  3. تأكَّد من تثبيت أحدث إصدار من Android Studio. يمكنك تنزيله من هنا.
  4. على محطة العمل، ثبِّت أحدث إصدار من أدوات حزمة تطوير البرامج (SDK).

للاتصال بجهازك، اتّبِع الخطوات التالية:

  1. افتح Android Studio واختَر إقران الأجهزة باستخدام Wi-Fi من قائمة الإعدادات.
    القائمة المنسدلة لإعدادات التشغيل
    الشكل 1. قائمة "تنفيذ الإعدادات"

    يظهر مربّع الحوار إقران الأجهزة عبر شبكة Wi-Fi، كما هو موضّح في الشكل 2.
    لقطة شاشة لشاشة النافذة المنبثقة لإقران الأجهزة عبر شبكة Wi-Fi
    الشكل 2. مربّع حوار لإقران الأجهزة باستخدام رمز الاستجابة السريعة أو رمز الإقران
  2. فعِّل خيارات المطوّرين على جهازك.
  3. فعِّل تصحيح الأخطاء عبر فاقِد سرعة Wi-Fi على جهازك.
    لقطة شاشة لهاتف Pixel تعرض إعدادات تصحيح أخطاء الأنظمة اللاسلكي
    الشكل 3. إعداد تصحيح الأخطاء اللاسلكي على هاتف Google Pixel
  4. انقر على تصحيح الأخطاء اللاسلكي وأقِرِن جهازك:
    1. لإقران جهازك باستخدام رمز الاستجابة السريعة، اختَر إقران الجهاز باستخدام رمز الاستجابة السريعة ومسح رمز الاستجابة السريعة ضوئيًا، كما هو موضّح في الشكل 2.
    2. لإقران جهازك باستخدام رمز إقران، اختَر إقران الجهاز باستخدام رمز الإقران من مربّع الحوار إقران الأجهزة الجديدة عبر شبكة Wi-Fi. على الجهاز، اختَر الإقران باستخدام رمز الإقران. سيظهر رمز مكوّن من ستة أرقام. بعد ظهور جهازك في نافذة إقران الأجهزة عبر Wi-Fi، أدخِل الرمز المكوّن من ستة أرقام الذي يظهر على جهازك وانقر على إقران .
      لقطة شاشة لمثال على إدخال رمز الإقران
      الشكل 4. مثال على إدخال رمز إقران مكوّن من 6 أرقام
  5. بعد الإقران، يمكنك محاولة نشر تطبيقك على جهازك.

لإقران جهاز مختلف أو حذف هذا الجهاز من محطة العمل، اتّبِع الخطوات التالية:

  1. انتقِل إلى تصحيح الأخطاء اللاسلكي على جهازك.
  2. انقر على اسم محطة العمل ضمن الأجهزة المقترنة.
  3. انقر على نسيان.

عكس الشاشة على الجهاز

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

تتوفّر ميزة "إقران الأجهزة" دائمًا عندما تكون هناك أجهزة متصلة بالكمبيوتر ويكون تصحيح أخطاء USB أو تصحيح أخطاء الربط اللاسلكي مفعّلاً عليها. يمكنك بدء النسخ المطابق وإيقافه باستخدام نافذة الأجهزة التي تعمل أو مدير الأجهزة (عرض > نوافذ الأدوات > مدير الأجهزة). يمكنك أيضًا تخصيص وقت تفعيل ميزة عكس الشاشة في إعدادات الجهاز (الإعدادات > الأدوات > عكس الشاشة).

مرآة الجهاز.

واجهة مستخدم الأجهزة التي تعمل

إعادة توجيه الصوت

عند استخدام ميزة "نسخ شاشة الجهاز"، يمكنك إعادة توجيه الصوت من الأجهزة المادية المتصلة إلى مكبّرات صوت الكمبيوتر أو سماعات الرأس. باستخدام ميزة إعادة توجيه الصوت، يمكنك إبقاء سماعات الرأس متصلة بالكمبيوتر والاستماع إلى كلٍّ من الكمبيوتر والهاتف المتصل بدون الحاجة إلى إعادة الاتصال يدويًا بأحد الجهازَين ثم بالآخر. لتفعيل إعادة توجيه الصوت، انتقِل إلى ملف (Android Studio على نظام التشغيل macOS) > الإعدادات > الأدوات > إقران الأجهزة واختَر إعادة توجيه الصوت من الأجهزة المحلية. تجدر الإشارة إلى أنّه تتم إعادة توجيه الصوت دائمًا، بغض النظر عن الإعدادات، على أجهزة Firebase Test Lab التي تعمل بنظام التشغيل Android 12 أو الإصدارات الأحدث.

المشاكل المعروفة

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

2023-06-01 15:32:22,675 [  56094]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - Too many video encoder errors:
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - encoder: c2.android.vp8.encoder
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - mime type: video/x-vnd.on2.vp8
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - max resolution: 640x640
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - min resolution: 2x2
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - alignment: 2x2
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - max frame rate: 960
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - max frame rate for 288x640: 960
2023-06-01 15:32:22,870 [  56289]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - max bitrate: 20000000
2023-06-01 15:32:22,871 [  56290]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - terminated with code 1

إشعار الخصوصية

استنادًا إلى إعدادات ميزة "إقران الجهاز"، يمكن أن يبدأ Android Studio تلقائيًا إقران الجهاز لأي جهاز متصل ومقترن. وقد يؤدي ذلك إلى إفصاح عن معلومات للأجهزة المتصلة باستخدام الأمر adb tcpip لأنّه يتم نقل معلومات النسخ المطابق والأوامر عبر قناة غير مشفَّرة. بالإضافة إلى ذلك، يستخدم Android Studio قناة غير مشفَّرة للتواصل مع خادم adb، لذا يمكن للمستخدمين الآخرين intercepting رصد معلومات النسخ المطابق على جهازك المضيف.

تحديد مشاكل الاتصال بالجهاز وحلّها

إذا لم يكن جهازك متصلاً بتطبيق Android Studio، جرِّب الخطوات التالية لمحاولة حلّ المشكلة:

تحديد المشاكل وحلّها باستخدام "مساعِد الاتصال"

يوفّر "مساعِد الربط" تعليمات مفصّلة لمساعدتك في إعداد واستخدام جهاز عبر اتصال ADB.

لبدء المساعد، اختَر الأدوات > تحديد المشاكل وحلّها في عمليات ربط الأجهزة.

يوفّر "مساعِد الربط" تعليمات وعناصر تحكّم في السياق وقائمة بالأجهزة المقترَنة في سلسلة من الصفحات في لوحة مساعد Google. استخدِم زرَّي التالي والسابق في أسفل لوحة مساعد Google للتنقل بين الصفحات حسب الحاجة:

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

حلّ المشاكل المتعلقة باتصال USB

إذا لم يرصد "مساعِد الاتصال" جهازك عبر USB، جرِّب الخطوات التالية لتحديد المشاكل وحلّها:

التأكّد من اتصال "استوديو Android" بمحاكي Android

للتحقّق مما إذا كانت المشكلة ناتجة عن مشكلة في الاتصال بين Android Studio ومحاكي Android، اتّبِع الخطوات التالية:

  1. افتح مدير الأجهزة.
  2. أنشئ جهاز افتراضي Android جديدًا إذا لم يكن لديك جهاز.
  3. شغِّل المحاكي باستخدام جهاز AVD.
  4. نفِّذ أيًا مما يلي:
    • إذا تعذّر على "استوديو Android" الاتصال بالمحاكي، نزِّل أحدث إصدار من أدوات حزمة تطوير البرامج (SDK) ثم أعِد المحاولة.
    • إذا بدأ المحاكي بنجاح، تحقّق من كابل USB كما هو موضّح في القسم التالي.

التحقّق من كابل USB

للتحقّق مما إذا كانت المشكلة ناتجة عن كابل USB تالف، اتّبِع الخطوات الواردة في هذا القسم.

إذا كان لديك كابل USB آخر:

  1. وصِّل الجهاز باستخدام الكابل الثانوي.
  2. تحقَّق مما إذا كان بإمكان "مساعِد الاتصال" الآن رصد الجهاز.
  3. إذا لم يتم رصد الجهاز، جرِّب استخدام الكابل الأساسي مرة أخرى.
  4. إذا لم يتم اكتشاف الجهاز بعد، افترض أنّ المشكلة في الجهاز، و تحقَّق مما إذا كان الجهاز قد تم إعداده للتطوير كما هو موضّح في القسم التالي.

إذا لم يكن لديك كابل USB آخر ولكن لديك جهاز Android آخر:

  1. وصِّل الجهاز الثانوي بجهاز الكمبيوتر.

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

    إذا لم يتم رصد الجهاز الثانوي، قد تكون المشكلة في كابل USB.

التحقّق مما إذا كان الجهاز قد تم إعداده للتطوير

للتحقّق مما إذا كانت المشكلة ناتجة عن الإعدادات على الجهاز، اتّبِع الخطوات التالية:

  1. اتّبِع الخطوات الواردة في القسم إعداد جهاز للتطوير.
  2. إذا لم يؤدّ ذلك إلى حلّ المشكلة، يُرجى التواصل مع فريق دعم عملاء المصنّع الأصلي للجهاز للحصول على المساعدة. أطلِع ممثّل دعم العملاء على أنّه لا يمكن توصيل الجهاز بـ "استوديو Android" باستخدام ADB.

حلّ مشاكل الاتصال اللاسلكي

إذا كنت تواجه مشاكل في الاتصال بجهازك لاسلكيًا، يمكنك تجربة الخطوات التالية لتحديد المشاكل وحلّها:

التحقّق مما إذا كانت محطة العمل والجهاز يستوفون المتطلبات الأساسية

لاستيفاء المتطلبات الأساسية لتصحيح الأخطاء اللاسلكي، تأكَّد مما يلي:

التحقّق من المشاكل الأخرى المعروفة

في ما يلي قائمة بالمشاكل المعروفة حاليًا في تصحيح الأخطاء اللاسلكي في IDE Android Studio وكيفية حلّها:

  • تعذُّر الاتصال بشبكة Wi-Fi: قد تحظر بعض شبكات Wi-Fi، مثل الشبكات المخصّصة للشركات، اتصالات p2p ولا تسمح لك بالاتصال عبر Wi-Fi. جرِّب الاتصال باستخدام كابل أو شبكة Wi-Fi أخرى.
  • إيقاف ADB عبر Wi-Fi تلقائيًا في بعض الأحيان: يمكن أن يحدث ذلك إذا كان الجهاز يبدّل شبكات Wi-Fi أو يقطع الاتصال بالشبكة.

مفتاح أمان RSA

عند توصيل جهاز يعمل بالإصدار 4.2.2 من نظام التشغيل Android (المستوى 17 لواجهة برمجة التطبيقات) أو إصدار أحدث بجهاز الكمبيوتر، يعرض النظام مربّع حوار يسألك ما إذا كنت تريد قبول مفتاح RSA الذي يسمح بإجراء تصحيح الأخطاء من خلال هذا الكمبيوتر. تحمي آلية الأمان هذه أجهزة المستخدِم لأنّه لا يمكن تنفيذ debugging عبر USB وأوامر adb الأخرى ما لم تتمكّن من فتح قفل الجهاز والموافقة على مربّع الحوار.